dsh-opencode-go-usage

DeepSeek Harness 的 OpenCode Go 计划用量监控插件：Web GUI 右下角悬浮用量坞， 实时显示 5h 滚动 / 本周 / 本月三个额度窗口的已用百分比与重置倒计时。

数据来自 OpenCode 官方配额 API（GET https://opencode.ai/zen/go/v1/usage， Bearer API Key 认证，无需 workspace id、无需 Cookie）。

安装

# 从 npm 安装（Web GUI 对应 web profile）：
dsh plugin --profile web add @xueayi/dsh-opencode-go-usage
# 或本地路径：
dsh plugin --profile web add /path/to/dsh-opencode-go-usage
# 升级到最新版：
dsh plugin --profile web update @xueayi/dsh-opencode-go-usage

安装后重启对应 profile（Web UI 即 dsh web）。

配置

推荐途径：在 Web 设置 → 模型 中选择「官方渠道 · OpenCode Go」并填入 API Key，之后无需任何配置即可使用。

插件每次刷新通过 ctx.credentials 解析 apiKeyEnv 指定的凭据引用（默认 OPENCODE_GO_API_KEY），也可手动把 Key 存入 ~/.dsh/.credentials.yaml 或环境变量：

- insert:
    - id: opencode-go-usage
      name: '@xueayi/dsh-opencode-go-usage'
      config:
        apiKeyEnv: OPENCODE_GO_API_KEY
        refreshMs: 60000

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | apiKeyEnv | string | OPENCODE_GO_API_KEY | 凭据引用 | | apiKey | string | — | 直接指定 Key（不推荐） | | endpoint | string | https://opencode.ai/zen/go/v1/usage | 配额接口 | | refreshMs | number | 60000 | 自动刷新间隔 | | timeoutMs | number | 10000 | 单次请求超时 |

用量坞

右下角一枚毛玻璃悬浮坞（Web shell 没有右下角插槽，采用 body portal 挂载）：

• 徽章（收起态）：三个迷你双层圆环直接显示三项配额——外环为剩余 额度占比（尚未使用时为满圆环，随用量消耗而缩短；弧按已用占比着色： <60% 绿 / ≥60% 橙 / ≥85% 红，越接近用完越显红），内环为窗口剩余时间 （品牌蓝，随窗口周期实时递减）；旁附 5h 滚动窗口的秒级精确倒计时 （↻3h25m）与实时状态点。
• 面板（点击展开）：三行窗口（5h 滚动 / 本周 / 本月），每行含双层 用量环（外环剩余额度 + 内环剩余时间）、已用/剩余百分比（「已用」前有 随用量着色的圆点：绿/橙/红；「重置于」前有蓝色圆点，对应内环颜色）与 重置倒计时；底部为更新时间、「控制台 ↗」（跳转 OpenCode Go 控制台） 与「立即刷新」按钮。
• 未配置/异常时面板内联给出配置指引，抓取失败不会让徽章空白。

显示稳定性

数据与健康状态分离：某次刷新失败（网络超时、API 异常）时，用量坞继续 显示上次成功获取的额度，仅状态点转为黄色、面板底部出现一行「刷新失败， 显示上次数据」的淡提示，不打断显示；只有从未成功获取过时才显示错误/未配置 提示。

状态点与「立即刷新」按钮复用 DSH 共享原语 dsh-client-ui-primitives（StateDot / Button），与全站视觉保持一致。用量坞还遵循 prefers-reduced-motion：在减少动 效环境下跳过弹入与圆环过渡、关闭面板时不再播放退场动画；浮窗徽章与面板按视口 安全区（safe-area inset）内缩，避免被刘海屏或 Home 指示区遮挡。

Model Experience

Request surface and condition

本插件不暴露任何模型可见面：模型看不到用量数值，不新增任何系统提示文本 或工具 schema。

Token effect

无 —— 不发起模型请求，不注入任何 token。

KV Cache effect

无 —— 不新增或替换任何请求 token。

Known Limitations and Deferred Work

• 轮询延迟 —— 收起态徽章每 60 秒、展开态面板每 10 秒轮询一次，用量 变化最多延迟一个轮询周期。
• 数据新鲜度 —— 刷新连续失败时继续显示上次成功数据，数据会随时间 变旧，恢复后自动更新。
• 单账户 —— 每个 profile 只解析一个 API Key；多账户仪表盘不在范围内。