前言¶
在 DeepSeek Harness（DSH）里切换模型、跑长会话时，真正卡住你的往往不是「能不能连上」，而是「这条订阅还剩多少」。各家厂商的额度窗口不同（日 / 周 / 月），有的走 API Key，有的走 OAuth，DeepSeek 官方账号又是平台钱包而不是简单的百分比。要逐个打开控制台或翻文档，和「在 composer 里连续写代码」的节奏是错位的。
下面介绍社区插件 dsh-quota-pill：在 DSH Web 界面 composer 工具栏旁放一个可折叠的「药丸」控件，汇总你已配置的多路 LLM 订阅剩余情况；维护者为 GitHub 用户 598934321，npm 包名为 @hystudio/dsh-quota-pill（与仓库 598934321/dsh-quota-pill 为同一作者的不同账号名），分类为 admin-security，许可证 MIT（见 package.json）。
这是什么¶
dsh-quota-pill 是面向 DeepSeek Harness Web GUI 的额度展示插件：在输入区旁显示最紧的那一个额度窗口，展开后可按服务商查看分项与重置时间。切换会话或模型时，控件会跟随当前路由到的服务商，先展示该服务商的上次读数并在后台刷新，再过渡到实时数值。
插件本身不跑 OAuth，也不把凭据送进浏览器；额度查询由本机 sidecar 进程完成（见下文架构）。
核心功能¶
展示与交互¶
- 药丸位于 composer 工具栏，默认突出「最紧」窗口的剩余比例或等价信息。
- 展开后按服务商列出明细，包含窗口类型与
resetAt。 - 仅列出 DSH 的
session/modelCatalog中实际可路由的服务商；从 DSH 移除某服务商后，药丸列表同步消失。已出现但无凭据的服务商会被跳过，而不是显示空行。
支持的服务商与凭据来源¶
| 服务商 | 凭据 |
|---|---|
| DeepSeek（官方） | DSH 已保存的 Platform 登录态，无需额外配置 |
| Kimi Coding | refs.KIMI_CODING_API_KEY（~/.dsh/.credentials.yaml） |
| OpenCode Go | refs.OPENCODE_GO_API_KEY |
| Command Code | refs.COMMANDCODE_API_KEY |
| xAI (Grok) | CLIProxyAPI 中的 OAuth token |
| Codex (ChatGPT Plus) | 同上；且 CLIProxyAPI 必须正在运行 |
| Antigravity | 同上 |
| Open Design（可选） | refs.OPENDESIGN_SESSION_COOKIE（云控制台 session cookie） |
已在 DSH 登录 DeepSeek Platform 时，DeepSeek 一行即可工作。三个 API Key 类服务商只需写入 key。三个 OAuth 类依赖 CLIProxyAPI 安装并登录；插件只读取 token，不自行发起 OAuth。
本机 sidecar 与 HTTP 接口¶
架构上分为两段：浏览器里的 client.js 只负责渲染；凭据读取与上游调用在 127.0.0.1 上的 sidecar 完成，结果缓存约 60 秒。
| 路径 | 作用 |
|---|---|
GET /health |
存活检查与服务商列表 |
GET /quota?model=<id> |
按模型前缀选一家服务商的读数 |
GET /quota/all |
并发查询全部已配置服务商 |
GET /setup |
各服务商仍缺什么配置 |
查询参数 ?fresh=1 可绕过 60 秒缓存。响应字段包含 kind（如 subscription-quota、payg、none、probe-failed）、remainingPct、window、resetAt、windows 等，便于 UI 区分「有上限订阅」「按量计费」「未配置」「探测失败」等情况。
若干服务商的实现要点（摘自上游说明）¶
- DeepSeek：预付 CNY 钱包，药丸展示余额与赠送额度，而非百分比；余额经 DSH 自有
account/getBalanceRPC 读取，插件不直接持有 Platform token。 - Codex：优先经 CLIProxyAPI 管理 API 读取代理流量中观察到的
X-Codex-*头；CLIProxyAPI 须保持运行。 - Antigravity：多 Gemini 模型共享同一额度池，因此只报一条汇总。
- Open Design：需从浏览器开发者工具取得 HttpOnly session cookie，并写入
refs.OPENDESIGN_SESSION_COOKIE。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。运行 sidecar 需要 Node.js >= 18。
1. 安装 DSH 插件¶
dsh plugin add @hystudio/dsh-quota-pill
2. 启动 sidecar¶
npx @hystudio/dsh-quota-pill
在 sidecar 未启动时，药丸会显示 “quota service is not running”，并提示上述命令。npx 随终端退出而结束，长期使用时宜按 README 配置为后台服务（macOS launchd 或 Linux systemd user unit，执行 bin/quota-pill-server.js 的绝对路径）。
3. 按需写入 API Key¶
# ~/.dsh/.credentials.yaml
refs:
KIMI_CODING_API_KEY: sk-...
OPENCODE_GO_API_KEY: sk-...
COMMANDCODE_API_KEY: sk-...
OAuth 类服务商按 README 配置 CLIProxyAPI；Open Design 按需增加 OPENDESIGN_SESSION_COOKIE。
4. 重载 DSH 窗口¶
保存凭据并确认 sidecar 监听本机后，重载 DSH Web 窗口即可。
典型用法¶
人工安装后的日常¶
- 保持
npx @hystudio/dsh-quota-pill（或等价 systemd / launchd 服务）在后台运行。 - 在 composer 旁查看药丸上的「最紧」窗口；需要分项时展开列表。
- 切换模型或会话时观察对应服务商读数是否随
GET /quota?model=...更新；需要立刻刷新时可依赖 sidecar 的?fresh=1行为（由客户端在需要时发起）。
交给智能体按文档安装¶
仓库提供 AGENTS.md，供 AI 智能体按步骤检测现有环境、只询问无法推断的 key、写入凭据并逐家验证。可对智能体发送例如：
Read AGENTS.md in this repo and set up dsh-quota-pill for me.
适用场景与注意¶
适合谁：同时在 DSH 里接多条订阅或 API（官方 DeepSeek、Kimi Coding、OpenCode Go、经 CLIProxyAPI 的 Codex / xAI / Antigravity 等），希望在写 prompt 的同一界面看到剩余额度与重置时间，而不是反复打开各厂商控制台。
隐私与边界（据 README「Privacy」）：凭据从磁盘读取、仅用于上游查询且不写入日志；sidecar 只绑定 127.0.0.1；除各服务商自己的额度接口外不向第三方发送数据。
生态说明：DSH 奉行「一切皆插件」；SkillHub 目录页 为社区收录站点，与 DeepSeek / 幻方无官方从属关系。安装社区插件前请习惯核对源码、权限与许可证。
结尾¶
经过上面的步骤，你可以在 DSH composer 旁用一颗药丸汇总「各路订阅还剩多少」，并把凭据留在本机 sidecar。进一步了解安装细节、服务商特例与后台常驻方式，见 GitHub：598934321/dsh-quota-pill 与 SkillHub 插件页。
