From 36bbdc36f52543044e209bbc496ebd571f5d70ea Mon Sep 17 00:00:00 2001 From: Jason Date: Mon, 16 Mar 2026 08:32:05 +0800 Subject: [PATCH] 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. --- CHANGELOG.md | 8 +++++-- README.md | 2 +- README_JA.md | 2 +- README_ZH.md | 2 +- docs/release-notes/v3.12.3-en.md | 36 +++++++++++++++++++++++++++----- docs/release-notes/v3.12.3-ja.md | 36 +++++++++++++++++++++++++++----- docs/release-notes/v3.12.3-zh.md | 36 +++++++++++++++++++++++++++----- src-tauri/tauri.conf.json | 2 +- 8 files changed, 103 insertions(+), 21 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7f7b79e6..a1acd534 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,13 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [3.12.3] - 2026-03-15 -Post-v3.12.2 work on `main` adds a Tool Search domain restriction bypass, improves proxy compatibility for OpenAI o-series models and gzip compression, and delivers robustness fixes for Skills import, provider forms, and terminal session restore. +Post-v3.12.2 work adds a Tool Search domain restriction bypass, skill backup/restore lifecycle, proxy compatibility for OpenAI o-series models and gzip compression, and robustness fixes for Skills import, provider forms, and terminal session restore. -**Stats**: 13 commits | 47 files changed | +1,764 insertions | -122 deletions +**Stats**: 17 commits | 61 files changed | +3,335 insertions | -194 deletions ### Added - **Tool Search Domain Bypass**: Added setting to bypass Claude CLI Tool Search domain whitelist via equal-length binary patching; backups stored in `~/.cc-switch/toolsearch-backups/` with auto-reapply on startup when enabled +- **Skill Auto-Backup**: Skill files are automatically backed up to `~/.cc-switch/skill-backups/` before uninstall, with metadata preserved in `meta.json`; old backups pruned to keep at most 20 +- **Skill Backup Restore & Delete**: Added list/restore/delete commands for skill backups; restore copies files back to SSOT, saves the DB record, and syncs to the current app with rollback on failure ### Changed @@ -31,6 +33,8 @@ Post-v3.12.2 work on `main` adds a Tool Search domain restriction bypass, improv - **Skill ZIP Install Target App**: ZIP skill installs now use the currently active app instead of always defaulting to Claude - **OpenClaw Active Card Highlight**: Fixed active OpenClaw provider card not being highlighted (#1419) - **Responsive Layout with TOC**: Improved responsive design when TOC title exists (#1491) +- **Import Skills Dialog White Screen**: Added missing TooltipProvider in ImportSkillsDialog to prevent runtime crash when opening the dialog +- **Panel Bottom Blank Area**: Replaced hardcoded `h-[calc(100vh-8rem)]` with `flex-1 min-h-0` across all content panels to eliminate bottom gap caused by mismatched offset values --- diff --git a/README.md b/README.md index 68818827..6b910709 100644 --- a/README.md +++ b/README.md @@ -244,7 +244,7 @@ For detailed guides on every feature, check out the **[User Manual](docs/user-ma ### System Requirements - **Windows**: Windows 10 and above -- **macOS**: macOS 10.15 (Catalina) and above +- **macOS**: macOS 12 (Monterey) and above - **Linux**: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ and other mainstream distributions ### Windows Users diff --git a/README_JA.md b/README_JA.md index 49859ccd..03163c3a 100644 --- a/README_JA.md +++ b/README_JA.md @@ -244,7 +244,7 @@ CC Switch は「最小限の介入」という設計原則に従っています ### システム要件 - **Windows**: Windows 10 以上 -- **macOS**: macOS 10.15 (Catalina) 以上 +- **macOS**: macOS 12 (Monterey) 以上 - **Linux**: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ など主要ディストリビューション ### Windows ユーザー diff --git a/README_ZH.md b/README_ZH.md index 3dc32d34..a608705e 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -247,7 +247,7 @@ CC Switch 使用“通用配置片段”功能，在不同的供应商之间传 ### 系统要求 - **Windows**：Windows 10 及以上 -- **macOS**：macOS 10.15 (Catalina) 及以上 +- **macOS**：macOS 12 (Monterey) 及以上 - **Linux**：Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版 ### Windows 用户 diff --git a/docs/release-notes/v3.12.3-en.md b/docs/release-notes/v3.12.3-en.md index a81788eb..3e7552cc 100644 --- a/docs/release-notes/v3.12.3-en.md +++ b/docs/release-notes/v3.12.3-en.md @@ -1,6 +1,6 @@ # CC Switch v3.12.3 -> Tool Search Domain Bypass, Proxy Gzip & o-Series Compatibility, Skills Import Robustness +> Tool Search Domain Bypass, Skill Backup/Restore Lifecycle, Proxy Gzip & o-Series Compatibility **[中文版 →](v3.12.3-zh.md) | [日本語版 →](v3.12.3-ja.md)** @@ -8,17 +8,18 @@ ## Overview -CC Switch v3.12.3 adds a Tool Search domain restriction bypass via binary patching, improves proxy compatibility for OpenAI o-series models and gzip compression, and delivers robustness fixes for Skills import, provider forms, and terminal session restore. The Skills import flow has been reworked from implicit filesystem inference to explicit app selection, eliminating incorrect multi-app activation bugs. +CC Switch v3.12.3 adds a Tool Search domain restriction bypass via binary patching, introduces a full skill backup/restore lifecycle, improves proxy compatibility for OpenAI o-series models and gzip compression, and delivers robustness fixes for Skills import, provider forms, and terminal session restore. Skills are now automatically backed up before uninstall with restore and delete management, and the import flow has been reworked from implicit filesystem inference to explicit app selection. -**Release Date**: 2026-03-15 +**Release Date**: 2026-03-16 -**Update Scale**: 13 commits | 47 files changed | +1,764 / -122 lines +**Update Scale**: 17 commits | 61 files changed | +3,335 / -194 lines --- ## Highlights - **Tool Search domain bypass**: New setting to remove Claude CLI Tool Search domain whitelist via equal-length binary patching, with automatic backup and reapply on startup +- **Skill backup/restore lifecycle**: Skills are automatically backed up before uninstall; backup list with restore and delete management added - **Proxy gzip compression**: Non-streaming proxy requests now auto-negotiate gzip compression, reducing bandwidth usage - **o-series model compatibility**: Chat Completions proxy correctly uses `max_completion_tokens` for o1/o3/o4-mini models; Responses API kept on the correct `max_output_tokens` field @@ -38,6 +39,23 @@ Added a setting to bypass Claude CLI Tool Search domain whitelist restrictions. - The patch auto-reapplies on app startup when the setting is enabled - Frontend checks patch result and rolls back the setting on failure +### Skill Auto-Backup on Uninstall + +Skill files are now automatically backed up before uninstall to prevent accidental data loss. + +- Backups stored in `~/.cc-switch/skill-backups/` with all skill files and a `meta.json` containing original metadata +- Old backups are automatically pruned to keep at most 20 +- Backup path is returned to the frontend and shown in the success toast + +### Skill Backup Restore & Delete + +Added management commands for skill backups created during uninstall. + +- List all available skill backups with metadata +- Restore copies files back to SSOT, saves the DB record, and syncs to the current app with rollback on failure +- Delete removes the backup directory after a confirmation dialog +- ConfirmDialog gains a configurable zIndex prop to support nested dialog stacking + --- ## Changes @@ -97,6 +115,14 @@ The Skills import flow has been reworked for correctness and cleanup. - Improved responsive design when TOC title exists (#1491) +### Import Skills Dialog White Screen + +- Added missing TooltipProvider in ImportSkillsDialog to prevent runtime crash when opening the dialog + +### Panel Bottom Blank Area + +- Replaced hardcoded `h-[calc(100vh-8rem)]` with `flex-1 min-h-0` across all content panels to eliminate bottom gap caused by mismatched offset values on different platforms + --- ## Download & Installation @@ -108,7 +134,7 @@ Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) to dow | System | Minimum Version | Architecture | | ------- | ------------------------------- | ----------------------------------- | | Windows | Windows 10 or later | x64 | -| macOS | macOS 10.15 (Catalina) or later | Intel (x64) / Apple Silicon (arm64) | +| macOS | macOS 12 (Monterey) or later | Intel (x64) / Apple Silicon (arm64) | | Linux | See table below | x64 | ### Windows diff --git a/docs/release-notes/v3.12.3-ja.md b/docs/release-notes/v3.12.3-ja.md index 51164196..8a152e1e 100644 --- a/docs/release-notes/v3.12.3-ja.md +++ b/docs/release-notes/v3.12.3-ja.md @@ -1,6 +1,6 @@ # CC Switch v3.12.3 -> Tool Search ドメイン制限バイパス、プロキシ Gzip 圧縮と o シリーズモデル互換性、Skills インポートの堅牢性向上 +> Tool Search ドメイン制限バイパス、Skill バックアップ/リストアライフサイクル、プロキシ Gzip 圧縮と o シリーズモデル互換性 **[中文版 →](v3.12.3-zh.md) | [English →](v3.12.3-en.md)** @@ -8,17 +8,18 @@ ## 概要 -CC Switch v3.12.3 は、バイナリパッチによる Tool Search ドメインホワイトリスト制限のバイパス機能を追加し、OpenAI o シリーズモデルのプロキシ互換性と gzip 圧縮を改善し、Skills インポート、プロバイダーフォーム、ターミナルセッション復元の堅牢性を修正しました。Skills インポートフローがファイルシステムベースの暗黙的な推論から明示的なアプリ選択に変更され、複数アプリの誤った有効化バグが解消されました。 +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 プロキシが o1/o3/o4-mini モデルに `max_completion_tokens` を正しく使用。Responses API は正しい `max_output_tokens` フィールドを維持 @@ -38,6 +39,23 @@ Claude CLI Tool Search のドメインホワイトリスト制限をバイパス - 設定が有効な場合、アプリ起動時にパッチを自動的に再適用 - フロントエンドがパッチ結果を確認し、失敗時に設定を自動ロールバック +### Skill アンインストール時の自動バックアップ + +アンインストール前に Skill ファイルを自動バックアップし、意図しないデータ損失を防止します。 + +- バックアップは `~/.cc-switch/skill-backups/` に保存され、すべての skill ファイルと元のメタデータを含む `meta.json` が含まれます +- 古いバックアップは自動的にプルーニングされ、最大 20 個を保持 +- バックアップパスはフロントエンドに返され、成功トーストに表示 + +### Skill バックアップのリストアと削除 + +アンインストール時に作成された Skill バックアップの管理コマンドを追加しました。 + +- すべての利用可能な skill バックアップをメタデータ付きで一覧表示 +- リストアはファイルを SSOT にコピーし、DB レコードを保存し、現在のアプリに同期。失敗時は自動ロールバック +- 削除は確認ダイアログの後にバックアップディレクトリを削除 +- 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 diff --git a/docs/release-notes/v3.12.3-zh.md b/docs/release-notes/v3.12.3-zh.md index 772da0ee..b7299ba5 100644 --- a/docs/release-notes/v3.12.3-zh.md +++ b/docs/release-notes/v3.12.3-zh.md @@ -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 diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json index 65a6cd09..93701c72 100644 --- a/src-tauri/tauri.conf.json +++ b/src-tauri/tauri.conf.json @@ -50,7 +50,7 @@ } }, "macOS": { - "minimumSystemVersion": "10.15" + "minimumSystemVersion": "12.0" } }, "plugins": {