前言¶

做數據分析時，常見路徑是：先把表格導出，再打開 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 定位一致（讀取用戶提供的表格類文件並生成可視化）：

1. 多格式數據輸入：支持 CSV、Excel、JSON 等常見表格/半結構化文件（具體解析規則以安裝後的 SKILL.md 爲準）。
2. 圖表類型與主題：32 種圖表類型，3 套主題，用於不同展示場景。
3. 交互式 HTML 交付：生成可在瀏覽器中交互查看的 ECharts 頁面，而非靜態截圖。
4. 導出圖片：在生成結果上可將圖表保存爲圖片，便於插入文檔或彙報。
5. 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 頁面「兩步生成」一致）

1. 將數據文件（如 sales.csv、report.xlsx）放在 Agent 可訪問的工作區。
2. 在對話中說明意圖，例如：「分析這份銷售表，生成合適的對比圖」或「用這份 JSON 做趨勢可視化」。
3. 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 文檔爲準，詳情與作者信息見官方頁面：

• API / 資源入口：https://api.skillhub.cn/user_5b28ea14/smart-charts
• Skill 頁：https://www.skillhub.cn/skills/user_5b28ea14/smart-charts