智谱套餐面板 Ayelsh/dsh-zhipu-plan

dsh-zhipu-plan

智谱 coding-plan 签到、套餐额度、服务端用量，为 DeepSeek Harness 提供，以树外配置档包的形式发布。应用本身没有打任何补丁：插件装进配置档，加上自己的设置页，并注册 coding-plan 凭据，供内置 zai 服务商的路由读取。

它加了什么

- 设置 → 智谱套餐，由本包的浏览器端贡献，布局照着 ZCode 自己的用量页来：
- 剩余额度 — 每个额度池一张卡片：五小时提示词池、每周池、每月工具额度。每张卡片显示还剩多少、这个池什么时候刷新，以及一条用该池颜色画的进度条；还没动过的池不显示重置条目，因为重置也拿不回什么。
- 可重置额度 — 一个对话框，列出每个池剩余的比例，以及部署已经发放的重置次数，附上到期倒计时。
- 用量趋势 — 服务端的模型与工具总量、活跃度、缓存健康度、解码速度，以及账号上的订阅，可选 7 天、30 天或全部时间窗口。
- 对两个部署（Z.ai 国际版或 BigModel 大陆版）都能登录，覆盖个人版、Team 版和 Start 版：宿主打开中转的授权页，等待期间显示地址并带复制按钮，然后轮询直到这次尝试有结果。页面全程看不到 token。
- 那个页面背后的 zhipuPlan Remote 命名空间。应用自己的 Remote 组装只挂载它构建时带的命名空间，所以本插件在激活时挂载自己的贡献（见 src/wire/）。
- 登录后即可用的 GLM 模型。 服务把已登录部署的服务商路由写进内置 llm-pi-ai 条目的设置文档——就是 Models 页面编辑的那份文档——并在登出时清掉两条路由：zai-coding-cn 读 DSH_ZHIPU_PLAN_KEY，zai 读 DSH_ZHIPU_PLAN_KEY_ZAI。匹配的那个部署的模型会在选择器里解析出来；另一个部署的服务商保持休眠，向它发请求会明确报出缺少凭据，而不是打到错误的端点。包补丁保持只插入：一条覆盖别的包行的补丁行会比本包活得更久，还会让插件管理器卸不掉它。因为路由存在配置档自己的补丁层里，卸载一个已登录的账号会把它们（以及存下的套餐密钥）留在原地；想让模型也消失，去设置 → Models 里删掉。

授权接缝（@deepseek-ai/dsh-authorization）自 0.1.7-rc.2 起由安装自带的 dsh-base 挂载；本插件依赖它，并按 0.2.0-rc.1 校验。它的补丁刻意不自己插入接缝——dsh-base 已经声明过的一行，从这个层回来会变成重复的条目 id，让整棵树加载失败。

额度重置怎么运作

重置是由部署发放的，不是按个按钮买来的。有两件事会自己发生：
- 重置状态每五分钟重新读取一次，所以部署发放的重置会自己出现——「剩余额度」旁边的徽章会统计它们，并倒计时到最早到期的那一个。
- 手头没有重置时，页面会按部署自己的规则重复 ZCode 的资格请求（POST /api/v1/coding-plan/reset/opportunity）：最多每五分钟一次，并且在拒绝指定的时刻发起。正是这个请求让部署去考虑该账号；它绝不是用户按下的控件。

花掉一次重置是唯一的手动步骤，通过对话框完成。部署会确认它——窗口一直保持 processing，直到状态报告新的 usedAt，所以过期的读取不会让已花掉的重置看起来又可用。这与 ZCode 使用的机制相同（该仓库中的 packages/ui/src/lib/codingPlanQuotaResetCoordinator.ts、packages/services/src/usage-stats/providers/bigmodelUsageQuotaProvider.ts）。

本包中的 preview/plan-page.html 用固定数据渲染页面——已登录、重置对话框、等待界面和未登录界面——所以不用安装任何东西就能查看布局。

安装

构建包（见下文），然后把 tarball 安装到应用拥有的配置档中：

Desktop: Settings → Plugins accepts the spec below in the install field.
CLI (for a CLI-owned profile such as dsh web):
dsh plugin --profile web add ./dsh-zhipu-plan-0.2.0.tgz

Host 会重启受影响的插件图；要加载新安装的 bundle，可靠的方式是完整重启应用。然后打开 Settings → 智谱套餐，选择部署和套餐类型，并登录。

从 tarball 安装，不要从这个目录安装。 作为依赖安装的本地文件夹会变成指向它所在位置的 link:，而 Node 和 harness 都按真实路径解析链接的包。harness 只对 $DSH_HOME/profiles 下的导入方，把裸 @deepseek-ai/ 请求路由到正在运行的安装，所以链接到其他任何地方的文件夹——G:\dsh-build\dist\dsh-zhipu-plan-0.2.0、某个 checkout、桌面——都无法解析 @deepseek-ai/cordis，加载时会以 failed to import 失败。tarball 会解包到*配置档里，这就是它可行的原因。把文件夹复制到 $DSH_HOME/profiles/<profile>/node_modules/ 也行，因为这样它就在 profiles 树下了，但没有任何东西管理这份副本。

