wellcover/dsh-opencodego-quota

dsh-opencodego-quota

DeepSeek Harness（DSH）Web GUI 的 OpenCode Go 额度用量插件：在页面左侧栏底部常驻一张小卡片，展示 日（近5小时）/ 周 / 月 三个窗口的额度使用进度条、已用金额 / 配额、重置时间，以及显式的刷新时间；自动刷新间隔默认 60 秒，点标题栏 ⚙（或底部秒数）在弹出的设置层里自由输入 5–3600 秒，回车或保存生效，持久化到浏览器 localStorage，卡片底部只显示当前秒数。

数据来自 OpenCode 官方用量接口 GET https://opencode.ai/zen/go/v1/usage（与官网仪表盘口径一致），非本地估算。

功能

- 📍 左侧栏常驻卡片：跟随 DSH 壳层渲染自动复位（MutationObserver 自愈），窄栏（图标栏）模式下自动隐藏
- 📊 三窗口进度条：日 · 近5小时（$12）、周 · 本周（$30）、月 · 本月（$60）
- 💰 每条显示已用百分比、已用美元 / 配额上限、重置时间（与官网一致）
- 🎨 进度条随额度渐变（v1.0.4）：填充条、圆点与百分比文字颜色随已用额度 0→100% 由绿 → 黄 → 红 平滑渐变（HSL 色相 120→0），额度越高越偏红
- ⏱️ DS 峰谷进度条（v1.0.2）：按北京时间实时显示当前计费时段——高峰 09:00–12:00、14:00–18:00（琥珀色），其余为低谷（绿色）；24 小时色带 + 当前时刻标记，显示「高峰/低谷 · 时段区间（不含已过百分比）」，每 30 秒本地刷新
- ⏱️ 刷新时间（v1.0.3）：卡片底部显示「刷新于 HH:MM:SS」与当前间隔秒数（如 60s，点击可打开设置）；标题栏 ⚙ 按钮弹出设置层，可输入 5–3600 秒，回车/保存生效、localStorage 持久化；⟳ 按钮手动刷新
- 🔑 零配置取 Key：自动从 DSH 凭据（OPENCODE_GO_API_KEY）读取，失败时回退到环境变量与 OpenCode CLI 的 auth.json
- 🔒 Key 仅经 HTTPS 发给官方接口（Authorization: Bearer + x-api-key）

安装

从 GitHub 直接安装（推荐）

dsh plugin --profile web add github:wellcover/dsh-opencodego-quota
或锁定稳定版本 tag（推荐）
dsh plugin --profile web add github:wellcover/dsh-opencodego-quota#v1.0.5

配置

无需额外配置；唯一前置条件：已配置 OpenCode Go API Key 且能在「设置 → 模型」中选择 opencode-go 提供商（当前默认 provider 即可）。

Key 解析顺序：

| 顺序 | 来源 |
| --- | --- |
| 1 | DSH 凭据 OPENCODE_GO_API_KEY（~/.dsh/.credentials.yaml） |
| 2 | 环境变量 OPENCODE_GO_API_KEY / OPENCODE_API_KEY |
| 3 | ~/.local/share/opencode/auth.json（opencode-go，回退 opencode，type: "api"） |

故障排查

| 现象 | 原因 / 处理 |
| --- | --- |
| 卡片显示「额度获取失败」 | 看工作区下 opencodego-quota-boot.log（宿主激活诊断）；确认 cordis.patch.yml 行存在且 inject 列表完整 |
| 「未找到 OpenCode Go API Key」 | 在设置 → 模型配置 API Key，或确认 ~/.dsh/.credentials.yaml 有 OPENCODE_GO_API_KEY |
| 卡片不出现 | 插件未激活或 client 未加载：确认 profile package.json 的 dsh.profile.bundles 含本包名，重启后刷新页面 |
| 窄栏图标模式下卡片隐藏 | 设计如此：侧栏 <110px 时自动隐藏，展开侧栏即恢复 |

变更记录

- v1.0.5：消除定时“刷新闪动”——数据请求期间不再整卡 loading 重建；30s 本地时钟只在分钟变化时局部替换峰谷条，不再整卡重绘。
- v1.0.4：额度进度条颜色随已用额度 0→100% 由绿渐变到红（填充条、圆点、百分比同色）。

License

MIT