dsh-ocgo-usage

dsh-ocgo-usage

在 DeepSeek Harness Web 侧边栏左下角显示 OpenCode Go 用量的插件。

Show your OpenCode Go usage in the DeepSeek Harness web sidebar's bottom-left corner.

功能 / Features

• 左下角常驻按钮（与设置按钮同列同款）：仪表盘图标 + 本月剩余用量百分比，剩余 ≤20% 变橙、≤0 变红
• 悬停展开明细卡片（向上弹出）：滚动 / 本周 / 本月三条用量进度 + 已用百分比 + 重置时间
• 数据每 60 秒自动刷新
• 零配置：自动读取 DSH 供应商配置中的 opencode-go API key（~/.dsh/.ocg-state.json → ~/.dsh/.credentials.yaml → 环境变量）
• 零构建：Client 端为手写 __ModuleLoader__ bundle，Host 端为纯 Node ESM

安装 / Install

dsh plugin --profile web add @badai147/dsh-ocgo-usage

从 GitHub 源安装（备选）：

dsh plugin --profile web add github:badai147/dsh-ocgo-usage

重启 dsh web，左下角（设置按钮旁）即可看到「Go 用量」按钮。

💡 安装后重启 dsh web 生效；自 0.1.1 起为纯 Node 实现，无需系统安装 python3。

使用 / Usage

1. 在 DSH 设置中配置 opencode-go 供应商（含 API key）——插件自动读取，无需额外配置
2. 悬停左下角「Go 用量」按钮查看明细
3. 常驻角标显示本月剩余用量百分比（如本月已用 5% 则显示 95% (本月)）

工作原理 / How it works

• Host（lib/index.js）：注册 DSH web server 路由 GET /api/ocgo-usage，按序读取 DSH 供应商配置中的 opencode-go API key，代理请求 https://opencode.ai/zen/go/v1/usage；key 只在本机处理，不下发浏览器
• Client（lib/client.js）：手写 window.__ModuleLoader__.load bundle，注册 sidebar.footer.action 按钮 + shell.overlay 悬浮卡片，通过本地路由取数
• 刷新：激活即拉取，之后每 60 秒自动刷新
• 跨平台：Host 用 Node 内置 https 直接发请求，不依赖 shell 与 python，Windows / macOS / Linux 均可用

目录结构 / Structure

dsh-ocgo-usage/
├── cordis.patch.yml   # bundle patch：插入 ocgo-usage 插件行
├── lib/
│   ├── index.js       # Host：/api/ocgo-usage 代理路由（Node ESM）
│   └── client.js      # Client：按钮 + 悬浮卡片 UI（__ModuleLoader__ bundle）
└── package.json

更新日志 / Changelog

• 0.1.1：改用 Node 内置 https 取数（不再依赖 shell/python，修复 Windows 沙箱报错）；角标改显本月剩余用量（带 (本月) 后缀）
• 0.1.0：初版，左下角用量按钮 + 悬停明细卡片，每 60 秒刷新

FAQ

为什么 Windows 上会报 sandbox 错误？ 0.1.0 用 ctx.shell 跑 python 脚本取数，会触发 shell 沙箱检查；Windows 上可用的后端要求 ACL 临时目录位于 workspace 之外，不满足即拒绝执行。0.1.1 改用 Node 内置 https 直接请求，不再依赖 shell 与 python，Windows / macOS / Linux 均正常。

升级后仍是旧版？ pnpm 可能命中旧的 lockfile。显式指定版本重装即可：dsh plugin --profile web add @badai147/dsh-ocgo-usage@0.1.1，重启 dsh web 生效。

License

MIT