dsh-go-quota

English | 简体中文

> 包名：@skyrocks/dsh-go-quota（GitHub 仓库名：dsh-go-quota）

在 DeepSeek Harness 的对话输入框下方，常驻显示 OpenCode GO 套餐的
5 小时 / 本周 / 本月三个额度窗口：标签 + 迷你进度条 + 百分比，悬浮看重置倒计时，点击立即刷新。

> 以上为界面示意图，实际样式跟随 DSH 主题（明 / 暗）。

为什么用它

• 一眼看完三个窗口：不用打开设置页，也不用切到 OpenCode 官网。
• 进度条 + 百分比：整条轨道代表 100%，已用部分按比例填充，剩余部分是灰色。
• 阈值变色：<80% 绿（#6bd586）、≥80% 琥珀、≥90% 红。
• 只读当前 DSH 配置里的 Key：不读 auth.json，不扫描无关环境变量，Key 永远不进浏览器。
• 零运行时依赖：没有 zod、没有原生模块，目录直装也不会缺包。
• 不干扰非 GO 模型：当前会话的 provider 不是 opencode-go 时整条隐藏。

环境要求

安装

在 DSH 桌面端安装（图形界面，推荐）

1. 打开 DSH 桌面端，进入插件管理页（设置 →「插件」）。
2. 点「添加插件」，在弹窗里粘贴：

github:skyrocks/dsh-go-quota

3. 确认安装，等待依赖解析完成。
4. 完全退出 DSH 再重新打开（macOS 用 Cmd+Q；Windows 从托盘退出）。
   只关窗口不够——Host 插件只在启动时加载。
5. 在对话里选择一个 opencode-go 的模型，输入框下方会出现
   GO 5h … · 周 … · 月 …。如果没出现，见常见问题。

安装完成后，插件列表里会显示 @skyrocks/dsh-go-quota（插件行 id 为 go-quota）。

> 从 0.1.8 及更早版本升级：先移除旧包 dsh-go-quota，再安装新的 @skyrocks/dsh-go-quota。
> 两个版本的插件行 id 都是 go-quota，同时存在会冲突。

其他安装来源

同样在「添加插件」弹窗里操作，只是粘贴的内容不同：

Windows 的目录安装请写成 file:C:\Users\you\dsh-go-quota，避免 pnpm link: 的盘符问题。
~ 和相对路径会被安装器拒绝。

从命令行安装（可选）

如果你习惯终端，CLI 和弹窗等价：

# GitHub（推荐）
dsh plugin --profile desktop add github:skyrocks/dsh-go-quota

# tarball
dsh plugin --profile desktop add /absolute/path/to/skyrocks-dsh-go-quota-0.1.9.tgz

# 本地目录（开发）
dsh plugin --profile desktop add /absolute/path/to/dsh-go-quota

> desktop 是桌面版 profile；如果你用的是 dsh web，换成 --profile web。
> 安装完成后同样要完全退出并重启 DSH。

Windows

插件本身跨平台：纯 ESM + 浏览器 bundle，没有 process.platform 分支、没有原生模块，
fetch / AbortSignal.timeout 由 Node 自带。

• 推荐用 tarball，弹窗粘贴 C:\Users\you\Downloads\skyrocks-dsh-go-quota-0.1.9.tgz。
• 目录安装请用 file:C:\...；pnpm 的 link: 目录依赖在 Windows 上有盘符问题。
• 路径必须是绝对路径。
• 装完同样要完全退出并重启 DSH。

配置

包内 cordis.patch.yml 已带默认值，通常不需要改。需要覆盖时，在
~/.dsh/profiles/desktop/cordis.patch.yml（用户层）写入同 id 的配置：

- id: go-quota
config:
baseUrl: https://opencode.ai/zen/go/v1/usage
timeoutMs: 15000   # 单次请求超时（毫秒）
cacheMs: 45000     # Host 侧缓存（毫秒）；点击刷新会绕过

改完配置需要重启 DSH。

工作原理

┌──────────────────────── 浏览器（Web GUI）────────────────────────┐
│ client.js                                                        │
│  ├─ ctx.remote.$mount({ package, descriptors })                  │
│  ├─ slots.register("conversation.composer.dock", Dock)           │
│  └─ Dock：每 5 分钟 read()，点击时 refresh()                      │
│                              │ Typert RPC（/api）                 │
└──────────────────────────────┼───────────────────────────────────┘
▼
┌──────────────────────── Host（Node）─────────────────────────────┐
│ index.js  GoQuotaGateway extends TypertRemoteService             │
│  ├─ 从 DSH 配置解析 opencode-go 的凭据引用                        │
│  ├─ ctx.credentials.resolve(ref) 取得 Key（只在 Host 内存）        │
│  ├─ GET baseUrl（Bearer，超时 + 一次重试）                         │
│  ├─ normalize：rolling / weekly / monthly                         │
│  └─ 45s 缓存 + 并发去重                                           │
│                              │                                    │
│                              ▼                                    │
│              https://opencode.ai/zen/go/v1/usage                  │
└───────────────────────────────────────────────────────────────────┘

