用途
数据科学可视化技能用于从真实表格（CSV/TSV/JSON/XLSX）或已有的统计与模型结果，生成一张能回答用户问题的交互式数据科学图表 HTML。其目标是“一张图回答问题”，只有在需要互补视角时才组合多图。完整分析报告或应用开发应使用对应的工作流。
主要能力
- 选图：先明确观测是什么、要比较什么、字段含义与单位、数据范围。只检查会影响图型选择的缺失情况、组内有效样本、常量或点密集程度，不自动生成审计报告。数字 ID 不因类型是 number 就变成测量指标，唯一性也不单独证明某字段是 ID。
- 尊重用户选择：用户已指定图型时尊重选择；若数据不满足契约，会说明原因，不会静默换图、猜带宽或伪造结果。
- 按索引定位图型：在索引中定位选中 type 的条目，读取其 guide、typeFile 及必要 import 依赖和 example 最小输入。特殊变体才读取 variantFile 中对应 type 的选项与固定链接。
- 生成与交付：复用生成器，不重写 HTML 或绘图计算。默认只展示标题、图表、单位与真实 Tooltip，保留必要的静态图例和色标；其他交互仅来自明确需求。
使用方式
通过命令行调用生成脚本：
python3 /实际技能目录/scripts/generate_visualization.py \
--request /实际请求目录/request.json \
--output /新的输出目录
- 需要 Python 3.11+。CSV/TSV/JSON 只需标准库；XLSX 可选 openpyxl 并须明确 sheet。默认解释器太旧时指定已有可用版本。
- 输出 HTML、可重放 request 和带来源的 data；输出目录必须不存在。
- HTML 内嵌使用数据，固定使用 VChart/statplots 2.1.8-alpha.0 CDN；打开需网络及外部脚本权限，无需 npm、TypeScript、MCP 或本地服务器。
- 标题写实际变量、比较对象和必要范围，轴/Tooltip 保留单位。交付 HTML 链接及影响解读的数据范围、缺失省略或小样本限制；不把相关当因果，不添加分析面板。不展开聚合频数、不默认采样/截断、不猜区间或降维坐标；原始模型计算和完整推断报告使用分析工作流。
验收与继续改图
实际打开 HTML 检查图元、Tooltip 和所请求的交互。window.__DSV_STATUS__.ready 只表示批次结束，成功需每图 status=rendered；输入/省略数及详细错误保留在状态对象。仅有文件或 canvas 不能证明可用；宿主/CDN 受限时说明未完成的验收。
对话改图读取磁盘 visualization.request.json，保留全部使用行、ID、单位、固定条件和按需选项，修改请求后生成新目录。新增未内嵌字段时从已知原数据按真实 ID 补回；request 不是全列备份。浏览器后续选择不自动写回磁盘，不可读取时确认具体条件；用户请求保存当前视图时才提供 saveView。
适用场景
- 看数据：快速从表格数据生成可回答问题的图表。
- 展示结果：对已有统计或模型结果做可视化呈现。
限制
- 不适用于完整分析报告或应用开发，这些应使用对应工作流。
- 不自动生成审计报告，不展开聚合频数，不默认采样/截断，不猜区间或降维坐标。
- 原始模型计算和完整推断报告使用分析工作流。
- 数据类型支持：CSV/TSV/JSON 使用标准库，XLSX 需可选 openpyxl。
- 打开 HTML 需网络及外部脚本权限。