前言¶

在 DeepSeek Harness（DSH）中接入 OpenCode Go 后，用户需要查看的不只是单个模型调用结果，还包括额度窗口、会话 token 用量、缓存命中情况和模型维度的消耗分布。dsh-opencode-go-usage 是一个 DSH Web-GUI 插件，为接入 OpenCode Go 模型的用户提供完整用量观测。

这是什么¶

dsh-opencode-go-usage 由 yascitom 维护，许可证为 MIT。它为 DSH 用户接入 OpenCode Go 模型后提供用量观测能力：在设置侧边栏新增 OpenCode Go 栏目，内含「额度」和「DSH 会话明细」两个标签页。

Host 端提供 Typert Remote opencodeUsage，包含 usage、dshUsage、dshSessionMessages 三个方法。插件依赖标准 web bundle 组合：api-gateway Client Remote 与 settings.section slot。

核心功能¶

额度窗口¶

额度页展示 5 小时滚动、每周、每月三个窗口：

• 已用百分比
• 套餐参考限额
• 重置时间

其中 $12 / $30 / $60 限额只作展示参考，并非接口返回内容；它们随 OpenCode Go 套餐而定，可能漂移。

DSH 会话明细¶

DSH 会话明细展示 DeepSeek Harness 中每个使用 opencode-go 模型的会话 token 用量，并可下钻到每一次模型调用。

单会话下钻展示每次模型调用的时间、模型与 token 计数；长会话保留最近 400 次调用。

缓存统计¶

缓存统计在以下三个层级展示：

• 会话累计
• 单会话
• 单次调用

展示内容包含缓存读取、缓存写入，并计算缓存命中率。

模型筛选¶

插件支持按模型分组筛选会话，查看每个模型的用量与缓存情况，并附按模型汇总对比表。

双语界面¶

内置中文 / English 两套文案，可一键切换语言并持久化。

底栏常驻挂件¶

输入框下方有一行常驻挂件，实时显示额度，并按阈值自动变色。

数据新鲜度¶

额度页与底栏挂件标注最近成功更新时间；轮询失败保留最后一次成功数据并标注未更新。

诊断区块¶

诊断区块展示：

• HTTP 状态码
• 解析版本
• 凭证来源与掩码 key
• 最近 3 次请求快照

DSH 明细会标注「本地统计仅供参考」。

安装与启用¶

插件以当前 dsh 进程权限运行，安装前应检查源码与 MIT 许可证。

从 GitHub 安装：

dsh plugin --profile web add github:yascitom/dsh-opencode-go-box

从本地源码目录安装：

dsh plugin --profile web add file:/path/to/dsh-opencode-go-usage

本包声明 dsh.bundle.patch，dsh plugin add 会自动将其 reconcile 进 dsh.profile.bundles，无需手动修改 cordis.patch.yml。

安装后请重启 dsh web，让 Host 半部与托管的 Client bundle 生效。

配置¶

Host 端可调项位于插件行 id: opencode-go-usage。在 $DSH_HOME/profiles/web/cordis.patch.yml 中覆盖：

- id: opencode-go-usage
  config:
    baseUrl: https://opencode.ai/zen/go/v1/usage
    timeoutMs: 15000
    warnPercent: 60
    dangerPercent: 85
    maxSessions: 30

可覆盖配置项如下：

• baseUrl：默认 https://opencode.ai/zen/go/v1/usage
• timeoutMs：默认 15000
• warnPercent：默认 60，达到该百分比后挂件变橙
• dangerPercent：默认 85，达到该百分比后挂件变红
• maxSessions：默认 30，作为 DSH 会话明细扫描的最近会话数上限

用量接口¶

用量查询接口为：

GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <API_KEY>

该接口返回 rolling、weekly、monthly 三个窗口的 status、percent、resetsAt。

用量接口未公开文档，可能变更；解析做了防御性处理，非 200 响应会以友好状态提示而非崩溃。

适用场景与注意¶

这个插件适合在 DSH 中使用 opencode-go 模型、希望在 Web-GUI 内查看额度和会话用量的用户。

使用前注意：

• 若设置中未添加 opencode-go，或未找到 API key，插件会显示引导说明。
• API key 解析链依次为：opencode-go provider 配置声明的凭证引用、DSH 凭证层常规引用、OpenCode 的 auth.json。
• DSH 会话明细统计的是 DSH 会话日志中的 token 记账，不含花费金额，只覆盖 DeepSeek Harness 内的对话。
• 本地 token 统计与服务端计费可能存在差异，以官方账单为准。

结尾¶

dsh-opencode-go-usage 将 OpenCode Go 的额度窗口、DSH 会话 token、缓存命中率和模型维度汇总放在同一处观测。GitHub 仓库：https://github.com/yascitom/dsh-opencode-go-box。