@verneuil/dsh-opencode-go-usage

dsh plugin --profile web add @verneuil/dsh-opencode-go-usage

<div align="center">

<img src="assets/icon.png" width="96" height="96" alt="OCG 余量查询 icon" />

OCG 余量查询

把 DeepSeek 官方余额与 OpenCode Go 三个用量窗口（5 小时 R / 本周 W / 本月 M）合并进同一个悬浮胶囊，另带一个同名设置页

 









[更新日志](CHANGELOG.md) · 反馈

</div>

---

一个非官方的 DeepSeek Harness 插件：把 DeepSeek 官方余额与 OpenCode Go 的 5 小时 / 本周 / 本月三档用量收进同一个悬浮胶囊 —— 点一下即刷新、边框闪烁反馈、可拖动吸附、悬停展开详情浮层，并自带一个同名的整页设置界面。

目录

• [特性](#特性) · [安装](#安装) · [使用](#使用) · [设置页](#设置页)
• [截图](#截图) · [数据来源](#数据来源) · [构型](#构型)
• [配置项](#配置项) · [稳健性设计](#稳健性设计) · [已知限制与免责声明](#已知限制与免责声明) · [许可](#许可)

特性

浮窗与悬停浮层

• OpenCode Go配额计算+DeepSeek官方余额展示：

• 浮窗左侧的余额区域可选择显示DeepSeek 官方余额或按参考模型折算出的 OCG 配额剩余；
• OCG模型列表与配额自动获取，取不到就用内置模型表和配额数据。

• 三环进度条显示窗口用量：

• OpenCode Go 三窗口用量，以圆环进度条显示，点击浮窗即刷新；
• 环心数字是百分比（默认已使用，可在设置里切为展示「剩余」），剩余 > 20% 绿 / ≤ 20% 琥珀 / ≤ 5% 红。

• 悬停浮层：

• 鼠标停在胶囊上，展开浮层面板，显示三根独立的用量进度条，显示用量百分比和重置时间；
• 此外还支持同时显示两个余额金额（ DeepSeek 账户余额、OpenCode Go 配额剩余——两者都可在「浮窗管理」页关掉）

• OCG 配额折算：

• 在设置页选一个参考模型（默认 DeepSeek V4.1 Flash，可选 OpenCode Go 全部官方模型），插件按「该模型 Go 档月度配额 × 本月已用百分比」算出已消耗 / 剩余金额，显示在设置页与悬停浮层；
• 免费模型显示「免费」，无限制模型显示「无限制」，剩余配额等均显示为 -- 。

• 金额计价币种：

• 所有金额（DS 余额与 OCG 配额）可选 ¥ 人民币 / ＄ 美元 / 自动（中文界面 ¥、英文界面 ＄）三种计价方式。
• 汇率自动获取，取不到就用内置汇率，换算只影响显示。

• 极简模式：

• 三环显示数据：外 / 中 / 内三环可分别绑定「5 小时 / 本周 / 本月」，右侧带实时预览（仅极简模式下可用）；
• 使用三环嵌套（内 R / 中 W / 外 M）+ 余额取整到元显示在环旁，胶囊更紧凑（非极简模式为「余额 + 三颗独立圆环」）；
• 再关掉「在浮窗左侧显示余额」即为最精简形态：只留三环嵌套，占地最小。

• 其他特性：

浮层可交互：鼠标从胶囊移到浮层上时浮层不会消失（留了 220ms 过渡，跨过两者之间的间隙）；点击浮层与点击胶囊效果相同，都会触发一次手动刷新；浮层边框的刷新闪烁与胶囊完全同步；

浮层方向自适应：贴近窗口底部时向上展开，贴近左右边缘时自动改为向内展开，不会被窗口裁掉；

拖动吸附：松手按窗口边沿记录位置（只记边沿 + 偏移，输入框卡片变化不会再带着它漂移），精确到 0.1px；窗口尺寸变化时按锚线保持相对位置；

• 长宽恒定：任何状态下浮窗尺寸都不变（反馈层是绝对定位叠加层，不参与布局）。

其它

• 零依赖：纯原生 JS，无构建步骤、无第三方运行时依赖（只 require('react')，由宿主提供）。
• 侧栏入口（可选）：设置页有「侧栏入口」开关（默认关）。开启后侧栏出现本插件入口，点一下直接打开本插件的整页设置界面（与设置对话框里完全同一套），侧栏图标与设置菜单里的标记一致；
• 中英双语：全部界面文案走客户端 locale 字典，随 DSH 语言设置即时切换（浮窗、设置页、菜单名与各项操作提示）。

安装

前置：DeepSeek Harness 桌面版（应用自带 node / pnpm，无需另装）。本插件按 DSH 官方插件规范编写，不需要手写 profile 的 package.json / cordis.patch.yml，也不要在 profile 目录里跑 pnpm。

在 DSH 里打开 插件管理页 → 「安装插件」对话框 → 粘贴下面任一 spec → 安装（对话框调用 pnpm，一次只能装一个）：

方式 · 粘贴的 spec

GitHub 直装（推荐） · github:verneuil/dsh-opencode-go-usage

npm 安装 · dsh plugin --profile web add @verneuil/dsh-opencode-go-usage

固定某个版本 · github:verneuil/dsh-opencode-go-usage#v3.4.2（换成任意已发布 tag）

Release 包 · https://github.com/verneuil/dsh-opencode-go-usage/releases/download/v3.4.2/dsh-opencode-go-usage-3.4.2.tgz

Release 直链（始终最新） · https://github.com/verneuil/dsh-opencode-go-usage/releases/latest/download/dsh-opencode-go-usage.tgz

离线 tgz · file:D:/你的路径/dsh-opencode-go-usage-3.4.2.tgz

命令行等价写法（dsh plugin 会把声明了 dsh.bundle 的依赖自动加进 profile 的 bundles，无需手写 patch）：

dsh plugin --profile web add github:verneuil/dsh-opencode-go-usage

装完按页面提示刷新（替换已安装的 JavaScript 模块代需要重启 DSH）。

• 只受理「组合包」：插件管理页拒绝没有 bundle patch 的依赖，本包自带 cordis.patch.yml，符合要求。
• 升级 = 卸载后重装：插件管理页不提供版本选择器与升级按钮。卸载会移除依赖记录，重装时才会重新解析，因此这是拿到新版的方式；直接覆盖安装同一 spec 不会刷新到新提交。
• 每个版本的改动见 [CHANGELOG.md](CHANGELOG.md)（中英双语）。

兼容性

• 宿主版本门禁：本插件在 package.json 声明 engines.dsh: ">=0.1.7"。宿主用 semver.satisfies(..., { includePrerelease: true }) 判定，因此 0.1.7 起的 rc / alpha 版本都会匹配，不需要为每个新宿主版本改插件。
• 已实测：dsh 0.2.1-rc.3、dsh 0.2.1-rc.5（隔离 profile 冷启动 + 浏览器冒烟全部通过）。
• 被宿主拒绝加载时（宿主把范围收窄、或清单判定不一致）：在该 profile 的 compatibility.json 里加一条精确豁免即可，不需要改插件：

  { "@verneuil/dsh-opencode-go-usage@3.4.2": ["0.2.1-rc.5"] }

文件位于 ~/.dsh/profiles/<profile>/compatibility.json（桌面版为 %DSH_HOME%\profiles\<profile>\compatibility.json）。

• 升级 DSH 后若浮窗 / 设置页异常，先看启动日志里有没有 plugin tree failed to load，再对照 [CHANGELOG.md](CHANGELOG.md)。

使用

• 点击浮窗 = 立即刷新余额 + 用量 + 模型清单 + 汇率（也可以等自动刷新）。
• 拖动浮窗 = 移动位置，松手自动吸附；「重置位置」按钮可一键回到默认位置（窗口左上角）。
• 浮窗左侧那一行余额 = 在设置里二选一：DS 官方余额 / OCG 配额剩余（详见[设置页](#设置页)）。
• 设置页 = `

…(truncated)