opencode-helper

一个为 opencode.ai Zen 套餐提供实时用量与可用模型展示的 DeepSeek Harness（DSH） 动态插件。 A DeepSeek Harness (DSH) dynamic plugin that shows real-time opencode.ai Zen quota usage and available models.

---

✨ Features / 功能

English

1. Live quota & plan models (host.js) Polls opencode.ai every 30s, reads the available models of the current plan and three usage windows 5h / 1w / 1m:

   • Usage: GET https://opencode.ai/zen/go/v1/usage → { usage: { rolling, weekly, monthly: { status, percent, resetsAt } } }
   • Models: GET …/zen/go/v1/models (go family) / GET …/zen/v1/models (zen family)
   • API keys come from DSH credentials and never appear in any RPC payload.

2. Settings → Models rows (client.js → ocu-models) Compact inline usage mini-bars (5h / 1w / 1m) + plan model count in the free space between the provider name and its action buttons; hovering a row shows a full usage card (reset times + available models).

3. Context ring (ContextMeter) (client.js → ocu-ring) When the active model belongs to an opencode provider:

   • Hover: the native tooltip is suppressed and replaced by a DSH-styled usage bubble above the ring.
   • Click: the native panel stays, and the usage block is appended inside the panel's lower part (no layout reflow — space is reserved before the first paint via a MutationObserver).

   The progress bar color changes continuously with usage (green → amber → red via color-mix on theme tokens, theme-aware), and the ring keeps its stock behaviour for non-opencode models.

中文

1. 实时用量与可用模型（host.js） 每 30 秒轮询 opencode.ai，读取当前套餐的可模型列表与 5h / 1w / 1m 三档用量：

   • 用量：GET https://opencode.ai/zen/go/v1/usage → { usage: { rolling, weekly, monthly: { status, percent, resetsAt } } }
   • 模型：GET …/zen/go/v1/models（go 系）/ GET …/zen/v1/models（zen 系）
   • API key 经 DSH credentials 解析，不经过任何 RPC 返回。

2. “设置 → 模型”行内用量（client.js → ocu-models） 在 provider 名称与操作按钮之间的空白处内联显示 5h / 1w / 1m 迷你用量条与套餐可用模型数； 悬停该行显示完整用量卡片（含重置时间与可用模型数）。

3. 上下文圆圈（ContextMeter）（client.js → ocu-ring） 当当前模型属于 opencode 系 Provider 时：

   • 悬停：抑制原生 tooltip，改为在上方显示 DSH 风格的用量气泡；
   • 点击：保留原生面板，并把用量块追加进面板内部下方（用 MutationObserver 在首帧绘制前占位，面板布局不重排）。

   进度条颜色随用量连续渐变（绿 → 黄 → 红，基于主题 token 的 color-mix，明暗主题自适应）； 非 opencode 模型时上下文保持原生行为不变。

---

🚀 Activate / 激活

DSH 动态插件仅在当前会话进程内生效（进程重启后丢失），应在 DSH GUI 中通过 Cordis 插件流程定义并运行。

# The plugin is distributed as host.js (Host half) + client.js (Client half).
# In DSH: define a dynamic plugin with the two halves below and run it.
#   code.host   = contents of host.js
#   code.client = contents of client.js

Prereguisites / 前置条件：

• 本机可访问 https://opencode.ai。
• curl.exe（Windows 自带）或 curl，用于携带 Authorization 请求头（DSH 的 web.fetch 不允许自定义该头）。
• 凭据写入 ~/.dsh/.credentials.yaml：OPENCODE_GO_API_KEY / OPENCODE_API_KEY（或把 opencode 自身的 ~/.local/share/opencode/auth.json 内容写入 DSH 凭据）。

---

🧩 Provider 识别规则 / Provider detection

针对 settings → llm-pi-ai.providers 中每一项，命中以下任一即为“opencode 系”：

• provider id 为 opencode / opencode-go；
• 或 apiKeyEnv 以 OPENCODE 开头；
• 或 baseURL 含 opencode.ai。

无任何匹配时回退扫描 OPENCODE_GO_API_KEY / OPENCODE_API_KEY 两个标准环境变量名。 相同 key 的多个 Provider 只抓取一次。

---

📁 Files / 文件

File	Role
host.js	Host half: polling fetch, snapshot cache, ocu/state RPC
client.js	Client half: models-page inline bars + ring hover/click overlays

---

🏷 Topics / 标签

GitHub topics：deepseek-harness, deepseek, dsh, cordis, plugin, opencode, opencode-zen, llm, usage, javascript

---

📄 License

MIT（如需其他协议，在 issue 中说明即可 / open an issue to request a change）。