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  add dsh-balance-view

本地开发时直接链进来：

dsh plugin --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-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

@president_h_999/dsh-balance-view

Install

README