前言¶

用 DeepSeek Harness（DSH）跑 Web 端智能體時，賬戶餘額是繞不開的一件事：餘額見底，後續調用就會失敗。要確認餘額，通常得切出當前環境，打開 DeepSeek 平臺後臺登錄查看，思路被打斷。dsh-balance-display 把這一步搬進 Harness 界面：餘額以面板形式常駐，隨用隨看。

下面介紹這個插件的功能、數據來源、安裝方式和配置。

這是什麼¶

dsh-balance-display 是由 Liu-ty 維護的 DeepSeek Harness 可安裝 bundle，版本 0.1.0，MIT 許可證。它在一個可摺疊的 shell.overlay 面板中顯示當前 DeepSeek API 賬戶餘額，數據來自官方餘額接口，插件本身不存儲任何餘額值。

核心功能¶

• 以可摺疊的 shell.overlay 面板顯示當前 DeepSeek API 賬戶餘額；
• CNY 與 USD 兩行，每行包含 total、granted、topped-up 三項餘額；
• 顯示賬戶可用性與最近刷新時間；
• 支持摺疊面板與手動刷新，自動刷新提供手動、1、5、15 分鐘幾檔選擇；
• 頁面隱藏時暫停定期刷新，頁面可見時恢復；
• 適配 Harness 明/暗主題 token，內置 zh-CN 與 en-US 語言字典；
• 錯誤狀態明確：missing-credential、401、超時、網絡、上游、無效響應各自有對應展示。

數據怎麼來的¶

Host 每次刷新經 Harness credentials 服務解析 DEEPSEEK_API_KEY，然後調用官方接口 GET https://api.deepseek.com/user/balance。API key 不發送到瀏覽器，也不被本插件持久化、記錄或寫入快照。Host 響應使用 Cache-Control: no-store；DeepSeek 的非成功響應體不被轉發或記錄。

安裝與啓用¶

先確認環境滿足三個條件：

1、帶 Web profile 的 DeepSeek Harness，以及當前的 profile-bundle 系統；
2、Node.js ^22.19.0 || >=24.0.0；
3、即時餘額讀取需要 Harness credentials 中可用的 DEEPSEEK_API_KEY。沒有憑據時插件仍會加載，並顯示 missing-credential 狀態。

推薦從固定的 v0.1.0 源碼 tag 安裝：

dsh plugin --profile web add github:Liu-ty/dsh-balance-display#v0.1.0

也支持本地檢出安裝與預構建發佈 tarball 安裝：

dsh plugin --profile web add F:\path\to\dsh-balance-display
dsh plugin --profile web add .\dsh-balance-display-0.1.0.tgz

安裝後執行以下命令，先檢查插入的配置，再啓動驗證：

dsh --profile web --dump-config
dsh --profile web

Git 安裝的構建權限¶

Git 安裝會拉取源碼並運行本包的 prepare 構建。pnpm 可能拒絕安裝，直到 profile 的 pnpm-workspace.yaml 顯式包含：

allowBuilds:
  dsh-balance-display: true

這一授權允許包代碼在安裝時於本機執行。授予前應先審查源碼，並固定 tag 或 commit。如果不想授予構建權限，改用發佈 tarball，其中已含預構建文件，無需該權限。

配置¶

bundle 會在配置中插入一行 Host/Client 條目：

- id: balance-display
  name: dsh-balance-display
  inject: [credentials, webServer]
  config:
    requestTimeoutMs: 10000

要修改超時，在 profile 或 home 的 cordis.patch.yml 中覆蓋整行，把 requestTimeoutMs 改爲正整數即可。自動刷新間隔與摺疊狀態是瀏覽器本地偏好；插件不存儲任何餘額值。

適用場景與注意事項¶

適合的人羣：日常使用帶 Web profile 的 DSH，希望在不離開當前界面的前提下掌握 DeepSeek API 餘額的開發者。

使用前注意幾點：

1、插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證（本項目爲 MIT）；
2、Git 安裝需要 pnpm 構建授權，授予前先審查源碼並固定 tag 或 commit；
3、插件無模型可見輸入，也沒有 token 統計集成，不要把它當成成本覈算工具；
4、無憑據時不會中斷，面板會顯示 missing-credential 狀態，配置好憑據後即可正常讀取。

小結¶

dsh-balance-display 解決的是一個具體的小問題：把查餘額從切頁登錄變成界面裏的一瞥。實現上走官方接口、憑據不進瀏覽器，MIT 許可，按需啓用即可。

社區插件目錄頁面：https://www.skillhub.cn/plugins/Liu-ty/dsh-balance-display（獨立站點，與 DeepSeek、幻方無官方從屬關係）
源碼倉庫：https://github.com/Liu-ty/dsh-balance-display