ZCode Switcher 用于本地保存和管理多个 ZCode 账号，支持额度显示、无感切换账号无需重启，以及 GLM-5.3 低额度自动切换。
所有账号档案保存在本机，不上传到第三方服务器。
| 功能 | 说明 |
|---|---|
| 本地账号管理 | 保存、重命名、删除、批量删除多个账号 |
| JSON 导入导出 | 方便备份、迁移账号档案 |
| 无感切换 | 无需重启 ZCode，切换账号后即时同步配置 |
| 额度显示 | 显示额度、订阅状态和刷新结果 |
| 重置窗口 | 额度卡显示 5 小时/周/月窗口的重置倒计时；工具栏统计各窗口卡片数量；窗口到点自动刷新对应账号并复位耗尽状态 |
| 重置卡 | 设置里开启"自动使用重置卡"：窗口剩余 ≤1%（可调）时自动用卡回满，周余额 ≤5%（可调）或用尽选周卡、否则 5 小时卡；显示库存并支持手动使用 |
| GLM-5.3 自动切换 | 额度低于阈值时先切账号内有余额的套餐，全部套餐耗尽再切账号；也支持暂停执行等待人工处理 |
| 胶囊悬浮窗 | 显示 GLM-5.3 账号池统计，并支持调整大小 |
| 定时刷新 | 支持按分钟自动刷新额度，关闭后保留最近额度信息 |
| 多语言界面 | 支持中文、英文、俄文 |
| 应用内更新 | 检测新版、显示更新内容、下载并安装 |
请到 Releases 下载对应平台安装包：
- Windows x64：
ZCode.Switcher_x.x.x_x64-setup.exe - macOS Apple Silicon 内测版：
ZCode.Switcher_x.x.x_aarch64.dmg
macOS 安装包尚未完成 Apple Developer ID 公证，首次打开可能需要在“系统设置 → 隐私与安全”中手动允许。
- 先在 ZCode 中正常登录一个账号。
- 打开 ZCode Switcher，点击“保存当前账号”，把当前登录态保存到本地账号库。
- 如需添加更多账号，可以先在 ZCode 中切换登录，也可以在工具中使用 OAuth 登录添加或导入 JSON / ZIP 备份文件。
- 账号保存后，会在列表中显示昵称、订阅到期时间、额度进度条和刷新状态。
- 开启“无感切换”后，点击账号卡片的切换按钮即可切换账号。切换过程无需重启 ZCode，账号配置会即时生效。
- 如果使用 GLM-5.3，可开启低额度自动切换。默认“自动切换套餐/账号”：当前套餐余额低于阈值时先切换到账号内仍有余额的另一个套餐，所有套餐都低于阈值后才切换到剩余额度更高的账号；也可以选择“暂停执行”，低于阈值时拦截请求并等待人工处理。
- 如需常驻查看账号池状态，可开启胶囊悬浮窗模式，把额度统计放在桌面角落。
无需重启 ZCode，切号后配置即时生效。
本工具管的账号池，可以直接作为 magpie 的一个 provider 端出去：
- 插件：halfking/magpie-zcode-pool
—— 读取本工具的账号池（
~/.zcode/v2/account-profiles/），账号额度用完时自动换下一个 - 装法：
magpie plugin add <本地目录>→magpie plugin login zcode-pool - 效果：magpie 的网关多出
zcode-pool/GLM-5.3、zcode-pool/GLM-5.2等模型， 任意 Agent 都能用；本工具负责账号与额度，magpie 负责路由、用量与界面
接上以后有五件事：
- 换帐号登录：
magpie plugin login zcode-pool会让你挑池里的哪个账号；每登录一次， magpie 里就多一个独立账号，各带自己的额度卡，路由组可以在它们之间挑 - 用量/额度：每个账号的额度（5 小时窗口、周窗口、套餐名、到期时间）由插件读出来， 显示在 magpie 的额度卡和 Usage 页里，与本工具显示的同源
- 额度耗尽时自动接力：登录的那个账号额度用完，池里另一个账号接管，请求不中断 （provider 选项里可以关掉这个接力，改由 magpie 自己的路由组换账号）
- 重置卡（只读）：magpie 的额度卡上还多一行
↺重置次数（还剩几张能回满额度的卡）， 读的是本工具用的同一个厂商接口；用卡仍在本工具里做，插件只读不扣卡 - 赠券（只读）：额度卡上还有
-Trial的条目（ZCode 1024 Dev Day 的 token 桶）， 每个池账号各一份，用账号自己的 ZCode 会话读；赠券只认 ZCode 的登录身份，key 花不了 ⇒ 要花它，就把 ZCode 切到那个账号（本工具管的就是这个），官方@magpie-community/opencode-zcode-auth随即用上它
两个插件可以并存：官方的 @magpie-community/opencode-zcode-auth 是单账号登录
（OAuth、团队席位、Start Plan 归它管），zcode-pool 是本机多账号池。
导出的 JSON 和本地账号档案包含敏感信息，请妥善保存，不要上传到公开位置。
本工具是第三方辅助工具，与 ZCode / Z.ai 官方无关。请遵守相关平台规则，并自行承担账号使用风险。