dsh-balance-guard
余额哨兵：会话头部右上角实时显示 DeepSeek 余额，余额不足自动变橙提醒（标题标记 + 系统通知），点击即时刷新。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:bunipai/dsh-balance-guard#a205a2cbc979b37800798693f5b1a0799d2c82b8Balance Guard 以 dsh-balance-guard 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness 插件:在 Web 界面会话头部右上角实时显示 DeepSeek API 账户余额,余额不足自动变橙提醒(标题标记 + 系统通知)。
GET /api/dsh-plugin-balance,服务端读取与 llm-deepseek
相同的凭证(默认 credential ref DEEPSEEK_API_KEY,即 $DSH_HOME/.credentials.yaml
或环境变量),调用 https://api.deepseek.com/user/balance(15 秒缓存、单飞)。conversation.session.header.utilities —
会话头部右上角(状态圆点 + 金额)插件行配置(profile cordis.patch.yml,或通过 llm 同款设置节):
- insert:
- id: plugin-balance
name: dsh-balance-guard
config:
apiKeyEnv: DEEPSEEK_API_KEY # credential ref
baseURL: https://api.deepseek.com # 可用 $DEEPSEEK_BASE_URL 覆盖
pollIntervalMs: 30000 # 客户端轮询间隔
cacheMs: 15000 # 服务端缓存
timeoutMs: 10000 # 上游请求超时
lowBalanceThreshold: 5 # 低余额提醒阈值
lowBalanceCurrency: CNY # 阈值比较的币种
也支持在 $DSH_HOME/settings.yaml 里以 plugin-balance: 节覆盖
pollIntervalMs / cacheMs / timeoutMs / lowBalanceThreshold /
lowBalanceCurrency。
dsh plugin --profile web add dsh-balance-guard
# 或本地目录:
dsh plugin --profile web add file:/path/to/dsh-balance-guard
运行中的 web 进程会热加载 patch 变更(host 插件即时生效),刷新页面即可看到胶囊。
{
"ok": true,
"value": {
"isAvailable": true,
"balanceInfos": [
{ "currency": "CNY", "totalBalance": "110.00",
"grantedBalance": "10.00", "toppedUpBalance": "100.00" }
],
"lowBalance": {
"active": false,
"currency": "CNY",
"threshold": 5,
"amount": "110.00"
},
"updatedAt": 1755012345678
},
"pollIntervalMs": 30000
}
错误时 ok: false + error.code:no-api-key | invalid-api-key | api-error |
transport-error | bad-response。