前言¶
在 DeepSeek Harness（DSH）里跑智能体或调模型时，钱包余额往往要切到平台页面或另开标签才能确认。开发节奏一旦密集，很容易在不知情的情况下把余额用到临界值。社区插件 dsh-balance-reminder（维护者 AdyVany，分类：客户端）针对的是 Web 客户端场景：在界面底部常驻显示 DeepSeek 平台钱包合计余额，并在偏低时变色与弹卡提醒。余额通过 DSH 已登录账号的 account.getBalance 读取，不需要另外配置 API Key。
这是什么¶
dsh-balance-reminder 是面向 DSH Web Client 的实验性客户端插件，当前版本 0.1.0，MIT 许可。它在 Harness 界面最底部挂载余额条，并依赖 shell.bottom、shell.overlay 等 0.2.x 插槽；数据来自当前登录态下的 DeepSeek 平台钱包摘要（充值钱包与赠金钱包的币种与余额字符串），插件不持久化 access token，也不向 DeepSeek 之外发送余额信息。
核心功能¶
以下能力均来自插件 README 与 package.json 说明。
- 常驻余额条：界面最底部一行显示充值余额与赠金合计；默认每 60 秒自动刷新，也可点「刷新」立即读取。
- 低余额变色：人民币余额低于 ¥20 显示为琥珀色，低于 ¥5 显示为红色。
- 低余额提醒卡：低于 ¥20 时在右下角弹出提醒，可「去充值」或「稍后提醒」；余额恢复后再次低于阈值会重新提醒。
- 失败不伪装：读取失败时展示明确失败原因，不会把失败显示成 ¥0.00。
- 中英文文案：跟随界面语言。
- 刷新策略：仅界面打开时每分钟请求一次；页面隐藏时暂停自动刷新，切回时立即刷新。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前建议自行查看源码与 MIT 许可证。兼容 DSH >=0.2.0 <0.3.0。
方式一：通过插件索引（推荐）¶
- 在 DSH 打开 插件 → 实验性插件 → 打开「自定义插件索引」。
- 点 发现 → 添加索引源，填入：
https://cdn.jsdelivr.net/gh/AdyVany/dsh-balance-reminder@main/market/index.json
- 搜索「余额」或「Balance」→ 安装。
方式二：直接安装 tarball¶
在访问 GitHub 不稳定时，可用 CLI 安装发布包：
dsh plugin add "https://cdn.jsdelivr.net/gh/AdyVany/dsh-balance-reminder@main/dist/dsh-balance-reminder-0.1.0.tgz"
方式三：本地开发¶
在本仓库目录下执行（target 填本目录绝对路径）：
plugin_manager install_bundle target="<本目录绝对路径>"
安装后若底部余额条未出现，可先刷新页面；开发改文件时可依赖 HMR 重新加载插件。
典型用法¶
安装并启用后，无需额外配置 API Key：保持 DSH 已登录 DeepSeek 账号即可。
- 日常开发时观察底部余额条，需要最新数字时点「刷新」。
- 余额低于 ¥20 时注意琥珀色样式与右下角提醒卡，按需跳转充值或选择「稍后提醒」。
- 若需自定义告警与刷新间隔，可编辑插件内
client.js中的常量（改完后保存，由 HMR 重载；首次安装未生效可刷新页面）：
// WARN_BELOW = 20
// CRITICAL_BELOW = 5
// REFRESH_MS = 60 * 1000
适用场景与注意¶
适合谁：长期在 DSH Web 界面调试、调用模型，希望一眼看到平台钱包合计、并在偏低时被动提醒的开发者。
不适用或需留意：
- 仅支持 DSH 0.2.x Web Client，依赖
@deepseek-ai/dsh-api-remotes等注入与账号远程接口；升级到 0.3.0 前需确认插件是否已适配。 - 插件读取的是登录态下的平台钱包摘要，权限范围与当前 DSH 会话一致；社区目录（如 SkillHub）为独立生态站点，与 DeepSeek / 幻方无官方从属关系，安装来源以维护者公布的索引或 tarball 为准。
- 低余额阈值目前为源码常量，未提供独立配置文件项；改阈值即改
client.js。
结尾¶
dsh-balance-reminder 把 DeepSeek 平台钱包合计余额固定在 Web 客户端底部，并在低于 ¥20 / ¥5 时分级变色与弹卡提醒，同时避免在请求失败时伪造为零余额。若你在 0.2.x 的 DSH Web 上长期开发，可从索引或 tarball 安装后直接使用登录态读余额。
- 目录页：https://www.skillhub.cn/plugins/AdyVany/dsh-balance-reminder
- GitHub：https://github.com/AdyVany/dsh-balance-reminder
