前言¶
對使用 DeepSeek Harness（DSH）的開發者來說，本地會話已經產生了 Token、請求、Agent 活動、工具調用和性能數據，但這些信息分散在會話事件中，不容易直接覈對。
dsh-usage-insights 解決的是這個具體問題：它不新增模型調用，不顯示金額，只讀取 DSH 已有的本地會話語料，並在 DSH Web 的“設置 > 工作活動”中提供可篩選、可覈對、可導出的用量面板。
這是什麼¶
dsh-usage-insights 是 fazhu4 維護的 DeepSeek Harness 本地只讀用量面板，當前版本爲 0.2.0，許可證爲 MIT。
它從 DSH 會話事件中統計 Token、請求、Agent 活動、工具調用和性能，並在“設置 > 工作活動”中提供卡片、趨勢和分頁明細。當前版本爲 alpha。
核心功能¶
下面按面板能力說明。
時間範圍與篩選¶
- 按已驗證的 IANA 時區自然日查看
today、7d、30d或all數據。 - 可同時按工作區、服務商和模型篩選。
- 工具維度不接受服務商或模型篩選；該組合會返回
HTTP 400。
Token 與請求¶
- 分開展示未緩存輸入、緩存讀取、緩存寫入、輸出和輸出中的推理 Token。
- 展示已計量請求、活躍工作區、活躍會話、Agent Usage、模型耗時、工具耗時、TTFT 覆蓋率和緩存複用率。
趨勢與明細¶
- 日趨勢可在 Token 與請求數之間切換。
- 服務商和模型明細區分 Agent 與 Compaction 請求來源。
- 提供工作區、服務商、模型、會話和工具五種分頁明細，可搜索和排序。
性能與導出¶
- 統計平均首 Token 時間、輸出速度、模型耗時、工具耗時、工具失敗日趨勢和輪次結果。
- 導出與當前篩選及分析維度一致的 UTF-8 CSV。
- 會話行通過 DSH 客戶端會話服務打開，不構造私有 URL。
界面與 API¶
- 中英文界面、鍵盤可操作標籤頁、可聚焦的圖表日桶和窄屏佈局。
- 提供
summary、breakdown、filters、export.csv、retry等 HTTP API。
安裝與啓用¶
v0.2.0 從 dsh-activity-report 更名。如果舊 profile 已安裝 dsh-activity-report，先移除舊包：
dsh plugin --profile web remove dsh-activity-report
然後安裝當前版本：
dsh plugin --profile web add dsh-usage-insights@0.2.0
經過上面的步驟後，重啓 dsh web，再打開“設置 > 工作活動”。
典型用法¶
下面按文檔給出的可復現步驟說明。
- 安裝
dsh-usage-insights@0.2.0。 - 重啓
dsh web。 - 打開“設置 > 工作活動”。
- 使用
range=today|7d|30d|all選擇時間範圍。 - 如需篩選，使用可重複的
workspace、provider、model參數。 - 查看工作區、服務商、模型、會話和工具明細，或導出 UTF-8 CSV。
- 如果查詢工具維度，不要同時傳服務商或模型參數；該組合會返回
HTTP 400。
配置¶
cordis.patch.yml 暴露以下部署參數：
| 字段 | 默認值 | 說明 |
|---|---|---|
persistDebounceMs |
1000 |
即時事件合併寫入的等待毫秒數 |
backfillConcurrency |
4 |
歷史會話回填併發數 |
defaultPageSize |
25 |
明細默認頁大小 |
timezone |
系統 IANA 時區 | 自然日分桶時區 |
本地存儲與隱私¶
- 插件只讀取 DSH 已有的本地會話語料。
- 插件通過 DSH
storageDomain的usage_insightsdomain 固化每會話聚合記錄。 - 插件不顯示金額，不調用模型或服務商接口，也不修改、歸檔或刪除會話。
- 界面和導出不包含提示詞、回覆正文、工具參數或工具輸出。
- 當源會話從 DSH 邏輯語料中移除時，插件只清理自己對應的派生聚合記錄，不修改或刪除 DSH 會話數據。
開發與驗證¶
開發驗證需要 Node.js ^22.19.0 或 >=24.0.0 與 pnpm。
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run verify:package
適用場景與注意¶
適合需要在本地核對 DSH 會話用量、請求、Agent 活動、工具調用和性能信息的開發者或運維人員。
注意：
- 當前版本爲 alpha。
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼、依賴和許可證。 - 插件不顯示金額，不調用模型或服務商接口，也不修改會話。
- 工具維度不接受服務商或模型篩選，該組合會返回
HTTP 400。
結尾¶
dsh-usage-insights 的價值，是把 DSH 本地會話中已有的用量、請求、Agent 活動和工具調用信息組織成可覈對、可篩選、可導出的只讀面板。
- 目錄頁：https://www.skillhub.cn/plugins/fazhu4/dsh-usage-insights
- GitHub：https://github.com/fazhu4/dsh-usage-insights
