⬇️ 下载
English | 简体中文
macOS / Windows / Linux 安装包发布在 GitHub Releases：
👉 最新版本 — github.com/leochan007/cc-mode-switcher/releases/latest
只有当三个系统的构建全部上传成功后，Release 才会对外发布，因此每个已发布的版本都包含完整的安装包。
选择对应文件
| 系统 | 文件 | 说明 |
|---|---|---|
| macOS（Apple Silicon） | .dmg | arm64 构建，适配 M1/M2/M3/M4 芯片。macOS 12+ |
| Windows 10/11 | .exe | NSIS 安装器（64 位） |
| Linux | .AppImage | x86-64，免安装，下载即可运行 |
历史版本：查看全部 Releases。
安装说明
macOS
打开
.dmg，把 CC Mode Switcher 拖入Applications。应用未做代码签名（没有 Apple 开发者证书），首次启动会被 Gatekeeper 拦截：右键点击应用 → 打开 → 打开（只需一次，之后 macOS 会记住选择）。
提示"已损坏，无法打开"？ 部分 macOS 版本会把未签名的
.dmg直接判定为 损坏。先清除隔离属性，再重新打开：双击
.dmg之前先执行bashxattr -cr /Users/xxx/Downloads/CC-Mode-Switcher-x.x.x-arm64.dmg把
xxx换成你的用户名、x.x.x换成实际下载的版本号。执行后再次双击.dmg， 按第 1 步继续即可。
Windows
- 运行
.exe，按 NSIS 向导完成安装。 - 未签名应用首次运行会弹出 SmartScreen：更多信息 → 仍要运行。
Linux
bash
chmod +x 'CC Mode Switcher-*.AppImage'
./'CC Mode Switcher-*.AppImage'如果无法启动，请安装 libfuse2（AppImage 依赖）：sudo apt install libfuse2。
使用 tips
工单里反复出现的几个安装后坑 —— 一次性看完，省一下午：
- macOS / Windows 首次启动慢。 系统每次冷启动都要校验 app 包。splash 出现后等 5–15 秒，Switcher Tab 才会显示；之后启动秒开。
- "在终端中打开"在 Windows / Linux 上没反应。 这个按钮仅 macOS 可用 —— 它走 AppleScript 驱动
Terminal.app/ iTerm。其他系统完整功能都 在，只是要通过 toolbar 的 ▶ 触发会话。 - Models → 📡 测试报 "unreachable"，但 API 是好的。 检查代理 / 公司 VPN 是否放行了 provider base URL 的 HTTPS。GET 返回 401/404 算"可达" （DNS + TLS 没问题）。
- 终端 Tab 里
cc-plan/cc-worker找不到。 先在 toolbar 点一次 ▶ 让应用重新生成~/.cc-mode-switcher/.launch-cache/launch.sh，再开新 Tab。 旧 Tab 保留创建时的绑定。 - 改了角色配置，旧会话里没生效。 参数在会话创建时已快照。开新 Tab （▶ 或
Cmd+N/Cmd+T）才会用上新绑定。 - 想回到出厂状态。 ⚙️ 设置 → 重置角色 会把
roles.yaml还原到 出厂默认（不会动你的 prompt 文件和models.yaml）。 - launch.sh 不见了？ 删掉
~/.cc-mode-switcher/.launch-cache/后点一次 ▶，应用会当场重新生成。
各平台功能差异
完整 UI（模型管理、模式绑定、设置）在所有系统上均可使用； 「在终端中打开」目前仅支持 macOS（通过 AppleScript 和 .command 文件驱动 Terminal.app / iTerm）。