前言¶
在 DSH Web 中使用 DeepSeek 時，賬戶餘額、當前會話模型、token 用量通常需要離開當前會話另行查看。下面介紹一個社區插件：它在會話頭部增加餘額按鈕，點擊下拉查看賬戶餘額、當前會話模型、即時 token 用量，並按 DeepSeek 官方價目表估算費用。
DSH 的理念是「一切皆插件」。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。這個插件適合已經在使用 DSH Web 和 DeepSeek API 的開發者。
這是什麼¶
lmmzss-jk/dsh-plugin-balance 是 DeepSeek Harness（DSH）的 Web 插件，由 lmmzss-jk 維護，許可證爲 MIT。
安裝名爲：
@lmmzss/dsh-plugin-balance
倉庫地址爲：
https://github.com/lmmzss-jk/dsh-plugin-balance
它複用 DSH 已配置的 DEEPSEEK_API_KEY，屬於零配置。插件把賬戶餘額、當前會話的模型與 token 用量放進會話頭部，減少在會話過程中反覆切出去查賬的步驟。
核心功能¶
會話頭部餘額按鈕¶
- 按鈕位於原生
Session log按鈕左側。 - 客戶端註冊到
conversation.session.header.utilities槽位，order: -10。 - 打開「設置」頁面時按鈕自動隱藏，關閉設置後恢復。
下拉麪板¶
點擊按鈕後，下拉麪板展示：
- 賬戶餘額。
- 當前會話模型。
- 即時 token 用量。
- 按 DeepSeek 官方價目表計算的費用估算。
即時 token 用量¶
- token 用量訂閱
token-meter的 session projection。 - 在模型回答流式過程中，token 數字即時更新。
價格同步與峯谷適配¶
- 宿主端每 6 小時以 ETag 條件請求同步官方定價頁。
- 自動提取峯谷價與生效日期。
- 未聯網時回退內置價目表。
- 客戶端打開面板時拉取最新價並本地緩存 12 小時。
- 按北京時間自動判斷高峯/空閒時段。
- 隨官方調價公告的生效日期切換新舊價目。
狀態提示與多語言¶
- 餘額較低、餘額耗盡、API Key 無效或未配置、網絡錯誤時給出狀態提示。
- 中英文自適應，跟隨瀏覽器語言自動切換文案。
請求代理¶
- 宿主端代理請求
/user/balance。 API Key不會暴露到瀏覽器。
安裝與啓用¶
先確認 DSH 環境滿足：
Node.js >= 18
@deepseek-ai/cordis ^4.0.1 爲可選 peer dependency
再確認 DeepSeek API Key 已配置。可位於：
設置 → 模型
~/.dsh/.credentials.yaml
安裝插件：
dsh plugin --profile web add @lmmzss/dsh-plugin-balance
安裝後重啓 dsh web 使插件生效。
啓用後，進入 DSH Web 會話頭部，查看 Session log 左側的餘額按鈕；點擊按鈕，查看賬戶餘額、當前會話模型、即時 token 用量與費用估算。
卸載插件：
dsh plugin --profile web remove dsh-plugin-balance
典型用法與本地開發¶
如果只是使用插件，完成上面的安裝和啓用即可。
如果要查看源碼或本地修改，可以先按本地路徑加載：
dsh plugin --profile web add /path/to/dsh-plugin-balance
修改 lib/client.js 後刷新頁面即可生效；修改宿主端或配置需重啓 dsh。
開發時可以運行：
npm test
node scripts/prepublish-check.mjs
適用場景與注意¶
適合以下場景：
- 在 DSH Web 中頻繁調用 DeepSeek。
- 希望在會話頭部直接查看餘額與當前會話 token 用量。
- 需要按 DeepSeek 官方價目表做粗略費用估算。
注意：
- 費用估算按 DeepSeek 官方價目表即時計算，僅供參考。
- 實際賬單以
platform.deepseek.com/usage爲準。 - 價格每 6 小時從官方頁面同步，無法覆蓋官方頁面未及時更新的情況。
- 「緩存寫入」恆爲 0，是因爲 DeepSeek API 不報告該字段，屬正常現象。
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼、許可證與依賴。 - 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
- 本次資料中未出現具體目錄頁 URL。
鏈接¶
- GitHub：
https://github.com/lmmzss-jk/dsh-plugin-balance - 社區目錄頁：當前資料未給出具體 URL，請以實際目錄站點入口爲準。
