前言¶
用 DeepSeek Harness（DSH）做日常开发时，ChatGPT、Gemini、Grok（Cursor）和 DeepSeek 往往分散在不同页面或客户端里查额度。插件 dsh-quota-card（维护者 bangyu888-cmd）把四家服务的剩余额度、重置倒计时和 DeepSeek 账户余额收拢到侧栏底部、登录名上方的一张卡片里，按需刷新，并在本地做阈值告警着色。
这是什么¶
dsh-quota-card 是面向 DSH Web 侧栏的额度展示插件（npm 包名 dsh-quota-card，当前版本 0.3.0，MIT 许可证）。它在浏览器里渲染 UI，由各 Provider 对应的取数逻辑在 Host 进程执行；敏感凭据不进入浏览器。社区目录页：SkillHub · dsh-quota-card；源码与说明：GitHub · bangyu888-cmd/dsh-quota-card。
展示的四个服务¶
下面表格概括卡片上的内容与数据来源（与 README 一致）。
| Provider | 展示内容 | 数据来源 | 需要的一次性准备 |
|---|---|---|---|
| ChatGPT | 每周剩余 % + 重置倒计时 | chatgpt.com/backend-api/wham/usage |
运行过 codex login，存在 ~/.codex/auth.json |
| Gemini | 每周 / 5 小时剩余 % + 重置倒计时 | Google Cloud Code retrieveUserQuotaSummary |
Antigravity 令牌：~/.gemini/antigravity-cli/antigravity-oauth-token |
| Grok Bot | 每周剩余 % + 重置倒计时 | Cursor GetSandUsageStatus |
用户级 Cursor API Key：CURSOR_API_KEY（~/.dsh/.env 或环境变量） |
| DeepSeek | 账户余额（¥） | DSH 已登录账号 deepseekAccount.getBalance() |
在 DSH 内登录 DeepSeek 账号 |
悬停某一行可查看该服务的全部时间窗口（例如 Gemini 的每周与 5 小时）。未知或失败时显示「—」，不伪造为 0。
交互与设置¶
- 自动刷新：默认每 60 秒拉取一次；页面隐藏时暂停。右上角 ↻ 可立即刷新。
- 倒计时：每秒本地走表，依据各服务真实的重置时间。
- 颜色告警：剩余 ≤ 30% 变黄、≤ 10% 变红（可在设置中调整）；DeepSeek 余额默认 ≤ ¥10 变黄、≤ ¥3 变红。
- 齿轮设置（弹层，改完即生效）：
- 按 Provider 开关显示（关闭后不再发请求）；
- 刷新间隔：30 / 60 / 120 / 300 秒；
- 百分比与余额告警阈值；
- HTTP 代理：全局默认值，并可按 Provider 覆盖；留空表示直连，例如http://127.0.0.1:7890；
- 恢复默认。
设置保存在浏览器 localStorage 键 dsh-quota-card:settings，不上传服务端；代理 URL 仅随本机取数请求发给 Host。
安全与隐私¶
- API Key、OAuth 令牌只在 Host 进程读取和使用，不进入浏览器。
- ChatGPT / Antigravity 令牌只读，不写回登录文件；Grok Bot 用 Cursor Key 换取短期访问令牌。
- 请求统一 15 秒超时，错误信息脱敏。
插件以当前 DSH 进程权限访问本机文件与环境变量；安装前应自行查看源码与 MIT 许可证，确认是否符合你的安全策略。
安装与启用¶
需要 DSH 0.2.2 及以上，且低于 0.3.0（package.json 中 engines.dsh 为 >=0.2.2-0 <0.3.0-0）；Node ≥ 20。
推荐从 npm 安装到指定 profile：
dsh plugin --profile <profile> add dsh-quota-card
若在本地开发本仓库，可用绝对路径安装：
dsh plugin --profile <profile> add /absolute/path/to/dsh-quota-card
也可以在 DSH 内打开「插件 → 发现」，搜索 dsh-quota-card 一键安装。
安装后刷新页面；若插件更新了 Host 侧代码，需重启一次 DSH。
典型用法与前置准备¶
按你实际使用的 Provider 完成下表对应项，卡片才会显示有效数字。
| Provider | 一次性准备 |
|---|---|
| ChatGPT | codex login，确认 ~/.codex/auth.json 存在 |
| Gemini | 准备好 ~/.gemini/antigravity-cli/antigravity-oauth-token；若令牌在系统钥匙串中，可先导出一次：security find-generic-password -s gemini -a antigravity-acp -w > ~/.gemini/antigravity-cli/antigravity-oauth-token |
| Grok Bot | 在 ~/.dsh/.env 或环境中设置 用户 Cursor API Key（CURSOR_API_KEY，不能是 admin:* 类 team key） |
| DeepSeek | 在 DSH 内完成 DeepSeek 账号登录 |
日常使用时打开侧栏即可扫一眼额度；阈值变色后可在齿轮里调高刷新频率或单独配置代理（例如仅 ChatGPT 走本机代理）。
已知限制与适用场景¶
- ChatGPT、Grok Bot、Gemini 依赖非公开接口，上游字段或鉴权变更时可能失效；卡片会显示可读错误，不会编造额度。
- 展示的余额与额度仅供参考，不是计费依据。
适合同时在 DSH 里编排多模型、又需要一眼确认「这周还剩多少」的开发者。若你只做单一平台、或不愿在本机存放 OAuth / API Key，可只开启 DeepSeek 余额一栏，或暂不安装。
社区插件目录 SkillHub 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；DSH 本身也遵循「一切皆插件」的扩展方式。
结尾¶
dsh-quota-card 把四家服务的额度、倒计时与 DeepSeek 余额固定在侧栏，Host 侧读凭据、浏览器侧只做展示与 localStorage 设置，并支持按 Provider 代理与阈值告警。安装命令以 README 为准：dsh plugin --profile <profile> add dsh-quota-card。
- 目录页：https://www.skillhub.cn/plugins/bangyu888-cmd/dsh-quota-card
- GitHub：https://github.com/bangyu888-cmd/dsh-quota-card
