Go Meter — DSH 的 OpenCode Go 剩余额度实时小窗
产品名 Go Meter;npm 包名 / 仓库名 @deepseek-ai/dsh-opencode-go-usage。介绍文案见 GITHUB_INTRO.md。
当当前会话使用的模型来自 OpenCode Go 订阅时,在 DSH Web 界面右侧边缘显示一个常驻小窗,实时展示三个配额窗口的剩余额度:
- 5h 滚动(rolling):最近 5 小时滚动窗口
- 本周(weekly):自然周
- 本月(monthly):自然月/订阅周期
每行显示「剩余百分比 + 重置倒计时」,行下为绿色进度条(自左向右表示剩余比例);剩余 ≤30% 转橙,≤10% 转红。模型切换到其他 provider 时小窗自动隐藏。
特性
- 📍 右侧浮层小窗(
shell.overlay 官方加性席位),不遮挡任何列;可折叠为小徽章「Go 剩 xx%」
- 🔄 自动刷新(默认 30s,可配 15/60/120s;会话切换、重连、切回前台时立即刷新)
- ⚙️ 设置页可配:启用开关、provider id、刷新间隔、显示的窗口、默认折叠
- 🔐 代理式数据通路:插件服务端半区经 DSH
credentials 服务解析 API key,调 OpenCode 官方 GET https://opencode.ai/zen/go/v1/usage;key 永不进入浏览器、不写日志
- 🛡️ 错误兜底:key 未配置 / 鉴权失败 / 未绑定订阅均给出可见错误并可重试;连续失败保留旧数据并标记「数据过期」
界面
- 小窗:右上角小卡片,标题 + 当前模型名 + 三窗口行(剩余% + 倒计时,行下进度条)+「更新于 HH:MM:SS」
- 折叠态:右侧小圆点徽章「Go 剩 xx%」,点击展开
- 设置:「设置 → OpenCode Go 额度」
安装(官方方式)
前置:dsh 已安装且目标 profile(默认 web)在运行。本插件通过官方的 dsh plugin add 安装(dsh plugin 是 pnpm 的薄转发层);包内声明了 dsh.bundle.patch(自带 cordis.patch.yml),因此 plugin add 一步即可完成安装,无需手动编辑任何 profile 配置。
# 方式一:仓库脚本(自动 npm pack + dsh plugin add)
bash install.sh
# 方式二:手动执行官方命令
npm pack -y # 产物 deepseek-ai-dsh-opencode-go-usage-<ver>.tgz
dsh --profile web plugin add ./deepseek-ai-dsh-opencode-go-usage-<ver>.tgz
安装成功后重启 dsh(让 profile 重新组合 bundle 层),刷新浏览器即可看到小窗。
验证
重启并刷新页面后:
数据来源与口径
- 上游:OpenCode 官方(未文档化)用量接口
GET https://opencode.ai/zen/go/v1/usage,鉴权 Authorization: Bearer <key>(另带 x-api-key);返回三个窗口 {status, percent, resetsAt},percent 为已用百分比,小窗显示剩余 = 100 − percent。
- 接口由社区经 cc-switch#6433(2026-08-13) 公开,OpenCodeMonitor 等项目生产使用;未写入官方文档,若上游变更地址,改
lib/index.js 顶部 USAGE_URL 常量即可。
- Provider 识别:DSH settings 中 id 为
opencode-go 的 provider,或自定义 provider 的 baseURL 含 opencode.ai/zen;取其 apiKeyEnv 指向的凭据(dsh-credentials 解析,支持 env/文件)。
- 服务端 15s 缓存 + 单飞去重,轮询不会打爆上游。
卸载(官方方式)
dsh --profile web plugin remove @deepseek-ai/dsh-opencode-go-usage
随后重启 dsh 并刷新页面;plugin remove 会自动把本插件从 dsh.profile.bundles 层移除(不再加载),无需手动清理配置。
打包与发布
npm pack # 产物 deepseek-ai-dsh-opencode-go-usage-<ver>.tgz(已被 .gitignore 排除,不入库)
发布到 npm 前把 package.json 的 "private": true 去掉;GitHub 仓库发布无需改动。
License
MIT
