前言¶
用 DeepSeek Harness（DSH）做智能体开发时，账户余额和当日用量往往要单独打开平台用量页才能确认。峰时、闲时计价不同，仅凭余额数字也不清楚今天花了多少、当前处在什么时段。下面介绍的 dsh-quota-ring 是社区维护者 Aya-zhang 发布的 客户端 插件：在 DSH 侧边栏账户名旁显示余额、今日预估花费，以及表示峰闲时段与花费占比的圆环；悬停可看明细，不必频繁切页。
这是什么¶
dsh-quota-ring 在 DSH 侧边栏账户名同一行挂载「余额环」：余 来自 DeepSeek 官方账户接口，今 由本机 DSH 会话日志与插件内置价目表估算。「今」不是官方账单，与余额来源不同，数值不会严格同步。
插件适用于 macOS。使用 DSH 自带的 Node 运行，无需额外安装 Node 或 npm 依赖；README 写明已在 DSH 0.2.1-rc.3 验证。安装后读取 DSH 已保存的 DeepSeek 登录信息，无需在插件里单独填密钥。
核心功能¶
余额与今日预估¶
侧边栏显示类似 余:¥9.89、今:¥1.71 的紧凑数字，深色与浅色主题均支持。
峰闲圆环¶
- 环心：表示此刻时段。按内置规则，北京时间周一至周五 09:00–12:00、14:00–18:00 为峰时（黄色），其余为闲时（绿色）；法定节假日与调休不做特殊处理。
- 环周：表示今天预估花费中峰时、闲时的占比（黄、绿弧长对应比例）。
- 余额低于阈值时环心变红并带红色呼吸光晕，默认阈值为 ¥3。
悬停、刷新与重启¶
鼠标移到数字上可查看今日峰时/闲时花费、合计、Token 数、缓存命中率、请求数及距离下次时段切换的时间；面板提供官方用量与充值页入口。
点击数字区域可手动刷新；插件每 60 秒自动刷新。圆环与数字为独立点击区域，点数字不会触发重启弹窗。刷新时圆环有高亮转动弧；数值变化有短暂翻动着色（余额增绿减红，今日预估增黄减红）。
点击圆环会弹出重启 DSH 确认框，确认后才会重启并中断当前会话。
安装与启用¶
在终端执行（以下以 desktop profile 为例；其他 profile 将 desktop 换成实际名称）：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add github:Aya-zhang/dsh-quota-ring#v0.1.0
安装命令会把插件加入对应 profile。完成后重启 DSH 生效。
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证。DeepSeek Harness 社区插件目录（SkillHub 条目）为独立站点，与 DeepSeek / 幻方无官方从属关系。
调整低余额提醒¶
默认在余额低于 ¥3 时提醒。在 profile 的 cordis.patch.yml 中为插件增加 lowBalance：
- insert:
- id: quota-ring
name: dsh-quota-ring
config:
lowBalance: 5
保存后重启 DSH。正数为阈值；0 关闭提醒；负数、非数字或留空时使用默认 3。
数据来源与限制¶
- 余额：经 DSH 已保存凭据调用官方账户接口，不向第三方发送凭据。
- 今日预估：仅读本机
~/.dsh/sessions中的 DSH 会话日志；其他设备或渠道的用量不会出现于此。 - 内置价格与峰闲规则可能随平台调整而过时；侧边栏布局依赖 DSH 当前 DOM 与宽度，DSH 大版本更新后可能需要插件跟进。
- 插件不上传统计，也不使用第三方遥测。
适用场景¶
适合在 macOS 上长期开着 DSH、希望侧边栏常驻余额与当日花费体感、并区分峰闲占比的开发者。若需要与官方账单完全一致的对账，仍应使用平台官方用量页，勿将 今 当作结算依据。
结尾¶
经过上面的步骤，你可以在不动用量页的前提下掌握余额、今日预估与当前峰闲状态；需要明细时悬停即可。更多说明与截图见仓库 README。
