dsh-quota-status
DeepSeek Harness (DSH) web 插件：在一个极简卡片里实时查看 DeepSeek API 余额、Kimi For Coding 套餐余量（周限 + 5 小时窗口）与 ChatGPT（Codex）订阅限流窗口，带剩余量、进度条、重置倒计时和 DeepSeek 波峰/波谷电价提醒。
A DeepSeek Harness (DSH) web plugin: one minimal card for the DeepSeek API balance, the Kimi For Coding plan quota (weekly + 5h windows) and ChatGPT (Codex) subscription rate limits — remaining amounts, progress bars, reset countdowns, and a DeepSeek peak/off-peak pricing reminder.
收起 / Collapsed
展开 / Expanded
功能 / Features
- 开箱即用：默认读取
DEEPSEEK_API_KEY 与 KIMI_CODING_API_KEY（经 dsh credentials seam，密钥永不进入浏览器）。
- 极简卡片：固定宽度 260px，每个账户一行（状态点 + 名称 + 数值），展开详情时宽度纹丝不动；行 hover/展开有浅阴影，卡片 hover 抬升阴影。无任何常驻按钮与底栏。
- 余额分档着色：DeepSeek 余额数值与状态点按金额变色（绿 ≥100 · 黄 20–99 · 红 1–19 · 灰 <1），一眼看出紧张程度。
- 波峰波谷提醒：DeepSeek 行内嵌「低谷 / 高峰」时段徽标（2026-08-17 起高峰为北京时间每日 09:00–12:00、14:00–18:00，含午间 12:00–14:00 在内的其余时段均为低谷半价；完整时段表在徽标 tooltip 里），展开详情用一句话讲明当前时段与距离切换的倒计时，每秒跟随系统时钟刷新。
- 点击某一行原地展开该账户详情（DeepSeek 充值/赠送拆分 + 峰谷一句话；Kimi 各窗口进度条、剩余量与重置倒计时），再点收起；详情底部有更新时间与手动刷新。
- Kimi 或 ChatGPT 的窗口耗尽（0%）且服务端提供重置时间时，收起态直接追加实时倒计时；未耗尽窗口仍保持极简百分比格式。
- 可拖动：按住卡片空白处拖到任意位置，位置记忆在浏览器本地。
- 60 秒自动刷新（YAML 可调），页面隐藏时暂停，回到前台立即刷新。
- 中英双语（跟随界面语言），跟随 DSH 设计 token（
--dsw-alias-*），自动适配深浅主题。
- 仅回环 Connection RPC（
authority: loopback），API Key 只在宿主进程解析与使用。
- 独立配额页签：在「设置 → 插件 → 配额余量」中直接查看三类账户状态；ChatGPT 可在这里启动 CLIProxyAPI 浏览器 OAuth 登录或重新登录，无需打开终端。OAuth token 只在宿主进程和本地 auth 文件之间流转。
- 显示偏好（行、阈值、刷新间隔）继续走 profile YAML 配置，账户登录等交互动作放在独立配额页签里。
安装 / Install
dsh plugin --profile web add dsh-quota-status@0.4.2 --save-exact --ignore-scripts
dsh web
也可以手动加入 profile：dsh-quota-status 是 bundle，会通过 cordis.patch.yml 插入 quota-status 行。
配置 / Configuration
默认无需任何配置。在 ~/.dsh/profiles/web/cordis.patch.yml 里可以按行覆盖：
- id: quota-status
config:
refreshMs: 30000 # 默认 60000
timeoutMs: 15000 # 上游查询超时
warnBalance: 30 # DeepSeek 余额低于 30 变黄
criticalBalance: 10 # 低于 10 变红
warnUsagePercent: 40 # Kimi 余量低于 40% 变黄
criticalUsagePercent: 15 # 低于 15% 变红
codexBinary: cliproxyapi # 设置页「登录 ChatGPT」调用的本机程序
codexConfigPath: ~/.cli-proxy-api/config.yaml
providers:
- id: deepseek
label: DeepSeek
kind: deepseek-balance
credential: DEEPSEEK_API_KEY
endpoint: https://api.deepseek.com/user/balance
- id: kimi-coding
label: Kimi Coding
kind: kimi-usage
credential: KIMI_CODING_API_KEY
endpoint: https://api.kimi.com/coding/v1/usages
# ChatGPT 订阅（可选，需本地 CLIProxyAPI 网关已登录 codex）：
# 读网关本地 OAuth 授权文件，查询官方 wham/usage 的 5h/周限窗口。
- id: codex-sub
label: ChatGPT
kind: codex-usage
credential: '' # codex-usage 无需 env 凭证
endpoint: https://chatgpt.com/backend-api/wham/usage
authDir: ~/.cli-proxy-api # codex-*.json 所在目录，取最新未禁用文件
providers 列表会整体替换默认列表；kind 支持 deepseek-balance、kimi-usage 与 codex-usage。codex-usage 行只在宿主进程读取 CLIProxyAPI 的本地 OAuth 授权文件（access_token + account_id），token 绝不进入浏览器或任何响应。
额外配额行 / Extra quota rows
统一卡片声明 root-scoped list Slot dsh-quota-status.extra-row。其他本机插件可以向该 Slot 注册额外配额行，并通过 Slot owner 的 renderRow() 提交业务无关、归一化后的 meter 展示数据（名称、已用、上限、剩余百分比、单位、重置时间和阈值）。本插件统一负责布局、展开交互、键盘语义、金额与倒计时格式、进度条及警告颜色。
额外插件应在自己的 Host 中查询上游和处理业务规则，Client 只接收归一化展示数据。凭证、token、API key 和 Authorization header 不得通过 RPC 或 Slot props 传递。卸载任一插件时，Cordis 会随父注册或扩展注册的 disposer 清理对应 Slot 生命周期。
数据源 / Data sources
| Provider | Endpoint | Meaning |
|---|
| DeepSeek | GET https://api.deepseek.com/user/balance | 可用余额（充值 + 赠送），按量计费，无重置时间 |
| Kimi For Coding | GET https://api.kimi.com/coding/v1/usages | 套餐周限（usage）+ 各窗口明细（limits[]，含 5h 滚动窗口与 resetTime） |
| ChatGPT（Codex 订阅） | GET https://chatgpt.com/backend-api/wham/usage | 订阅限流窗口（rate_limit.primary/secondary_window，按 limit_window_seconds 归一化为 5h/周限；used_percent 换算剩余量；plan_type 显示为套餐等级），凭证来自 CLIProxyAPI 本地 auth 文件 |
开发 / Development
npm install
npm run typecheck
npm test
npm run build # 输出 lib/（host + client bundle）
当前 0.5.0 分支精确面向 DSH 0.1.5-rc.1。Client manifest 只使用
connection 与 locale 两条存活动态关系——0.1.5-rc.1 已删除
dsh-client-runtime，本插件也不再声明该图边——不请求 eager activation
或旧的 Cordis client-runner 边；React 继续由 Web baseline 共享。设置界面使用
0.1.5-rc.1 官方 settings.plugins.tab 扩展点，不占用需要 Host settings
namespace 的 settings.plugin.item 卡片 Slot。
src/providers.ts：纯函数适配器，fixture 单测在 tests/providers.spec.ts。src/index.ts：host 半身，拥有 /dsh-quota-status RPC channel（specs / fetch-all）。quotaStatus：host-only sibling service，提供同一份 fresh normalized
read() snapshot 给 Agent Platform；credentials 与 upstream payload 不会跨出 host。src/client.ts：浏览器半身，注册 shell.overlay 和业务无关的额外配额行子 Slot。
安全 / Security
- API Key 只通过
ctx.credentials.resolve() 在宿主进程解析，不写入响应、日志或浏览器。
- Codex 订阅的 OAuth token 只在宿主进程从 CLIProxyAPI 本地 auth 文件读取（取最新未禁用的
codex-*.json），同样不写入响应、日志或浏览器。
- RPC channel 仅回环可访问（
authority: loopback），浏览器只收到归一化后的余额/余量视图。
- 上游数据可能略有延迟，仅供参考。
License
MIT
