前言¶

用 DeepSeek Harness 做智能体开发时，如果同时订阅了 OpenCode Go，5 小时滚动限额、周限额和月限额往往要到 OpenCode Console 页面才能看清。窗口里开着 Harness，又要切浏览器查用量，节奏容易被打断。下面介绍社区插件 dsh-opencodego-status：在 Harness Web UI 上挂一个浮动 overlay，把三类限额百分比和重置信息放在同一界面里。

这是什么¶

dsh-opencodego-status（GitHub：Assidefok/dsh-opencodego-status）由维护者 Assidefok 发布，分类为客户端插件。它在 DeepSeek Harness Web UI 上提供浮动层，展示 OpenCode Go 订阅的 5 小时滚动限额、周限额和月限额。数据来自 OpenCode Console Go 订阅计量，与 Console 页面同源。

核心功能¶

README 中列出的能力如下，均可对照仓库文档核实。

• 收起态药丸（pill）：角落显示 5h · 7d · 30d 三类用量百分比；每个限额旁有颜色点，用量从 60% 起偏警告色、80% 起偏错误色；并显示周限额重置倒计时。
• 展开卡片：每个限额一条进度条、resets in / renews in 倒计时、Refresh、Sign out，以及指向 OpenCode console 的链接。
• 设备码登录：在 overlay 内发起连接；短码显示在卡片上，在浏览器中批准设备，不在 overlay 里输入密码。
• 静默刷新 token：本地会话在过期前自动刷新。
• 中英文界面：跟随 Harness 的 locale 服务。
• 主题适配：颜色与边框使用 Harness 主题 token，明暗主题与宿主一致。

未保存 OpenCode 会话时显示 Not connected；订阅缺失或 API 变更时进入错误状态。

环境与依赖¶

• DeepSeek Harness Web UI 0.2.x。
• 有效的 OpenCode Go 订阅；overlay 读取 Go 套餐计量。

安装与启用¶

在终端执行官方安装命令（来自 README）：

dsh plugin --profile web add github:Assidefok/dsh-opencodego-status

安装后刷新 Harness Web UI，窗口右上角会出现小药丸。

插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证，确认行为符合预期。

连接 OpenCode¶

1. 点击药丸，再点 Connect。
2. 卡片显示短码（例如 GNNM-XQHS）和 Open approval page；在浏览器中批准设备。
3. Console 确认后，overlay 即显示实时用量。

会话保存在 $DSH_HOME/opencodego-status/state.json（权限 0600；$DSH_HOME 默认为 ~/.dsh）。卡片内 Sign out 会删除该文件。Token 仅发往 opencode.ai，浏览器端 overlay 不持有 access token。

配置¶

在 Harness profile 的 cordis.patch.yml 中，对应 bundle 行可写：

- id: opencodego-status
  name: dsh-opencodego-status
  config:
    enabled: true        # hide the overlay without uninstalling the bundle
    position: top-right  # top-right | top-left | bottom-right | bottom-left
    refreshSeconds: 60   # 15 – 3600
    showResets: true     # show reset countdowns

enabled: false 可隐藏 overlay 而不卸载 bundle；refreshSeconds 取值范围为 15–3600。

工作原理（简述）¶

• 宿主侧（index.js）注册前缀路由 /api/opencodego-status，与 OpenCode Console 通信：设备授权与刷新（/console/auth/device/code、/console/auth/device/token）以及 /console/api/go/status。
• 客户端（client.js）在 shell.overlay 槽位注册一项，轮询 /api/opencodego-status/status，不接触 access token。
• 无额外依赖、无构建步骤；客户端为纯 JavaScript，React 来自 Harness 浏览器模块表。

README 注明：Console 相关端点并非公开文档 API；若 OpenCode 变更接口，overlay 会降级为带 Retry 的错误状态，而不是拖垮整个 Web UI。

适用场景与注意¶

适合经常在 Harness Web UI 里开发、又需要盯 OpenCode Go 三类限额的用户。社区插件目录（如 SkillHub 上的条目）为独立生态站点，与 DeepSeek / 幻方无官方从属关系。

安装命令、配置字段与行为以 GitHub 仓库为准：https://github.com/Assidefok/dsh-opencodego-status。