前言¶
在使用 DeepSeek API 时，频繁查看账户余额通常需要切换到官方控制台。dsh-ds-balance 将余额信息直接集成到 DeepSeek Harness (DSH) 的侧边栏中，通过状态环和弹出窗口提供直观的查看方式。
插件简介¶
dsh-ds-balance 是一个 DSH 插件，由 dsh-plugin-lab 维护。它直接从官方 DeepSeek API 端点读取余额，并在侧边栏底部展示状态，同时在插件页面提供配置卡片。
核心功能¶
- 侧边栏状态环：在侧边栏底部固定显示余额状态，通过颜色和弧度展示余额多少及距离警告阈值的距离。
- 余额弹出窗口：点击状态环展开，显示总额、赠送/充值细分以及数据年龄。
- 配置卡片：在插件页面提供连接、显示、阈值和刷新设置。
安装与启用¶
- 前置条件：DSH 当前 RC 线（安装时需指定
@next），Node.js 版本 >= 20。 - 安装 DSH 主机：
npm install -g @deepseek-ai/dsh@next
- 安装插件：
dsh plugin --profile web add dsh-ds-balance
- 启动 DSH：
dsh --profile web
- 从源码安装：克隆仓库后执行
pnpm install && pnpm run build，然后通过上述命令添加插件路径。
典型用法¶
安装并启动 DSH 后，侧边栏底部会出现 DeepSeek 余额的状态环。点击该环可以展开弹出窗口，查看详细的余额构成和更新时间。
安全与架构¶
- 凭证管理：插件通过 DSH 的凭证通道解析凭证，自身不存储密钥。UI 仅显示头尾掩码（如
sk-cf08d*****3b84），完整密钥不会在传输、日志或文件中暴露。 - 网络访问：仅连接
api.deepseek.com，不代理其他流量。 - 数据存储：余额快照按凭证存储，切换凭证会重置记录。
配置说明¶
在 DSH 侧边栏点击“插件”，找到已安装的“DeepSeek Balance”卡片进入详情页。配置区域包含：
* Connection：只读，显示当前使用的凭证来源，提供测试按钮。
* Display：设置货币显示方式。
* Thresholds：设置警告和严重阈值（同一货币下严重值必须低于警告值）。
* Refresh：设置服务端刷新间隔、UI 轮询间隔和手动刷新冷却。
升级说明¶
插件版本 3.0 移除了手动设置的 apiKey 和 baseUrl，凭证统一由 DSH 管理。升级后，旧的设置值不会自动迁移，需在配置卡片中重新填写。
结尾¶
该插件通过官方 API 提供余额监控，适合需要管理多个 DeepSeek 账户或需要实时监控 API 消耗的开发者。相关源码与更新请访问 GitHub。
