前言¶

在 DeepSeek Harness（DSH）裏跑 dsh web 或桌面版時，模型調用會不斷產生 token 消耗。DeepSeek 控制檯能看官方賬單，但本地會話裏「這條消息花了多少」「本月累計多少」「峯谷時段是否該換模型」並不直觀。手工對照官方定價頁、自己記表格，既慢也容易漏。

dsh-web-billing 是社區維護者 bpc-oss 發佈的 DSH 組合包插件，面向 dsh web 場景，在瀏覽器端做逐條消息記賬、官方政策自動計價（含峯谷定價）、賬號餘額展示與費用匯總頁。SkillHub 目錄將其歸類爲 admin-security；GitHub 倉庫當前約 11 stars，許可證 MIT，最新版本 2.3.2。

需要事先明確：插件統計的是 DSH 本地捕獲的已完成 assistant/message 事件，不是 DeepSeek 賬號的官方用量賬單；跨 API key 覈對請以 DeepSeek 控制檯 Usage 導出爲準。

這是什麼¶

一句話定位：DeepSeek Harness Web 端的人民幣 / 美元 token 計費插件——按官方政策自動計價（內置政策時間表，含 2026-08-17 起的峯谷定價），逐條消息記賬，即時顯示賬號餘額，界面語言自動切換 ¥ / $ 展示。

插件以標準 DSH bundle 形式分發（dsh.bundle.patch 指向包內 cordis.patch.yml），運行 Node.js ≥20，依賴 @deepseek-ai/schemastery 與 @deepseek-ai/dsh-home-paths。

核心功能¶

官方政策自動計價（峯谷跟隨）¶

lib/pricing.js 內置 OFFICIAL_PRICING_POLICIES 價格時間表，每條政策有生效時刻（since）與單價表。已知政策節點包括：

計價語義要點：

1. 按消息時刻取價：每條消息按其完成時刻所屬的政策與峯谷時段計費；新政策生效後自動切換。
2. 政策鏈繼承：新政策未點名的模型沿用最近一次被點名的價格。
3. 改價自愈：政策表或配置變化後，重啓時按當前規則重估全部存量記錄。
4. 用戶覆蓋：prices 中模型精確條目覆蓋官方價；officialPricing: off 則完全使用用戶價格表。
5. 可擴展時間表：通過 policyOverrides 在配置裏追加政策，無需改代碼。

政策時間表策展自 DeepSeek API Docs 定價頁，發現偏差可向倉庫提交 PR。

Coding plan 計費¶

除 DeepSeek 官方 API 外，插件支持 DSH 內置的各類 coding plan（如 opencode-go、opencode、kimi-coding，以及 qwen / xiaomi / z.ai 的 token 訂閱包）。價格表在 lib/coding-plans.js，按 (provider, model) 路由計價：

• 平臺官方價：美元單價來自平臺發佈；人民幣展示價 = 美元價 × codingUsdCnyRate（默認 7.2，僅展示換算）。
• 訂閱 token 包：平臺不公佈逐 token 單價，調用按 0 元計。
• 升級 DSH 後，可運行 node scripts/sync-coding-plans.mjs 從本機 DSH 內置 catalog 重新生成價格表。

Provider 收費形式（metering）¶

每個 provider 可單獨設置收費形式（設置 → 費用 → Provider 收費形式，即時生效）：

切換收費形式後立即重估全部歷史記錄，無需重啓。

費用頁與會話角標¶

設置 → 費用 提供瀏覽器端彙總頁：時間段篩選（今日 / 本週 / 本月 / 近 30 天 / 全部 / 自定義）、概覽與來源構成、Token 統計（含緩存命中率）、來源分組（本地部署省 / 訂閱回本 / 白嫖 / 按量）、月度預算、CSV/JSON 導出、賬本一致性自檢。

會話頭部角標（右上角）顯示本會話今日 / 累計花費與節省、分模型統計、DeepSeek 峯谷提示，以及可開關的官方賬戶餘額行。

