Starstruk Logo MarkStarstruk

v3.3.1

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

AI Summary

cc-switch v3.3.1 introduces significant cross-platform enhancements including Windows WSL support, improved VS Code auto-sync functionality, and Codex wizard improvements. This release also adds DeepSeek-V3.1-Terminus support, custom template capabilities, and fixes several platform-specific issues for macOS and Linux.

Key Highlights

  • Added Windows WSL environment support with configurable Claude Code and Codex directories
  • Enhanced VS Code auto-sync - tray/window vendor switching now silently writes to settings.json
  • Improved Codex wizard with display name support, dedicated API Key URL, and clearer form validation
  • Fixed macOS system tray display instability and Linux modal background blur issues
  • Added DeepSeek-V3.1-Terminus model support

New Features

  • DeepSeek-V3.1-Terminus support
  • Custom common templates for reusable vendor settings (CC prohibited signatures, Codex MCP)
  • VS Code Codex plugin vendor card one-click apply/remove operation
  • Default VS Code auto-sync across multiple windows
  • Codex wizard enhancement with display name, API Key URL, and form validation
  • Common config snippet management for JSON/TOML reuse and validation
  • Windows WSL environment support with configurable Claude Code and Codex directories
  • Provider data with created_at timestamp for time-based sorting
  • macOS Dock click to restore window

Full Release Notes

## Release Note v3.3.1

### 新增功能

  - 新增对 DeepSeek-V3.1-Terminus 的支持
  - 新增自定义通用模板，可以便捷的将自定义内容（比如 CC 的禁止签名、Codex 的 MCP）应用到每个供应商设置
  - 新增 VS Code Codex 插件的供应商卡片“一键应用/移除”操作，自动写入 settings.json
  - 默认启用 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，不上传任何敏感数据