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) и показывающий квоту каждого аккаунта рядом, не затрагивая ваш текущий проект, сессию или настройки.
Это GUI-приложение или оно работает и из скриптов?Это прежде всего десктопное приложение Tauri с иконкой в трее и главным окном, но в комплекте есть и CLI для автоматизированных операций экспорта/импорта.
Как добавлять и переключать аккаунты?Внутри приложения вы добавляете новый аккаунт через OAuth (точки входа BigModel или z.ai), не трогая аккаунт, под которым вошли сейчас, а затем переключаетесь между сохранёнными аккаунтами одним кликом; при переключении делается снимок файлов учётных данных и конфигов, и они атомарно подменяются.
Нужны ли существующие аккаунты BigModel или z.ai?Да, этот инструмент лишь управляет переключением между аккаунтами, которые у вас уже есть; в каждый вы входите через встроенный в приложение OAuth-процесс для BigModel или z.ai.
Одинаково ли надёжна поддержка на Windows и macOS?Приложение построено с приоритетом Windows: определение путей, управление процессами и поведение трея используют семантику Win32; на macOS встроенный WebView для входа/капчи может вызывать безвредные запросы разрешений на микрофон, специальные возможности или запись экрана, которые можно просто отклонить.
Что внутри файла резервной копии .zsb?.zsb — зашифрованный бандл аккаунта, защищённый PBKDF2-HMAC-SHA256 (100 тысяч итераций) и AES-256-GCM со случайными salt/nonce, поэтому неверный пароль просто не расшифровывает данные, не оставляя следа в открытом виде.
Как работает отображение квоты?В строке каждого сохранённого аккаунта показываются квота тарифа и время сброса, причём несколько тарифов группируются и опрашиваются по разнесённому расписанию, чтобы избежать rate limit.
Можно запускать экспорт/импорт, не вводя пароль на экране?Да, CLI принимает пароль через переменную окружения ZSWPASSWORD, так что он не появится в списке процессов или истории shell, либо можно передать --password напрямую.
Что значит «claiming activities» в этом приложении?Для тарифов с доступными акциями вы можете забрать их в один клик (с проверкой капчи в GUI) или использовать кнопку «обновить право на акцию», чтобы вручную перепроверять право каждого аккаунта на получение с ограниченным по частоте кулдауном.
Creator
pjpv
Size
1 MB
Stars
414
Age
1mo
Commits · 90 Days