前言¶

在 DeepSeek Harness 里跑智能体、对接 OpenCode Go 时，订阅额度往往要另开控制台或查文档才能对齐「5 小时滚动 / 每周 / 每月」还剩多少。官方底栏已有会话统计、Token 用量等药丸，但不会直接展示 OpenCode Go 的三段额度比例。

社区插件 dsh-opencode-quota（仓库内包名 dsh-opencode-quota-full）把 OpenCode Go 的已用百分比挂进 conversation.composer.dock 同一行，不另占一条状态栏，也不把 API key 下发到浏览器。下面介绍它的定位、安装与配置。

这是什么¶

一句话：在 Harness 输入框下方官方状态行最左侧增加一个药丸，显示 5 小时（rolling）/ 每周 / 每月 的已用百分比；点击可展开详情浮层。

核心功能¶

底栏展示与交互（均来自仓库 README）：

• 药丸示例文案形态：◔ 5小时 3% · 每周 1% · 每月 0%
• 百分比为已用比例；颜色：绿 < 60%、黄 < 85%、红 ≥ 85%
• 点击药丸展开 StatDialog 风格浮层：各窗口已用 %、剩余 %、重置时间、进度条
• 浮层可「刷新」、或跳转 OpenCode Console；Esc 或点击外部关闭
• 每 60 秒自动刷新，页面重新可见时立即刷新；样式使用宿主主题 token，浅色 / 深色适配

数据与安全：

• 浏览器通过同源 GET /opencode-quota/stats 拉取（带 Harness 登录 cookie）
• Host 半在进程内解析 OPENCODE_GO_API_KEY，再请求 https://opencode.ai/inference/go/v1/usage；API key 不进入浏览器
• 成功结果 Host 内缓存 30 秒（可配置），并发合并为一次上游调用；失败不缓存
• 上游只返回百分比，插件不做美元换算

上游 usage 中 rolling 对应 5 小时滚动窗口，weekly / monthly 分别为每周、每月。

插件以最小 order 并入官方 dock，不遮挡聊天区；仅在带 Web 服务的 profile（desktop / web）生效。

安装与启用¶

插件是 DSH bundle（dsh.bundle.patch + dsh.client），仓库根目录即包目录，无构建步骤。

从 GitHub 安装：

dsh plugin --profile desktop add github:wang-yzh/dsh-opencode-quota

若本地已有源码目录，可同时为 desktop / web 添加：

dsh plugin --profile desktop add /path/to/dsh-opencode-quota-full
dsh plugin --profile web add /path/to/dsh-opencode-quota-full

也可在 Harness 设置 → 插件 中用插件管理器安装本地目录或仓库地址。

安装后需要刷新页面，以便浏览器 bundle 重新发布。

卸载并重装示例（开发调试用）：

dsh plugin --profile desktop remove dsh-opencode-quota-full
dsh plugin --profile desktop add /path/to/dsh-opencode-quota-full

说明：package.json 中声明与 DeepSeek Harness 0.2.2-rc.1 兼容；README 记载在该版本 Windows + 官方 desktop profile 上完成验证。

配置¶

在 profile 的 cordis.patch.yml 中可选覆盖 opencode-quota 条目：

- id: opencode-quota
  config:
    credentialRef: OPENCODE_GO_API_KEY
    apiBaseUrl: https://opencode.ai/inference/go/v1
    cacheMs: 30000

凭据写入 ~/.dsh/.credentials.yaml，或通过 设置 → 模型 / 凭据：

OPENCODE_GO_API_KEY: oc_sk_...

cacheMs 最小 1000（毫秒）。

典型用法¶

1. 按上一节安装插件并配置 OPENCODE_GO_API_KEY。
2. 刷新 Harness 页面，进入已有会话（底栏 dock 与官方药丸一样，新建会话首屏可能不显示）。
3. 看状态行最左侧药丸上的三段百分比；颜色反映已用比例是否接近上限。
4. 点击药丸查看各窗口剩余 % 与 resetsAt；需要即时数据时点「刷新」。

未登录访问 /opencode-quota/stats 会返回 401；凭据错误或上游失败时，失败结果不会被 Host 缓存。

适用场景与注意¶

适合谁：在 Harness desktop / web 里长期使用 OpenCode Go，希望在写 prompt 时一眼看到三段额度，而不是频繁切到控制台。

限制（README 已知）：

• headless profile 不注册路由
• 官方接口无金额字段，插件不提供金额换算
• 上游若只返回部分窗口，界面只渲染已返回项，不整体报错

安全与权限：插件 Host 半在 当前 DSH 进程权限 下运行，并会代表你调用 OpenCode 用量 API。安装前建议阅读仓库源码与 LICENSE（Host 查询结构参考 dsh-plugin-opencode-usage）。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-opencode-quota 把 OpenCode Go 的 5 小时 / 每周 / 每月已用百分比嵌入 Harness 官方底栏，API key 留在 Host，浏览器只拿百分比。需要进一步细节或提 issue，见 GitHub：https://github.com/wang-yzh/dsh-opencode-quota ；目录收录：https://www.skillhub.cn/plugins/wang-yzh/dsh-opencode-quota 。