賬號餘額與計價情報¶

餘額通過 provider 的 API key 調用 GET /user/balance（默認 60s 刷新）。瞬時失敗保留最近一次成功值，週期自動重試。

/billing/state 的 pricing 字段提供當前單價（currentUnitPrices）、下一次峯谷或政策切換時刻（nextTransitionAt）等計價情報，供客戶端與外部工具使用。

安裝與啓用¶

插件有三種安裝方式，任選其一：

# 從 GitHub 安裝
dsh plugin --profile web add github:bpc-oss/dsh-web-billing

# 從 npm 安裝（發佈後）
dsh plugin --profile web add dsh-web-billing

# 本地開發：鏈接 checkout
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 -Profile web

安裝後重啓 dsh web 生效。同一 $DSH_HOME 下請只運行一個實例，多個實例會爭寫同一賬本文件。

git 安裝時若 pnpm ≥10 要求構建授權，把提示的包鍵加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 後重試；本包爲純 JS，通常無需構建。

覆蓋默認配置時，在 $DSH_HOME/profiles/web/cordis.patch.yml 按 id 覆寫整行（覆蓋會替換整份 config，需重述所有鍵）。常用配置項：

完整配置項見 GitHub README。

典型用法¶

查看費用匯總¶

安裝並重啓 dsh web 後，打開 設置 → 費用，默認展示本月花費、Token 統計與來源構成。可按需切換時間段，或設置每月預算（¥）觀察進度條。

切換 Provider 收費形式¶

在費用頁的 Provider 收費形式 區域，爲不同 provider 選擇 usage、usage-free、subscription、free 或 local。切換後歷史記錄立即重估，訂閱 provider 的調用會折算爲「回本」視角。

同步 coding plan 與免費模型清單¶

升級 DSH 後，在插件目錄執行：

node scripts/sync-coding-plans.mjs
node scripts/sync-promo-models.mjs

前者從本機 DSH 內置 catalog 更新 coding plan 美元單價；後者同步各 provider 的免費模型清單（見 lib/promo-models.js）。

自定義價格或追加政策¶

在 cordis.patch.yml 中設置 prices 覆蓋特定模型單價，或通過 policyOverrides 追加官方政策條目（since 必填）。設置 officialPricing: off 可完全使用用戶價格表。

導出賬單¶

費用頁支持 CSV（UTF-8 BOM）與 JSON 一鍵下載，便於離線對賬或接入其他工具。

適用場景與注意¶

適合誰：

• 長期在 dsh web 使用 DeepSeek 及多種 coding plan，需要本地可見的 token 花費與節省統計。
• 需要跟隨官方峯谷定價、自動重估歷史賬單，或按 provider 區分按量 / 訂閱 / 本地 / 白嫖計費邏輯。
• 希望在會話界面即時看到本會話花費與官方賬戶餘額。

注意事項：

1. 插件以當前 dsh web 進程權限運行，安裝前應閱讀源碼與 MIT 許可證，確認 /billing 端點默認 loopbackOnly: true（僅迴環地址訪問）。
2. 本地統計與 DeepSeek 官方賬單口徑不同；餘額來自 /user/balance，僅反映當前配置的 API key 對應賬號。
3. 賬本寫入 $DSH_HOME 下 JSON 文件，多實例併發會損壞數據。
4. SkillHub 目錄（skillhub.cn）是社區插件索引，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-web-billing 把 DSH Web 端的 AI 花銷做成「看得見、算得清」：官方價自動跟隨、峯谷時段感知、逐條消息賬本、費用頁與角標雙入口展示。若你在 Harness 生態裏需要本地 token 計費與預算管理，可以按上文步驟安裝試用。

• SkillHub 目錄：https://www.skillhub.cn/plugins/bpc-oss/dsh-web-billing
• GitHub 倉庫：https://github.com/bpc-oss/dsh-web-billing