chore(release): update release notes, changelog and macOS minimum version for v3.12.3

Update CHANGELOG.md with full v3.12.3 entry, create release notes in
three languages (en/zh/ja), bump macOS minimumSystemVersion from 10.15
to 12.0 (Monterey) to match actual runtime requirements, and update
README version badges and links.
This commit is contained in:
Jason
2026-03-16 08:32:05 +08:00
parent fc08a5d364
commit 36bbdc36f5
8 changed files with 103 additions and 21 deletions

View File

@@ -1,6 +1,6 @@
# CC Switch v3.12.3
> Tool Search 域名限制绕过、代理 Gzip 压缩与 o 系列模型兼容性、Skills 导入健壮性提升
> Tool Search 域名限制绕过、Skill 备份/恢复生命周期、代理 Gzip 压缩与 o 系列模型兼容性
**[English →](v3.12.3-en.md) | [日本語版 →](v3.12.3-ja.md)**
@@ -8,17 +8,18 @@
## 概览
CC Switch v3.12.3 新增了通过二进制补丁绕过 Tool Search 域名白名单限制的功能,改进了代理对 OpenAI o 系列模型的兼容性和 gzip 压缩支持,并修复了 Skills 导入、供应商表单和终端会话恢复等方面的问题。Skills 导入流程从基于文件系统的隐式推断改为显式应用选择,消除了多应用错误激活的 bug
CC Switch v3.12.3 新增了通过二进制补丁绕过 Tool Search 域名白名单限制的功能,引入了完整的 Skill 备份/恢复生命周期,改进了代理对 OpenAI o 系列模型的兼容性和 gzip 压缩支持,并修复了 Skills 导入、供应商表单和终端会话恢复等方面的问题。Skill 卸载前会自动备份并支持恢复和删除管理,导入流程从基于文件系统的隐式推断改为显式应用选择。
**发布日期**2026-03-15
**发布日期**2026-03-16
**更新规模**13 commits | 47 files changed | +1,764 / -122 lines
**更新规模**17 commits | 61 files changed | +3,335 / -194 lines
---
## 重点内容
- **Tool Search 域名绕过**:新增设置项,通过等长二进制补丁移除 Claude CLI Tool Search 域名白名单检查,启动时自动备份和重新应用
- **Skill 备份/恢复生命周期**:卸载前自动备份 Skill 文件;新增备份列表、恢复和删除管理
- **代理 Gzip 压缩**:非流式代理请求现在自动协商 gzip 压缩,减少带宽消耗
- **o 系列模型兼容性**Chat Completions 代理正确使用 `max_completion_tokens` 处理 o1/o3/o4-mini 模型Responses API 保持使用正确的 `max_output_tokens` 字段
@@ -38,6 +39,23 @@ CC Switch v3.12.3 新增了通过二进制补丁绕过 Tool Search 域名白名
- 设置启用时,应用启动自动重新应用补丁
- 前端检查补丁结果,失败时自动回滚设置
### Skill 卸载自动备份
卸载 Skill 前自动备份文件,防止数据意外丢失。
- 备份存储在 `~/.cc-switch/skill-backups/`,包含所有 skill 文件和记录原始元数据的 `meta.json`
- 旧备份自动清理,最多保留 20 个
- 备份路径返回前端并在成功提示中显示
### Skill 备份恢复与删除
新增卸载时创建的 Skill 备份的管理功能。
- 列出所有可用的 skill 备份及元数据
- 恢复操作将文件拷回 SSOT保存数据库记录并同步到当前应用失败时自动回滚
- 删除操作在确认对话框后移除备份目录
- ConfirmDialog 新增可配置的 zIndex 属性,支持嵌套对话框堆叠
---
## 变更
@@ -97,6 +115,14 @@ Skills 导入流程经过重构,提升正确性和清理能力。
- 改善存在 TOC 标题时的响应式布局 (#1491)
### Skills 导入对话框白屏
- 在 ImportSkillsDialog 中补充缺失的 TooltipProvider修复打开对话框时的运行时崩溃
### 面板底部空白区域
- 将所有内容面板的硬编码 `h-[calc(100vh-8rem)]` 替换为 `flex-1 min-h-0`,消除因不同平台偏移量不匹配导致的底部空白
---
## 下载与安装
@@ -108,7 +134,7 @@ Skills 导入流程经过重构,提升正确性和清理能力。
| 系统 | 最低版本 | 架构 |
| ------- | ----------------------------- | ----------------------------------- |
| Windows | Windows 10 及以上 | x64 |
| macOS | macOS 10.15 (Catalina) 及以上 | Intel (x64) / Apple Silicon (arm64) |
| macOS | macOS 12 (Monterey) 及以上 | Intel (x64) / Apple Silicon (arm64) |
| Linux | 见下表 | x64 |
### Windows