@gehennawu/dsh-service 0.24.0 → 0.26.0

package/README.en.md

@@ -44,14 +44,15 @@ The plugin also appears under **Plugins → Plugin configuration**, with six hos
 
 ### Quota lookup
 
-- A dedicated "Quota lookup" tab shows adapted providers as separate cards, each window rendered as a percentage with its own bar and a reset countdown on its own line, plus a refresh icon beside the updated time that force-refreshes that provider on click (bypassing the poll interval); unadapted providers take no space — a "Manual adapt" row at the bottom enables one by picking its type, and each card's footer can switch type, fall back to auto-detect, or disable lookup at any time
+- A dedicated "Quota lookup" tab shows adapted providers as separate cards, each window rendered as a percentage with its own bar and a reset countdown on its own line, plus a refresh icon beside the updated time that force-refreshes that provider on click (bypassing the poll interval); adapted card titles link to the provider's official usage page (DeepSeek Platform, Zhipu GLM Coding Plan, OpenCode Go) in a new tab; a "Reorder" toggle at the top-right of the card list (shown with two or more cards) reveals ↑/↓ buttons on each card header (auto-disabled at the ends), and clicking it again hides them; the order is remembered in this browser and newly seen providers append at the end; unadapted providers take no space — a "Manual adapt" row at the bottom enables one by picking its type, and each card's footer can switch type, fall back to auto-detect, or disable lookup at any time
 - A quota ring inside the conversation composer follows the provider selected by the current session and shows the tightest budget window as a percentage (green below 80%, amber at or above); clicking opens a panel headed by the provider name, with a bar and used percentage for each window and reset times on their own lines; on narrow viewports (phones) the panel switches to a viewport-centered floating layer — fully visible, scrolling internally when too tall — and rotates or resizing wider flips it back to the anchored placement above the ring
 - A "Show a remote quota entry in the settings left navigation" switch lives in the Quota lookup tab (off by default), mirroring the Restart entry
