前言¶

在 DSH（DeepSeek Harness）裏跑腳本、插件或聊天機器人時，經常需要知道當前登錄賬號的 DeepSeek 餘額。若每次讓模型自己去查，要麼走對話、消耗 token，要麼還得在別處登錄 DSH 看界面。社區插件 dsh-balance-view（維護者 President-H，分類：聯網工具）走另一條路：由宿主已有的賬號服務定時拉餘額，寫入本地文件，並提供一個只讀 HTTP 路徑，其它程序直接讀數字即可，讀緩存本身不消耗 token。

下面介紹它做什麼、怎麼裝、怎麼讀，以及適用邊界。

這是什麼¶

dsh-balance-view 是 DSH 生態裏的一個小型聯網工具插件（npm 包名 @president_h_999/dsh-balance-view，當前版本 0.1.0，MIT 許可證）。它不造 UI，也不自己拼 DeepSeek HTTP 或碰憑據；餘額來源是宿主自帶的 deepseekAccount 服務，口徑與官方 total_balance 一致（充值錢包 + 贈金）。

裝好後，大約每 2 分鐘刷新一次，結果寫在 $DSH_HOME/dsh-balance-view/cache.json（默認 ~/.dsh/dsh-balance-view/cache.json），同時註冊只讀接口 GET /dsh-balance/balance.json，支持 ?refresh=1 立即再取一次。

目錄頁：https://www.skillhub.cn/plugins/President-H/dsh-balance-view
源碼：https://github.com/President-H/dsh-balance-view

核心功能¶

定時緩存¶

• 通過 deepseekAccount 取餘額，每 2 分鐘寫入 cache.json。
• 成功時 JSON 含 total、recharge、bonus、currency、wallets、checkedAt 等字段；失敗時 ok 爲 false，code 區分原因（如未登錄、無賬號服務、未就緒等）。

只讀 HTTP¶

同一數據可通過 DSH 本地端口訪問：

curl http://127.0.0.1:<DSH 端口>/dsh-balance/balance.json?refresh=1

明確不做的事¶

• 不改 DSH 設置、不寫其它文件、不聯網做餘額以外的事。
• 只讀，不提供充值或寫入能力。

安裝與啓用¶

官方 README 給出的安裝方式如下（<你的 profile> 換成你實際使用的 profile 名）：

dsh plugin --profile <你的 profile> add dsh-balance-view

本地開發時可以把倉庫目錄鏈進 profile：

dsh plugin --profile <你的 profile> add link:<本目錄絕對路徑>

裝完需要重啓一次 DSH。重啓後若賬號服務正常且已登錄，應能看到 ~/.dsh/dsh-balance-view/cache.json 開始按間隔更新。

插件以當前 DSH 進程的權限運行；安裝前建議瀏覽 GitHub 源碼與 MIT 許可證，確認符合你的環境策略。

典型用法¶

直接讀緩存文件¶

緩存成功時結構類似：

{
  "ok": true,
  "total": 7.76,
  "recharge": 7.76,
  "bonus": 0,
  "currency": "CNY",
  "wallets": [
    { "kind": "recharge", "currency": "CNY", "balance": 7.7637408 },
    { "kind": "bonus", "currency": "CNY", "balance": 0 }
  ],
  "checkedAt": "2026-10-30T04:06:25.186Z"
}

失敗時對照 code：NO_ACCOUNT_SERVICE（老版本宿主無賬號服務）、NOT_LOGGED_IN、NOT_READY、NO_WALLET、ERROR（異常詳情在 error）。

腳本里讀一行餘額¶

README 提供的 Node 示例：

import { readFileSync } from 'node:fs'
const j = JSON.parse(readFileSync(process.env.HOME + '/.dsh/dsh-balance-view/cache.json', 'utf8'))
console.log(j.ok ? `餘額 ${j.total} ${j.currency}` : `讀不到：${j.error}`)

其它語言同理：解析 JSON，看 ok 與 total。需要最新值時用 HTTP 的 ?refresh=1，或等下一次定時刷新。

適用場景與注意¶

適合誰

• 已在 DSH 裏用 DeepSeek 賬號登錄、且宿主提供 deepseekAccount 服務的用戶；希望機器人、定時任務或其它插件讀餘額，而不反覆走對話或登錄 UI。
• 純 API key、不看賬號錢包的用戶，README 建議以宿主自帶的餘額展示爲準，本插件意義不大。

邊界

• DSH 未運行時不會刷新，舊數據以 checkedAt 爲準。
• 社區目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係；DSH 理念是「一切皆插件」，本插件是社區貢獻之一。

結尾¶

經過上面的步驟，dsh-balance-view 的價值可以概括爲：在 DSH 進程內複用官方賬號服務，把餘額變成本地 JSON 和只讀 HTTP，方便自動化與聯動。需要詳情時見 SkillHub 目錄頁 與 GitHub 倉庫。