前言¶
DSH 生態強調“一切皆插件”；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。對使用 DeepSeek Harness（DSH）的人來說，一個常見需求是在會話或 Web GUI 裏直接查看 DeepSeek 賬戶餘額，而不是離開當前工作環境去平臺查詢。
dsh-balance 是 DeepSeek Harness 插件，提供 /balance 斜槓命令，並在 Web GUI 的 composer-dock 顯示即時 DeepSeek 賬戶餘額。本文只根據已覈實資料介紹它的功能、安裝方式、典型用法和注意事項。
這是什麼¶
dsh-balance 由 deepforce 維護，許可證爲 MIT。插件倉庫名爲 deepforce/dsh-balance。
它調用 DeepSeek 官方 Get User Balance 端點，返回按幣種的 total、topped-up、granted 餘額。
核心功能¶
下面介紹已覈實的能力。
/balance斜槓命令：在會話中打印完整餘額明細。- Web GUI 顯示：在 conversation stats area 顯示
Balance: ¥…行，懸停顯示topped-up/granted明細。 Top up鏈接：指向 DeepSeek 平臺 top-up 頁面。- 手動刷新按鈕。
Session ≈ ¥…：顯示估算的會話花費，懸停顯示token buckets × unit prices。Last {days}d ≈ ¥…：懸停顯示最近usageDays天的 SVG 柱狀圖。- 雙語顯示：跟隨活動 dsh 語言，支持中文 / 英文。
- 瀏覽器通過宿主
/dsh-balance路由獲取公開餘額數據，API key 不進入瀏覽器。
安裝與啓用¶
先安裝插件：
dsh plugin --profile web add github:deepforce/dsh-balance
安裝後重啓 dsh web，使 client plugin table 加載新條目：
dsh web
經過上面的步驟，插件的宿主側命令和瀏覽器側顯示都會進入可用狀態。
典型用法¶
在會話 composer 中輸入：
/balance
示例輸出如下：
Balance (CNY): 110.00
Topped up: 100.00
Granted: 10.00
在 Web GUI 中，composer 下方 stats area 會顯示：
Balance: ¥110.00 ⟳
懸停可看到 topped-up / granted 明細，使用 ⟳ 按鈕刷新。
配置與估算¶
Session ≈ ¥… 是估算，不是賬單記錄。它使用配置的 estimateModel 價格，並且 cache-write tokens 不計價。
價格可通過以下配置字段調整：
offpeakPricespeakMultiplierpeakWindows
資料列出的配置項包括：
apiKeyEnv
baseURL
timeoutMs
estimateModel
offpeakPrices
peakMultiplier
peakWindows
topUpUrl
usageDays
其中，usageDays 與 daily-spend chart 的歷史天數窗口相關。
安全與權限¶
API key 通過 credential seam 或環境在每次調用時解析，不寫入配置、返回文本或瀏覽器。
資料稱插件只調用：
GET https://api.deepseek.com/user/balance
並且沒有其他數據離開進程。瀏覽器通過宿主 /dsh-balance 路由獲取公開餘額數據。
安裝前仍建議檢查源碼與許可證。插件以當前 dsh 進程權限運行，安裝命令執行時等同於在該 DSH 環境中引入新代碼。
兼容與構建¶
兼容測試基於 DeepSeek Harness 0.1.0-rc.6（web profile, Windows 11），並於 2026-08-14 驗證。
資料稱 @deepseek-ai/dsh-* npm 包爲 pre-release，無兼容保證；若 dsh 更新影響 conversation.composer.dock slot 或 webServer service，需要重新檢查。
本地構建使用 pnpm，並依賴 pnpm-workspace.yaml overrides 解決上游 npm 缺失依賴。
適用場景與注意¶
dsh-balance 適合需要在 DSH 會話或 Web GUI 中查看 DeepSeek 賬戶餘額、Top up 入口和會話花費估算的場景。
不適合把 Session ≈ ¥… 當作賬單記錄；它只是估算。
如果你從社區目錄安裝，目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。安裝前請確認來源，並檢查 MIT 許可證是否滿足你的使用要求。
小結¶
dsh-balance 的價值在於把 DeepSeek 餘額、Top up 入口和會話花費估算放進 DSH 工作流裏。
倉庫地址爲：
https://github.com/deepforce/dsh-balance
當前已覈實資料未提供目錄頁 URL；如需從社區目錄檢索，請自行確認入口。
