dsh-go-usage：DeepSeek Harness 中的 OpenCode GO 订阅用量监控

在 DeepSeek Harness (DSH) 的开发环境中，直接查看 OpenCode GO 的订阅用量通常需要切换到外部控制台页面，这增加了上下文切换的开销。dsh-go-usage 插件通过在 DSH Web 界面右下角展示角标组件，将用量监控直接集成到开发流中。

插件定位¶

这是一个 DSH Web 插件，由开发者 shsr07 维护。它将 OpenCode GO 的滚动/每周/每月用量百分比与重置倒计时，以折叠式角标的形式呈现，使开发者无需离开当前页面即可掌握资源消耗情况。

核心功能¶

多维度用量展示：支持滚动、每周、每月三种用量桶，数据逻辑与 OpenCode 官方控制台保持一致。
可视化状态反馈：进度条颜色随用量变化。达到 80% 时变为琥珀色，达到 100% 时变为红色（表示触发限流）。
实时倒计时：显示重置倒计时（格式如 “Resets in X days X hours”），每 15 秒更新一次数值。
自动刷新机制：界面每 60 秒自动重新获取数据，同时也提供了手动刷新按钮。
交互与主题适配：支持收起为右边缘的竖条标签，点击即可展开；界面会跟随 DSH 的主题（浅色/深色模式）自动调整颜色。

安装与启用¶

前置要求¶

Windows 操作系统（插件通过 PowerShell 获取数据）。
Node.js >= 24 和 pnpm。
DeepSeek Harness 已安装。
本地 auth.json 中包含 opencode-go API 密钥（通常位于 %USERPROFILE%\.local\share\opencode\auth.json）。

安装步骤¶

使用 npm 包安装：

dsh plugin --profile web add dsh-go-usage

从源码安装¶

如果需要从 GitHub 源码安装或进行本地开发：

git clone https://github.com/shsr07/dsh-go-usage.git
cd dsh-go-usage
pnpm install
pnpm build
dsh plugin --profile web add link:<绝对路径>

安装完成后，重启 Web 服务：

dsh web

在浏览器中打开 DSH Web 界面，查看页面右下角。初始状态下会显示用量卡片，点击卡片上的 » 按钮可将其收起为右边缘的竖条标签。

配置说明¶

插件提供可选配置项，位于 cordis.patch.yml 中的插件行内。默认配置通常可直接使用，如需自定义可添加 config: 块：

- id: go-usage
  name: 'dsh-go-usage'
  config:
    authJsonPath: 'C:\Users\me\.local\share\opencode\auth.json'
    apiUrl: 'https://opencode.ai/zen/go/v1/usage'
    powershellExe: 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
    timeoutSec: 15

配置项	类型	默认值	说明
`authJsonPath`	string	`$USERPROFILE/.local/share/opencode/auth.json`	本地 opencode 认证文件路径。
`apiUrl`	string	`https://opencode.ai/zen/go/v1/usage`	OpenCode GO 用量 API 端点。
`powershellExe`	string	`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`	用于获取数据的 PowerShell 执行路径。
`timeoutSec`	number	`15`	API 请求超时时间（秒）。

注意事项¶

平台限制：目前仅支持 Windows 系统。
隐私安全：API 密钥仅在本地读取，从机器上的 auth.json 中提取，不会发送至其他服务器。发送至 opencode.ai 的仅包含用量百分比和重置时间戳。
许可证：遵循 MIT 许可证，建议安装前检查源码。

总结¶

dsh-go-usage 通过将 OpenCode GO 的用量监控无缝集成到 DSH 的日常开发流中，提供了直观的视觉反馈和便捷的折叠交互。对于依赖 OpenCode GO 订阅进行开发或测试的用户，这是一个实用的工具。

项目主页：https://github.com/shsr07/dsh-go-usage
插件目录：https://www.skillhub.cn/plugins/shsr07/dsh-go-usage