前言¶
做数据分析时，常见路径是：先把表格导出，再打开 BI 或手写脚本绑图。表格稍脏——合并单元格、中文表头、需要先做聚合——就要在 pandas 和图表配置之间来回改。若你已经在 Cursor、Claude Code 等环境里用 Agent 处理文件，更希望把「读表、选型、出图」收成一条对话，而不是每次从零搭环境。
下面介绍 SkillHub 上的 smart-charts：面向 Agent 的图表生成 Skill，用数据文件驱动，输出可本地打开的交互式 HTML 图表。
这是什么¶
smart-charts 是发布在 SkillHub 的社区 Skill，坐标为 @user_5b28ea14/smart-charts，当前页面标注版本 v8.4.0，作者为 hanli。
官方简介概括为两步：将 CSV / Excel / JSON 等格式的数据放入对话；Agent 按 Skill 流程处理，交付 交互式图表（HTML），并支持将图表保存为图片。Skill 提供 32 种图表与 3 个主题，底层为 ECharts 可视化。
与「只给 Agent 一段画图代码、由模型临时拼 option」相比，smart-charts 把解析、选型、渲染收敛到 Skill 约定的工作流里，减少每次手写配置和依赖遗漏。
官方入口：https://api.skillhub.cn/user_5b28ea14/smart-charts
Skill 详情页：https://www.skillhub.cn/skills/user_5b28ea14/smart-charts
核心功能¶
以下能力均来自 SkillHub 页面说明，并与 Skill 定位一致（读取用户提供的表格类文件并生成可视化）：
- 多格式数据输入：支持 CSV、Excel、JSON 等常见表格/半结构化文件（具体解析规则以安装后的
SKILL.md为准）。 - 图表类型与主题：32 种图表类型，3 套主题，用于不同展示场景。
- 交互式 HTML 交付：生成可在浏览器中交互查看的 ECharts 页面，而非静态截图。
- 导出图片：在生成结果上可将图表保存为图片，便于插入文档或汇报。
- Agent 触发场景：当用户要求分析数据、生成图表、做数据可视化，或提供表格文件希望出图时，由 Agent 加载本 Skill 执行（与 SkillHub 英文说明中的 Use when… 一致）。
说明：预抓取资料中 @indiv-lailalli/smart-charts 的简介指向浏览器自动化，与上述图表 Skill 不符；写作以 user_5b28ea14 详情页为准。
安装与启用¶
安装流程遵循 SkillHub 官方文档 skillhub.cn/install/skillhub.md。要点是：使用 skillhub CLI，并用 --dir 指向当前 Agent 的 skills 目录，否则默认装在 ./skills/ 可能不会被识别。
1、检查或安装 SkillHub CLI
command -v skillhub && skillhub --version
若未安装，可按文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 smart-charts 到当前 Agent
以 Cursor 为例，skills 目录为 ~/.cursor/skills/（其他客户端路径见同一安装文档第四节）：
skillhub install @user_5b28ea14/smart-charts --dir ~/.cursor/skills/
也可在对话中让 Agent 按官方提示安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5b28ea14/smart-charts`。
3、启用后
安装完成后按你所用客户端要求重启或重新加载 Agent；具体子命令、环境依赖（如 Python 与 requirements.txt）以 Skill 包内 SKILL.md 与 scripts/ 说明为准。首次使用建议先让 Agent 执行文档中的环境自检步骤（若 Skill 提供 --doctor 一类命令）。
Codex CLI、Claude Code 等仅路径不同：将 --dir 换为 ~/.codex/skills/、~/.claude/skills/ 等，安装坐标仍为 @user_5b28ea14/smart-charts。
典型用法¶
对话式（与 SkillHub 页面「两步生成」一致）
- 将数据文件（如
sales.csv、report.xlsx）放在 Agent 可访问的工作区。 - 在对话中说明意图，例如：「分析这份销售表，生成合适的对比图」或「用这份 JSON 做趋势可视化」。
- Agent 加载 smart-charts 后解析数据、选择图表类型与主题，生成交互式 HTML；需要时按页面说明保存为图片。
CLI 辅助（安装 Skill 后）
Skill 本体通常包含 scripts/cli.py 等入口，用于解析、转换与渲染。典型调用形态为对数据文件指定图表类型与轴字段；复杂清洗往往通过 Skill 文档中的 transform 参数由 Agent 生成 pandas 代码并在沙箱中执行。具体 flags、错误码与多图批量配置请直接查阅安装目录下的 SKILL.md 与 references/，避免与 v8.4.0 行为不一致。
适用场景与注意¶
适合
- 已有 CSV / Excel / JSON，希望在 Agent 会话里快速得到可分享的 ECharts 页面。
- 需要较多图表类型与主题预设，又不想每次手写 ECharts option。
- 团队统一通过 SkillHub 分发同一套「读表 → 出图」规范。
注意
- 大文件、嵌套过深的 JSON、非表格媒体等，Skill 可能有明确不支持项；应以
SKILL.md中的能力边界为准，不要假设能直连数据库或实时流。 - 脏表头、多 sheet、列名含中文或特殊字符时，通常需要 Agent 按 Skill 约定做列名规范化或 transform，不要跳过 Skill 工作流自行写替代脚本（若 Skill 文档要求 MUST 使用 CLI）。
- SkillHub 上存在同名或相似坐标时，安装与引用时请确认
@user_5b28ea14/smart-charts与版本 v8.4.0，避免装错包。
结尾¶
smart-charts 把「表格数据 → 交互式 ECharts HTML（可存图）」封装成 Agent Skill，适合在已有 LLM 编程环境里做轻量分析与可视化交付。安装与更新以 SkillHub 文档为准，详情与作者信息见官方页面：
