dsh-coding-plan-quota
DSH 输入框工具行里的一个额度圆环，就在模型选择器的左侧。它读取你的 coding plan 用量窗口或账户余额，同时只显示一个来源。
- 点击圆环循环切换该来源的窗口：5 小时 → 每周 → 每月。纯余额类来源改为刷新。
- 按紧急程度着色：绿
<50% → 蓝 <75% → 橙 <90% → 红 ≥90%。
- 悬停可看到已用百分比、实时重置倒计时，以及每个窗口的进度条。
- 卡片用一行
额度来源 · <名称> › 标出当前来源。点它即可切换——选择页只列能真正答上来的来源，其余收在开关后面。
- 采集失败的来源会保留上一次成功的数字并标记
stale，而不是变成空白。
所选来源与窗口都会持久化在 localStorage。
截图
额度卡片
来源选择
安装
从 DSH 插件市场安装（分类 Usage & Billing），或在终端里直接装：
dsh plugin --profile web add dsh-coding-plan-quota # npm
dsh plugin --profile web add github:sxwer001/dsh-coding-plan-quota # GitHub
装完请重启 DSH。
若要对着源码目录边改边调，用目录联接（junction）代替拷贝：
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-coding-plan-quota" -Target "D:\Antigravityproject\dsh-coding-plan-quota"
来源
| 来源 | id | 凭据 | 说明 |
|---|
| OpenCode Go | opencode-go | OPENCODE_GO_API_KEY | 5 小时 / 每周 / 每月 |
| 智谱 GLM | glm | ZHIPU_API_KEY | 5 小时 / 每周；region: cn 走 open.bigmodel.cn |
| Kimi | kimi | KIMI_API_KEY | |
| MiniMax | minimax | MINIMAX_COOKIE | 要浏览器会话 Cookie，不是 API key |
| 火山方舟 | ark | ARK_API_KEY | 没有公开额度地址——请自行填 endpoint |
| Claude 订阅 | claude | CLAUDE_CODE_OAUTH_TOKEN | OAuth token，不是 API key |
| Codex / ChatGPT | codex | CHATGPT_ACCESS_TOKEN + CHATGPT_ACCOUNT_ID | chatgpt.com 在部分网络下不可达 |
| Gemini CLI | gemini | GEMINI_ACCESS_TOKEN | cloudcode-pa.googleapis.com 在部分网络下不可达 |
| GitHub Copilot | copilot | COPILOT_API_TOKEN | 若 TLS 代理拦握手，请设 insecureTls: true |
| DeepSeek 余额 | deepseek | DEEPSEEK_API_KEY | 仅余额 |
| Moonshot 余额 | moonshot | MOONSHOT_API_KEY | 仅余额 |
| OpenRouter 余额 | openrouter | OPENROUTER_API_KEY | 仅余额 |
| 硅基流动余额 | siliconflow | SILICONFLOW_API_KEY | 仅余额 |
| 阶跃星辰余额 | stepfun | STEPFUN_API_KEY | 仅余额 |
| Novita 余额 | novita | NOVITA_API_KEY | 仅余额 |
没有凭据的来源只会说明它需要哪一个。厂商按 remaining 报的百分比会被反相成 used；当套餐按模型各报一个窗口时（GLM、Gemini），取最差的那个。
配置
apply(ctx, config) 会把配置合并到这些默认值之上：
| 键 | 默认值 | 含义 |
|---|
cacheMs | 60000 | 每个来源的宿主侧缓存时长 |
timeoutMs | 12000 | 上游请求超时 |
thresholds | [50, 75, 90] | 绿 → 蓝 → 橙 → 红的分界 |
defaultProvider | "opencode-go" | 还没选择时显示哪个 |
hideUnconfigured | false | 隐藏没有凭据的来源 |
insecureTls | false | 跳过证书校验 |
providers | {} | 按 id 索引的单来源覆盖项 |
单来源覆盖项：
| 键 | 含义 |
|---|
enabled | 设为 false 会把该来源从卡片里移除 |
endpoint | 替换内置地址（这也是启用 ark 的方式） |
apiKey | 直接写字面量密钥，优先级高于其他所有凭据来源 |
apiKeyEnv | 改为从这个环境变量读取密钥 |
region | "cn" 切换到该厂商的国内地址 |
insecureTls | 单来源覆盖全局开关 |
- insert:
- id: coding-plan-quota
name: dsh-coding-plan-quota
config:
thresholds: [50, 75, 90]
defaultProvider: opencode-go
providers:
ark:
endpoint: "https://<your-ark-quota-url>"
凭据
对每个来源，先命中者胜：providers.<id>.apiKey → providers.<id>.apiKeyEnv 指名的环境变量（或内置名称）→ DSH 的 credentials 服务 → $DSH_HOME/.credentials.yaml → 该厂商自己 CLI 的凭据文件（OpenCode、Claude、Codex、Gemini、Copilot 有）。
凭据只在宿主半边读取，绝不送到浏览器。
说明
- 卡片跟随 DSH 当前 UI 语言（中 / 英）实时切换，自身没有语言设置。
- 浏览器半边读取宿主半边的同源路由：
/plugins/dsh-coding-plan-quota/usage.json（支持 ?refresh=1、?provider=<id>、?debug=1）。
- 改
lib/host.js 需要重启 DSH；改 lib/client.js 只需刷新页面。
node scripts/verify.mjs 跑端到端检查。
目录结构
dsh-coding-plan-quota/
├── package.json dsh.bundle.patch + dsh.client { platform: web }
├── cordis.patch.yml - insert: [{ id, name }]
├── lib/
│ ├── host.js 宿主半边——来源、凭据、缓存、HTTP 路由
│ └── client.js 浏览器半边——圆环、卡片与来源选择
├── scripts/
│ └── verify.mjs 端到端检查
├── README.md 中文（默认）
└── README.en.md English
许可
MIT
