dsh-quota-dock

dsh-quota-dock

输入框上方常驻一行，不折进二级菜单：Command Code 的 5h / 周 / 月三个窗口（进度条 + 百分比），加一条 DeepSeek 官方的峰谷时段轨道。点这一行，从界面中央浮出「只谈钱」的面板；平台接入在 设置 → 额度与平台。

5h ▮▮▯▯▯ 6%   周 ▮▮▯▯▯ 14%   月 ▮▮▯▯▯ 12%  │  ▮▮▮▯ 谷时 · 全天谷价

安装

dsh plugin add dsh-quota-dock

DSH 会把包内自带的 cordis.patch.yml 展开进你的 profile，不用手工改补丁。

装完在 设置 → 额度与平台 里接入平台；内置的 Command Code 与 DeepSeek 只要环境里有 key 就会自己出现。

常显行

• 条 + 百分比：比例看条，读数看百分比。
• 条长 = used / cap；取不到就留空轨道、读数打 —，不编数。
• 分档：< 80% 低饱和绿 #4f8d6c，≥ 80% 琥珀 #b9812f，≥ 95% 暗红 #c05a52。百分比文字只在报警档变色。
• 不单列「余」：月度条已经说明剩多少。
• DeepSeek 那组按计价周期画，不显示余额：一条轨道画完整周期（08:30 起 16h 峰 + 8h 谷），橙黄为峰、蓝为谷，竖线标出当前位置，右侧是当前档位与倒计时（峰时 · 距谷 3h42m），30 秒走一次。谷 = 00:30–08:30；2026-08-23 起整周末算谷，显示 谷时 · 全天谷价、轨道全蓝。

点开面板

居中浮层，最宽 820px、最高 78vh，圆角跟宿主面板（--qd-r-panel，默认 12px），从上方淡入。

• 顶部：额度与余额 + 更新于 10-18 20:04 + 刷新 + ×。
• 概览：本月剩余（大号）+ 本月已用 + 还能用 N 天。N 按当前消耗速度推算，取不到显示 —。
• Command Code：独占一行宽度，三窗口各一行，已用/额度 credits、条、百分比、右侧时间（5h/周 是「x 后重置」，月直接给周期结束日期）；月行下面一行小字：已用 · 剩余 · 订阅。
• DeepSeek：币种写在卡片右上角，下面是 总额 / 赠送 / 充值 / 可用 + 峰谷一行说明。
• 其他平台：已接入平台各一行，有钱显示钱，没钱显示错误；一家都没有时给一句说明。
• 页脚：左边「每 N 自动重取一次」（N 就是设置里的刷新间隔），右边告诉你配置在哪。

金额都带单位：CC 写 credits，DeepSeek 按币种给符号（¥ / $ …），OpenRouter 固定 USD，自定义接口没有币种信息只显示数字。

面板里没有任何配置项：没有输入框、没有 key 字段、没有「添加」按钮。按 Esc、点右上角 ×、或再点一次那一行都能关。

设置 → 额度与平台

左下角设置对话框侧边栏多一页，只做配置，四段固定顺序：

• 内置平台：Command Code 与 DeepSeek 各一行 —— 状态点、名称、它读的环境变量、一个关键数字（当月已用占比 / 钱包总额）、更新时间、单行刷新。
• 已接入平台：一行 = 状态点 + 名称 + 类型 · 地址 + 正常/失败 + 金额 + 删除。没接任何平台时是一行虚线框，带「去添加」。
• 接入新平台：六个预设（OpenRouter / LiteLLM / New API / 硅基流动 / Kimi / 自定义），点一下把名称和地址填好；OpenRouter 的地址由插件固定，只读显示并说明原因。字段标签在上、输入在下。
• 数据与刷新：刷新间隔（30 秒 / 1 分钟 / 2 分钟 / 5 分钟 / 10 分钟）+ 立即刷新、最近刷新、配置文件路径。

视觉与主题

