前言¶

运营月报、销售复盘、财务汇总里，大量时间花在「选什么图、怎么画」上。常见做法是手写 pandas + matplotlib 脚本，或在 BI 工具里拖拽字段。若数据只是一张表、需求只是一句话，这套流程往往偏重。

下面介绍 SkillHub 社区 Skill Smart Dashboard（坐标 @user_26bdbd50/smart-dashboard）。它把「解析表格 → 推荐图表类型 → 导出 PNG」收成一条可脚本化的流水线，并可在 Cursor 等支持 Skills 的 Agent 里按 SKILL.md 指引调用。

这是什么¶

Smart Dashboard（包内全名 Smart Dashboard Generator）定位为：上传 CSV/Excel，用自然语言描述需求，由 AI 推荐图表并渲染为 PNG。

• 维护方：社区发布者 user_26bdbd50，来源为 community。
• 分类：SkillHub 类目 data-analysis；页面标签含 requires_api_key=true（AI 推荐需自备 API Key）。
• 版本：1.0.0（以 SkillHub 页面与安装包为准）。
• 商店数据（SkillHub 抓取，2026-10-22）：评分 100000，下载 758，安装 0。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_26bdbd50/smart-dashboard
• API 坐标页：https://api.skillhub.cn/user_26bdbd50/smart-dashboard

核心功能¶

以下能力来自包内 SKILL.md、SKILLHUB.md 与 scripts/ 实现，已核对一致部分。

数据与解析¶

1. 支持 CSV、Excel（.xlsx / .xls），用 pandas 解析字段类型。
2. 解析结果包含数据概览（行列数、列名、类型等）；SKILLHUB.md 中单独列出「数据概览」能力。
3. 包内说明：数据在本地处理，不上传服务器；工作目录与输出默认落在 /tmp/smart-dashboard（见 scripts/config.py）。

AI 图表推荐与渲染¶

1. 根据数据特征与用户自然语言需求推荐图表；单次请求可生成多个相关图表。
2. AI 侧支持用户自带 Key，文档写明可对接 OpenAI、Claude、智谱 GLM、MiniMax；CLI 通过 --provider 选择（openai / claude / zhipu / minimax）。
3. 图表用 Apache ECharts（pyecharts）渲染，输出 PNG。

支持的图表类型¶

用量与套餐（包内文档）¶

包内 SKILL.md / SKILLHUB.md 描述了 FREE / Standard / Pro / Enterprise 等档位及行数、价格；FREE 档共 10 次体验（非按月重置），默认单行数上限 500（FREE_USES_LIMIT、ROW_LIMITS 与文档一致）。付费档位可通过 billing.py 对接 https://api.yk-global.com/v1/verify 校验 SKILL_TOKEN 或 Authorization: Bearer 令牌（实现于包内，是否开通以 SkillHub 订阅说明为准）。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 官方安装文档检查 CLI：

command -v skillhub && skillhub --version

未安装时可执行（完整安装，含默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

说明与路径约定见：https://skillhub.cn/install/skillhub.md。

2. 安装 Smart Dashboard 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

skillhub install smart-dashboard --namespace user_26bdbd50 --dir <你的 skills 目录>

常见路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

SkillHub 页面亦提供给 Agent 的提示：请根据 https://skillhub.cn/install/skillhub.md 安装 @user_26bdbd50/smart-dashboard。

安装成功后，目录一般为：<skills 目录>/@user_26bdbd50/smart-dashboard/。

3. 安装 Python 依赖¶

在 Skill 包根目录执行：

cd <skills 目录>/@user_26bdbd50/smart-dashboard
pip install -r requirements.txt

requirements.txt 声明：pandas>=2.0.0、pyecharts>=2.0.0、requests>=2.28.0、openpyxl>=3.1.0。

4. API Key 与启用¶

• AI 推荐步骤需要 --api-key（recommend 子命令为必填；generate 在未提供 Key 时会走包内 fallback 推荐逻辑）。
• 可将 Key 通过命令行传入，勿写入仓库；环境变量 SKILL_TOKEN 用于订阅档位校验（见 billing.py）。

在 Cursor 中安装并重启/刷新 Agent 后，对话里引用该 Skill，Agent 应读取包内 SKILL.md 并按用户上传的数据文件与自然语言需求执行上述 CLI 或等价步骤。

典型用法¶

包内 SKILLHUB.md 给出的 CLI 示例如下。入口文件位于 scripts/main.py；在 Skill 根目录建议用模块方式调用（与包结构一致）：

cd <skills 目录>/@user_26bdbd50/smart-dashboard

# 仅解析文件，输出 JSON 概览
python -m scripts.main parse data.csv

# AI 推荐图表类型
python -m scripts.main recommend data.csv \
  --request "显示每月销售额趋势" \
  --api-key YOUR_KEY \
  --provider openai

# 解析 + 推荐 + 渲染 PNG（完整流水线）
python -m scripts.main generate data.csv \
  --request "显示每月销售额趋势" \
  --api-key YOUR_KEY \
  --provider openai

SKILL.md 中的端到端示例（表格数据 + 用户需求）：

输入数据（节选）

用户请求

显示每月销售额趋势

文档中的推荐结果示例：折线图与柱状图组合（具体以运行输出 JSON 为准）。

其他子命令（包内实现）：

• render：根据 --config 指定的图表 JSON 渲染 PNG。
• generate 支持 --tier FREE|STANDARD|PRO|ENTERPRISE 控制行数上限，--output-dir 指定 PNG 输出目录（默认 /tmp/smart-dashboard/output）。

适用场景与注意¶

更适合

• 手头是单表 CSV/Excel，需要快速出报告用 PNG，且愿意用一句话描述图表意图。
• 已在用 Cursor / Claude Code / Codex 等 Agent，希望把「解析 + 推荐 + 出图」固定成 Skill 工作流。
• 能接受自备大模型 API Key，并遵守包内 FREE 档 10 次、500 行等限制做试用。

限制与注意

1. API Key：SkillHub 标签 requires_api_key=true；无 Key 时 generate 仍可能运行，但推荐质量依赖 fallback，与完整 AI 推荐不同。
2. 文件大小：文档建议数据文件小于 10MB。
3. 免费次数：FREE 档 10 次为总量，解析/推荐/渲染等 CLI 路径会经 UsageTracker 扣减（见 scripts/main.py）。
4. 依赖环境：需 Python 与上述 pip 依赖；输出与中间文件默认在 /tmp/smart-dashboard，注意磁盘与权限。
5. 商店安装数：抓取显示安装 0，可能与统计口径或刚发布有关；以你本机 skillhub install 结果为准。

结尾¶

Smart Dashboard 把表格可视化收成「自然语言需求 + 本地解析 + AI 推荐 + ECharts PNG 导出」，适合作为 Agent 的数据分析类 Skill 使用。安装走 SkillHub 标准流程，能力边界与命令以包内 SKILL.md 为准。

• SkillHub：https://www.skillhub.cn/skills/user_26bdbd50/smart-dashboard
• 坐标：@user_26bdbd50/smart-dashboard v1.0.0