dsh-plugin-zquota
English | 中文
DeepSeek Harness 的智谱 GLM Coding Plan 账号面板插件：多账号额度监控 + 一键切换当前账号。
- 额度监控：每账号三格 meter —— 5 小时窗口 / 每周 / MCP 月（≥70% 橙、≥90% 红），重置倒计时大于 1 天精确到小时、小于 1 天精确到分钟，MCP 月悬停可见分工具明细
- 一键切换 + 模型路由自动补齐（国内版/国际版通用）：「设为当前」把所选账号的 API Key 写入对应端点的凭据引用（国内版
ZAI_CODING_CN_API_KEY→ 路由zai-coding-cn；国际版ZAI_API_KEY→ 路由zai），同时自动补齐模型配置——全新安装（什么供应商都没配）首次点击即创建整条路由（API Key 引用、glm-5.3模型项：上下文 1,000,000 / 最大输出 128,000；端点用 DSH 内置目录默认，不写baseURL）并把默认模型切到该路由的glm-5.3；已配置的用户只补缺失项、不覆盖显式配置。「使用中」徽章跟随当前默认模型路由实际在用的账号。llm-pi-ai每次模型请求重新解析凭据与配置，下一次请求即生效，无需重启 - 数据归属：API Key（机密）存于本机
$DSH_HOME/.credentials.yaml（ZAI_QUOTA_KEY_<id>，与 DSH 自身凭据同库）；账号索引与额度快照（非机密状态）存于插件自有状态文件$DSH_HOME/zquota-state.json（0600、原子写）。API Key 明文永不进入浏览器 - 查询通路：Host 半用 Node 原生 fetch 直连
open.bigmodel.cn/api.z.ai（进程内 HTTPS，不经 shell/沙箱，无外部依赖），Key 仅进入内存中的请求头 - 样式：完整使用 DSH 设计令牌（
--dsw-alias-*），深浅色主题自动跟随
安装
前置：Node.js 环境（npx 会自动拉取 dsh，无需全局安装）。
# 一条命令安装并自动挂载（package.json 声明 dsh.bundle.patch，
# 安装后 dsh 自动把本插件加入 bundles 层）
npx @deepseek-ai/dsh plugin --profile web add github:wuyan19/dsh-plugin-zquota
# 刷新浏览器页面；若面板未出现，重启 dsh web查询与卸载：
# 查询 profile 里已安装的插件（--depth 0 只列直接依赖，即手动安装的插件）
npx @deepseek-ai/dsh plugin --profile web list --depth 0
# 卸载（自动从 bundles 层一并移除，重启 dsh web 后完全生效）
npx @deepseek-ai/dsh plugin --profile web remove dsh-plugin-zquota面板位置：设置 → GLM 编程套餐。
模型路由自动补齐（账号切换功能，国内版/国际版通用）
「设为当前」在写入 API Key 的同时，经 ctx.settings 检查并补齐 settings.yaml 中的两处用户配置（热加载，无需重启）。按账号端点选择路由：国内版 → zai-coding-cn / 凭据引用 ZAI_CODING_CN_API_KEY，国际版 → zai / 凭据引用 ZAI_API_KEY（两套账号体系，互不混用；补齐其中一条不会触碰另一条的配置）：
llm-pi-ai.providers.<route>：路由不存在时整条创建——apiKeyEnv: <对应凭据引用>、models: [{ id: glm-5.3, name: GLM-5.3, contextWindow: 1000000, maxTokens: 128000 }]。不写baseURL：路由键就是 pi-ai 内置目录的绑定，端点/协议由目录默认提供、目录更新后自动跟进；路由已存在时同样只补缺失项（apiKeyEnv改指本面板写点、被裁剪过的模型列表追加glm-5.3、为只有 id/name 的裸glm-5.3条目补全尺寸——不补会落到路由兜底 262144/32768），不覆盖用户显式配置——自定义baseURL（镜像网关）与已声明尺寸的模型条目原样保留agent-default-model：当前默认模型未指向<route>时整节写入；与 dsh-vision-router 兼容——其自动识图孪生路由<route>-vision（如zai-coding-cn-vision，动态注册、文字轮委托本体、共用同一凭据引用）视为「已指向」：provider 原样保留、不会被降级回本体，只把 model 对齐glm-5.3
「使用中」徽章的判定也随路由走：读当前默认模型路由落在哪条 GLM 编程路由上（识图孪生按其本体归属），就比对那条路由的凭据引用——双端点并存不会出现两个徽章，默认模型指向其他供应商时徽章不亮。
因此不再需要手工预配置：全新安装（什么供应商都没配）也能添加账号（国内版或国际版）后一键应用并直接开始对话。额度监控不依赖模型配置，任何账号添加后即可查询。
本地开发
git clone https://github.com/wuyan19/dsh-plugin-zquota
cd dsh-plugin-zquota
npm install
# 重建 client bundle（tsdown 来自本仓库 devDependencies，无需 DSH 源码仓库；
# lib/ 已随仓库提交，只有改 src/client.js 后才需要）
npm run build
# 以 link 方式装进 profile，改 host 代码重启 dsh web 即生效（host 半零构建）
npx @deepseek-ai/dsh plugin --profile web add /path/to/dsh-plugin-zquota
# 运行测试（路由补齐纯函数 planRouteProvision 的 正常/边界/失败 三态覆盖）
npm test架构
一个 npm 包携带两个半侧（与官方插件同构）：
| 半侧 | 入口 | 职责 |
|---|---|---|
| Host | src/host.js（exports "."，纯 ESM 零构建） | API Key 凭据存取、Node fetch 配额查询（不经沙箱）、状态文件维护（$DSH_HOME/zquota-state.json）、模型路由自动补齐（ctx.settings.mutate 路径编辑，只补缺失不覆盖）、webServer 前缀路由 /zquota-api 提供 JSON API |
| Client | lib/client.js（exports "./client"，闭包工厂 bundle） | settings.section 设置页 UI，同源 fetch 调用 /zquota-api |
package.json 的 dsh.client 声明让 web 外壳发现并服务该 bundle（/plugins/dsh-plugin-zquota/client.js）。 静态包没有动态插件的包私有 RPC 通道，同源 HTTP API 是其等价替代（带自定义头 + loopback Host 校验的本地防线）。
安全说明
- 凭据文件只放真机密：每个账号的 API Key（
ZAI_QUOTA_KEY_<id>，0600，与 DSH 自身凭据同库同权限等级）；非机密的账号索引与额度快照在插件自有状态文件$DSH_HOME/zquota-state.json（0600、temp+rename 原子写） - 浏览器半永远收不到 Key 明文（
state响应只含live标志） /zquota-api仅接受携带x-zquota-client头的 loopback 请求（防跨站简单请求与 DNS rebinding）
License
MIT