前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的架构。在使用 OpenCode Go 进行开发时，频繁切换浏览器查看订阅配额与花费会打断工作流。willwhi/dsh-opencode-go-meter 插件将 OpenCode Go 的用量监控（5小时滚动/每周/每月）与真实花费金额直接集成到对话输入区，并在弹窗内提供登录与凭据配置功能，无需接触终端或修改代码。

插件定位¶

这是一个 DeepSeek Harness（dsh）Web 界面插件，由 willwhi 维护，采用 MIT 协议。它解决了在本地开发时查看 OpenCode Go 订阅状态和成本的需求。

核心功能¶

• 用量与花费监控：显示 5小时滚动窗口、每周、每月三个维度的订阅使用量（百分比）与重置倒计时，并直接显示本月真实花费（美元）。
• 数据来源：支持双数据源自动回退，优先使用官方配额 API，失败时自动回退至仪表盘 SSR 数据。
• 凭据安全：API Key 和 Cookie 仅在 Host 进程中使用，浏览器只读取同源 JSON 端点，不会发送给浏览器或记录日志。
• 开箱即用：未配置时显示 <noconfig>，点击按钮即可弹出登录表单进行配置。
• 轻量级设计：前端 30 秒轮询，Host 端 60 秒缓存及失败冷却机制。

安装与启用¶

安装命令

dsh plugin --profile web add dsh-opencode-go-meter

前置要求
* DeepSeek Harness (web profile) 版本需在 0.1.0-rc.6 或更高。
* 系统环境变量 PATH 中需包含 pnpm（插件依赖）。
生效步骤
1. 执行上述安装命令。
2. 重启 dsh web 进程（结束当前进程并重新启动）。
3. 在浏览器中强制刷新页面（Ctrl+Shift+R）。

使用方式¶

• 查看摘要：在对话输入区下方，可以看到三个窗口的使用率百分比及本月花费。
• 查看详情：点击输入框内的「Go 用量」按钮，弹出详情窗口，包含进度条、重置倒计时及按天费用明细柱状图。
• 刷新与更新：弹窗右下角提供手动刷新功能；如需更新凭据，点击弹窗内的「登录」即可。

注意事项¶

• 卸载残留：执行卸载命令不会删除 ~/.dsh/opencode-go-meter.json 和 auth.json，凭据保留在本地。
• 权限安全：插件读取的 auth cookie 是完整的 OpenCode 用户会话，仅用于 Host 侧抓取数据，绝不发送给浏览器或写入日志。
• 适用范围：本插件仅适用于 DSH 的 Web Profile，需确保本地已安装 OpenCode Go CLI（可选，若已安装可自动读取 Key）。

总结¶

该插件通过在 DSH 界面内集成监控，简化了资源管理流程。更多细节可参考 GitHub 仓库 或 社区目录。