dsh-opencode-go

September 5, 2026 · View on GitHub

OpenCode GO / CommandCode 套餐用量芯片 · Plan usage chip for DeepSeek Harness Web

会话头部常驻的套餐用量芯片：同时监控两个 OpenCode GO 账号与一个 CommandCode 账号的滚动(5h)/每周/每月三个额度窗口，3 分钟自动刷新，悬停分账号查看明细与滚动窗口剩余时间。

A persistent usage chip in the conversation header: watches two OpenCode GO accounts plus one CommandCode account across rolling(5h) / weekly / monthly quota windows, auto-refreshes every 3 minutes, and shows per-account breakdown with rolling-window countdown on hover.

功能 / Features

会话头部芯片，显示各账号的周用量百分比（≥90% 或受限=红、≥70%=橙、否则绿）
悬停气泡分账号展示：滚动(5h) / 周 / 月用量 + 滚动窗口剩余时间
3 分钟自动刷新 + 手动刷新按钮
切换会话不重复拉取：用量数据与定时器为模块级共享缓存，组件重挂载直接读缓存
单个账号失败不影响其他账号（对应行显示「获取失败」）
密钥只存在于宿主侧，浏览器永不接触

安装 / Install

dsh plugin --profile web add github:305037991x-pixel/dsh-opencode-go

重启 dsh web 并硬刷新页面（Ctrl+Shift+R）。

配置 / Configuration

在 $DSH_HOME/.credentials.yaml 中配置（或环境变量同名）：

# OpenCode GO 账号 A（必填）
OPENCODE_GO_API_KEY: sk-xxx
# OpenCode GO 账号 B（可选，不配则只显示一个账号）
OPENCODE_GO_API_KEY_B: sk-yyy
# CommandCode（可选，不配则不显示该行）
COMMANDCODE_API_KEY: cmd-zzz

OpenCode GO 的 Key 在 opencode.ai/auth 创建；CommandCode 的 Key 在其 Studio 创建（即 Provider API 使用的 CMD_API_KEY）。

工作原理 / How it works

端	文件	职责
Host	`lib/index.js`	注册 `GET /dsh-opencode-go/usage`：并行解析各账号的 key（凭证服务：环境变量 → `$DSH_HOME/.credentials.yaml` → `.env`），按账号类型调用对应官方接口，返回 `{ ok, accounts: [...] }`
Client	`lib/client.js`	在 `conversation.session.header.utilities` 槽位注册芯片；模块级共享数据 + 3 分钟定时器；悬停气泡分账号渲染

上游接口：

账号类型	接口	窗口来源
OpenCode GO（A/B）	`https://opencode.ai/zen/go/v1/usage`	官方直接返回 rolling(5h)/weekly/monthly 三窗口（`percent`/`status`/`resetsAt`）
CommandCode	`https://api.commandcode.ai/alpha/billing/credits` + `/alpha/usage/summary`（可选 `/alpha/whoami?limits=1` 取 orgId）	与 command-code CLI `/usage` 命令同源的 `/alpha` 系列端点；5h/周窗口由 `windowLimits.fiveHour/weekly` 的 `used/cap` 换算百分比，月窗口 = `totalMonthlyCredits` /（已用 + 剩余 `monthlyCredits`）

注：CommandCode 的 /alpha 端点未在官方文档登记（文档只列 /provider/v1/*），但为官方 CLI 自身使用的接口；若官方日后提供正式用量 API，建议迁移。

License

MIT