在 DSH 生態中，插件承擔了擴展功能的作用。當 Agent 處理完數據後，直接在對話上下文中生成可視化圖表，比複製數據到外部工具更高效。dsh-chartlab 便是爲此設計，它允許用戶將本地數據文件或 DuckDB 數據庫中的數據轉化爲可交互的圖表。
核心功能¶
該插件支持以下已覈實的能力：
- 數據源支持：本地數據文件（
.csv、.xlsx、.xls）或 DuckDB 數據庫（.duckdb、.ddb）。 - 圖表類型：折線圖、散點圖。
- 交互操作：框選縮放、滾輪縮放、拖拽平移、懸浮讀數、截圖下載。
- 數據篩選：支持條件篩選（等於、不等於、區間、多選），並支持日期範圍篩選。
- 數據分組：按某一列分組，不同取值對應不同的折線。
- SQL 查詢：支持在圖表中直接編寫 SQL 語句進行查詢。
- 主題與語言：圖表會自動跟隨 DSH 的語言設置（中/英）與主題設置（深/淺）。
- 會話隔離：每個對話擁有獨立的圖表緩存，刪除會話會自動清理緩存。
安裝與啓用¶
在啓用插件前，請檢查源碼與許可證（MIT）。安裝命令如下：
dsh plugin --profile web add dsh-chartlab
典型用法¶
安裝完成後，在對話中直接輸入指令即可生成圖表。
- 使用 CSV 文件：
用 dsh-chartlab 插件繪製 `/path/to/your-data.csv` 的圖表
- 使用 Excel 文件：
用 dsh-chartlab 插件繪製 `/path/to/your-data.xlsx` 的圖表
- 使用 DuckDB 數據庫：
用 dsh-chartlab 插件繪製 `/path/to/your-data.duckdb` 中 `sales` 表的圖表
*注：DuckDB 表名可省略，插件會自動讀取第一張表。*
注意事項¶
目前存在以下已知限制，屬於計劃中的優化項：
- Excel 性能：Excel 文件目前採用全量同步加載，大文件時性能有待優化（Roadmap 計劃支持流式讀取）。
- Excel 工作表：目前僅讀取第一個工作表（Roadmap 計劃支持多工作表）。
總結¶
dsh-chartlab 專注於解決 Agent 產出數據的可視化問題，通過支持 SQL、分組和篩選，提供了靈活的數據分析工作臺。它符合 DSH “一切皆插件” 的生態理念，適合需要在對話流中快速查看數據分佈的開發者和數據分析人員。
