Copilot 配额徽标 vowa-antilamer/dsh-copilot-quota

dsh-copilot-quota

给 DeepSeek Harness web GUI 用的 GitHub Copilot 配额指示器。

DeepSeek Harness 本身没有 Copilot 配额界面：dsh-oauth-copilot 插件只存授权和账号启用的模型列表，而 harness 要等到额度已经耗尽才会反应（QUOTA / RATE_LIMIT 失败提示）。这个插件补上这块空白，在输入框那一行、发送按钮旁边显示一个实时徽标。

Copilot 200/200 ← 绿点，点击刷新

显示什么

| 元素 | 含义 |
| 圆点 | 所有计量桶中剩余百分比最差的那个：绿色，≤ 40 % 变琥珀色，≤ 15 % 变红色 |
| 数字 | chat 桶的 remaining/total（没有就退回第一个计量桶） |
| 悬停 | 登录名、套餐与 SKU、每个桶、配额重置日期、上次刷新时间 |
| 点击 | 强制刷新，绕过服务端缓存 |

没有 Copilot 授权时徽标整个隐藏，所以它绝不会凭空显示一个并不存在的计量表。报告 0 of 0 的桶同样会被丢弃——免费套餐没有 AI 额度池。

要求

- DeepSeek Harness >= 0.1.0-rc.6 < 0.3.0，配置档 web（已在 0.2.0-rc.2 上验证）。
- 已登录的 Copilot 授权：
npx -y dsh-oauth-copilot login

登录按设计只能在终端里由人操作；详见那个包的 README。
- 仅支持 github.com——不支持 GitHub Enterprise，与 dsh-oauth-copilot 保持一致。

安装

从 GitHub 安装（不用 clone，也不用构建）：

dsh plugin --profile web add github:vowa-antilamer/dsh-copilot-quota

从本地 checkout 安装：

dsh plugin --profile web add /path/to/dsh-copilot-quota

运行中的配置档会自己重组（服务端那一半立刻开始服务，客户端 bundle 也开始对外提供）；重新加载浏览器页面才会载入客户端模块。只有重新加载后徽标仍不出现，才需要重启 dsh web。

卸载：

dsh plugin --profile web remove dsh-copilot-quota

配置

可选的条目配置（配置档补丁，或 GUI 里的插件行）：

- id: copilot-quota
config:
cacheMs: 300000 # GitHub response cache, ms (0 disables caching)

工作原理

| 一半 | 文件 | 职责 |
| 服务端 | index.js | 通过 ctx.credentials 读取 llm-pi-ai/github-copilot 记录，调用 GitHub，提供 GET /copilot-quota/api |
| 客户端 | client.js | 插槽 conversation.input.right；每 2 分钟轮询一次该路由，窗口获得焦点时也轮询 |

服务端那一半请求的是 VS Code 用的同一个客户端端点：

GET https://api.github.com/copilot_internal/user
Authorization: Bearer <token>

两种响应结构都支持：quota_snapshots（当前账号）和 monthly_quotas + limited_user_quotas（较老的账号）。结果在服务端缓存（默认 5 分钟），并且刷新失败时，屏幕上会保留上一次成功读取的数据。

token 永远不会到达浏览器。 授权凭证留在 harness 凭据存储里，只有派生出的数字会经过这条路由。徽章访问的是提供页面的同一个源（/copilot-quota/api）。

不用 GUI 也能验证

curl http://127.0.0.1:3080/copilot-quota/api

限制

- copilot_internal/user 不是公开的 GitHub API。如果 GitHub 改了响应结构，徽章会在提示框里报告错误，而不是弄坏界面。
- 不支持 GitHub Enterprise（dsh-oauth-copilot 里的授权凭证白名单只接受官方端点 proxy.individual.githubcopilot.com）。
- 徽章反映的是已登录账号，不是当前选中的模型：它显示的是账号的配额，任何模型下都可见。
- 配额按定时器重新拉取，所以数字会比实际用量滞后，最多滞后一个缓存窗口。

许可证

MIT — 见 LICENSE。

俄语版：README.ru.md。