前言¶

DeepSeek Harness（DSH）把會話、工具和界面都做成插件。網頁界面開着長時間跑 Agent 時，內置統計行能告訴你本場用了多少 token，但賬戶還剩多少錢、這一場大概花了多少，往往要另開控制檯或自己拿單價去乘。

這個問題在 2026 年 8 月 17 日更具體。DeepSeek 官方從北京時間當天 0 時起對 API 實行峯谷定價：高峯爲北京時間 09:00–12:00 和 14:00–18:00，其餘爲空閒時段。Flash 和 Pro 單價不同，緩存命中、未命中和輸出也不一樣。同一段對話，換模型或跨過高峯，花費差一截是正常的。

dsh-balance-meter 把官方餘額接口和官方價格頁接到 DSH 網頁的輸入框下方：一條 chip 同時給出賬戶總餘額和當前會話估算花費。本文按社區目錄詳情頁、倉庫 README / README.zh.md、package.json 和源碼交叉覈對後整理。社區插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係；DSH 本身的定位仍是官方倉庫寫的那句：一切皆插件。

這是什麼¶

dsh-balance-meter 是一款面向 DSH 網頁界面 的會話與消息插件，由 Ghost011118 維護，許可證 BSD-3-Clause，當前倉庫版本爲 0.1.0。目錄分類是「會話與消息」。GitHub 倉庫 Ghost011118/dsh-balance-meter 在覈實當日顯示 16 星；社區目錄頁當時標註 13 星，以倉庫頁面爲準。

它解決的是網頁會話裏「錢花到哪了」看不見的問題：

• 賬戶總餘額：查詢 DeepSeek 官方 Get User Balance 接口
• 本場估算花費：用 DSH 持久化的 tokenUsage 乘以官方單價
• 按會話實際模型計價，而不是寫死 Flash

package.json 裏 dsh.client.platform 爲 web，peer 依賴對齊 DeepSeek Harness 0.1.0-rc.6。它不是 CLI 賬單工具，也不會替你改模型或限流；只在網頁輸入框下方給出讀數。

核心功能¶

輸入框下方的餘額 chip¶

安裝並重啓網頁後，chip 出現在輸入框下方、與內置會話統計行同一排。倉庫給出的示例如下：

餘額 CNY 4.16 · 本場 CNY 2.57

點擊 chip 會展開兩組明細：

• 餘額：按幣種拆開，贈送額度與充值額度分開顯示
• 花費：按分桶拆開，輸入、緩存讀、輸出分別計價

chip 報錯時再點一次，會立即強制刷新。倉庫說明：錯誤視圖不會當成新鮮緩存複用，後續輪詢會重新查詢；網絡或 Key 恢復後，chip 會自己回到即時總額。

按會話真實模型計價¶

默認 model: auto。每個會話的請求頭會記下最近一次請求的 provider/model，插件把 id 映射到單價表：

• deepseek-v4-flash → flash
• deepseek-v4-pro → pro

因此一場用 Pro 的會話按 Pro 計價，不會被寫死成 Flash。尚無請求頭、或模型 id 無法識別時，auto 回退到 flash。需要鎖定估算口徑時，可把 model 設成 flash 或 pro，此時忽略自動識別。

花費 JSON 會帶上 pricingKey 和 model，chip 能標出這一場按哪個模型算的。

從官方價格頁取單價，並識別峯谷¶

插件默認每 6 小時抓取一次官方價格頁：

https://api-docs.deepseek.com/zh-cn/quick_start/pricing/

抓到之後，按當前北京時間套高峯或空閒單價。高峯時段與官方公告一致：09:00–12:00、14:00–18:00。價格變動不必發新版插件。

價格頁抓取失敗時，回退到倉庫寫明的內置預設（flash：緩存命中 0.02 / 未命中輸入 1 / 輸出 2 元，每百萬 tokens）。這組數字是抓取失敗時的兜底，不是 8 月 17 日峯谷價生效後的官方價。組合配置裏顯式的 cost.* 覆蓋優先於任何預設。

花費怎麼算¶

記賬口徑與內置統計行相同：讀取 DSH 持久化的 tokenUsage 投影，把四個分桶換成金額：

1. 未命中輸入
2. 緩存讀
3. 緩存寫
4. 輸出

DeepSeek 不對緩存寫單獨計費，插件默認按 0。餘額側走官方接口；花費側是本地估算，用來看本場量級，不是賬單對賬。

宿主側還會掛上 /api/balance JSON 接口，瀏覽器側負責把讀數畫到頁面上。cordis.patch.yml 用一條 id: balance 的插件行同時掛上這兩半。

安裝與啓用¶

環境要求以倉庫 README 爲準：

• DeepSeek Harness 0.1.0-rc.6 或更新（web profile）
• 已通過 DSH 憑據通道寫入 DeepSeek API Key（DEEPSEEK_API_KEY，在網頁 Models 頁面填寫即可）

社區目錄頁給出的安裝命令如下，在 DSH 終端執行：

