DeepSeek Harness 用户需要同时监控 DeepSeek 官方余额与 OpenCode Go 的 5 小时/周/月用量。直接查看控制台或多个界面效率低下。该插件将这两项数据合并到一个悬浮胶囊中，位于主界面旁。
这是一个 DeepSeek Harness 客户端插件，由 verneuil 维护。它在一个浮窗中同时显示 DeepSeek 官方余额与 OpenCode Go 的 5h/w/m 用量。它包含一个同名设置页，用于调整刷新行为和界面选项。
功能概览¶
- 一屏两套数据：在同一个悬浮胶囊中显示 DeepSeek 官方余额（以 ¥ 计）和 OpenCode Go 的 5h/w/m 用量。点击浮窗即可刷新（一侧失败不影响另一侧）。
- 三颗圆环：用圆环显示百分比（默认显示“剩余”，可在设置中切换为“已使用”）。颜色编码：剩余 > 20% 为绿色，≤ 20% 为琥珀色，≤ 5% 为红色。底盘为 32% 透明度的同色。
- 细光轨反馈：更新时，一条细光沿胶囊周长等弧长匀速跑圈。完成后，它收束成整圈“封环”。如果失败，则显示红色。
- 拖动吸附：松手时，浮窗自动吸附到最近的参考线（输入框卡片边 / 窗口边）。尺寸变化或窗口调整时，它会跟随锚线，不会跑位。
- 长宽恒定：浮窗在任何状态下尺寸都不变（反馈层是绝对定位叠加层，不参与布局）。
- 零依赖：纯原生 JS，无构建步骤，无第三方运行时依赖。
- 中英双语：所有界面文案跟随 DSH 语言设置即时切换（浮窗、设置页、菜单名与操作提示）。
- 主题自适应：颜色只取宿主主题令牌（
--dsw-alias-*），明暗主题自动跟随。开关、按钮、输入框、徽章照抄宿主组件样式。
安装¶
DeepSeek Harness 桌面版自带 node / pnpm，无需额外安装。
在 DSH 中打开插件管理页 → 「安装插件」对话框，粘贴以下任一 spec 并安装（对话框会调用 pnpm，一次只能装一个）：
# GitHub 直装（推荐）
github:verneuil/dsh-opencode-go-usage
# 固定版本
github:verneuil/dsh-opencode-go-usage#v2.10.0
命令行等价写法：
dsh plugin --profile web add github:verneuil/dsh-opencode-go-usage
注意：插件管理页拒绝没有 bundle patch 的依赖，本包自带 cordis.patch.yml。安装后按页面提示刷新。
使用方法¶
- 点击浮窗：立即刷新余额与用量。
- 拖动浮窗：移动位置，松手自动吸附。
- 设置页路径：
设置 → 插件 → OCG 余量查询。 - 调整口径：在设置页切换“已使用” / “剩余”显示模式。
- 手动操作：在设置页手动刷新、调整自动刷新间隔、开关余额显示、重置位置。
设计与兼容性¶
- 席位占用：只占官方
shell.overlay席位（replaceRisk=none），不遮蔽官方 UI。 - 样式原则：样式只用主题令牌，无阴影、无模糊、无字面色值。
- 技术栈：不引入任何 Harness 客户端包，控件全部自写。宿主半侧负责拉取与解析，客户端只读配置投影。
- 升级：升级需卸载后重装，不支持直接覆盖安装。