Key 从哪来

严格只读当前 DSH 配置，按以下顺序取第一个可解析的凭据引用：

1. settings.describe() 中 id 为 opencode-go 的插件条目：apiKeyEnv，再退到 accounts[].apiKeyEnv；
2. settings.describe() 中 llm-pi-ai 条目的 providers["opencode-go"].apiKeyEnv。

每个引用交给 ctx.credentials.resolve() 解析；不读 ~/.local/share/opencode/auth.json，
不扫描无关环境变量。解析结果中的 keyRef 只是变量名（用于排查），不会返回 Key 本身。

接口与错误

• 请求：GET {baseUrl}，Authorization: Bearer，Accept: application/json。
• 兼容 { usage: {...} } 包裹与平铺两种响应，窗口字段支持 percent / used_percent、resetsAt / resets_at。
• 错误映射：

显示规则

进度条规则：

• 轨道全长 = 100%，未使用部分为灰色（半透明灰，明暗主题一致）；
• 已用部分：<80% #6bd586，≥80% #e6a23c，≥90% var(--dsw-alias-state-error-primary, #e5484d)；
• 百分比文字在阈值前使用次要文字色，达到阈值后跟随琥珀 / 红。

兼容性

• 已验证：DSH 0.2.1-rc.2（macOS 桌面版）。
• 0.2.1 契约：Typert strict codec 使用 { mode, typeSymbol, create() }；客户端 bundle 使用
  window.__ModuleLoader__.load({ id, factory })；槽位为 conversation.composer.dock。
• 不支持 0.1.x：0.1.x 的 codec 与客户端注入契约不同，装上也跑不起来。
• 0.3.x：engines.dsh 会拒绝安装；如确需尝试，可用
  dsh plugin allow-version 放行，但接口可能已变。

常见问题

开发

node test/smoke.mjs     # 8 项纯逻辑 / 契约 / CSS 回归
node --check client.js  # 浏览器 bundle 语法
pnpm pack               # 产出 tarball

本地迭代：

# 1. 以目录方式安装（link:）
dsh plugin --profile desktop add /absolute/path/to/dsh-go-quota

# 2. 修改源码

# 3. Cmd+Q 完全退出并重启 DSH

改动 package.json 的 dsh.bundle / dsh.client 声明后，需要重新执行一次 add。
CI 会在 Ubuntu / macOS / Windows 的 Node 22、24 上跑同一套测试。

项目结构

dsh-go-quota/
├── index.js            # Host 半：取 Key、请求、缓存、Remote 服务
├── config.js           # 纯函数：从 DSH 配置表单收集凭据引用
├── normalize.js        # 纯函数：用量响应规范化
├── typert.host.js      # Typert RPC 清单（零依赖校验）
├── client.js           # Client 半：lazy-CJS bundle + React UI
├── cordis.patch.yml    # 插件行（安装后自动注入 profile）
├── package.json        # 双半声明：dsh.bundle / dsh.client / exports
├── test/smoke.mjs      # 回归测试
└── docs/               # README 预览图

隐私与安全

• Key 只在 Host 进程内使用；浏览器侧只收到百分比、重置时间和引用名。
• 唯一的出站请求是 baseUrl 指向的用量接口（可通过配置替换）。
• 不读取会话日志、不上传任何本地数据、没有遥测。
• 本插件与 DeepSeek、OpenCode 均无隶属关系；用量接口未公开文档，可能随时变化。

已知限制

• 官方接口只返回账户级百分比，没有按模型 / 按设备的明细；本插件也不聚合会话日志。
• 只显示百分比，不显示剩余金额（$12 / $30 / $60 是套餐名义额度，换算容易被误读）。
• 轮询间隔 5 分钟；需要即时数据时点击刷新。
• 没有设置页；MVP 聚焦输入框下方的常驻展示。

路线图

• [ ] 设置页：三窗口环形图、按模型 token / 金额统计
• [ ] 可配置阈值与轮询间隔
• [ ] 英文 UI（当前界面文案为中文）
• [ ] Windows 实机验证与截图
• [ ] 更多 DSH 主题下的视觉回归

参与贡献

欢迎 issue 和 PR。反馈问题时请附上：

• DSH 版本与操作系统；
• 悬浮提示里的错误码；
• 脱敏后的接口响应（不要贴 Key）。

提交 PR 前请确保 node test/smoke.mjs 通过，并保持零运行时依赖。

License

MIT

> 非官方插件，与 DeepSeek、OpenCode 无隶属关系。使用前请确认你的订阅条款允许此类本地用量查询。