dsh-balance-mini：DeepSeek Harness 极简余额监视器

前言¶

DeepSeek Harness (DSH) 采用插件化架构，为开发者提供了扩展能力。在使用多供应商模型进行开发或测试时，监控 API 余额是常见需求。dsh-balance-mini 专为解决“随时看一眼余额”这一痛点而生，提供常驻显示与状态提示，不占用额外界面空间。

插件介绍¶

dsh-balance-mini 是 DeepSeek Harness 的一个客户端插件，由 DaYanQAQ 开发，遵循 MIT 许可证。它通过常驻左下角的徽章和红绿灯配色，实时展示余额状态，并支持多供应商与高峰/空闲时段识别。

核心功能¶

• 常驻余额徽章：在 DSH Web 界面左下角显示余额（格式：余额：￥xx.xx · 更新于 HH:MM）。徽章随侧边栏宽度平滑自适应。
• 红绿灯圆灯：当侧边栏收起时，徽章收缩为圆灯。颜色与金额文字颜色同步：红色（<10 元）、黄色（10~20 元）、绿色（20 元以上）。
• 自动刷新：每 60 秒自动查询一次余额；面板右上角提供手动刷新入口。
• 多供应商支持：支持 DeepSeek、Kimi、OpenRouter。插件自动读取 DSH 配置文件中已设置的 API Key，哪一家配置了即可查看哪家余额。
• 高峰/空闲时段提示：根据 DeepSeek 官方定价，区分高峰时段（周一至周五 9:00–12:00、14:00–18:00）与空闲时段（其余时间）。空闲时段价格为高峰价的一半，并显示距下一时段切换的倒计时。
• 中英文自动切换：界面语言跟随浏览器设置。
• 安全边界：接口仅接受回环地址（127.0.0.1）访问，API Key 仅在本机进程内存中读取，不落盘，不转发给第三方。

安装与启用¶

需要 DeepSeek Harness 版本 @deepseek-ai/dsh >= 0.1.0-rc.6。

1. 在终端执行安装命令：

   dsh plugin --profile web add dsh-balance-mini

2. 重启 dsh web 进程，并在浏览器中硬刷新页面（通常为 Ctrl+Shift+R）。
3. 左下角出现余额徽章即安装成功。

配置¶

该插件为零配置。它通过读取 DSH 的凭据文件来获取 API Key：

• 路径：~/.dsh/.credentials.yaml
• 逻辑：在 Harness 的「设置-模型」中配置了哪家的 Key，插件就自动可用。

配置示例：

refs:
  DEEPSEEK_API_KEY: sk-xxxxxxxx      # DeepSeek
  MOONSHOT_API_KEY: sk-xxxxxxxx      # Kimi
  OPENROUTER_API_KEY: sk-or-xxxx     # OpenRouter

添加或删除 Key 后，重新打开余额面板即可生效。

典型用法¶

• 查看详情：点击左下角的余额徽章，展开详情面板。
• 处理未配置供应商：若在面板中选择了未配置 API Key 的供应商，会显示提示，余额显示为 ￥0.00。

注意事项¶

• 插件基于当前 dsh 进程权限运行，API Key 仅在内存中处理。
• 目前支持的供应商为 DeepSeek、Kimi、OpenRouter。Z.ai（智谱）等因无公开余额查询接口或接口语义不符，暂未接入。

结语¶

dsh-balance-mini 以极简的方式解决了 DSH 用户监控余额的日常需求。适合需要频繁切换供应商并关注计费时段的开发者。

• 项目目录页
• GitHub 仓库