常显行、弹层、设置页共用一个 --qd-* 语义层，值映射到宿主的 --dsw-* token；换肤和明暗模式跟着宿主走，插件里没有散落的色值和像素圆角。

两个例外是刻意的：

• 三态色（成功 #4f8d6c / 警告 #b9812f / 危险 #c05a52）由插件自己定。宿主的 success 语义色是 #22c55e，占比低的时候也扎眼，不适合当"正常"的颜色。
• DeepSeek 峰谷轨道保留宿主原色（峰 --dsw-alias-state-warn-primary / 谷 --dsw-alias-brand-primary）。那一条是时间轴不是占用率，亮色更好扫读。

行 hover、键盘 focus ring、弹层 elevation 都吃宿主 token。

刷新与缓存

• 间隔默认 60 秒，可在设置页改成 30 秒 ~ 10 分钟，落到 platforms.json 的 refreshMs。
• 这是这一行自己的读表节奏：行按这个间隔读一次快照，而这次读取就是刷新触发（Host 发现缓存过期就顺手起一轮，并立刻回当前缓存）。Host 端没有后台定时器，关掉界面就不再发请求。
• 读到 fetching: true 时行会以 1.5 秒连读，刷新一落地新数字就上屏；上一轮失败则退到 15 秒重试。设置页的「立即刷新」和切换会话都会立刻重排节奏，不用等满一个间隔。
• 行内 ⚠ 只在真的旧了才出现：缓存过了 TTL 却没有刷新在飞（例如上一轮失败），或某一家返回了错误。刚好在 TTL 边界触发的那一轮刷新不算。
• 数据时间写在 tooltip 里（更新于 10-09 16:53）。超过 24 小时才追加一句「数据较旧」，行内不显示警告。
• 刷新失败继续显示上一次成功的数据，两家的值与缓存互不影响；连着点刷新只发一次请求。

接入别的平台

• openrouter：固定打 GET https://openrouter.ai/api/v1/credits，余额 = total_credits − total_usage。
• custom：打你填的地址，带 Authorization: Bearer <key>，把响应前两层的数字字段铺开显示。
• 单家失败不影响其他家，也不影响常显行；每家 15 秒超时。

key 存在 <DSH_HOME>/dsh-quota-dock/platforms.json（明文），接口只回 hasKey，不回显。

数据来源

供应商	端点	说明
Command Code	GET /alpha/billing/credits	windowLimits.{fiveHour,weekly}；monthlyCredits 是剩余额度
Command Code	GET /alpha/usage/summary	totalMonthlyCredits 是本周期已用额度（字段平铺在响应根上）
Command Code	GET /alpha/billing/subscriptions	data.currentPeriodEnd = 月度窗口重置时间
DeepSeek	GET /user/balance	balance_infos[]，按币种显示

月度窗口总额 = totalMonthlyCredits + monthlyCredits，只读其中一个会算错。

峰谷时段不取数，按本机时钟算，跟接口是否成功无关。

凭据

Host 端从 ctx.credentials 读 COMMANDCODE_API_KEY 与 DEEPSEEK_API_KEY，环境变量兜底。密钥不进源码、不进接口返回、不进日志。

开发与测试

桌面版的 profile 由应用托管，本地开发走 link：profile 的 package.json 里保留 "dsh-quota-dock": "link:E:/dsh/dsh-quota-dock"，并把 dsh-quota-dock 登记进 dsh.profile.bundles。改 index.js 要触发 patchReload 或重开应用；改 client.js 刷新页面即可。

cd E:\dsh\dsh-quota-dock

npm test

离线 harness（test/smoke.cjs）用 stub 的 window.__ModuleLoader__ 与 react 真渲染组件，断言三个槽位、常显行百分比与峰谷分支、进度条填充比与分档、面板开关、面板内无输入框、设置页四段与六个预设、刷新间隔档位、读表节奏（TTL 边界 / 刷新在飞 / 失败退避）、刷新在飞时不亮 ⚠，以及降级态不出现 undefined / NaN。时钟是注入的，凌晨和白天跑结论一致。