@pengpeng6845/dsh-balance
DeepSeek Harness 的真实 API 余额监控：使用您的 API 密钥轮询官方 /user/balance 端点，并在侧边栏显示实际剩余余额
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:PengPeng6845/dsh-balance#a366d96898d0ec595417593954e45b2279dc945eBalance 以 @pengpeng6845/dsh-balance 发布，当前版本为 0.8.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
💡 一句话：模型花掉多少钱，侧边栏里瞄一眼就知道 —— 余额来自官方 API，不是本地估算。
| 特性 | 说明 | |
|---|---|---|
| 💰 | 真实余额 | 官方 GET /user/balance 端点，API key 核实，按账户币种显示 |
| ⚡ | SSE 即时推送 | 余额一变，1 秒内上屏（EventSource 长连接 + 15s 轮询兜底） |
| 🚨 | 低余额告警 | 低于阈值（默认 ¥5）数字变橙，悬停有提示 |
| 🌐 | 中英双语 | 文案跟随界面语言自动切换 |
| 🧹 | 零依赖 | 无 npm 运行时依赖、无构建步骤；Host 纯 ESM，Client 手写 bundle |
侧边栏底部，一行扁平原生风格（无卡片、无边框，hover 才高亮）——就一行，只有余额：
┌──────────────────────────┐ │ 余额 ¥22.39 │ └──────────────────────────┘
npm（发布后推荐）：
dsh plugin --profile web add @pengpeng6845/dsh-balance
GitHub 直装：
dsh plugin --profile web add github:PengPeng6845/dsh-balance
然后确认 profile 的 package.json 的 dsh.profile.bundles 里有 "@pengpeng6845/dsh-balance"，重启 dsh web。
在 profile 自己的 cordis.patch.yml 中按 id 覆盖：
- id: balance
config:
balanceEnabled: true # 是否轮询官方余额端点
balanceApiKeyEnv: DEEPSEEK_API_KEY # 余额 API key 的凭据引用（环境变量名）
balanceBaseUrl: https://api.deepseek.com
balanceRefreshMs: 60000 # 兜底轮询间隔（毫秒）
lowBalanceAlert: 5 # 低余额警戒线（账户币种单位）
| 键 | 类型 | 默认 | 含义 |
|---|---|---|---|
| balanceEnabled | boolean | true | 是否轮询官方余额端点 |
| balanceApiKeyEnv | string | DEEPSEEK_API_KEY | 余额 API key 的凭据引用 |
| balanceBaseUrl | string | https://api.deepseek.com | 余额 API 基地址 |
| balanceRefreshMs | number | 60000 | 兜底轮询间隔；token 活动后约 20 秒也会主动刷新 |
| lowBalanceAlert | number | 5 | 低于该余额数字变橙 |
余额以账户币种显示，不做任何汇率换算。
┌───────────────┐
│ 你的 API key │ (凭据环境变量，每次请求重新解析，绝不落盘)
└──────┬────────┘
│ Bearer
▼
┌──────────────────────────────┐
│ GET /user/balance (官方) │ 每 60s 兜底轮询
│ · token 活动停止 20s 后追查 │ · 失败指数退避 5s→5m
│ · 并发去重 / 10s 超时 │ · 退避期继续供上次成功值
└──────────────┬───────────────┘
│
▼
┌──────────────────────────────┐
│ 余额采样 → storage 持久化 │ 余额下降差 = 真实花费
│ (schemaVersion 3, 旧数据迁移) │ (充值上涨自动忽略)
└──────┬───────────────┬───────┘
│ │
▼ ▼
侧边栏小组件 token_usage 工具
(SSE 即时推送) (模型自查 tokens+余额)
/user/balance 的账单真值：余额下降就是花费。
DEEPSEEK_API_KEY 环境变量/凭据是否配置，以及网络是否可达。悬停小组件可看详细提示。
npm test # 零安装单元冒烟测试（Node 20/22 CI） npm pack # 生成可分发 tarball npm run release -- 0.9.0 "..." # 一键发版：bump+CHANGELOG+测试+tag+推送(+Release) npm login && npm publish # 发布到 npm
MIT © 2026 PengPeng6845