dsh plugin add github:Ghost011118/dsh-balance-meter

該插件只作用於網頁界面。維護者 README 寫的是帶 web profile 的寫法，效果更明確：

dsh plugin --profile web add https://github.com/Ghost011118/dsh-balance-meter

需要可復現安裝時，按目錄頁說明把 commit 哈希釘死。覈實當日 master 最新提交爲 db97c0ea49767d7e73166d8d57a13e54970533e4（2026-08-14），示例：

dsh plugin add github:Ghost011118/dsh-balance-meter#db97c0ea49767d7e73166d8d57a13e54970533e4

也可以從本地檢出安裝：

git clone https://github.com/Ghost011118/dsh-balance-meter.git
dsh plugin --profile web add link:$(pwd)/dsh-balance-meter

裝完後重啓 dsh web，再刷新瀏覽器。餘額 chip 應出現在輸入框下方。

插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。

典型用法¶

1. 零配置先看讀數¶

默認使用 DEEPSEEK_API_KEY 和官方價格頁，不必先寫配置。網頁 Models 頁面寫入 Key 後：

1. 按上一節安裝插件
2. 重啓 dsh web 並刷新頁面
3. 開一場會話，chip 應顯示「餘額」和「本場」
4. 點擊 chip，覈對贈送 / 充值，以及輸入、緩存讀、輸出的分桶花費

README 裏的 餘額 CNY 4.16 · 本場 CNY 2.57 只是界面示例，不是你的賬戶數據。

2. 可選組合配置¶

需要改模型預設、刷新間隔或走兼容網關時，在組合配置裏插入插件行。倉庫給出的示例如下：

- insert:
    - id: balance
      name: 'dsh-balance-meter'
      config:
        model: auto         # 'auto'（默認）| 'flash' | 'pro'
        pricingRefreshHours: 6

倉庫列出的配置項：

多數情況保持 model: auto 即可。只想用 Flash 口徑估所有會話時，再改成 flash。

3. Key 讀不到時怎麼查¶

README 把報錯 no API key for provider route \deepseek-official`寫進了疑難排查。插件和 LLM 路由走同一套憑據通道，默認文件是~/.dsh/.credentials.yaml`（即網頁 Models 頁面寫入的那份）。

按倉庫說明，可以按下面順序覈對：

1. 確認文件裏有 DEEPSEEK_API_KEY: sk-...（引用指向非空字符串）。DSH 運行中直接改文件即可，provider 會熱重載。
2. 憑據通道已掛載時，只從該文件讀 Key；此時僅 export DEEPSEEK_API_KEY 不會被採用。導出只在未掛載通道時作爲本插件的兜底。
3. 建議用單一受守護實例跑 dsh web（例如 dsh-autostart），避免多個 npx dsh web 搶同一端口、讀到不同憑據快照。chip 恢復到即時總額，說明 Key 已經解析成功。

適用場景與注意事項¶

適合這些情況：

• 主要在 DSH 網頁界面跑會話，想同時看到剩餘額度和本場花費
• 同一環境會切 Flash / Pro，希望花費跟着實際模型走
• 峯谷定價生效後，需要按北京時間高峯 / 空閒來估本場成本
• 走兼容網關時，可以用 baseUrl 指向自己的入口

使用前注意下面幾條，均來自目錄頁或倉庫，不是額外發揮：

1. 只覆蓋網頁界面。 package.json 聲明 platform: web。純終端、桌面殼或其他 profile 不會出現這條 chip。
2. 本場數字是估算。 口徑對齊內置 tokenUsage 和官方價格頁，用於看量級；對賬仍以 DeepSeek 官方賬單爲準。價格頁失敗時會落到內置 flash 預設，數字可能偏舊。
3. Key 必須進憑據通道。 網頁 Models 頁寫入的 DEEPSEEK_API_KEY 纔是餘額查詢和模型路由共用的那份。
4. 插件以當前 dsh 進程權限運行。 安裝可能執行代碼。先看 GitHub 源碼和 BSD-3-Clause 許可證；生產環境建議固定 commit。
5. 社區目錄不是官方應用商店。 條目來自 DeepSeek Harness 插件庫，與 DeepSeek / 幻方無官方從屬關係。DSH 官方倉庫仍是 deepseek-ai/deepseek-harness。

小結¶

dsh-balance-meter 在 DSH 網頁輸入框下方補了一條餘額與本場花費 chip：餘額走官方接口，花費用同一套 token 記賬乘以官方單價，並能按會話真實模型以及 8 月 17 日起的峯谷時段切換。對經常在網頁裏跑 Agent、又需要盯着額度的人，它把「還剩多少、這一場大概多少」放到了統計行旁邊。

目錄頁與倉庫：

• 社區目錄：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-balance-meter/
• GitHub：https://github.com/Ghost011118/dsh-balance-meter
• DSH 官方倉庫：https://github.com/deepseek-ai/deepseek-harness
• 官方價格頁：https://api-docs.deepseek.com/zh-cn/quick_start/pricing/