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