data-science-visualization
GitHub根据数据与问题生成交互式数据科学图表 HTML,支持按条件选图、保留单位 Tooltip 及按需交互。通过 Python 脚本调用生成器,交付可重放请求的静态页面,适用于数据展示与结果分析。
触发场景
安装
npx skills add VisActor/VChart --skill data-science-visualization -g -y
SKILL.md
Frontmatter
{
"name": "data-science-visualization",
"description": "从真实表格或已有统计与模型结果生成简洁的交互数据科学图表 HTML,按问题与数据条件选图,支持按需交互和对话改图。用于看数据和展示结果;完整分析报告或应用开发使用对应工作流。"
}
数据科学可视化
生成一张能回答用户问题的图;需要互补视角时才组合多图。默认只展示标题、图表、单位与真实 Tooltip,保留必要静态图例和色标;其他交互只来自明确需求。
选择有意义的图
先明确观测是什么、要比较什么、字段含义/单位和数据范围。只检查会影响选择的缺失、组内有效样本、常量或点密集程度;不自动生成审计报告。数字 ID 不因是 number 就变成测量指标,唯一性也不单独证明一个字段是 ID。
按 问题与数据条件 选择图义。含义不足时只澄清会改变图义的问题。用户已指定图型时尊重选择;数据不满足契约则说明原因,不静默换图、猜带宽或伪造结果。
定位本地索引中选中 type 的条目,读取其本地 guide、typeFile 及必要 import 依赖、example 最小输入。索引每行一图,可按 type 定位;不要读完整联合声明或全部指南。特殊变体才读取 variantFile 中对应 type 的 options 和选中条目的本地 example,路径相对 references/statplots 根目录;不要预读全部变体示例。公共数值、区间或配色条件见 公共约束。TS 是字段参考,最终仍由公共 validate/compile 校验。
生成与交付
复用生成器,不重写 HTML 或绘图计算。输入与交互协议 维护表格绑定、直接 Spec、预算和按需控件。examples/ 为六份可执行演示;基础例子无控件,interactive.json 仅供明确交互需求参考,演示数据不能当用户数据。
python3 /实际技能目录/scripts/generate_visualization.py \
--request /实际请求目录/request.json \
--output /新的输出目录
Python 3.11+,CSV/TSV/JSON 只需标准库;XLSX 可选 openpyxl 并明确 sheet。默认解释器太旧时指定已有可用版本。输出 HTML、可重放 request 和带来源的 data;输出目录必须不存在。HTML 内嵌使用数据,VChart/statplots 使用 release.json 指定的同版本固定 CDN;打开需网络及外部脚本权限,无需 npm、TypeScript、MCP 或本地服务器。
标题写实际变量、比较对象和必要范围,轴/Tooltip 保留单位。交付 HTML 链接及影响解读的数据范围、缺失省略或小样本限制;不把相关当因果,不添加分析面板。不展开聚合频数、不默认采样/截断、不猜区间或降维坐标;原始模型计算和完整推断报告使用分析工作流。
验收与继续改图
实际打开 HTML 检查图元、Tooltip 和所请求的交互。window.__DSV_STATUS__.ready 只表示批次结束,成功需每图 status=rendered;输入/省略数及详细错误保留在状态对象。仅有文件或 canvas 不能证明可用;宿主/CDN 受限时说明未完成的验收。
对话改图读取磁盘 visualization.request.json,保留全部使用行、ID、单位、固定条件和按需选项,修改请求后生成新目录。新增未内嵌字段时从已知原数据按真实 ID 补回;request 不是全列备份。浏览器后续选择不自动写回磁盘,不可读取时确认具体条件;用户请求保存当前视图时才提供 saveView。
请整体使用版本匹配的技能包。参考资源缺失或版本不一致时停止生成,更新完整技能包后再运行,不单独修改库版本。
版本历史
-
e1c5c21
当前 2026-11-03 01:46
升级 VChart/statplots CDN 至 2.2.0,统一版本管理;收敛资源至包内,移除元数据并完善同步发布回滚与校验机制。
- e41a07f 2026-10-19 08:45


