zcode switch 是一款基于 Tauri 2 的 Windows 桌面工具，专门用来在多个 ZCode 账号之间一键切换登录身份。它只替换当前登录凭据，已经打开的项目、运行中的会话和本地设置全部保持不动，同时把每个账号的套餐额度与重置时间直接列在主界面，省去反复扫码登录和手动查余额的麻烦。
作为一款面向 AI应用 场景的 实用软件，Z·SWITCH 适合需要同时维护多个 ZCode 账号的人，比如同时持有个人号与工作号、团队共用设备，或需要区分生产与测试环境的开发者。文章接下来会介绍它的核心功能、安装流程、安全设计以及 CLI 自动化用法。
主界面：账号卡片内联显示有效期、套餐类型、额度使用比例与重置时间，当前登录账号置顶，其余账号可一键切换或领取活动。
场景痛点
如果你同时拥有两个以上 ZCode 账号，每次切号都要退出当前登录、重新扫码、等待同步，中间还可能忘记当前用的是哪个号。团队里多人共用一台机器时，这种反复登录更容易打断思路。Z·SWITCH 把切换做成一个按钮，同时把额度信息直接放在账号卡片里，在 效率提升 的同时降低误操作风险。
核心功能
一键保存与切换账号
Z·SWITCH 在切换前会自动快照当前的 credentials 和 config 文件，并用原子替换写入目标账号的登录信息。如果当前账号还没入库，工具会先提示保存，避免误切导致丢号。
内置 OAuth 添加新账号
不需要退出当前登录，直接在工具内通过 BigModel 或 z.ai 双入口完成 OAuth 登录，新账号自动加入账号库。
额度展示与活动领取
每个账号卡片内联显示套餐额度、使用比例和重置时间；支持多套餐分组和错峰轮询。对于可领取的套餐活动，可以直接在界面内点击领取，并弹出 GUI 验证码。
加密导入导出
账号库可以导出为 .zsb 捆绑包，使用 PBKDF2-HMAC-SHA256（10 万次迭代）+ AES-256-GCM 口令加密。CLI 导入导出时优先使用环境变量 ZSW_PASSWORD，也可以用 --password 参数传入。
中英双语与 CLI 自动化
设置里一键切换中文 / English，主窗、托盘、错误提示和 CLI 输出全覆盖，首次运行按系统语言自动选择。同时提供完整的 CLI 支持，支持 state、list、quota、switch、export、import 等命令，可配合脚本或定时任务实现 自动化。
安全设计
所有账号数据保存在本地，无遥测、无远端存储，额度查询直连官方接口。切换前自动保全当前登录；文件写入走临时文件 + 原子 rename，降低写入中断导致凭据损坏的风险。账号 ID 使用白名单 [A-Za-z0-9-]，删除和读取操作均不可逃出账号库目录。导出文件的口令派生与加密过程含单测断言。
关于 WebView CSP：为加载阿里云验证码 SDK，工具在 script-src 基线 'self' 基础上放行了 'unsafe-inline'、'unsafe-eval' 与 o.alicdn.com / *.alicdn.com；connect-src 仅白名单放行 *.aliyuncs.com、*.aliyun.com、ynuf.aliapp.org 与 alicdn；img-src 放行 https: 仅因验证码弹窗素材域名不固定。界面交互不依赖 eval，事件走白名单式分发。这些设计让 隐私保护 与功能需求之间取得了明确边界。
安装与使用
前置条件
- Windows 系统（路径探测、进程管理和托盘为 Win32 语义）
- 已安装 ZCode 客户端
- 若从源码构建，需要 Node.js 和 Rust 工具链
下载安装
前往 GitHub Release 页面下载 Z·SWITCH v1.4.0 的安装包，按向导完成安装即可。安装后首次启动会按系统语言自动选择中文或英文界面。
日常使用
- 打开 Z·SWITCH，点击「保存当前登录」把当前 ZCode 账号入库。
- 点击「添加账号」，按提示完成 OAuth 登录新账号。
- 在主界面点击目标账号右侧的「切换」，工具会自动替换登录凭据并重启 ZCode。
- 需要导出时，使用
zcode-switch.exe --cli export --id <账号id> --out <文件名.zsb>，并设置环境变量ZSW_PASSWORD或在命令行传入--password。
我的使用感受
zcode switch 把原本需要退出、扫码、再登录的多账号切换流程压缩成一个按钮，额度展示也让「哪个号还有多少 Token」一目了然。本地优先的数据处理和加密导出让它在多人共用设备或跨机迁移时更放心，CLI 的存在则为批量运维留出了空间。对于经常使用多个 ZCode 账号的用户来说，这是一款值得尝试的 效率工具。
官方网站
https://github.com/pjpv/zcode-switch
下载地址
https://pan.quark.cn/s/67450f3724b0
