DeepSeek Harness (DSH) 插件生態強調模塊化與功能解耦。在開發調試或用量分析時，開發者往往需要跨會話的模型調用統計（如 Token 分佈、模型使用偏好），而現有的計價插件僅關注資金流向。dsh-plugin-session-insights 專注於活動統計，通過 Host 側的邊車文件記錄每次模型調用，並提供可視化的命令行查詢與 CSV 導出。
核心功能¶
該插件在 Host 側運行，將每次模型調用（無論是否計價）追加到按月存儲的 JSONL 邊車文件中。
- 概覽命令：
/insights- 顯示會話總數與 Token 總量。
- 展示近 N 天的每日趨勢（ASCII 條形圖）。
- 列出最貴會話 Top 榜。
- 展示模型分佈情況。
- 導出命令：
/insights-export <YYYY-MM>- 將指定月份的數據導出爲 BOM+CRLF 格式的 CSV，確保 Excel 可直接打開。
- 與計價插件的分工
- 本插件管活動：統計所有模型調用的 Token、輪次及模型分佈，未計價事件也會被記錄。
- 與
dsh-plugin-cost-ledger不同，後者專注於錢，未計價事件會被直接丟棄。
安裝與啓用¶
安裝過程需要三步，確保 pnpm 已在 PATH 中。
- 安裝插件包
dsh plugin --profile web add github:121212165/dsh-plugin-session-insights
該命令會通過 pnpm 獲取包並自動運行構建。
-
修改配置文件
將本倉庫根目錄的cordis.patch.yml內容合併進$DSH_HOME/profiles/web/cordis.patch.yml。
該文件默認爲空數組[]。請將內容並進同一個數組，不要直接追加。追加會導致 YAML 解析錯誤，報錯信息爲end of the stream or a document separator is expected。 -
重啓與驗證
配置層與客戶端都需要重啓才能生效（瀏覽器硬刷新無效）。
重啓後，通過以下命令驗證掛載狀態：
dsh --profile web --dump-config | grep dsh-plugin-session-insights
數據模型與用法¶
插件在 Host 側維護按月的 JSONL 邊車文件，路徑默認爲 ~/.dsh/session-insights/insights-YYYY-MM.jsonl。每行記錄包含會話 ID、時間戳、模型 ID、Provider、輪次、Token 桶統計（輸入、緩存讀取、輸出、緩存寫入）以及計費信息（若有）。
示例數據結構：
{"v":1,"sessionId":"…","at":"2026-09-15T02:00:00.000Z","day":"2026-09-15",
"modelId":"deepseek-v4-pro","provider":"deepseek","turn":3,
"buckets":{"uncachedInput":100,"cacheRead":900,"output":50,"cacheWrite":0},
"costMicros":1200000,"currency":"CNY"}
適用場景與注意¶
- 適用場景：需要分析模型使用習慣、追蹤長期 Token 消耗趨勢、以及導出結構化數據進行二次分析的開發者。
- 運行機制：Host 側運行，無 Web UI 界面，所有交互通過命令行完成。
- 邊界限制：
- 本插件無歷史回填能力，只能統計安裝後的會話數據。
- 若邊車文件出現崩潰導致的半行數據，插件會跳過該行並計數，不會改寫文件。
- 暫不支持運行中的 live mount。
總結¶
dsh-plugin-session-insights 是一個輕量級的跨會話分析工具。它填補了 DSH 生態中活動統計與計價統計之間的空白，適合需要精細化控制與分析模型調用流量的開發者。更多插件與目錄可參考 GitHub 與 SkillHub 插件目錄。
