Starstruk Logo MarkStarstruk

v3.3.0

farion1231/cc-switchv3.3.0Sep 22, 2025by github-actions[bot]

AI Summary

v3.3.0 is a major feature release for cc-switch that introduces VS Code Codex plugin integration with one-click vendor card operations, custom common templates for reusable configurations, and WSL environment support. The release also enables VS Code auto-sync by default and includes various platform-specific improvements for Linux, macOS, and Windows.

Key Highlights

  • VS Code Codex plugin integration with one-click apply/remove for vendor cards
  • Custom common templates for reusable configurations (e.g., CC no-sign, Codex MCP)
  • Windows WSL environment support with configurable Claude Code/Codex directories
  • VS Code auto-sync enabled by default for multi-window consistency
  • Platform improvements: Linux blur fix, macOS Dock restore, macOS tray stability

New Features

  • VS Code Codex plugin vendor card one-click apply/remove operation (writes to settings.json)
  • Custom common template support for reusable vendor configurations
  • Default VS Code auto-sync for tray/window vendor switching
  • Codex wizard enhancement with display name, dedicated API Key URL, and form validation
  • Common config snippet management for JSON/TOML reuse and validation
  • Windows WSL environment support with configurable Claude Code/Codex directories
  • Provider data includes created_at timestamp for time-based sorting
  • @codemirror/lint bundled for real-time editor validation hints

Full Release Notes

## Release Note v3.3.0

### 新增功能

  - 新增 VS Code Codex 插件的供应商卡片“一键应用/移除”操作，自动写入 settings.json
  - 新增自定义通用模板，可以便捷的将自定义内容（比如 CC 的禁止签名、Codex 的 MCP）应用到每个供应商设置
  - 默认启用 VS Code 自动同步，托盘切换或窗口切换供应商都会静默写入，保持多窗口一致
  - Codex 向导增强：支持展示名称、专用 API Key URL 与更清晰的表单校验，第三方服务配置更顺畅
  - 引入通用配置片段管理，统一在 JSON/TOML 里复用、校验与提示，减少重复配置
  - 新增 Windows WSL 环境支持，可以在设置里指定 Claude Code 与 Codex 的配置目录，供应商与主目录保持一致
 
<img width="890" height="444" alt="截屏2025-09-22 23 09 20" src="https://github.com/user-attachments/assets/8181302e-c2d5-4ec9-b119-e409069fef3b" />


###  体验改进

  - 托盘菜单隐藏主窗口后仍可操作，按钮样式与文案统一，操作反馈更清晰
  - Linux 自动禁用模态背景模糊避免卡死；
  - macOS Dock 点击即可恢复窗口
  - Provider 数据新增 created_at 时间戳，供应商可以正常按时间排序

###  缺陷修复

  - 修正 Codex 配置向导中的正则转义与片段修剪，避免校验误报
  - 修复 macOS 系统托盘显示不稳定的问题
  - 加固 VS Code 同步流程，提升 TOML/JSON 解析稳定性并减少布局跳动
  - 随应用打包 @codemirror/lint，恢复编辑器的实时校验提示

###  升级提示

  - 如果您正在使用的是 v3.1.2 或之前版本，首次运行仍会执行一次性迁移：扫描旧副本文件并合并到 ~/.cc-switch/config.json，完成后不再重复归档
  - 建议升级前备份现有配置，升级后确认 ~/.cc-switch/config.json 正常写入并验证自动同步状态
 
 ### 下载与安装

  - Windows：MSI 安装包与便携 zip（便携版无法使用内置更新器，后续更新需要手动下载新版）
  - macOS：.app.zip（首次运行如提示“未知开发者”，在“系统设置 → 隐私与安全性”选择“仍要打开”）
  - Linux：.deb、AppImage

 ### 反馈与支持

  - 问题与建议：请提交 Issue 并附带系统信息、复现步骤与日志
  - 安全与隐私：应用仅在本地写入 ~/.cc-switch 与 ~/.claude 与 ~/.codex，不上传任何敏感数据