前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的设计，将各种功能封装为可独立安装/卸载的模块。在开发智能体或管理多个套餐时，开发者常需要在 DSH 的设置页中快速查看 OpenCode 的额度与重置情况。opencode-usage-dsh 插件正是为这个需求提供了解决方案：它把 opencode.ai 的套餐用量（5 小时滚动、每周、每月）以及剩余百分比和重置倒计时，渲染成 DSH 设置页中的一个卡片。

是什么¶

opencode-usage-dsh 是一个运行在 DSH 客户端的插件，由用户 yal3ay 维护。它通过 Host 进程定时轮询 opencode 官方额度接口，再由浏览器端使用官方的 settings.section 插槽渲染出一个设置页。API key 仅在 Host 进程内使用，不会经过任何 RPC 传输，因此凭证在 Host 端解析，只有百分比、重置时间和模型 ID 等信息会通过 Remote 传递给浏览器。

核心功能¶

• 三档额度：rolling（5 小时滚动）、weekly、monthly，显示剩余百分比、重置倒计时与进度条。
• 套餐模型数量：同时读取 GET <base>/v1/models，显示当前套餐可用的模型数量。
• 自动更新：Host 端每 30 秒轮询一次额度接口，倒计时也每 30 秒自行刷新。
• 手动刷新：卡片右上角的「刷新」按钮会先叫 Host 立即重读，再取快照。
• 主题相容：全部使用行内样式与 rgba(128,128,128,…) 中性色，深色与浅色主题均可读。
• 凭证安全：key 由 ctx.credentials 在 Host 端解析，仅百分比 / 重置时间 / 模型 id 会通过 Remote 传递。

前置条件¶

• DeepSeek Harness 0.2.0-rc.2（Desktop 或 Web profile）。
• 已配置 OpenCode 憑证，二选一：
• profile 的 llm-pi-ai.providers 中有一个 opencode 系 provider（id 为 opencode 或 opencode-go，或 apiKeyEnv 以 OPENCODE 开头，或 baseURL 包含 opencode.ai）；或
• 直接在 DSH 凭证中填写 OPENCODE_GO_API_KEY（或 OPENCODE_API_KEY）。
• 本机能连接到 https://opencode.ai。

安装与启用¶

从 GitHub 直接安装（最省事，日后可执行 dsh plugin update）：

dsh plugin --profile <profile> add github:yal3ay/opencode-usage-dsh

安装后，插件会自动把 opencode-usage-dsh 加入 profile 的 dsh.profile.bundles，并插入宿主插件条目（cordis.patch.yml）。安装完成后，重启该 profile（没有开启 HMR 时），重新加载页面，打开 设定 → OpenCode 用量 即可看到用量卡片。

若不想修改 bundle 清单，也可以仅将下面两行添加到 profile 的 ~/.dsh/profiles/<name>/cordis.patch.yml：

- insert:
    - id: opencode-usage-dsh
      name: 'opencode-usage-dsh'

典型用法¶

在 profile 的 cordis.patch.yml 中配置一个 opencode provider 示例（仅作示例，实际配置以你的 profile 为准）：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      opencode-go:
        apiKeyEnv: OPENCODE_GO_API_KEY
        models:
          - id: deepseek-v4-flash-vision-exp
            name: DeepSeek V4 Flash Vision Exp

安装插件后，DSH 会自动在设置页注入 opencodeUsage Remote 命名空间，Host 端每 30 秒轮询一次额度接口，浏览器端通过 namespace.snapshot() 获取快照并渲染进度条与倒计时。

适用场景与注意¶

• 适合需要在 DSH 设置页中持续监控 OpenCode 套餐使用情况（滚动、每周、每月）的开发者或团队。
• 插件以当前 DSH 进程的权限运行，安装前建议查看源码与许可证（MIT）。
• 官方接口仅返回百分比，不提供金额明细，因此「还差多少钱」无法从 API 获取。
• 目前仅读取 opencode 官方的 Zen / Go 端点，若自建或改写的网关缺少 /v1/usage，会显示错误。
• 此插件为社区外挂，非 DeepSeek 官方维护。

短结尾¶

opencode-usage-dsh 将 OpenCode 的三档额度与重置倒计时集成到 DSH 设置页中，无需切换页面即可查看剩余情况。它通过 Host 端轮询与 Remote 通信，实现了安全且自动更新的用量展示。如需安装或查看更多细节，可访问插件目录页或 GitHub 仓库。

参考资料¶

• GitHub 仓库：https://github.com/yal3ay/opencode-usage-dsh
• 插件目录页：https://www.skillhub.cn/plugins/yal3ay/opencode-usage-dsh