zcode-switch README

The project's README from github.com/pjpv/zcode-switch. As one markdown file: README.md.

Z·SWITCH (zcode-switch)

简体中文 | English

Tauri 2 桌面工具:在多个 ZCode 账号之间一键切换,自动显示额度。只换登录身份——项目、会话、设置全部共用不动。

screenshot

功能

安全设计

CLI

zcode-switch.exe --cli state|list
zcode-switch.exe --cli quota [--id <账号id>]
zcode-switch.exe --cli claim-preview [--id <账号id>]
zcode-switch.exe --cli capture [--name 名称]
zcode-switch.exe --cli switch --id <id> [--force] [--restart|--no-restart] [--hot <bool>|--no-hot]
zcode-switch.exe --cli kill
zcode-switch.exe --cli export --id <id> --out <a.zsb>
zcode-switch.exe --cli export-all --out <all.zsb>
zcode-switch.exe --cli import --file <file.zsb>
zcode-switch.exe --cli rename|delete|update|behavior|setpath|launch
zcode-switch.exe --cli --lang en state              # 英文输出(--lang 空格传值、可置于任意位置;默认跟 GUI 语言/系统语言)

CLI 密码(export / import):优先环境变量 ZSW_PASSWORD(不出现在进程列表和命令历史),也可 --password <密码>。

常见问题

macOS 弹出「麦克风 / 辅助功能 / 录屏」权限询问?

全部拒绝即可,不影响任何功能,验证码照常通过。 应用内嵌的登录/验证码网页由系统 WebView 渲染,网页发起的请求会被透传为应用的系统权限询问;应用本体与其内嵌网页均未使用这三项能力。

构建

npm install
npm run tauri dev      # 开发(HMR)
npm run tauri build    # NSIS 安装包
cd src-tauri && cargo test   # 单元测试(含 node↔Rust 跨语言加密向量)

Windows 优先(路径探测 / 进程管理 / 托盘均为 Win32 语义)。

License

MIT

zcode-switch (pjpv/zcode-switch)

Searching Database…

这是什么?Z·SWITCH 是一个 Tauri 2 桌面工具,让你在多个 ZCode(BigModel / z.ai)账户之间一键切换,内联显示每个账户的额度,而且不会碰你当前的项目、会话或设置。
这是图形界面应用,还是也能用脚本调用?它主要是一个带托盘图标和主窗口的 Tauri 桌面应用,但也附带一个 CLI,用于自动化的导出/导入操作。
怎么添加和切换账户?在应用内通过 OAuth(BigModel 或 z.ai 入口)添加新账户,不会打扰当前已登录的账户,然后在已保存的账户之间一键切换;切换时会对凭据和配置文件做快照并原子化地交换。
需要已有 BigModel 或 z.ai 账户吗?需要,这个工具只管理你已有账户之间的切换;每个账户都要通过应用内置的 BigModel 或 z.ai OAuth 流程登录。
它在 Windows 和 macOS 上的支持一样稳吗?这个应用以 Windows 优先构建,路径检测、进程管理和托盘行为都采用 Win32 语义;在 macOS 上,内嵌的登录/验证码 WebView 可能触发无害的麦克风、辅助功能或屏幕录制权限弹窗,直接拒绝即可。
.zsb 备份文件里有什么?.zsb 是一个加密的账户打包文件,用 PBKDF2-HMAC-SHA256(10 万次迭代)和带随机 salt/nonce 的 AES-256-GCM 保护,密码错误时只会解密失败,不会留下任何明文痕迹。
额度显示是怎么工作的?每个已保存账户的行内会显示其套餐额度和重置时间,多个套餐会被分组并按错开的时间表轮询,以避免触发限流。
导出/导入时能不在屏幕上输入密码吗?可以,CLI 支持通过 ZSWPASSWORD 环境变量传入密码,这样它不会出现在进程列表或 shell 历史里;你也可以直接传 --password。
应用里的 “领取活动” 是什么意思?对于带可领取推广活动的套餐,你可以一键领取(需通过图形界面验证码验证),或使用 “刷新资格” 按钮在限速冷却之下手动重新检查每个账户的领取资格。
Creator
pjpv
Size
1 MB
Stars
413
Age
1mo
Commits · 90 Days