前言¶

DSH 的插件機制，適合把成本查看、額度顯示和導出這類界面能力拆成獨立包。對於長期使用多個模型、多個 provider 或中轉站的開發者來說，手動記錄 token 和餘額容易出現口徑不一致。

dsh-ui-usage-billing 是 kenz1117 維護的一個 DeepSeek Harness 插件。它通過 npm 包 @kenz1117/dsh-ui-usage-billing 安裝，許可證爲 MIT。插件在側邊欄提供成本指標入口，並提供全屏儀表盤，從持久化會話日誌聚合真實用量，再按多廠商目錄估算費用。

下面介紹它的功能、安裝方式和需要留意的邊界。

這是什麼¶

一句話定位：面向 DSH 的用量計費儀表盤。資料說明它屬於純 UI surface，不註冊工具、不注入系統提示、不向會話日誌寫入模型可見事件。

當前 package.json 標註版本爲 1.0.15，許可證爲 MIT。engines 要求爲：

node ^22.19.0 || >=24.0.0

核心功能¶

側邊欄與儀表盤¶

啓動宿主後，側邊欄設置上方出現計費入口。打開後是全屏儀表盤，分區包括：

• 概覽
• 趨勢
• 明細
• 統計
• 費率
• 設置

服務端從持久化會話日誌即時聚合真實用量；數據到達前顯示空快照。

費用估算與自定義單價¶

插件按即時多廠商官方價估算費用，並支持峯谷計價：

• 工作日高峯時段 ×2
• 週末全天按低谷價計費

自定義單價用於未收錄或變價模型，可填寫：

• 未命中
• 緩存命中
• 輸出

可選 USD 與低谷價。

未計價模型費用按 0 計，並在 Hero 下提示 N 個模型未收錄計價。

訂閱、餘額與對賬¶

資料列出的訂閱與餘額能力包括：

• 訂閱套餐額度識別與顯示，包括 Kimi / Z.ai / OpenCode Go / MiniMax / OpenRouter / 小米 / 火山等
• 多廠商餘額查詢：DeepSeek / Kimi / 階躍星辰 / 硅基流動 / xAI / 智譜 GLM / 騰訊雲 TokenHub
• 中轉站餘額與滾動額度識別，按 provider baseURL 歸一化 origin 歸組
• 聲明端點 declaredEndpoints
• 餘額差對賬 reconcilePath

用量明細與導出¶

資料列出的明細與導出能力包括：

• 成本突增歸因：最近 40 輪每輪費用柱狀圖，超 2 倍紅標
• 會話明細
• 月 / 年日曆熱力圖
• 性能指標：TTFT 均值 / P50 / P90、tokens/s、總延遲均值
• Token 統計：輸入（緩存未命中）/ 輸入（緩存命中）/ 輸出，含 reasoning 思考
• 按日 / 按會話 / 按站點 CSV 導出
• 全量 JSON 導出

CSV 導出對以 = / + / - / @ 開頭的單元格前置單引號，並轉義逗號 / 引號 / 換行 / 回車。

國際化與離線能力¶

資料列出的基礎能力包括：

• 多語種：中文 / English
• 雙幣種：¥ / ≈$ 切換
• 離線自包含：無圖表庫、無外部 CDN、純設計令牌

安全與隱私¶

資料列出的安全邊界包括：

• 全部 HTTP 端點強制迴環訪問
• 寫操作額外校驗 Origin 迴環與 Content-Type application/json
• 隱私底線：純 UI surface，不註冊工具、不注入系統提示、不向會話日誌寫入模型可見事件

安裝與啓用¶

先檢查宿主版本和依賴，再安裝 npm 包，最後啓動宿主。

資料說明兼容底線爲 DSH 0.1.2-alpha.1；舊宿主 0.1.0-rc.8 到 0.1.1-rc.2 建議停留在 v1.0.11。資料中的 peerDependencies 列表被截斷，安裝前建議以宿主和包的當前依賴爲準。

1、安裝 npm 包：

npm install @kenz1117/dsh-ui-usage-billing

2、在宿主 cordis.patch.yml 中加入：

- insert:
    - id: ui-usage-billing
      name: '@kenz1117/dsh-ui-usage-billing'

3、啓動宿主後，側邊欄設置上方出現計費入口。

4、sessionPersistence 可用時自動聚合真實用量。

典型用法¶

先啓動宿主，再從側邊欄進入儀表盤。下面幾個示例來自資料：

• 未收錄或變價模型：使用自定義單價，可填未命中、緩存命中、輸出，並可選 USD 與低谷價。
• 騰訊雲 TokenHub：憑據值填 <SecretId>:<SecretKey>。
• MiniMax 國內開發者環境：使用 minimax-token-plan-cn，自動對接 https://api.minimaxi.com。
• 導出：按日 / 按會話 / 按站點導出 CSV，也可導出全量 JSON。

適用場景與注意¶

適合在以下情況使用：

• 使用 DSH，並且需要把多 provider、多會話的用量與費用放在同一界面查看。
• 需要同時查看訂閱額度、多廠商餘額、中轉站額度、聲明端點與餘額差對賬。
• 需要導出 CSV / JSON，做後續覈對或歸檔。

使用前注意：

• 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證；當前許可證爲 MIT。
• 真實用量聚合依賴 sessionPersistence；資料說明 sessionPersistence 可用時自動聚合真實用量。
• 費用是估算口徑：按即時多廠商官方價估算；未計價模型按 0 計，並在 Hero 下提示未收錄計價模型數量。
• 資料中的 peerDependencies 列表被截斷，不能據此確認完整依賴。
• 全部 HTTP 端點強制迴環訪問，寫操作額外校驗 Origin 迴環與 Content-Type application/json。

小結¶

dsh-ui-usage-billing 提供的是一個 DSH 客戶端側的成本查看層：側邊欄入口、全屏儀表盤、真實用量聚合、多廠商價格估算、訂閱餘額與導出。它的邊界也清楚：不註冊工具，不注入系統提示，不寫入模型可見事件。

GitHub：https://github.com/kenz1117/dsh-ui-usage-billing

資料中給出的目錄頁：https://www.skillhub.cn/plugins/kenz1117/dsh-ui-usage-billing