-- Built-in adaptations: **OpenCode Go** (`{baseURL}/usage`), **Zhipu GLM Coding Plan / zai-coding-cn** (official monitor `quota/limit` endpoint with three windows — 5-hour rolling tokens, weekly tokens, monthly MCP quota; an idle 5-hour window hides its reset time, matching the official console), **OpenRouter** (credits used %), **Kimi/Moonshot** and **SiliconFlow** (CNY balance text); dialects that natively report remaining percentage flip the panel word to "Remaining" and invert the warn threshold; transient network errors retry automatically and the Zhipu dual-domain candidate chain switches automatically; the provider-to-kind mapping lives in `DSH_HOME/dsh-service-quota.json`, and known services are auto-detected from their baseURL (e.g. opencode.ai, bigmodel.cn) with no manual picking; no upstream request is ever made for unadapted or disabled providers; disabling can be done via "Disable" in a card's footer or by writing `"<provider>": null` in the config file (both are equivalent). Zhipu reset cards have no API-key-queryable endpoint yet — you can add any number of them via each provider card's "Add reset card" button on the tab (name plus expiry time, down to the minute), and remove each one independently — the ring panel shows them too (stored in the same config file); expired cards are flagged automatically
+- Built-in adaptations: **OpenCode Go** (`{baseURL}/usage`), **Zhipu GLM Coding Plan / zai-coding-cn** (official monitor `quota/limit` endpoint with three windows — 5-hour rolling tokens, weekly tokens, monthly MCP quota; an idle 5-hour window hides its reset time, matching the official console), **OpenRouter** (credits used %), **Kimi/Moonshot** and **SiliconFlow** (CNY balance text), **DeepSeek Platform** (official balance, see next bullet); dialects that natively report remaining percentage flip the panel word to "Remaining" and invert the warn threshold; transient network errors retry automatically and the Zhipu dual-domain candidate chain switches automatically; the provider-to-kind mapping lives in `DSH_HOME/dsh-service-quota.json`, and known services are auto-detected from their baseURL (e.g. opencode.ai, bigmodel.cn, api.deepseek.com) with no manual picking; no upstream request is ever made for unadapted or disabled providers; disabling can be done via "Disable" in a card's footer or by writing `"<provider>": null` in the config file (both are equivalent). Zhipu reset cards have no API-key-queryable endpoint yet — you can add any number of them via each provider card's "Add reset card" button on the tab (name plus expiry time, down to the minute), and remove each one independently — the ring panel shows them too (stored in the same config file); expired cards are flagged automatically
+- **DeepSeek official balance with peak/off-peak hint (deepseek)**: calls DeepSeek Platform's official `GET /user/balance` and shows the total balance per currency (CNY→¥, USD→$), plus a separate "Granted balance" line whenever unexpired granted credit is positive; each DeepSeek card embeds a **peak/off-peak block** — a status badge on top (orange = "Peak now · standard price", green = "Off-peak now · half price") with a countdown to the next switch in Beijing time (e.g. "Peak pricing from 09:00 (in 12 h 41 min)", correctly spanning weekends to Monday's morning peak), below it a two-segment ribbon: the first block is the remainder of the current period and the second is the next opposite period (spanning days when needed — e.g. Friday evening draws straight to Monday's morning peak), widths proportional to actual durations with the left edge marking "now"; blocks are tagged inline as Peak / Off-peak, advancing every 30 seconds, and a caption stating the official rule "off-peak price is half the peak price"; the ring panel shows a compact version without the caption. Credentials resolve via the `DEEPSEEK_API_KEY` hint from the DSH credential store or environment variables, or can be written directly through the card's credential form. DSH's built-in `@deepseek-ai/dsh-llm-deepseek` official channel (the DeepSeek V4 models in the model picker, route id `deepseek-official`) needs **no extra settings route** — the quota lookup merges that runtime channel automatically and adapts it to the official balance endpoint, so the ring also appears when you switch to one of its models
 - **CLIProxyAPI accounts (cliproxy)**: queries the **official remaining quota** of each OAuth upstream account inside a CLIProxyAPI (CPA) deployment (Codex 5-hour/weekly windows, per-model quotas for GeminiCLI and Antigravity) — not proxy-key usage. Prerequisites: CPA's `remote-management.secret-key` must be set (the whole management API is unavailable without it), remote access requires `allow-remote-management`, and the management secret goes into the DSH credential store as `CPA_MANAGEMENT_KEY` or an environment variable of the same name — it is independent of the proxy API key, and the plugin never sends the proxy key to the management plane. When you save the "CLIProxyAPI accounts" adaptation, the plugin pins the hostname of that provider's settings baseURL into the config file and afterwards only sends requests to that pinned domain (re-save the adaptation after changing baseURL); a single refresh queries at most 8 accounts (disabled accounts and account types without a supported quota endpoint are skipped automatically), and failures on some accounts do not affect the rest. Note that CPA's management plane has built-in key throttling — 5 wrong attempts ban your IP for 30 minutes — so make sure the secret is correct before testing
-- Credential fill-in form: when an adapted provider shows "credential missing", its card offers an inline **"Set API credential"** form — the credential name comes from a host-derived whitelist per adaptation type (CLIProxyAPI only ever offers `CPA_MANAGEMENT_KEY`/`CLIPROXY_MANAGEMENT_KEY` — these are **alias slots for the same secret; storing one is enough**, discovery takes the first configured value in order; the primary name is marked and the form defaults to a configured slot. Never the proxy key); saving writes the value into the DSH credential provider (the `refs:` section of `$DSH_HOME/.credentials.yaml`, hot-effective without restarts) and then force-refreshes that provider; the form can also clear a stored file-layer credential in one click. If a process environment variable is currently shadowing that name, the host refuses the write (credential-store contract) — change the environment variable itself instead
+- Credential fill-in form: when an adapted provider shows "credential missing", its card offers an inline form — regular adaptations show **"Set API credential"**, while the CLIProxyAPI adaptation shows **"Set management key (web login key)"** (the remote-management secret you use to log into CPA's web management UI — not the proxy API key, which the management plane bans wrong attempts for); the credential name comes from a host-derived whitelist per adaptation type (CLIProxyAPI only ever offers `CPA_MANAGEMENT_KEY`/`CLIPROXY_MANAGEMENT_KEY` — these are **alias slots for the same secret; storing one is enough**, discovery takes the first configured value in order; the primary name is marked and the form defaults to a configured slot. Never the proxy key); saving writes the value into the DSH credential provider (the `refs:` section of `$DSH_HOME/.credentials.yaml`, hot-effective without restarts) and then force-refreshes that provider; the form can also clear a stored file-layer credential in one click. If a process environment variable is currently shadowing that name, the host refuses the write (credential-store contract) — change the environment variable itself instead
 - Anti-rate-limit pacing is enforced by the host: successful results are cached for 60 seconds (shared across tabs), failures back off exponentially (30 s doubling, capped at 15 minutes), upstream timeout is 15 s; the panel can set auto query to manual only / 1 / 2 / 5 / 10 minutes (manual only by default), paused automatically while the page is hidden
-- API keys are resolved and used only inside the host process — the browser receives normalized percentages only; data flows through the plugin's own loopback RPC with no webServer routes exposed
+- API keys are resolved and used only inside the host process — the browser receives normalized window data (percentages or balance text) only; data flows through the plugin's own loopback RPC with no webServer routes exposed
 
 ### Backup management
 

package/README.md

@@ -44,14 +44,15 @@
 
 ### 额度查询
 
-- 独立的「额度查询」标签：以卡片分区展示已适配的供应商，每个窗口显示百分比、独立进度条，重置时间单独一行；卡片头部更新时间旁有刷新图标，点击即强制重拉该供应商（不受轮询间隔限制）；未适配的不占位置，统一收进底部「手动适配」行选择类型启用，卡片脚部可随时切换适配类型、回退自动识别或停用查询
+- 独立的「额度查询」标签：以卡片分区展示已适配的供应商，每个窗口显示百分比、独立进度条，重置时间单独一行；卡片头部更新时间旁有刷新图标，点击即强制重拉该供应商（不受轮询间隔限制）；已适配卡片的标题链接到对应官网用量页（DeepSeek 平台、智谱 GLM Coding Plan、OpenCode Go），点击新标签页打开；卡片列表右上角有「调整排序」开关（至少两张卡时显示），点击后各卡头部出现 ↑/↓ 按钮（首末卡对应方向自动禁用），再点一次收起；顺序记忆在本浏览器，新出现的供应商排在末尾；未适配的不占位置，统一收进底部「手动适配」行选择类型启用，卡片脚部可随时切换适配类型、回退自动识别或停用查询
 - 对话输入框内一枚额度圆环，跟随当前会话所选模型的供应商，显示最紧预算窗口的已用百分比（<80% 绿色、≥80% 黄色）；点击弹出面板——头部标明供应商，各窗口带独立进度条与已用百分比、重置时间单独一行；手机等窄屏上面板自动切换为视口居中的浮层（完整可见、超高时内部滚动），旋转或拖宽窗口即时切回圆环上方锚定
 - 可在「额度查询」标签开启「设置页左列显示入口」开关（默认关闭），开启后在设置页左侧标签列底部显示「额度查询」快捷入口（与「重启」入口同模式）
-- 内置适配：**OpenCode Go**（`{baseURL}/usage`）、**智谱 GLM Coding Plan / zai-coding-cn**（官方监控端点 `quota/limit`，含 5 小时滚动 Token、每周 Token、MCP 月度配额三个窗口，5 小时窗口空闲时与官网一致地不显示重置时间）、**OpenRouter**（credits 已用%）、**Kimi/Moonshot** 与 **硅基流动**（人民币余额）；原生报「剩余百分比」的方言会自动把面板头部切换为「剩余」并把预警阈值反向；上游瞬时网络错误自动重试，智谱双域候选链自动切换；供应商与适配类型的对应关系保存在 `DSH_HOME/dsh-service-quota.json`，已知服务商按 baseURL 自动识别适配（如 opencode.ai、bigmodel.cn），无需手选；未适配或已停用的供应商不会被发起任何上游请求，停用可在卡片脚部选「停用查询」或在配置文件写 `"<provider>": null`（两者等价）。智谱的重置卡暂无 API Key 可查的接口，可在「额度查询」标签内点各供应商卡片的「添加重置卡」填写名称与到期时间（可精确到分钟），可连续添加多条、每条独立移除；圆环面板同步显示（数据存入同一配置文件），过期自动标注
+- 内置适配：**OpenCode Go**（`{baseURL}/usage`）、**智谱 GLM Coding Plan / zai-coding-cn**（官方监控端点 `quota/limit`，含 5 小时滚动 Token、每周 Token、MCP 月度配额三个窗口，5 小时窗口空闲时与官网一致地不显示重置时间）、**OpenRouter**（credits 已用%）、**Kimi/Moonshot** 与 **硅基流动**（人民币余额）、**DeepSeek 开放平台**（官方余额，见下一条）；原生报「剩余百分比」的方言会自动把面板头部切换为「剩余」并把预警阈值反向；上游瞬时网络错误自动重试，智谱双域候选链自动切换；供应商与适配类型的对应关系保存在 `DSH_HOME/dsh-service-quota.json`，已知服务商按 baseURL 自动识别适配（如 opencode.ai、bigmodel.cn、api.deepseek.com），无需手选；未适配或已停用的供应商不会被发起任何上游请求，停用可在卡片脚部选「停用查询」或在配置文件写 `"<provider>": null`（两者等价）。智谱的重置卡暂无 API Key 可查的接口，可在「额度查询」标签内点各供应商卡片的「添加重置卡」填写名称与到期时间（可精确到分钟），可连续添加多条、每条独立移除；圆环面板同步显示（数据存入同一配置文件），过期自动标注
+- **DeepSeek 官方余额与峰谷提示（deepseek）**：调用 DeepSeek 开放平台官方 `GET /user/balance`，按币种显示总额余额（CNY→¥、USD→$），未过期赠金大于 0 时追加一行「赠送余额」；卡片内嵌**峰谷时段提示块**——顶部为当前状态徽标（橙=「当前高峰时段 · 标准价」、绿=「当前空闲时段 · 半价计费」）和下一次换挡的北京时间倒计时（如「09:00 转高峰（12 小时 41 分钟后）」，跨周末也能算到周一早高峰），下方是一条**两段式**峰谷色带：第一段是当前时段的剩余部分，第二段是下一个相反时段（可跨天，如周五晚直接画到周一早高峰），宽度按实际时长比例、左缘细标线即当前时刻；段内只标「忙时 / 闲时」，每 30 秒自动前进，底部说明行写明官方规则「空闲时段价格为高峰时段的一半」；圆环面板内同步显示紧凑版（无说明行）。凭据按 `DEEPSEEK_API_KEY` 线索从 DSH 凭据库或环境变量解析，也可直接在卡片上用「填写 API 密钥」表单写入。DSH 内置的 `@deepseek-ai/dsh-llm-deepseek` 官方渠道（模型选择器里的 DeepSeek V4 系列，路由名 `deepseek-official`）**无需在 settings 另建路由**——额度查询会自动并入这个运行时渠道并按官方余额适配，切换到它的模型时圆环同样出现
 - **CLIProxyAPI 账号额度（cliproxy）**：查询 CLIProxyAPI（CPA）部署内各 OAuth 上游账号的**官方剩余额度**（Codex 的 5 小时/本周窗口、GeminiCLI 与 Antigravity 的各模型配额），而不是代理 key 的用量。前置条件：CPA 配置 `remote-management.secret-key` 非空（为空时管理面整体不可用）、远程访问需开启 `allow-remote-management`；管理密钥放入 DSH 凭据库 `CPA_MANAGEMENT_KEY` 或同名环境变量——它与代理用的 API key 相互独立，插件绝不会把代理 key 发往管理面。在「手动适配」中选择「CLIProxyAPI 账号额度」保存时，插件会把该供应商 settings baseURL 的域名钉进配置文件，此后外呼只发往这个域（修改 baseURL 后需重新保存适配）；单次刷新最多查询 8 个账号（已禁用或无受支持配额端点的账号自动跳过），部分账号失败不影响其余账号的结果。请注意 CPA 管理面对错误密钥有内建封禁（连续错 5 次封 IP 30 分钟），务必填对再测
-- 凭据填写窗口：已适配供应商因缺凭据显示「凭据未配置」时，卡片上会出现**「填写 API 密钥」**内联表单——凭据名称由宿主按适配类型派生白名单（CLIProxyAPI 只会出现 `CPA_MANAGEMENT_KEY`/`CLIPROXY_MANAGEMENT_KEY`——两者是同一密钥的**别名存放槽，二选一即可**，查找按顺序取第一个已配置的值；主名带「主名」标记且表单默认选中已配置的槽位。绝不混入代理 key），输入密钥值保存即写入 DSH 凭据提供方（`$DSH_HOME/.credentials.yaml` 的 `refs:` 分节，热生效无需重启），随后自动强制重拉该供应商；表单里还能一键清除已存的文件层凭据。进程环境变量正在遮蔽该名字时宿主会拒绝写入（凭据库契约），此时请改环境变量本身
+- 凭据填写窗口：已适配供应商因缺凭据显示「凭据未配置」时，卡片上会出现内联表单——普通适配显示**「填写 API 密钥」**，CLIProxyAPI 适配显示**「填写管理密钥（网页登录的 key）」**（即登录 CPA 网页管理面所用的 remote-management 密钥，不是代理 API key——管理面对错密钥有封禁，别填错）；凭据名称由宿主按适配类型派生白名单（CLIProxyAPI 只会出现 `CPA_MANAGEMENT_KEY`/`CLIPROXY_MANAGEMENT_KEY`——两者是同一密钥的**别名存放槽，二选一即可**，查找按顺序取第一个已配置的值；主名带「主名」标记且表单默认选中已配置的槽位。绝不混入代理 key），输入密钥值保存即写入 DSH 凭据提供方（`$DSH_HOME/.credentials.yaml` 的 `refs:` 分节，热生效无需重启），随后自动强制重拉该供应商；表单里还能一键清除已存的文件层凭据。进程环境变量正在遮蔽该名字时宿主会拒绝写入（凭据库契约），此时请改环境变量本身
 - 防风控节律由宿主统一控制：成功结果缓存 60 秒（多标签共享）、失败指数退避（30 秒起 ×2、封顶 15 分钟）、上游超时 15 秒；面板可把自动查询调成仅手动 / 1 / 2 / 5 / 10 分钟（默认仅手动），页面不可见时自动暂停
-- API key 只在宿主进程内解析使用，浏览器只会收到归一化后的百分比数字；数据走插件自有 loopback RPC，不在 webServer 上暴露任何路由
+- API key 只在宿主进程内解析使用，浏览器只会收到归一化后的窗口数据（百分比或余额文本）；数据走插件自有 loopback RPC，不在 webServer 上暴露任何路由
 
 ### 备份管理
 

package/client.js

@@ -404,12 +404,17 @@ window.__ModuleLoader__.load({
       'quota.resetCard.remove': '移除',
       'quota.retryAt': '{time} 后可重试',
       'quota.refresh': '刷新',
+      'quota.card.moveUp': '上移',
+      'quota.card.moveDown': '下移',
+      'quota.reorder': '调整排序',
+      'quota.usageLink': '打开官网用量页',
       'quota.adapt': '适配',
       'quota.kind.opencode-go': 'OpenCode Go',
       'quota.kind.zai-coding-cn': '智谱 GLM Coding Plan',
       'quota.kind.openrouter': 'OpenRouter',
       'quota.kind.kimi': 'Kimi / Moonshot',
       'quota.kind.siliconflow': '硅基流动',
+      'quota.kind.deepseek': 'DeepSeek 开放平台',
       'quota.kind.cliproxy': 'CLIProxyAPI 账号额度',
       'quota.kindAuto': '自动识别',
       'quota.noAdapted': '暂无已适配的供应商，可在下方手动适配',
@@ -432,6 +437,7 @@ window.__ModuleLoader__.load({
       'quota.error.host-not-pinned': 'baseURL 与适配时记录的域名不一致，请重新保存适配',
       'quota.error.upstream-status': '上游官方接口返回错误状态',
       'quota.credential.edit': '填写 API 密钥',
+      'quota.credential.editManagement': '填写管理密钥（网页登录的 key）',
       'quota.credential.nameLabel': '凭据名称',
       'quota.credential.valueLabel': '密钥值',
       'quota.credential.save': '保存',
@@ -449,6 +455,14 @@ window.__ModuleLoader__.load({
       'quota.unit.day': '{count} 天',
       'quota.unit.hour': '{count} 小时',
       'quota.unit.minute': '{count} 分钟',
+      'quota.window.granted-balance': '赠送余额（未过期）',
+      'quota.peak.nowIdle': '当前空闲时段 · 半价计费',
+      'quota.peak.nowPeak': '当前高峰时段 · 标准价',
+      'quota.peak.untilIdle': '{time} 转空闲（{dur}后）',
+      'quota.peak.untilPeak': '{time} 转高峰（{dur}后）',
+      'quota.peak.tag.peak': '忙时',
+      'quota.peak.tag.idle': '闲时',
+      'quota.peak.caption': '空闲时段价格为高峰时段的一半。高峰时段：北京时间周一至周五 09:00–12:00、14:00–18:00；其余时间为空闲时段，周六和周日全天空闲。',
     }
     const en = {
       'nav.label': 'Service Control',
@@ -846,6 +860,10 @@ window.__ModuleLoader__.load({
       'quota.resetCard.remove': 'Remove',
       'quota.retryAt': 'Retry allowed after {time}',
       'quota.refresh': 'Refresh',
+      'quota.card.moveUp': 'Move up',
+      'quota.card.moveDown': 'Move down',
+      'quota.reorder': 'Reorder',
+      'quota.usageLink': 'Open the official usage page',
       'quota.adapt': 'Adapt',
       'quota.kind.opencode-go': 'OpenCode Go',
       'quota.kind.zai-coding-cn': 'Zhipu GLM Coding Plan',
@@ -853,6 +871,7 @@ window.__ModuleLoader__.load({
       'quota.kind.kimi': 'Kimi / Moonshot',
       'quota.kind.siliconflow': 'SiliconFlow',
       'quota.kind.cliproxy': 'CLIProxyAPI accounts',
+      'quota.kind.deepseek': 'DeepSeek Platform',
       'quota.kindAuto': 'Auto-detected',
       'quota.noAdapted': 'No adapted providers yet — adapt manually below',
       'quota.disable': 'Disable',
@@ -874,6 +893,7 @@ window.__ModuleLoader__.load({
       'quota.error.host-not-pinned': 'baseURL differs from the domain recorded when adapting; save the adapter again',
       'quota.error.upstream-status': 'Upstream official API returned an error status',
       'quota.credential.edit': 'Set API credential',
+      'quota.credential.editManagement': 'Set management key (web login key)',
       'quota.credential.nameLabel': 'Credential name',
       'quota.credential.valueLabel': 'Secret value',
       'quota.credential.save': 'Save',
@@ -891,6 +911,14 @@ window.__ModuleLoader__.load({
       'quota.unit.day': '{count} d',
       'quota.unit.hour': '{count} h',
       'quota.unit.minute': '{count} min',
+      'quota.window.granted-balance': 'Granted balance (unexpired)',
+      'quota.peak.nowIdle': 'Off-peak now · half price',
+      'quota.peak.nowPeak': 'Peak now · standard price',
+      'quota.peak.untilIdle': 'Half price from {time} (in {dur})',
+      'quota.peak.untilPeak': 'Peak pricing from {time} (in {dur})',
+      'quota.peak.tag.peak': 'Peak',
+      'quota.peak.tag.idle': 'Off-peak',
+      'quota.peak.caption': 'Off-peak price is half the peak price. Peak hours (GMT+8): Mon–Fri 09:00–12:00 and 14:00–18:00. All other times are off-peak, including all day Saturday and Sunday.',
     }
 
     // 设置页导航自定义图标：settings.section 协议没有 icon 字段，外壳 navIcon(id) 只认
@@ -1671,7 +1699,7 @@ window.__ModuleLoader__.load({
       const QUOTA_POLL_KEY = 'dsh-service-quota-poll'
       const QUOTA_POLL_CHOICES = [0, 1, 2, 5, 10]
       // 适配类型下拉选项：与宿主 QUOTA_KINDS 白名单保持一致（词典键 quota.kind.<kind>）。
-      const QUOTA_KIND_OPTIONS = ['opencode-go', 'zai-coding-cn', 'openrouter', 'kimi', 'siliconflow', 'cliproxy']
+      const QUOTA_KIND_OPTIONS = ['opencode-go', 'zai-coding-cn', 'openrouter', 'kimi', 'siliconflow', 'deepseek', 'cliproxy']
       function readQuotaPollMinutes() {
         try {
           const raw = Number.parseInt(localStorage.getItem(QUOTA_POLL_KEY), 10)
@@ -1683,6 +1711,28 @@ window.__ModuleLoader__.load({
       function writeQuotaPollMinutes(minutes) {
         try { localStorage.setItem(QUOTA_POLL_KEY, String(minutes)) } catch (_) {}
       }
+      const QUOTA_CARD_ORDER_KEY = 'dsh-service-quota-card-order'
+      // 卡片手动排序（用户点名）：localStorage 只存 provider 名单；坏形状/超限整体回退快照序。
+      function readQuotaCardOrder() {
+        try {
+          const raw = JSON.parse(localStorage.getItem(QUOTA_CARD_ORDER_KEY) ?? 'null')
+          if (!Array.isArray(raw)) return []
+          return raw.filter((name) => typeof name === 'string' && name !== '').slice(0, 64)
+        } catch (_) {
+          return []
+        }
+      }
+      function writeQuotaCardOrder(order) {
+        try { localStorage.setItem(QUOTA_CARD_ORDER_KEY, JSON.stringify(order.slice(0, 64))) } catch (_) {}
+      }
+      /** 快照序 → 记忆序：名单内的按存储位次在前，名单外的保持快照相对顺序追加在后。 */
+      function applyQuotaCardOrder(rows, order) {
+        const rank = new Map(order.map((name, index) => [name, index]))
+        return rows
+          .map((row, index) => ({ row, key: rank.has(row.provider) ? rank.get(row.provider) : order.length + index }))
+          .sort((a, b) => a.key - b.key)
+          .map((entry) => entry.row)
+      }
       let quotaSnapshotPromise = null
       let quotaSnapshotQueuedPayload = null
       function normalizedQuotaPayload(payload) {
@@ -1877,6 +1927,136 @@ window.__ModuleLoader__.load({
         const digits = (value) => String(value).padStart(2, '0')
         return `${date.getFullYear()}-${digits(date.getMonth() + 1)}-${digits(date.getDate())}`
       }
+
+      // ─── DeepSeek 峰谷时段（v0.25）───────────────────────────────────────────
+      // 官方计费口径：空闲时段价格为高峰的一半。高峰 = 北京时间周一至周五 9:00–12:00、14:00–18:00；
+      // 其余全为空闲（周六日全天空闲）。北京时间固定 UTC+8 无夏令时：nowMs 平移 8h 后读 UTC 字段即得。
+      const DEEPSEEK_PEAK_SEGMENTS = [[540, 720], [840, 1080]] // 当日分钟数（北京零点起算）
+      const DEEPSEEK_PEAK_COLOR = '#f0952f'
+      const DEEPSEEK_IDLE_COLOR = 'var(--dsw-alias-state-success-primary)'
+      const DEEPSEEK_PEAK_TICK_MS = 30000
+      // 换挡倒计时用数字钟时刻（formatBeijingClockTime），无 boundary 类词典键。
+      // 色带无外部刻度：只画两段——当前时段剩余 + 下一个相反时段（可跨天，用户点名隐藏
+      // 过去时间），左缘细标线即当前时刻，段内短词「忙时/闲时」过窄自动隐藏。
+      function beijingCivilParts(nowMs) {
+        const shifted = new Date(nowMs + 8 * 3600 * 1000)
+        return { dayIndex: shifted.getUTCDay(), minutesOfDay: shifted.getUTCHours() * 60 + shifted.getUTCMinutes() }
+      }
+      function deepseekIsPeakMinute(dayIndex, minutesOfDay) {
+        if (dayIndex === 0 || dayIndex === 6) return false
+        return DEEPSEEK_PEAK_SEGMENTS.some(([start, end]) => minutesOfDay >= start && minutesOfDay < end)
+      }
+      /** 从当前时刻起收集前 count 个峰谷切换时刻（毫秒，升序）。
+       * 工作日的四个边界点必为状态翻转；周末无边界。最坏情形（周五 18:00 后）下个翻转在
+       * 周一 09:00，扫 7 天必然覆盖（现有调用最多取 2 个）。 */
+      function deepseekUpcomingFlips(nowMs, count) {
+        const shifted = new Date(nowMs + 8 * 3600 * 1000)
+        shifted.setUTCHours(0, 0, 0, 0)
+        const beijingDayStart = shifted.getTime() - 8 * 3600 * 1000
+        const flips = []
+        for (let dayOffset = 0; dayOffset <= 6 && flips.length < count; dayOffset++) {
+          const dayStart = beijingDayStart + dayOffset * 86400000
+          const dayIndex = new Date(dayStart + 8 * 3600 * 1000).getUTCDay()
+          if (dayIndex === 0 || dayIndex === 6) continue
+          for (const minute of DEEPSEEK_PEAK_SEGMENTS.flat()) {
+            const candidate = dayStart + minute * 60000
+            if (candidate <= nowMs) continue
+            flips.push(candidate)
+            if (flips.length >= count) return flips
+          }
+        }
+        return flips
+      }
+      function formatBeijingClockTime(ms) {
+        const shifted = new Date(ms + 8 * 3600 * 1000)
+        const digits = (value) => String(value).padStart(2, '0')
+        return `${digits(shifted.getUTCHours())}:${digits(shifted.getUTCMinutes())}`
+      }
+
+      /** 峰谷块显隐判定：仅 DeepSeek 行且有窗口数据（额度卡与圆环面板共用一处口径）。 */
+      function deepseekPeakVisible(row, windows) {
+        return row?.kind === 'deepseek' && Array.isArray(windows) && windows.length > 0
+      }
+
+      /** DeepSeek 余额卡专属的峰谷提示块：当前状态徽标 + 数字钟换挡倒计时、两段式峰谷色带
+       * （橙=高峰、绿=空闲；当前时段剩余 + 下一个相反时段，可跨天）、左缘细标线即当前时刻，
+       * 规则说明行可选。额度卡与圆环面板共用，圆环面板窄所以不渲染说明行（showCaption:false）。
+       * 时刻推进用 ctx.timer 自续链而非 setInterval：测试桩里不会留真实定时器挂住进程，卸载即断链。 */
+      function QuotaPeakTimeline({ showCaption }) {
+        const translate = useTranslation()
+        // 测试桩的 useState 不调用函数式初始化器，直接传值（多算一次 Date.now 无副作用）。
+        const [now, setNow] = useState(Date.now())
+        useEffect(() => {
+          let disposed = false
+          let disposer = null
+          const schedule = () => {
+            if (disposed) return
+            disposer = ctx.timer.timeout(() => {
+              setNow(Date.now())
+              schedule()
+            }, DEEPSEEK_PEAK_TICK_MS)
+          }
+          schedule()
+          return () => {
+            disposed = true
+            if (disposer !== null && disposer !== undefined) disposer()
+          }
+        }, [])
+        const civil = beijingCivilParts(now)
+        const inPeak = deepseekIsPeakMinute(civil.dayIndex, civil.minutesOfDay)
+        const flips = deepseekUpcomingFlips(now, 2)
+        const nextFlip = flips[0] ?? null
+        const accentColor = inPeak ? DEEPSEEK_PEAK_COLOR : DEEPSEEK_IDLE_COLOR
+        // pctOf 复用 /1440 归一：传入「权重占比 ×1440」得到百分比（保留 4 位小数）。
+        const pctOf = (minute) => Math.round((minute / 1440) * 1000000) / 10000
+        return React.createElement('div', { 'data-testid': 'quota-peak-timeline', style: { display: 'flex', flexDirection: 'column', gap: '4px' } },
+          React.createElement('div', { style: { display: 'flex', alignItems: 'center', flexWrap: 'wrap', gap: '6px', minHeight: '16px' } },
+            React.createElement('span', {
+              'data-testid': 'quota-peak-state',
+              'data-in-peak': String(inPeak),
+              // nowrap + flexShrink:0：容器过窄时整块折行，绝不把文字挤成一列竖排（用户点名）。
+              style: { display: 'inline-flex', alignItems: 'center', gap: '5px', fontSize: '12px', lineHeight: '16px', color: accentColor, whiteSpace: 'nowrap', flexShrink: 0 },
+            },
+            React.createElement('span', { style: { width: '7px', height: '7px', borderRadius: '50%', background: accentColor, flexShrink: 0 } }),
+            translate(inPeak ? 'quota.peak.nowPeak' : 'quota.peak.nowIdle')),
+            nextFlip !== null ? React.createElement('span', {
+              'data-testid': 'quota-peak-next',
+              style: { marginLeft: 'auto', fontSize: '11px', lineHeight: '16px', color: 'var(--dsw-alias-label-tertiary)', whiteSpace: 'nowrap' },
+            }, translate(inPeak ? 'quota.peak.untilIdle' : 'quota.peak.untilPeak', {
+              time: formatBeijingClockTime(nextFlip),
+              dur: humanizeDuration(nextFlip - now, translate),
+            })) : null),
+          React.createElement('div', {
+            'data-testid': 'quota-peak-bar',
+            style: { position: 'relative', height: '14px', borderRadius: 999, overflow: 'hidden', background: 'var(--dsw-alias-interactive-bg-hover)' },
+          },
+          // 两段式（用户点名）：第一段 = 当前时段剩余，第二段 = 下一个相反时段（可跨天），
+          // 宽度按实际时长比例；段内只标「忙时/闲时」，过窄自动隐藏（精确时刻在倒计时与说明行）。
+          (flips.length > 0 ? [
+            { peak: inPeak, weight: flips[0] - now },
+            ...(flips.length > 1 ? [{ peak: !inPeak, weight: flips[1] - flips[0] }] : []),
+          ] : [{ peak: inPeak, weight: 1 }]).map((segment, index, all) => {
+            const totalWeight = all.reduce((sum, part) => sum + part.weight, 0)
+            const widthPct = pctOf(segment.weight / totalWeight * 1440)
+            return React.createElement('span', {
+              key: index,
+              'data-testid': `quota-peak-segment-${index}`,
+              'data-peak': String(segment.peak),
+              style: { position: 'absolute', top: 0, bottom: 0, left: `${index === 0 ? 0 : pctOf(all[0].weight / totalWeight * 1440)}%`, width: `${widthPct}%`, background: segment.peak ? DEEPSEEK_PEAK_COLOR : DEEPSEEK_IDLE_COLOR, overflow: 'hidden' },
+            },
+            widthPct >= 11 ? React.createElement('span', { style: { position: 'absolute', inset: 0, textAlign: 'center', fontSize: '9px', lineHeight: '14px', fontWeight: 500, color: 'rgba(255,255,255,0.95)' } }, translate(segment.peak ? 'quota.peak.tag.peak' : 'quota.peak.tag.idle')) : null)
+          }),
+          // 左缘细标线即「当前」时刻（原移动圆点在 now 起点域下恒在左缘，退化为标线）。
+          React.createElement('span', {
+            'data-testid': 'quota-peak-now',
+            style: { position: 'absolute', top: 0, bottom: 0, left: 0, width: '3px', borderRadius: '3px', background: 'var(--dsw-specific-menu)' },
+          })),
+          showCaption === true ? React.createElement('div', {
+            'data-testid': 'quota-peak-caption',
+            style: { fontSize: '11px', lineHeight: 1.6, color: 'var(--dsw-alias-label-tertiary)', marginTop: '2px' },
+          }, translate('quota.peak.caption')) : null)
+      }
+
       /** 手录重置卡的统一文案与过期态：卡片行与圆环面板共用。v0.20 起免次数。 */
       function resetCardContent(card, translate) {
         const rawExpiry = typeof card.expiresAt === 'string' && card.expiresAt.trim() !== '' ? card.expiresAt.trim() : ''
@@ -2063,12 +2243,17 @@ window.__ModuleLoader__.load({
         }, [open])
         if (row === undefined || row === null) return null
         const percent = tightest === null ? 0 : tightest.percent
-        const remainingBasis = tightest !== null && tightest.remaining === true
+        // 纯文本窗口（余额类：DeepSeek/Kimi/硅基流动）没有百分比可「已用」，头部按剩余口径显示；
+        // 百分比窗口仍按方言的 remaining 标记切换已用/剩余。
+        const hasPercentWindow = tightest !== null
+        const remainingBasis = !hasPercentWindow || tightest.remaining === true
         const usedWord = remainingBasis ? translate('quota.panel.remaining') : translate('quota.panel.used')
         const color = (remainingBasis ? percent <= 20 : percent >= 80) ? 'var(--dsw-alias-state-warn-primary)' : 'var(--dsw-alias-state-success-primary)'
         const radius = 5.5
         const circumference = 2 * Math.PI * radius
-        const ariaText = `${translate('quota.ring.label')} · ${provider} · ${usedWord} ${percent}%`
+        const ariaText = hasPercentWindow
+          ? `${translate('quota.ring.label')} · ${provider} · ${usedWord} ${percent}%`
+          : `${translate('quota.ring.label')} · ${provider}`
         const retrySuffix = typeof row.nextAllowedAt === 'number' && row.nextAllowedAt > Date.now()
           ? ` · ${translate('quota.retryAt', { time: formatClockTime(row.nextAllowedAt) })}`
           : ''
@@ -2120,6 +2305,9 @@ window.__ModuleLoader__.load({
             React.createElement('span', { style: { marginLeft: 'auto', fontSize: '11px', color: 'var(--dsw-alias-label-secondary)' } }, provider)),
           React.createElement('div', { style: { marginTop: '10px', display: 'flex', flexDirection: 'column', gap: '8px' } },
             windows.map((window) => renderQuotaWindowRow(window, translate, null))),
+          ...(deepseekPeakVisible(row, windows)
+            ? [React.createElement(QuotaPeakTimeline, { key: 'panel-peak-timeline', showCaption: false })]
+            : []),
           ...(Array.isArray(row.resetCards) && row.resetCards.length > 0
             ? [React.createElement('div', { key: 'panel-reset-cards', style: { marginTop: '8px', display: 'flex', flexDirection: 'column', gap: '4px' } },
                 row.resetCards.map((card, cardIndex) => {
@@ -2743,10 +2931,24 @@ window.__ModuleLoader__.load({
         const adaptProvider = (providerName, kind) => requestQuotaConfig({ provider: providerName, kind })
         // 删掉手动覆盖键，回退 baseURL 自动推断。
         const clearAdaptedKind = (providerName) => requestQuotaConfig({ provider: providerName, clear: true })
+        // 卡片手动排序：localStorage 名单驱动展示序（纯客户端，宿主契约不动）；新供应商自然排末尾。
+        const [cardOrder, setCardOrder] = useState(readQuotaCardOrder())
+        // 排序模式开关（用户点名）：平时不显示 ↑↓，点「调整排序」才出现，避免卡片头部常驻小钮。
+        const [reorderMode, setReorderMode] = useState(false)
         // 卡片分区（v0.20）：只展示已适配供应商；未适配/已停用的不渲染灰行，统一收进底部「手动适配」行。
-        const adaptedRows = providers.filter((row) => row.adapted === true)
+        const adaptedRows = applyQuotaCardOrder(providers.filter((row) => row.adapted === true), cardOrder)
         const candidateRows = providers.filter((row) => row.adapted !== true)
         const quotaSelectStyle = { fontSize: '12px', padding: '3px 6px', borderRadius: '6px', border: '1px solid var(--dsw-alias-border-l2)', background: 'var(--dsw-alias-bg-layer-2)', color: 'var(--dsw-alias-label-primary)' }
+        // ↑↓ 换位：以当前可见卡序列表交换相邻项并整体落盘（新见过的供应商一并入册）。
+        const moveQuotaCard = (providerName, delta) => {
+          const names = adaptedRows.map((row) => row.provider)
+          const from = names.indexOf(providerName)
+          const to = from + delta
+          if (from < 0 || to < 0 || to >= names.length || from === to) return
+          names.splice(to, 0, names.splice(from, 1)[0])
+          setCardOrder(names)
+          writeQuotaCardOrder(names)
+        }
         // 手动适配行（未适配/已停用的候选供应商）的选择状态；拆成两个独立 state 避免对象草稿接力更新。
         const [addProvider, setAddProvider] = useState('')
         const [addKind, setAddKind] = useState('')
@@ -2785,12 +2987,34 @@ window.__ModuleLoader__.load({
               style: { width: '34px', height: '20px', borderRadius: '10px', padding: 0, flexShrink: 0, position: 'relative', border: `1px solid ${quotaNav ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-border-l2)'}`, background: quotaNav ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-bg-layer-2)', cursor: 'pointer', lineHeight: 0 },
             }, React.createElement('span', { style: { position: 'absolute', top: '1px', left: quotaNav ? '15px' : '1px', width: '16px', height: '16px', borderRadius: '50%', background: quotaNav ? '#fff' : 'var(--dsw-alias-label-tertiary)' } }))),
           configError !== '' ? React.createElement('p', { 'data-testid': 'quota-config-error', style: Object.assign({}, hint, { color: 'var(--dsw-alias-state-error-primary)' }) }, configError) : null,
+          // 「调整排序」开关（≥2 张卡才有意义）：进入后卡片头部出现 ↑↓，再点一次收起。
+          ...(adaptedRows.length >= 2
+            ? [React.createElement('div', { key: 'quota-reorder-row', style: { display: 'flex', justifyContent: 'flex-end', margin: '2px 0 8px' } },
+                React.createElement('button', {
+                  type: 'button',
+                  'data-testid': 'quota-reorder-toggle',
+                  'aria-pressed': String(reorderMode),
+                  title: translate('quota.reorder'),
+                  onClick: () => setReorderMode(!reorderMode),
+                  style: { fontSize: '12px', lineHeight: '20px', padding: '2px 12px', borderRadius: 999, border: `1px solid ${reorderMode ? 'var(--dsw-alias-brand-primary)' : 'var(--dsw-alias-border-l2)'}`, background: 'transparent', color: reorderMode ? 'var(--dsw-alias-brand-primary)' : 'var(--dsw-alias-label-secondary)', cursor: 'pointer' },
+                }, translate('quota.reorder')))]
+            : []),
           adaptedRows.length === 0
             ? React.createElement('p', { style: hint }, translate('quota.noAdapted'))
-            : React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: '10px' } },
-                adaptedRows.map((row) => {
+            : React.createElement('div', { 'data-testid': 'quota-card-list', style: { display: 'flex', flexDirection: 'column', gap: '10px' } },
+                adaptedRows.map((row, index) => {
                   const nameNode = React.createElement('span', { style: { fontWeight: 600, fontSize: '12px', overflowWrap: 'anywhere' } },
-                    row.displayName || row.provider,
+                    // 官网用量页链接（用户点名）：宿主按 kind 下发 usageUrl 时，展示名本身即外链。
+                    typeof row.usageUrl === 'string' && row.usageUrl !== ''
+                      ? React.createElement('a', {
+                          'data-testid': `quota-usage-link-${row.provider}`,
+                          href: row.usageUrl,
+                          target: '_blank',
+                          rel: 'noreferrer',
+                          title: translate('quota.usageLink'),
+                          style: { color: 'var(--dsw-alias-brand-primary)', textDecoration: 'underline' },
+                        }, row.displayName || row.provider)
+                      : (row.displayName || row.provider),
                     row.kindSource === 'auto'
                       ? React.createElement('span', {
                           'data-testid': `quota-auto-tag-${row.provider}`,
@@ -2812,6 +3036,10 @@ window.__ModuleLoader__.load({
                   } else {
                     body = React.createElement('span', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-tertiary)' } }, translate('quota.empty'))
                   }
+                  // DeepSeek 余额卡专属：峰谷提示（状态徽标 + 换挡倒计时 + 24h 色带 + 随北京时间移动的圆点）。
+                  const peakTimeline = deepseekPeakVisible(row, windows)
+                    ? React.createElement(QuotaPeakTimeline, { key: 'peak-timeline', showCaption: true })
+                    : null
                                     // 手录重置卡（v0.19 过渡方案；v0.20 免次数、可多条）：每条一行，行尾自带「移除」。
                   const resetCardNodes = Array.isArray(row.resetCards)
                     ? row.resetCards.map((card, cardIndex) => {
@@ -2848,6 +3076,28 @@ window.__ModuleLoader__.load({
                     React.createElement('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'baseline', gap: '10px' } },
                       nameNode,
                       React.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: '5px' } },
+                        // 手动排序（用户点名）：仅在「调整排序」模式下出现；↑↓ 与相邻卡换位，
+                        // 首/末卡对应方向禁用；顺序存本浏览器。
+                        ...(reorderMode ? [
+                          React.createElement('button', {
+                            type: 'button',
+                            'data-testid': `quota-move-up-${row.provider}`,
+                            'aria-label': translate('quota.card.moveUp'),
+                            title: translate('quota.card.moveUp'),
+                            disabled: index === 0,
+                            onClick: () => moveQuotaCard(row.provider, -1),
+                            style: { display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: '16px', height: '16px', padding: 0, border: 'none', background: 'transparent', color: index === 0 ? 'var(--dsw-alias-label-tertiary)' : 'var(--dsw-alias-label-secondary)', cursor: index === 0 ? 'default' : 'pointer', opacity: index === 0 ? 0.45 : 1, fontSize: '12px', lineHeight: '16px' },
+                          }, '↑'),
+                          React.createElement('button', {
+                            type: 'button',
+                            'data-testid': `quota-move-down-${row.provider}`,
+                            'aria-label': translate('quota.card.moveDown'),
+                            title: translate('quota.card.moveDown'),
+                            disabled: index === adaptedRows.length - 1,
+                            onClick: () => moveQuotaCard(row.provider, 1),
+                            style: { display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: '16px', height: '16px', padding: 0, border: 'none', background: 'transparent', color: index === adaptedRows.length - 1 ? 'var(--dsw-alias-label-tertiary)' : 'var(--dsw-alias-label-secondary)', cursor: index === adaptedRows.length - 1 ? 'default' : 'pointer', opacity: index === adaptedRows.length - 1 ? 0.45 : 1, fontSize: '12px', lineHeight: '16px' },
+                          }, '↓'),
+                        ] : []),
                         // 手动刷新：SVG 图标按钮，点击强制该 provider 重拉上游；在途时置灰防重入。
                         React.createElement('button', {
                           type: 'button',
@@ -2862,6 +3112,7 @@ window.__ModuleLoader__.load({
                           ? React.createElement('span', { style: { fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } }, translate('quota.updated', { time: formatClockTime(row.fetchedAt) }))
                           : null)),
                     body,
+                    ...(peakTimeline !== null ? [peakTimeline] : []),
                     ...(row.status === 'unconfigured' && Array.isArray(row.credentialHints) && row.credentialHints.length > 0
                       ? (() => {
                           const editingCred = credEditor !== null && credEditor.provider === row.provider
@@ -2902,7 +3153,7 @@ window.__ModuleLoader__.load({
                                   'data-testid': `quota-cred-edit-${row.provider}`,
                                   onClick: () => openCredEditor(row),
                                   style: { fontSize: '12px', lineHeight: '20px', padding: '4px 14px', borderRadius: 999, border: '1px solid var(--dsw-alias-brand-primary)', background: 'transparent', color: 'var(--dsw-alias-brand-primary)', cursor: 'pointer', width: 'auto', minWidth: 0, overflow: 'visible', flex: '0 0 auto', whiteSpace: 'nowrap' },
-                                }, translate('quota.credential.edit')))]
+                                }, translate(row.kind === 'cliproxy' ? 'quota.credential.editManagement' : 'quota.credential.edit')))]
                         })()
                       : []),
                     ...resetCardNodes,

package/index.js

@@ -79,6 +79,8 @@ const KIND_REGISTRY = {
     parser: normalizeOpencodeUsage,
     keyHints: ['OPENCODE_GO_API_KEY', 'OPENCODE_API_KEY'],
     hosts: ['opencode.ai'],
+    // 官网用户页（卡片标题外链；宿主常量，零浏览器输入）。
+    usageUrl: 'https://opencode.ai/',
   },
   'zai-coding-cn': {
     parser: normalizeZaiCodingUsage,
@@ -88,6 +90,7 @@ const KIND_REGISTRY = {
     ],
     keyHints: ['ZAI_CODING_CN_API_KEY', 'ZAI_API_KEY', 'BIGMODEL_API_KEY'],
     hosts: ['open.bigmodel.cn', 'bigmodel.cn'],
+    usageUrl: 'https://open.bigmodel.cn/coding-plan/personal/usage',
   },
   openrouter: {
     parser: normalizeOpenRouterCredits,
@@ -107,6 +110,15 @@ const KIND_REGISTRY = {
     keyHints: ['SILICONFLOW_API_KEY'],
     hosts: ['siliconflow.cn'],
   },
+  // DeepSeek 开放平台官方余额（v0.25）：GET /user/balance，Bearer 即 API key。
+  // balance_infos[] 每项一个币种（文档枚举 CNY/USD），金额是字符串，total = granted + topped_up。
+  deepseek: {
+    parser: normalizeDeepseekBalance,
+    endpoints: ['https://api.deepseek.com/user/balance'],
+    keyHints: ['DEEPSEEK_API_KEY'],
+    hosts: ['api.deepseek.com', 'deepseek.com'],
+    usageUrl: 'https://platform.deepseek.com/usage',
+  },
   // CLIProxyAPI（router-for-me/CLIProxyAPI）管理面：查它托管的 OAuth 上游账号官方额度。
   // 无固定 endpoints / 全局 hosts——每个部署一个域名，保存适配时把 settings baseURL 的
   // hostname 钉进配置 allowedHosts[provider]（见 quota-config 写入口），外呼前复验精确命中。
@@ -724,6 +736,53 @@ function readLlmProviders(settings) {
     }))
 }
 
+/**
+ * 运行时 LLM 渠道别名表（v0.25）：DSH 有 settings 之外的内置 LLM 渠道（如 dsh-llm-deepseek
+ * 注册的 deepseek-official 路由），它们不出现在 llm-pi-ai.providers 清单里，额度查询却同样适用。
+ * 只有「kind 固定端点 + keyHints 齐备」的渠道才允许进表——进表即自证兼容（官方域名、凭据线索
+ * 宿主常量），延续零意外外呼口径：不在表内的运行时渠道一概不产生行。
+ */
+const QUOTA_RUNTIME_CHANNEL_KINDS = {
+  'deepseek-official': 'deepseek',
+}
+
+/** 运行时 llm 服务已注册渠道 → 合成 provider 行（runtimeKind 标记别名来源）。服务缺席/异常返回空表。
+ * 注意 listProviders() 的真实契约（dsh-llm 源码核实）：下发 [{id,name,…}] 对象数组、注册顺序，
+ * 不是字符串——v0.25 首版按字符串过滤导致全部条目被静默跳过（测试假桩喂字符串掩盖了 bug）。 */
+function readRuntimeQuotaChannels(llm) {
+  if (llm === undefined || llm === null || typeof llm.listProviders !== 'function') return []
+  let providers
+  try {
+    providers = llm.listProviders()
+  } catch (_) {
+    return []
+  }
+  if (!Array.isArray(providers)) return []
+  const channels = []
+  for (const entry of providers) {
+    const id = typeof entry === 'string' ? entry : entry !== null && typeof entry === 'object' ? entry.id : undefined
+    if (typeof id !== 'string' || id.length === 0 || id.length > MAX_QUOTA_PROVIDER_NAME) continue
+    if (!Object.prototype.hasOwnProperty.call(QUOTA_RUNTIME_CHANNEL_KINDS, id)) continue
+    const kind = QUOTA_RUNTIME_CHANNEL_KINDS[id]
+    if (KIND_REGISTRY[kind] === undefined) continue
+    const displayName = typeof entry === 'object' && entry !== null && typeof entry.name === 'string' && entry.name.trim() !== ''
+      ? entry.name.trim().slice(0, 128)
+      : id
+    channels.push({ name: id, displayName, baseURL: '', apiKeyEnv: '', runtimeKind: kind })
+  }
+  return channels
+}
+
+/** 额度查询的供应商清单 = settings 路由在前 + 运行时别名渠道殿后（settings 同名条目优先）。 */
+function readQuotaProfiles(settings, llm) {
+  const profiles = readLlmProviders(settings)
+  const known = new Set(profiles.map((profile) => profile.name))
+  for (const channel of readRuntimeQuotaChannels(llm)) {
+    if (!known.has(channel.name)) profiles.push(channel)
+  }
+  return profiles
+}
+
 /**
  * opencode-go 方言 → 统一窗口形状。真实端点只有 percent 与 resetsAt（ISO），
  * 没有金额字段：percent 是一等公民，缺字段/非数字跳过该窗口，percent 截到 [0,100]。
@@ -822,7 +881,8 @@ function cliproxyFetchGuard(profile, config) {
 
 /**
  * 单个 provider 的 kind 解析（quota 与 quota-refresh 共用）。
- * 优先序：配置显式 kind > 配置 null（手动停用，永不外呼）> baseURL 自动推断；未命中返回空对象。
+ * 优先序：配置显式 kind > 配置 null（手动停用，永不外呼）> baseURL 自动推断 >
+ * 运行时渠道别名（readRuntimeQuotaChannels 合成的行带 runtimeKind）；未命中返回空对象。
  */
 function resolveQuotaKind(config, profile) {
   if (Object.prototype.hasOwnProperty.call(config.kinds, profile.name)) {
@@ -832,6 +892,7 @@ function resolveQuotaKind(config, profile) {
     return {}
   }
   const inferred = inferQuotaKind(profile.baseURL)
+    ?? (profile.runtimeKind !== undefined && KIND_REGISTRY[profile.runtimeKind] !== undefined ? profile.runtimeKind : undefined)
   if (inferred !== undefined && KIND_REGISTRY[inferred] !== undefined) return { kind: inferred, kindSource: 'auto' }
   return {}
 }
@@ -966,6 +1027,50 @@ function normalizeSiliconFlowInfo(payload) {
   return { windows: [{ id: 'balance', text: `¥${(Math.round(n * 100) / 100).toFixed(2)}` }] }
 }
 
+/**
+ * DeepSeek 官方余额（v0.25）：{is_available, balance_infos:[{currency,total_balance,granted_balance,topped_up_balance}]}
+ * → 文本窗口。每币种一行总额；赠金 > 0 时追加一行（官方口径：granted 是未过期赠金，total 含赠金+充值）。
+ * currency 作为 label（纯数据，多币种区分），窗口名走客户端词典（双语教义：宿主不拼用户可见句子，
+ * 货币符号 ¥/$ 属于数字格式化惯例，与 kimi 解析器同口径）。is_available 不改写金额——余额为 0 时
+ * 数字本身已说明问题，不伪造状态文案。
+ */
+function normalizeDeepseekBalance(payload) {
+  const infos = Array.isArray(payload?.balance_infos) ? payload.balance_infos : []
+  const windows = []
+  const seenCurrencies = new Set()
+  for (const info of infos) {
+    if (info === null || typeof info !== 'object') continue
+    const rawCurrency = typeof info.currency === 'string' ? info.currency.trim().toUpperCase() : ''
+    // 文档枚举 CNY/USD；其他三~八字母码照收（上游扩展不炸），形状不对的条目丢弃。
+    const currency = /^[A-Z]{3,8}$/.test(rawCurrency) ? rawCurrency : ''
+    if (currency === '' || seenCurrencies.has(currency)) continue
+    const total = normalizeDeepseekMoney(info.total_balance)
+    if (total === null) continue
+    seenCurrencies.add(currency)
+    const idSuffix = currency.toLowerCase()
+    windows.push({ id: `balance-${idSuffix}`, text: deepseekMoneyText(total, currency), label: currency, kindKey: 'balance' })
+    const granted = normalizeDeepseekMoney(info.granted_balance)
+    if (granted !== null && Number(granted) > 0) {
+      windows.push({ id: `granted-${idSuffix}`, text: deepseekMoneyText(granted, currency), label: currency, kindKey: 'granted-balance' })
+    }
+  }
+  return { windows }
+}
+
+/** DeepSeek 金额字段归一：字符串/数字均可（官方下发字符串），负数或非有限值拒绝；
+ * 空白串也拒绝——Number('') 是 0，会把上游缺数据伪装成 ¥0.00。保留两位小数。 */
+function normalizeDeepseekMoney(value) {
+  if (typeof value === 'string' && value.trim() === '') return null
+  const n = Number(value)
+  if (!Number.isFinite(n) || n < 0) return null
+  return (Math.round(n * 100) / 100).toFixed(2)
+}
+
+function deepseekMoneyText(amount, currency) {
+  const symbol = currency === 'CNY' ? '¥' : currency === 'USD' ? '$' : ''
+  return symbol === '' ? `${amount} ${currency}` : `${symbol}${amount}`
+}
+
 // ─── CLIProxyAPI（cliproxy）管理面编排 ──────────────────────────────────────
 // 上游官方额度端点注册表（经 CPA api-call 代调，header 的 $TOKEN$ 由 CPA 替换为对应账号凭据）。
 // 形状来源：muyouzhi6/astrbot_plugin_cliproxy_stats + CPA main 分支源码（2026-08 核实）；
@@ -3511,7 +3616,7 @@ function apply(ctx) {
     if (endpoint === 'quota') {
       if (!featureEnabled('quotaLookup')) return { ok: false, error: 'feature-disabled' }
       try {
-        const providers = readLlmProviders(ctx.get('settings'))
+        const providers = readQuotaProfiles(ctx.get('settings'), ctx.get('llm'))
         quotaThrottle.prune(new Set(providers.map((profile) => profile.name)))
         const config = await refreshQuotaConfigCache()
         const allResetCards = Array.isArray(config.resetCards) ? config.resetCards : []
@@ -3576,6 +3681,8 @@ function apply(ctx) {
             nextAllowedAt: view.nextAllowedAt,
             ...(providerResetCards.length > 0 ? { resetCards: providerResetCards } : {}),
             ...(credentialHints !== undefined ? { credentialHints } : {}),
+            // 官网用户页余额网址（宿主常量白名单随 kind 下发；无则缺省）。
+            ...(typeof KIND_REGISTRY[kind].usageUrl === 'string' && KIND_REGISTRY[kind].usageUrl !== '' ? { usageUrl: KIND_REGISTRY[kind].usageUrl } : {}),
           })
         }
         return { ok: true, value: { providers: rows, serverTime: Date.now() } }
@@ -3590,7 +3697,7 @@ function apply(ctx) {
         // 手动刷新入口：provider 过白名单且 kind 已适配；清掉节流闸后立即 kick。
         // 单飞仍生效（在途时本次点击为 no-op）；上游结果经后续 quota 快照带出，不在此等待。
         const providerName = typeof payload?.provider === 'string' ? payload.provider : ''
-        const profile = readLlmProviders(ctx.get('settings')).find((candidate) => candidate.name === providerName)
+        const profile = readQuotaProfiles(ctx.get('settings'), ctx.get('llm')).find((candidate) => candidate.name === providerName)
         if (profile === undefined) return { ok: false, error: 'unknown-provider' }
         const config = await refreshQuotaConfigCache()
         const { kind } = resolveQuotaKind(config, profile)
@@ -3613,7 +3720,7 @@ function apply(ctx) {
         const providerName = typeof payload?.provider === 'string' ? payload.provider : ''
         // 三种写法，语义对齐配置文件解析（显式 kind > 显式 null 停用 > 自动推断）：
         // {clear:true} 删掉覆盖键回退自动推断；{kind:null} 存显式停用（baseURL 可推断也不外呼）；{kind:<name>} 指定适配。
-        const profileForProvider = readLlmProviders(ctx.get('settings')).find((candidate) => candidate.name === providerName)
+        const profileForProvider = readQuotaProfiles(ctx.get('settings'), ctx.get('llm')).find((candidate) => candidate.name === providerName)
         if (profileForProvider === undefined) return { ok: false, error: 'unknown-provider' }
         return await serializeQuotaConfigWrite(async (config) => {
           if (payload?.clear === true) {
@@ -3653,7 +3760,7 @@ function apply(ctx) {
       if (!featureEnabled('quotaLookup')) return { ok: false, error: 'feature-disabled' }
       try {
         const providerName = typeof payload?.provider === 'string' ? payload.provider : ''
-        const profileForProvider = readLlmProviders(ctx.get('settings')).find((candidate) => candidate.name === providerName)
+        const profileForProvider = readQuotaProfiles(ctx.get('settings'), ctx.get('llm')).find((candidate) => candidate.name === providerName)
         if (profileForProvider === undefined) return { ok: false, error: 'unknown-provider' }
         const config = await refreshQuotaConfigCache()
         const { kind } = resolveQuotaKind(config, profileForProvider)
@@ -3694,7 +3801,7 @@ function apply(ctx) {
         // provider 过宿主清单白名单；{remove:true,id} 删除宿主下发 id 对应的那一条，
         // 其余载荷为追加一条（label/expiresAt 截断限长），单 provider 上限 10 条防配置膨胀。
         const providerName = typeof payload?.provider === 'string' ? payload.provider : ''
-        if (!readLlmProviders(ctx.get('settings')).some((candidate) => candidate.name === providerName)) {
+        if (!readQuotaProfiles(ctx.get('settings'), ctx.get('llm')).some((candidate) => candidate.name === providerName)) {
           return { ok: false, error: 'unknown-provider' }
         }
         return await serializeQuotaConfigWrite(async (config) => {
@@ -3758,6 +3865,7 @@ export {
   name,
   normalizeAntigravityModels,
   normalizeCodexRateLimit,
+  normalizeDeepseekBalance,
   normalizeGeminiBuckets,
   normalizeKimiBalance,
   normalizeOpencodeUsage,
@@ -3799,6 +3907,7 @@ export default {
   name,
   normalizeAntigravityModels,
   normalizeCodexRateLimit,
+  normalizeDeepseekBalance,
   normalizeGeminiBuckets,
   normalizeKimiBalance,
   normalizeOpencodeUsage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gehennawu/dsh-service",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "DSH Web 自托管运维面板：安全重启、健康监控、备份和 Linux 权限维护。",
   "type": "module",
   "scripts": {