余额快照 President-H/dsh-balance-view

dsh-balance-view

把 DSH（DeepSeek Harness）里登录账号的 DeepSeek 余额 定时写进一个本地 JSON 文件，并开一个只读 HTTP 接口。
好处很简单：脚本、别的插件、聊天机器人不用登录 DSH，也能随时读到最新余额，而且读取本身不消耗 token。

它做什么

- 通过宿主自带的 deepseekAccount 服务取余额（充值钱包 + 赠金，口径与官方 total_balance 一致）
- 每 2 分钟刷新一次，写进 $DSH_HOME/dsh-balance-view/cache.json（默认 ~/.dsh/dsh-balance-view/cache.json）
- 顺便提供一个只读接口：GET /dsh-balance/balance.json（加 ?refresh=1 立刻重新取一次）

它不做什么

- 不自己拼 HTTP、不碰任何凭据：token 的注入、请求头、失效清理全部交给宿主的账号服务
- 不改设置、不写别的文件、不联网做别的事
- 没有 UI，一行界面都不加

安装

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

本地开发时直接链进来：

dsh plugin --profile <你的 profile> add link:<本目录绝对路径>

装完重启一次 DSH，就会看到 ~/.dsh/dsh-balance-view/cache.json 开始更新。

缓存文件长什么样

{
"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"
}

失败时 ok 为 false，code 会告诉你是哪一种：

| code | 意思 |
| NO_ACCOUNT_SERVICE | 当前宿主没有账号服务（老版本 DSH） |
| NOT_LOGGED_IN | 没登录 DeepSeek 账号，也没有账号凭据 |
| NOT_READY | 账号服务没就绪 |
| NO_WALLET | 账号没有任何余额钱包 |
| ERROR | 取数时抛异常，error 里是原因 |

怎么读

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

或者直接读那个 cache.json。下面是个最简单的读取脚本（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})

已知边界

- DSH 没开着就不会刷新，这时候缓存会变旧，checkedAt 就是判断依据
- 只读，不提供任何写入或充值能力
- 只在有 deepseekAccount 服务的宿主上有意义（账号登录用户）；纯 API key 用户请看宿主自己的余额卡片

License

MIT