前言¶

在 DeepSeek Harness（DSH）裏跑智能體時，模型調用會不斷發生，但 harness 本身並不長期保存「每次用了多少 token、按官方價應花多少錢」。要去官方控制台對賬，又要面對峯谷時段、緩存命中分項等規則，和本地會話裏看到的調用並不總是一一對應。

下面介紹社區插件 dsh-token-plugin（README 中亦稱 dsh-usage-plugin）：在每次經 harness 轉發的調用上記錄 token 與緩存命中，並按 DeepSeek 公開價（含峯谷）估算費用，在 Web UI 裏集中查看、篩選與導出。該倉庫由 realhenrylan 維護，fork 自 feiyang-dev/dsh-usage-plugin，以 MIT 許可證發佈；npm 包名爲 dsh-token-plugin，當前資料中版本爲 2.1.0，要求 Node.js ≥ 18。在 SkillHub 上歸類爲 admin-security（社區目錄站點，與 DeepSeek / 幻方無官方從屬關係）。

這是什麼¶

一句話：DSH 生態裏的 Host + Client 一體用量與消耗統計插件——host 側（lib/index.js）負責記錄、計費與導出，client 側（lib/client.js）提供瀏覽器面板，經 /usage/api 與 host 通信。安裝並在 DSH 中啓用後，Web UI 頂部在「對話」「軌跡」之後會出現 「用量與消耗」 標籤頁。

核心功能¶

以下能力均來自項目 README 與 package.json 說明，按面板模塊歸納。

用量與消耗概覽¶

記錄每次調用的 token 分項（輸入未命中、緩存命中、緩存寫入、輸出、推理、結束原因等），並按 DeepSeek 峯谷/基礎價計算費用：工作日高峯按北京時間 9:00–12:00、14:00–18:00；自 2026-08-23 起週末全天按空閒價；自 2026-09-10 12:00（北京時間）起適用 V4.1 Flash 調價後的峯谷表（例如 deepseek-flash 空閒價緩存命中 0.02 / 輸入 1 / 輸出 4 元，高峯爲兩倍）。模型名取自請求參數；無官方價的模型按 0 計消耗。

概覽提供按模型表、按 API 服務商 × 模型明細，以及日期篩選（今天 / 近 7 天 / 近 30 天 / 全部與自定義區間）。

用量日曆與調用明細¶

按月熱力圖（按費用或調用數着色），可點選某日查看明細與高峯/空閒拆分；明細列表最新在前，支持快捷與自定義日期篩選，分頁每頁 100 條。

價格表與計費通道¶

面板內展示並編輯 DeepSeek 官方價表，持久化到數據目錄下的 pricing.json，可恢復默認。支持爲訂閱制 Coding Plan 登記計費通道（內置 OpenCode Go、Command Code GOAT 等默認條目），新調用按 Provider ID 精確匹配自動標註。

導出、導入與持久化¶

支持 CSV、JSON、PNG 長圖導出（默認按最新在前，最多約 2000 條並有超出提示），可選目錄並在導出後打開所在文件夾；JSON/CSV 可合併導入並按時間去重。

自 v1.9.2 起，記錄寫在固定專用數據目錄（如 Windows %LOCALAPPDATA%\dsh-usage-plugin\dsh-usage\usage-records.json），可通過環境變量 DSH_USAGE_DATA_DIR 覆蓋；上限約 100000 條。面板會說明本地統計與官方後臺可能存在的差異（中斷調用、其他 API Key 的調用等）。

平臺與界面¶

支持 Windows / macOS / Linux；界面語言跟隨 DSH「通用設置 → 語言」。內部/佔位調用（如 dsh2shell-*、fake 模型）單獨歸在「工具調用（內部）」分組，不計入模型消耗明細。

安裝與啓用¶

官方 README 給出的常用方式如下。安裝後需重啓 DSH 服務。

從 GitHub 倉庫安裝：

dsh plugin --profile web add github:realhenrylan/dsh-token-plugin

從 npm 安裝已發佈包：

dsh plugin --profile web add dsh-token-plugin

也可在本地對倉庫執行 npm pack 後安裝生成的 dsh-token-plugin-<版本>.tgz（文件名以 npm pack 輸出爲準）。桌面端若提供推薦列表，由對應維護方單獨管理，與上述命令等價目標均爲把 bundle 裝入 profile。

卸載示例：

dsh plugin --profile web remove dsh-token-plugin

若 dsh plugin 提示缺少 pnpm，可先執行 npm install -g pnpm；連不上 npm 官方源時可配置鏡像後再安裝（README 故障排查一節有說明）。

典型用法¶

1. 按上一節命令爲 web profile 安裝插件並重啓 DSH。
2. 在瀏覽器打開 DSH Web UI，進入 「用量與消耗」 標籤。
3. 正常進行對話與模型調用；面板會實時累積記錄。
4. 在概覽或日曆中按日期篩選，查看按模型、高峯/空閒拆分的費用。
5. 需要留檔時，在面板中選擇 CSV、JSON 或 PNG 導出到本機目錄；需要合併歷史文件時使用導入功能。

價格或與官方賬單不一致時，可先閱讀面板頂部關於「本地捕獲」與官方後臺差異的說明，再按需導出官方月度賬單 CSV 對比。

適用場景與注意¶

適合誰： 長期在 DSH 裏調試智能體、希望在本機掌握 token 與預估費用、並要做峯谷口徑彙總或導出的開發者。

權限與安全： 插件以當前 DSH 進程權限運行，會讀寫本機數據目錄、可能調用系統目錄選擇與「在文件管理器中顯示」等能力。安裝前應自行審閱 GitHub 倉庫 源碼與 MIT 許可證；社區目錄頁的 admin-security 分類僅作歸類參考，不替代你自己的安全評估。

生態背景： DSH 採用「一切皆插件」的擴展方式；SkillHub 是獨立的社區插件目錄，並非官方應用商店。

結尾¶

dsh-token-plugin 把「每次調用的 token / 緩存命中 / 峯谷費用」收斂到 harness 自帶 UI，並支持導出與持久化，適合作爲本地用量臺賬。更多信息見社區目錄 realhenrylan/dsh-token-plugin 與源碼倉庫 github.com/realhenrylan/dsh-token-plugin。