前言¶
在 DSH（DeepSeek Harness）生態裏，插件化是常見做法：把工具、技能和文檔拆成可安裝的 bundle。數據類任務中，常見痛點不是“能不能讓模型看數據”，而是如何把 CSV、粘貼表格、SQL 查詢結果或 DuckDB 數據穩定地整理成可複用的報告。
duyanta123/dsh-data-insight 提供的是一個數據洞察技能插件：把原始數據變成「業務結論 + 指標數據 + 圖表」的結構化 Markdown 分析報告。
DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；這裏介紹的是插件本身的能力與使用邊界。
這是什麼¶
- 插件名：
duyanta123/dsh-data-insight - 維護者：
duyanta123 - 類型：DSH 數據洞察技能插件
- 許可證：MIT
- 實現方式：純指令型技能插件，零依賴、零構建；計算由宿主已提供的文件 / Shell 工具驅動的 LLM 完成。
核心功能¶
數據源¶
支持四種數據源：
- CSV 文件
- 粘貼表格文本
- SQL 查詢結果
- DuckDB 直連數據庫（可選）
五階段流水線¶
執行流程爲：
輸入受理 → 數據探查 → 指標計算 → 圖表呈現 → 報告產出
指標與圖表¶
指標能力包括：
- 彙總統計
- 同環比（基準期規則寫死）
- TopN
- 異常值（Z-score / IQR）
圖表呈現有三通道：
- Markdown 表格 + 數字
- Mermaid
- ASCII 條形圖
安裝與啓用¶
在目標 profile 中執行：
dsh plugin --profile web add dsh-data-insight
重啓 profile 後，data-insight-runbook 出現在技能列表即可用。
該插件聲明瞭可選 peerDependency：
@deepseek-ai/dsh-skill-filesystem
安裝前應檢查源碼與 MIT 許可證。插件會以當前 dsh 進程權限運行，涉及本地文件、Shell 工具或 DuckDB 時，需要確認這些工具與數據源在預期權限範圍內。
典型用法¶
會話觸發¶
在會話中可以說：
- 「分析這份 CSV 出報告」
- 「看看這個數據」
- 「幫我算一下指標」
同時附上數據源：文件路徑、粘貼表格或 DuckDB 連接。模型會加載 data-insight-runbook，並按五階段執行。
先做 CSV 探查¶
如果要先檢查樣例數據，可以運行：
node scripts/csv-profile.mjs examples/sample-sales.csv
這一步會輸出 examples/sample-sales.csv 的探查報告，內容覆蓋 schema、缺失、分佈、異常。
DuckDB 可選直連¶
DuckDB 直連爲可選能力。如需使用，先安裝 DuckDB 單文件 CLI，並加入 PATH。
無庫文件查詢（CSV/Parquet）示例：
duckdb -csv -c "SELECT * FROM read_csv_auto('data.csv') LIMIT 100"
連接庫文件 / 遠程庫時，需要遵守以下紅線：
- 連接庫一律使用
-readonly，寫語句會被攔截 - 連接串走環境變量
DATA_INSIGHT_DB_URL - 查詢默認
LIMIT 5000 - 無庫文件查詢（CSV/Parquet）不要加
-readonly；-readonly僅用於庫文件 / 遠程庫
適用場景與注意¶
適合：需要在 DSH 會話中把原始數據整理成 Markdown 報告的場景，尤其是 CSV、粘貼表格、SQL 查詢結果或 DuckDB 數據。
注意：
- CSV 中文亂碼時，優先 UTF-8（帶 BOM 也能正確處理）；GBK 編碼文件先用
iconv -f GBK -t UTF-8轉碼再探查。 - Mermaid 圖在本地 Markdown 預覽不渲染時，可用 Typora 等本地渲染編輯器打開，或參考
docs/chart-spec.md換用 Markdown 表格 / ASCII 條形圖通道。 - DuckDB 爲可選依賴；不連接數據庫時，不需要安裝 DuckDB。
結尾¶
回顧一下：duyanta123/dsh-data-insight 把“原始數據到 Markdown 報告”的步驟收斂成 DSH 技能流程，輸入、探查、指標、圖表、報告都在同一會話中完成。
項目地址：GitHub。如果通過 DSH 社區目錄檢索，可搜索插件名 dsh-data-insight。
