前言¶
用 DeepSeek Harness（DSH）做本地智能体开发时，API 余额和可用模型往往要切到 DeepSeek 控制台或单独写脚本查询。对话过程中也不容易判断当前 Key 还剩多少额度、高峰时段定价是否生效。
下面介绍的 dsh-balance 是社区维护的客户端插件，把余额查询和模型列表集成进 DSH 的设置页，并在聊天框下方持续显示摘要。API Key 仅由本机 Host 使用，不会发送到浏览器。
这是什么¶
dsh-balance 由 crazywoola 维护，归类为客户端插件，在 SkillHub 目录 可找到安装入口。npm 包名为 @pinkbanana/dsh-balance，当前版本 0.4.1，采用 MIT 许可证。
插件面向已在使用 DSH Web 配置文件的开发者：在 Harness 内直接查看 DeepSeek 账户余额、充值余额、赠送余额，以及当前 API Key 可用的模型列表，无需离开对话界面。
核心功能¶
根据项目 README，插件提供以下能力：
- 查看总余额、充值余额和赠送余额
- 在聊天框下方持续显示余额摘要
- 查看当前 API Key 可用的模型
- 缓存查询结果，并支持手动刷新
- 依据 DeepSeek 峰谷定价，在北京时间 9:00–12:00、14:00–18:00 高峰时段，将聊天框下方的余额指示灯变为橙色
- 原生支持简体中文和英文，跟随 Harness 系统语言切换
- 支持 Harness 已保存的
DEEPSEEK_API_KEY，也可在「设置 → 模型」中配置 API Key
安装与启用¶
先在 DSH 中安装插件，再以 Web 配置启动 Harness：
dsh plugin --profile web add @pinkbanana/dsh-balance@latest
dsh --profile web
安装完成后打开 http://127.0.0.1:3080/，进入「设置 → DeepSeek 余额」。该入口位于「Agent 预设」下方。若已在「设置 → 模型」保存 API Key，或通过环境变量 DEEPSEEK_API_KEY 提供，插件即可发起余额与模型查询。
典型用法¶
完成安装并配置 API Key 后，可按下面步骤使用：
- 打开 Harness Web 界面，进入「设置 → DeepSeek 余额」，查看总余额、充值余额、赠送余额及可用模型列表。
- 返回已有会话，聊天框下方会显示余额摘要，无需每次进入设置页。
- 需要最新数据时，在设置面板手动刷新；插件会缓存查询结果以减少重复请求。
- 若当前处于 DeepSeek 高峰定价时段（北京时间 9:00–12:00、14:00–18:00），聊天框下方的余额指示灯会变为橙色，便于留意计费变化。
API Key 的两种配置方式：
- 在 Harness「设置 → 模型」中保存
- 通过环境变量
DEEPSEEK_API_KEY提供
适用场景与注意¶
适合谁
- 日常在 DSH 中调试智能体、需要随时掌握 API 余额的开发者
- 希望在同一会话界面确认当前 Key 可用模型、避免额度耗尽后才发现的用户
- 关注 DeepSeek 峰谷定价、需要在高峰时段留意余额状态的场景
使用前注意
- 插件以当前
dsh进程的权限运行，安装前应阅读 GitHub 源码 并确认 MIT 许可证条款。 - 本插件面向 Web 配置文件（
--profile web），安装命令中的包名为@pinkbanana/dsh-balance，与 GitHub 仓库crazywoola/dsh-balance对应同一项目。 - SkillHub 为社区插件目录，与 DeepSeek、幻方无官方从属关系；插件能力以 README 与源码为准。
- 开发构建需 Node.js >= 20；贡献者可执行
pnpm install与pnpm check进行校验。
结尾¶
dsh-balance 把 DeepSeek API 余额与模型查询嵌入 DSH 设置页和聊天界面，减少在控制台与 Harness 之间来回切换。若你正在用 DSH 做本地智能体开发，可从目录页或 GitHub 获取插件并按上述命令安装。