要移除它，用同样的方式卸载 bundle（remove dsh-zhipu-plan），这也会去掉它的补丁层。

构建

pnpm install
pnpm run build # writes lib/index.js, lib/typert.js, lib/client.js
pnpm pack # writes dsh-zhipu-plan-<version>.tgz
构建直接跑 esbuild，不走仓库的 client preset，因为这个包在仓库之外构建；随后它会检查自己产出的产物：浏览器 bundle 只 require shell 模块表能应答的 specifier，标记里用到的每个类名都存在于注入的样式表，两份字典携带相同的键，已发布的 wire 与服务源码点名的每个 Remote 方法在两侧都存在。

目录结构

| 路径 | 作用 |
| src/host/ | zhipuPlan 服务：中转登录、plan 凭据解析、监控与重置读取。从树内同形态的包移植而来。 |
| src/wire/ | 生成的 Typert 面。typert-host.js 是清单 @deepseek-ai/dsh-typert-loader 注册的产物，来自任何导出 ./typert 的已挂载包；typert-remote-client.js 是本插件通过 ctx.remote.$mount 挂载的浏览器贡献。 |
| src/client/ | Settings 页面。 |
| cordis.patch.yml | bundle 层：授权接缝与本插件，只做插入。 |

为什么 wire 面是复制来的，而不是在这里生成

仓库的 Typert 生成器会分析整个工作区上的 ts.Program，树外包没有这个。这两个文件就是它针对本服务的输出，只改了包名；一旦它们和 src/host/service.ts 对哪些方法是 Remote 产生分歧，pnpm run build 就会失败。

运行时依赖

host 那一半导入 @deepseek-ai/cordis、@deepseek-ai/dsh-authorization、@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-settings、@deepseek-ai/dsh-typert-protocol、@deepseek-ai/schemastery 和 zod。它们都属于已安装应用自身的依赖闭包，配置档的模块回退链接会把它们解析到运行进程已经加载的那几份副本——所以插件共享 host 的服务实例，而不是自带第二份副本。因此本包不声明任何依赖；安装它除了 tarball 什么都不会下载。

浏览器那一半从 shell 的模块表解析 react、react/jsx-runtime 和 @deepseek-ai/dsh-client-ui-primitives，其余全部内联。

说明与限制

- 登录走 ZCode 授权中转（zcode.z.ai），使用该产品的客户端身份。这是个人本地构建；中转的部署可能随时变化，地址属于配置而非代码（zhipu-plan 行上的 Config 字段）。
- plan 配额、用量和重置调用会读写智谱账号本身：花掉一次重置是对账号的真实改动，发送前会先确认。
- 登录解析出的 plan API key，会存进 harness 凭据库，用的引用名就是部署自己的那一个：BigModel 大陆部署用 DSH_ZHIPU_PLAN_KEY，Z.ai 国际部署用 DSH_ZHIPU_PLAN_KEY_ZAI。如果你在 Settings → Models 里手动配了 zai 服务商路由，它会把自己的 key 存在 ZAI_API_KEY 下，并且对该路由优先。
- host 那一半也要读 settings 服务，所以配置档必须挂载 @deepseek-ai/dsh-settings-file（每个随包发布的 app bundle 都挂了）。
- 原仓库内页面里的 application-usage 标签页（本地会话统计）不属于这个插件。

许可证与署名

MIT —— 见 LICENSE 和 NOTICE。

- src/host/ 下的 host 模块，以及 src/wire/ 下生成的 wire 模块，都源自 DeepSeek Harness 仓库内的 \@deepseek-ai/dsh-zhipu-plan\ 包（MIT，Copyright (c) 2026 DeepSeek）；\
eset.ts\ 和 \service.ts\ 是直接搬过来再扩展的。
- 登录和配额轮询要跟 ZCode 授权中继通信，这是一份没有文档的第三方契约，从 ZCode（Apache-2.0，Copyright 2026 Z.AI Co., Ltd）观察得来，在这里重新实现；本项目没有复制任何 ZCode 源码。

这个插件不是 Z.AI / Zhipu 或 DeepSeek 写的，跟它们没有隶属关系，也没得到它们的背书。中继会以 ZCode 自己的客户端身份签发 token，所以用这个插件可能违反 Z.ai 的服务条款，Z.ai 也可能随时撤销访问。每个中继源都是配置字段，所以这个依赖可以改指向别处，也可以直接去掉。「Z.ai」「Zhipu」「BigModel」「GLM」和「ZCode」是各自所有者的商标，这里只作描述性使用。