前言¶
在 DSH Web 里使用 OpenCode Go 时，用量通常需要离开当前界面去外部接口查看。dsh-ocgo-usage 把这件事做成了 DSH 插件：在 Web 侧边栏左下角显示常驻用量角标，悬停后展开用量明细和高峰时段时间轴。
DSH 采用「一切皆插件」的扩展方式。相关社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，本文按已核实的插件资料介绍。
这是什么¶
badai147/dsh-ocgo-usage 是一个 DSH Web 插件，维护者为 badai147。它的作用是在 DeepSeek Harness Web 侧边栏左下角显示 OpenCode Go 用量。
已核实资料中，许可证为 MIT。截至 2026-09-01，资料中 package.json 版本为 0.2.0。
核心功能¶
常驻角标¶
左下角有一个常驻按钮，与设置按钮同列同款。角标显示仪表盘图标和本月剩余用量百分比。
状态颜色如下：
剩余 ≤20%：橙色
剩余 ≤0：红色
悬停明细卡片¶
悬停左下角「Go 用量」按钮后，会向上弹出明细卡片。卡片中包括：
DeepSeek 高峰时段时间轴（北京时间）
滚动 / 本周 / 本月三条用量进度
已用百分比
重置时间
高峰时段时间轴¶
高峰时段按北京时间展示。DeepSeek V4 Flash / Pro 的高峰时段为：
09:00-12:00
14:00-18:00
对应 UTC 时间为：
01:00-04:00
06:00-10:00
时间轴会高亮当前时刻所处区间，并显示距下一切换点的剩余时间。
数据刷新¶
激活后会先拉取一次用量，之后每 60 秒自动刷新。
读取 API key¶
插件自动读取 DSH 供应商配置中的 opencode-go API key，无需额外配置。读取顺序如下：
~/.dsh/.ocg-state.json → ~/.dsh/.credentials.yaml → 环境变量
运行方式¶
Host 端注册一条 DSH web server 路由，用于给 Client 提供用量数据：
GET /api/ocgo-usage
该路由会代理请求到 OpenCode Go 的用量接口：
https://opencode.ai/zen/go/v1/usage
Client 端注册两个 UI 位置：
sidebar.footer.action
shell.overlay
Client 端为手写 __ModuleLoader__ bundle，Host 端为纯 Node ESM。跨平台支持 Windows / macOS / Linux。
安装与启用¶
先安装插件，再重启 dsh web 生效。
执行以下安装命令：
dsh plugin --profile web add @badai147/dsh-ocgo-usage
如果升级后仍是旧版，可以显式指定版本重装：
dsh plugin --profile web add @badai147/dsh-ocgo-usage@0.1.1
经过上面的步骤后，重启 dsh web，侧边栏左下角应能看到「Go 用量」按钮。
典型用法¶
1、在 DSH 设置中配置 opencode-go 供应商，包含 API key。插件会自动读取，无需额外配置。
2、重启 dsh web。
3、悬停左下角「Go 用量」按钮查看明细。
4、常驻角标会显示本月剩余用量百分比。例如本月已用 5% 时，显示：
95% (本月)
5、在悬停卡片中查看高峰时段。当前时刻会落在高峰或非高峰区间中，并显示距下一切换点的剩余时间。
适用场景与注意¶
适合以下场景：
- 需要在 DSH Web 中频繁查看 OpenCode Go 用量。
- 需要按北京时间判断 DeepSeek V4 Flash / Pro 高峰时段。
- 不想每次手动打开外部用量接口。
使用前注意：
- 插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证。
- opencode-go API key 只在本机处理，不下发浏览器。
- 自动读取顺序为：
~/.dsh/.ocg-state.json → ~/.dsh/.credentials.yaml → 环境变量
- 自 0.1.1 起为纯 Node 实现，无需系统安装 python3。
- 0.1.0 在 Windows 上可能触发 shell 沙箱检查；0.1.1 改用 Node 内置 https 后，Windows / macOS / Linux 均正常。
参考¶
- GitHub：https://github.com/badai147/dsh-ocgo-usage
- 目录页：已核实资料中未给出可确认的目录页 URL；如需使用，请以插件来源页面提供的链接为准。
