dsh-opencode-usage
用于 DeepSeek Harness Web GUI 撰写器停靠栏的 OpenCode Go 配额读数
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ColorlessBoy/dsh-opencode-usage#cc7bddf954df2bd91d168a96356d6d6b38fb8ee3
Opencode Usage 以 dsh-opencode-usage 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness (dsh) 插件：在 Web GUI 输入框下方的开发者小字里，紧挨内置的「会话统计 / Token 用量」两枚 pill，多显示一枚 OpenCode Go 额度 pill。
10 轮 89 步 · 42 tok/s │ 1.2M · 缓存命中 45% │ ⏰ 剩余 5h 80% │ 周 84% │ 月 42%
baseURL 指向
https://opencode.ai/zen/go... 时才显示；切到 DeepSeek 官方等其它 provider 时自动隐藏，
不会误报错误。每月 剩余 42%），不会出现一个来路不明的孤立数字。/api/opencode-usage，API key 由 host 侧
credentials 服务按 apiKeyEnv 解析，永不进入页面。lib/ 是可直接加载的纯 JS 产物，装好即用，仓库不需要构建步骤。OpenCode Go 订阅的官方额度接口：
GET <baseURL>/usage # https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <apiKeyEnv 对应的凭据>
返回 {"usage":{"rolling":{…},"weekly":{…},"monthly":{…}}}，每个窗口带
status / percent（已用百分比）/ resetsAt。
dsh plugin --profile web add github:ColorlessBoy/dsh-opencode-usage
package.json 声明了 dsh.bundle，dsh plugin 会把它加进 profile 的
dsh.profile.bundles 并链接进 profile 的 node_modules。仓库自带可直接运行的 lib/，
安装过程不需要构建授权。
装好后重启 dsh web 并刷新页面。不启动也能先验证层已组合：
dsh --profile web --dump-config # 应出现 "# == dsh-opencode-usage" 层
在 $DSH_HOME/profiles/web/cordis.patch.yml 里按绝对路径挂载：
- insert:
- id: opencode-usage
name: /absolute/path/to/dsh-opencode-usage/lib/index.js
两种方式不要同时用：同一个 opencode-usage id 出现两行是组合错误。
dsh plugin --profile web remove dsh-opencode-usage
手工方式则删掉那一块。之后重启 dsh web。
dsh-opencode-usage/
├── package.json # dsh.client 声明 lib/client.js 是浏览器半边；dsh.bundle 指向 patch
├── cordis.patch.yml # bundle 层：插入 opencode-usage 这一行
├── lib/
│ ├── index.js # host 半边：/api/opencode-usage 路由 + 上游抓取 + 缓存
│ └── client.js # 浏览器半边：模块表 bundle，注册 composer dock 里的 chip
└── test/
├── host.test.mjs # 路由行为：URL 判定、凭据、归一化、错误码、缓存、鉴权
└── client.test.mjs # jsdom + 真实 React：chip、portal 进统计行、详情面板、中英文案
架构上分两半，是因为 API key 只在 host 侧：
| 半边 | 职责 |
|---|---|
host lib/index.js | 解析 provider 的 baseURL / apiKeyEnv，带凭据请求上游，归一化为只含剩余量的 JSON，按 provider 缓存（成功 30s、失败 10s），对并发轮询合并为一次上游请求 |
browser lib/client.js | 从会话的 modelSelection 投影读当前 provider，轮询同源端点（15s），把 chip 渲染进内置统计行 |
浏览器半边把一个零尺寸锚点留在 dock 里，并用一个只监听 childList 的 MutationObserver
盯住自己父节点：内置统计行存在时，chip 通过 portal 成为那一行的第三个子元素（因此和
两枚内置 pill 共用同一套 flex 布局、居中与间距）；统计行不在（新会话还没有落定的步）时，
chip 退化成 dock 里自己的一行居中。
它用的是自己的 1px 竖线分隔符，而不是内置 pill 的 · 字形：三个分段挤在一枚标签里，
竖线加两侧留白比借来的圆点更窄。皮肤其余部分（字号、行高、--dsw-* 语义 token、
面板圆角与阴影）与内置 pill 保持一致。
两个脚本都从 DSH checkout 里解析 React / react-dom / jsdom，插件目录本身不需要
npm install：
DSH_CHECKOUT=/path/to/deepseek-harness npm test
DSH_CHECKOUT 省略时默认为本机的 DSH checkout 路径。test/host.test.mjs 只依赖 Node。
无。行为完全由已有的 DSH 配置推导：
| 事实 | 来源 |
|---|---|
| 当前选中的 provider | 会话的 modelSelection 投影（/model 弹窗写入的同一个值） |
provider 的 baseURL / apiKeyEnv | settings 的 llm-pi-ai.providers.<route> |
| API key | credentials 服务解析 apiKeyEnv 指向的引用 |
未在 llm-pi-ai 中声明的 provider（例如 deepseek-official 由另一个适配器族提供）一律
视为「不适用」并隐藏。
profile patch 是 live reload 的，但 host 半边不会：lib/index.js 由 Node 的 ESM 模块
缓存持有，改完必须重启 dsh web。浏览器半边（lib/client.js）由 client HMR 的文件监视器
热重载，改完刷新页面即可。
MIT