MIT 開源的 DSH 外掛，把經過 `llm/stream` 的呼叫記成本機計費帳本，提供依平台 / 模型明細、峰谷價、人工匯入價格、官方帳單對齊與 HTML / PDF / CSV 匯出。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-13
授權條款
MIT
01它能幫你完成什麼？
看清 DeepSeek Harness 的模型呼叫到底花了多少錢，依平台、依模型
側邊欄面板裡的呼叫次數、失敗與中止次數、輸入 / 輸出 / 快取命中 token 與花費，並可從某一天下鑽到小時桶
在 DSH 裡同時跑多個 provider 或中轉平台、需要知道錢花在哪的開發者
把本機帳本和平臺帳單對上
依平台 / 日期把官方金額（可選再抄呼叫次數與 token）與外掛當天記錄逐項比對，並顯示差額
結帳前需要解釋或核對平臺帳單的人
把花費報表交給沒有跑 DSH 的人
依平台 / 模型分組、帶時間明細的自包含 HTML 報表或 PDF 文件，或給試算表用的 CSV
需要一份檔案而不是即時面板的團隊主管、財務與客戶
02如何將外掛接入 DeepSeek Harness？
先決條件
- DSH Web UI 版本在 `>=0.2.1-rc.5 <0.3.0`，Node.js `>=20` —— README 已在 Windows 11 + DSH `0.2.1-rc.5`、`0.2.2-rc.1` 實機驗證
- 一個你能改 package.json 的 DSH profile（README 用 `link:` 形式登記相依套件）
- `pdfkit` 已列在 dependencies、安裝時自動裝；`@deepseek-ai/schemastery` 是選用 peer
安裝步驟
- 01
把外掛目錄放進你的工作區
- 02
在 profile 的 package.json 裡把它登記為相依套件 —— `link:` 形式即可
- 03
重新啟動應用程式，側邊欄出現「計費統計」入口
- 04
從 1.12.x 升級：先在 Plugin Manager 解除安裝舊 bundle（舊名 `dsh-billing-insights`，更早是 `llm-usage-insights`），避免兩個 bundle 同時註冊同一個側邊欄頁面
驗證整合成功
- 重新啟動後側邊欄出現計費統計入口，頁面依平台 / 模型列出呼叫記錄
復原
- README 沒有提供解除安裝指令：它只說明解除安裝不會刪除帳本，想清掉資料需要手動刪除 `$DSH_HOME/llm-usage-insights/` 目錄
03DSH 整合程度與能力邊界
DSH 外掛 bundle：在工作區放好目錄、在 profile 的 package.json 以 `link:` 登記為相依套件後重新啟動，側邊欄出現「計費統計」入口，頁面讀取 DSH `llm/stream` 的使用記錄
依平台 / 模型的用量明細
DSH `llm/stream` 記錄下來的呼叫→每個平台與模型的呼叫、失敗與中止次數、輸入 / 輸出 / 快取命中 token 與花費，每天下面還有小時桶
把計數、token 與價格來源附加寫入 `$DSH_HOME/llm-usage-insights/` 的 `usage.json`峰谷價與階梯計價
token 數量加一張價格表→依峰時視窗（預設 UTC+8，可用 `utcOffsetHours` 調整）與階梯價算出的花費，金額記到 6 位小數
每一列都標出價格來源，估算價不會被顯示成官方價人工匯入價格（表格或 CSV 範本）
在平台列彈窗裡填的單價，或填好的 CSV 範本→持久保存的人工價，可帶 `09:00-12:00, 14:00-18:00` 這類峰時視窗，依每天 / 工作日 / 週末生效
人工價不會被後續目錄重新整理覆蓋DeepSeek 官方價要明確儲存後才會變成人工覆蓋官方帳單對齊
從平臺後台依平台與日期抄來的金額（可選再帶呼叫次數與 token）→與外掛當天記錄逐項比對並顯示差額
外掛不登入也不抓取平臺後台 —— 數字由你自己貼上報表匯出（HTML / PDF / CSV）
選好的統計範圍與是否包含時間明細→自包含 HTML 報表、PDF 文件或 CSV
PDF 匯出依賴 `pdfkit` 與本機中文字型，缺字型時直接報錯而不是產生亂碼報表
04適合誰？何時不該用？
適合
- 在 DSH 裡同時跑多個 provider 或中轉平台、需要知道錢花在哪的開發者
- 結帳前需要解釋或核對平臺帳單的人
- 需要一份檔案而不是即時面板的團隊主管、財務與客戶
不適合
- 只記錄經過 DSH `llm/stream` 的呼叫——DSH 沒在跑時發出的請求、直連 API、其他用戶端的請求都不在帳本裡，所以數字是依 DSH 範圍統計，而不是依帳號。
- 金額是依 models.dev、DeepSeek 官方價或你匯入的人工價估算出來的；結算以官方帳單為準，帳單對齊只是把官方數字和本機觀測放在一起。
- 資料只在本機 `$DSH_HOME/llm-usage-insights/` 底下，沒有雲端同步或多機合併；依小時明細 30 天後被裁剪（`retainDays` 可調），月度彙總長期保留，解除安裝不會刪除這個目錄。
05相容性、維護與安全提醒
- 只記錄經過 DSH `llm/stream` 的呼叫——DSH 沒在跑時發出的請求、直連 API、其他用戶端的請求都不在帳本裡，所以數字是依 DSH 範圍統計，而不是依帳號。
- 金額是依 models.dev、DeepSeek 官方價或你匯入的人工價估算出來的；結算以官方帳單為準，帳單對齊只是把官方數字和本機觀測放在一起。
- 資料只在本機 `$DSH_HOME/llm-usage-insights/` 底下，沒有雲端同步或多機合併；依小時明細 30 天後被裁剪（`retainDays` 可調），月度彙總長期保留，解除安裝不會刪除這個目錄。
- 面向 `>=0.2.1-rc.5 <0.3.0` 的 DSH Web UI 與 Node.js `>=20`；頁面路由只接受同源 / 迴路位址存取，PDF 匯出在沒有中文字型時會直接失敗。
MIT · 僅 README 證據，最新版本 v1.14.0，未做安全稽核
06常見問題
在 DeepSeek Harness 裡怎麼安裝這個外掛？
把目錄放進工作區，在 profile 的 package.json 裡以 `link:` 形式登記為相依套件，然後重新啟動應用程式，側邊欄就會出現計費統計入口。README 面向 `>=0.2.1-rc.5 <0.3.0` 的 DSH Web UI 與 Node.js `>=20`。從 1.12.x 升級時先解除安裝舊的 `dsh-billing-insights` bundle，避免兩個 bundle 註冊同一個側邊欄頁面。
它會往 DSH 工作區寫什麼，會保存我的提示詞嗎？
寫在 `$DSH_HOME/llm-usage-insights/` 底下：`usage.json` 只有計數、token 與價格來源，`manual-prices.json` 只存你匯入的價格表，models.dev 目錄快取在旁邊。README 明確不保存任何 prompt / 回覆內容。沒有雲端同步，解除安裝也不會刪除這個目錄。
它會攔截或限制 DeepSeek Harness 的呼叫嗎？
不會。它不接管模型請求，只記錄已經經過 DSH `llm/stream` 的呼叫；也沒有日 / 月預算、超額阻擋、餘額查詢或自動加值，只做統計和顯示。
models.dev 裡沒有的平台怎麼定價？
價格比對順序是自訂 `pricing` → 人工匯入價格 → DeepSeek 官方自動價（僅官方 API）→ models.dev 目錄 → 內建參考價，頁面上會標出用的是哪一種。依呼叫次數收費的中轉站可以在彈窗裡勾選單純按次計費，此時 token 單價與峰時價都不參與計算；`chargeFailedCalls` 決定失敗 / 中斷的請求是否也收一次費。
PDF 匯出為什麼失敗？
PDF 匯出依賴 `pdfkit` 與本機中文字型，找不到可用字型時會直接報錯，而不會默默產生亂碼報表。可以改用自包含 HTML 報表，或在機器上裝好中文字型。
07相關的 DSH 工作流程
weknora
作者 tencent
开源的 LLM 知识库平台：把原始文档转化为可检索的 RAG 知识库、自主推理智能体和自动维护的 Wiki 系统，支持多租户部署。
honcho
作者 plastic-labs
用于构建有状态 AI 智能体的记忆库，支持跨会话连续学习与上下文工程。
webnovel-writer
作者 lingfengqaq
基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作。
reme
作者 agentscope-ai
ReMe：面向 AI Agent 的记忆管理套件——帮 Agent「记住我、优化我」，支持 RAG 与长期记忆。
08資料與來源
`dsh-billing-statistics` 是 DSH 的本地计费账本：把经过 `llm/stream` 的模型调用按平台、模型和小时记下来，用价格表估算花费，并提供报表与官方账单对照。它不接管模型请求，也不替你登录任何平台。
- 按 **平台 / 模型** 汇总调用次数、失败与中止次数、输入 / 输出 / 缓存命中 token、花费。
# 1. 把本目录放到工作区 # 2. 在 profile 的 package.json 里登记为依赖（link: 形式即可） # 3. 重启应用，在侧栏看到「计费统计」入口
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-11-13。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。