dsh-plugin-provider-quota

DeepSeek Harness（DSH） 的 Web 插件：在侧边栏底部展示模型 Provider 的订阅额度、限流窗口与账户余额（如 DeepSeek），点击读数即可查看详情。读数注册在 sidebar.footer.action（root 作用域），新会话页面与所有页面常驻，切换会话不重挂载、不闪烁。

功能特性

• 紧凑额度读数：侧边栏展开时每个 Provider 一行，显示订阅周期和最短限额窗口的剩余比例，例如 Kimi 66% · 5h 34%、Codex 5h 94%、DeepSeek ¥110.00；侧边栏收起为窄栏时退化为单个指示灯圆点（颜色取所有 Provider 的最差状态）。
• 可视化详情：点击读数在浮层中展示会员等级、剩余额度、已用进度、重置时间、路由状态、更新时间，以及余额型 Provider 的币种总余额与充值/赠送明细。浮层渲染在 shell.overlay 图层，不会被侧边栏裁剪。
• 额度预警：剩余比例高于 35% 显示绿色，高于 10% 且不超过 35% 显示黄色，10% 及以下显示红色；存在多个 Provider 或窗口时采用最差状态。余额型 Provider 在账户余额不足（is_available: false）时读数变红并在详情中提示。
• 回合末刷新：每轮对话结束后 2 秒静默全量刷新一次额度（读数在 root 作用域拿不到聊天节点，无法精准定位本轮 Provider，故退化为全量刷新）。
• 自动轮询：每 5 分钟更新一次，Host 端使用 30 秒缓存以减少外部请求；客户端保留最近一次成功结果，任何重挂载都先渲染缓存、后台静默刷新，不会闪烁。
• 安全凭据解析：通过 DSH credentials 服务读取 apiKeyEnv 引用，原始凭据不会发送到浏览器，也不会写入响应或日志。

支持的 Provider

Provider	路由 ID	额度接口	凭据说明
Kimi For Coding	kimi-coding	https://api.kimi.com/coding/v1/usages（另请求 /coding/v1/me 取会员等级展示名 user_level_name）	使用该路由 apiKeyEnv 引用的凭据，通常为 KIMI_API_KEY。
OpenAI Codex	openai-codex	https://chatgpt.com/backend-api/wham/usage	使用 CODEX_OAUTH_ACCESS_TOKEN；建议由 dsh-plugin-llm-codex 完成 OAuth 登录和自动刷新。
DeepSeek	deepseek-official	https://api.deepseek.com/user/balance	由 DSH 自带的 dsh-llm-deepseek 插件注册，凭据缺省引用 DEEPSEEK_API_KEY（可在 llm-deepseek.apiKeyEnv 覆盖）。余额是货币金额而非百分比订阅额度，详情展示各币种总余额与充值/赠送明细。

插件只展示同时满足以下条件的 Provider：

1. 已在本插件的 Provider 注册表中支持；
2. 已在 DSH 中配置对应路由 —— providers 型（Kimi/Codex）在 llm-pi-ai.providers 配置；命名空间型（DeepSeek）由 dsh-llm-deepseek 注册、路由激活即展示，无需额外配置。