chore(release): consolidate v3.12.3 release notes, changelog and test fixes

Merge previously unreleased v3.12.4 content into v3.12.3: - CHANGELOG: combine [Unreleased] into [3.12.3], clear [Unreleased] - Release notes (zh/en/ja): add Copilot proxy, macOS signing, Reasoning Effort, OpenCode SQLite, Codex 1M toggle, Disable Auto-Upgrade toggle, and contributor thanks - Fix test mocks for skill backup/restore hooks - Fix schema migration test missing providers table - Fix TempHome to save/restore CC_SWITCH_TEST_HOME env var
2026-04-02 18:12:05 +08:00 · 2026-03-24 15:26:17 +08:00
parent 10be929f33
commit 155a226e6a
7 changed files with 479 additions and 107 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,26 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

 ## [Unreleased]

-Post-v3.12.3 work introduces GitHub Copilot reverse proxy support as a major new feature, adds intelligent reasoning_effort mapping for OpenAI o-series models, optimizes Skills cache invalidation, and delivers critical fixes for WebDAV password safety, tool message parsing, and dark mode.
+---

-**Stats**: 13 commits | 74 files changed | +6,080 insertions | -1,197 deletions
+## [3.12.3] - 2026-03-24
+
+Major release adding GitHub Copilot reverse proxy support, macOS code signing & Apple notarization, intelligent reasoning effort mapping for o-series models, skill backup/restore lifecycle, proxy gzip compression, and critical fixes for WebDAV password safety, tool message parsing, and dark mode.
+
+**Stats**: 36 commits | 107 files changed | +9,124 insertions | -802 deletions

 ### Added

 - **GitHub Copilot Reverse Proxy**: Full GitHub Copilot integration as a Claude Code provider via OAuth Device Code flow; includes multi-account management, automatic token refresh, Anthropic ↔ OpenAI format conversion, real-time model list fetching, and usage statistics (#930)
 - **Copilot Auth Center**: New Auth Center panel in Settings for managing GitHub accounts globally, with per-provider account binding via `meta.authBinding`
+- **Tool Search Toggle**: Added `ENABLE_TOOL_SEARCH` env var support for Claude 2.1.76+; exposed as a checkbox in the provider Common Config editor (#930)
 - **Reasoning Effort Mapping**: Two-tier `resolve_reasoning_effort()` for OpenAI o-series and GPT-5+ models — explicit `output_config.effort` takes priority, falling back to thinking `budget_tokens` thresholds (<4 000→low, 4 000–16 000→medium, ≥16 000→high); covers both Chat Completions and Responses API paths with 17 unit tests
- **OpenCode SQLite Backend**: Added SQLite session storage support for OpenCode alongside existing JSON backend; dual-backend scan with SQLite priority on ID conflicts, atomic session deletion, and path validation
+- **OpenCode SQLite Backend**: Added SQLite session storage support for OpenCode alongside existing JSON backend; dual-backend scan with SQLite priority on ID conflicts, atomic session deletion, and path validation (#1401)
+- **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
 - **macOS Code Signing & Notarization**: CI now imports an Apple Developer ID certificate, signs the universal binary, submits for Apple notarization, and staples the ticket to both `.app` and `.dmg`; a hard-fail verification step (`codesign --verify` + `spctl -a` + `stapler validate`) gates the release for both artifacts
+- **Codex 1M Context Window Toggle**: One-click checkbox in Codex config editor to set `model_context_window = 1000000` with auto-populated `model_auto_compact_token_limit = 900000`; unchecking removes both fields
+- **Disable Auto-Upgrade Toggle**: Added `DISABLE_AUTOUPDATER` env var checkbox in the Claude Common Config editor to prevent Claude Code from auto-upgrading

 ### Changed

- **Tool Search Mechanism Migration**: Replaced the binary-patching bypass (~590 lines in `toolsearch_patch.rs`) with Claude 2.1.76+ native `ENABLE_TOOL_SEARCH` env var toggle; moved the control from Settings page to the provider Common Config editor as a simple checkbox (#930)
 - **Skills Cache Strategy**: Replaced `invalidateQueries` with direct `setQueryData` updates for skill install/uninstall/import operations; added `staleTime: Infinity` with `keepPreviousData` to eliminate loading flicker (#1573)
+- **Proxy Gzip Compression**: Non-streaming proxy requests now auto-negotiate gzip compression instead of forcing `identity`; streaming requests conservatively keep `identity` to avoid SSE decompression errors
+- **o1/o3 Model Compatibility**: Chat Completions proxy forwarding now correctly uses `max_completion_tokens` instead of `max_tokens` for OpenAI o-series models such as o1/o3/o4-mini (#1451)
+- **OpenCode Model Variants**: Placed OpenCode model variants at top level instead of inside options for better discoverability (#1317)
+- **Skills Import Flow**: Replaced implicit filesystem-based app inference with explicit `ImportSkillSelection` to prevent incorrect multi-app activation; added reconciliation to remove disabled/orphaned symlinks and MCP servers from live config
 - **Claude 4.6 Context Window**: Updated Claude Opus 4.6 and Sonnet 4.6 context window from 200K to 1M across OpenClaw and OpenCode presets (GA release)
 - **MiniMax Model Upgrade**: Updated MiniMax presets from M2.5 to M2.7 across Claude, OpenClaw, and OpenCode configurations with updated partner descriptions in all three locales
 - **Xiaomi MiMo Model Upgrade**: Updated MiMo presets from mimo-v2-flash to mimo-v2-pro across all supported applications
 - **AddProviderDialog Simplification**: Removed redundant OAuth tab, reducing dialog from 3 tabs to 2 (app-specific + universal)
+- **Provider Form Advanced Options Collapse**: Model mapping, API format, and other advanced fields in the Claude provider form now auto-collapse when empty; auto-expands when any value is set or when a preset fills them in

 ### Fixed

@@ -34,38 +47,9 @@ Post-v3.12.3 work introduces GitHub Copilot reverse proxy support as a major new
 - **Tool Message Parsing**: Fixed tool_use/tool_result message classification across Claude (tool_result content blocks), Codex (function_call/function_call_output payloads), and Gemini (array content + toolCalls extraction) session providers (#1401)
 - **Dark Mode Selector**: Changed Tailwind `darkMode` from `["selector", "class"]` to `["selector", ".dark"]` to ensure correct dark mode activation (#1596)
 - **Copilot Request Fingerprint**: Unified Copilot request fingerprint headers across all API call sites to prevent User-Agent leakage and stream check mismatches
-
-### Docs
-
- **Pricing Model ID Normalization**: Added documentation section explaining model ID normalization rules (prefix stripping, suffix trimming, `@`→`-` replacement) in EN/ZH/JA user manuals (#1591)
- **macOS Signed & Notarized**: Removed all `xattr` workaround instructions and "unidentified developer" warnings from README, README_ZH, installation guides (EN/ZH/JA), and FAQ pages (EN/ZH/JA); replaced with "signed and notarized by Apple" messaging
-
---
-
-## [3.12.3] - 2026-03-15
-
-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**: 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
-
- **Proxy Gzip Compression**: Non-streaming proxy requests now auto-negotiate gzip compression instead of forcing `identity`; streaming requests conservatively keep `identity` to avoid SSE decompression errors
- **o1/o3 Model Compatibility**: Chat Completions proxy forwarding now correctly uses `max_completion_tokens` instead of `max_tokens` for OpenAI o-series models such as o1/o3/o4-mini (#1451)
- **OpenCode Model Variants**: Placed OpenCode model variants at top level instead of inside options for better discoverability (#1317)
- **Skills Import Flow**: Replaced implicit filesystem-based app inference with explicit `ImportSkillSelection` to prevent incorrect multi-app activation; added reconciliation to remove disabled/orphaned symlinks and MCP servers from live config
-
-### Fixed
-
 - **o-series Responses API Tokens**: Kept Responses API on the correct `max_output_tokens` field for o-series models instead of incorrectly injecting `max_completion_tokens`
 - **Provider Form Double Submit**: Prevented duplicate submissions on rapid button clicks in provider add/edit forms (#1352)
- **Ghostty Session Restore**: Fixed Claude session restore in Ghostty terminal (#1506, thanks @canyonsehun)
+- **Ghostty Session Restore**: Fixed Claude session restore in Ghostty terminal (#1506)
 - **Skill ZIP Import Extension**: Added `.skill` file extension support in ZIP import dialog (#1240, #1455)
 - **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)
@@ -73,6 +57,11 @@ Post-v3.12.2 work adds a Tool Search domain restriction bypass, skill backup/res
 - **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

+### Docs
+
+- **Pricing Model ID Normalization**: Added documentation section explaining model ID normalization rules (prefix stripping, suffix trimming, `@`→`-` replacement) in EN/ZH/JA user manuals (#1591)
+- **macOS Signed & Notarized**: Removed all `xattr` workaround instructions and "unidentified developer" warnings from README, README_ZH, installation guides (EN/ZH/JA), and FAQ pages (EN/ZH/JA); replaced with "signed and notarized by Apple" messaging
+
 ---

 ## [3.12.2] - 2026-03-12
--- 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, Skill Backup/Restore Lifecycle, Proxy Gzip & o-Series Compatibility
+> GitHub Copilot Reverse Proxy, macOS Code Signing & Notarization, Reasoning Effort Mapping, OpenCode SQLite Backend

 **[中文版 →](v3.12.3-zh.md) | [日本語版 →](v3.12.3-ja.md)**

@@ -8,19 +8,25 @@

 ## Overview

-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.
+CC Switch v3.12.3 is a major feature release that adds GitHub Copilot reverse proxy support with a dedicated Auth Center, introduces macOS code signing and Apple notarization for a seamless install experience, maps reasoning effort levels across providers, migrates OpenCode to a SQLite backend, enables Tool Search via the native `ENABLE_TOOL_SEARCH` environment variable toggle, and delivers a full skill backup/restore lifecycle. Additional improvements include proxy gzip compression, o-series model compatibility, Skills import rework, Ghostty terminal fix, Skills cache strategy optimization, Claude 4.6 context window update, and multiple bug fixes.

-**Release Date**: 2026-03-16
+**Release Date**: 2026-03-24

-**Update Scale**: 17 commits | 61 files changed | +3,335 / -194 lines
+**Update Scale**: 36 commits | 107 files changed | +9,124 / -802 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
+- **GitHub Copilot reverse proxy**: Full Copilot proxy support with OAuth device flow authentication, token refresh, and request fingerprint emulation
+- **Copilot Auth Center**: Dedicated authentication management UI for GitHub Copilot OAuth flow with token status display and one-click refresh
+- **macOS code signing & notarization**: macOS builds are now code-signed and notarized by Apple, eliminating the "unidentified developer" warning entirely
+- **Reasoning Effort mapping**: Proxy-layer auto-mapping — explicit `output_config.effort` takes priority, falling back to `budget_tokens` thresholds (<4 000→low, 4 000–16 000→medium, ≥16 000→high) for o-series and GPT-5+ models
+- **OpenCode SQLite backend**: Added SQLite session storage for OpenCode alongside existing JSON backend; dual-backend scan with SQLite priority on ID conflicts
+- **Codex 1M context window toggle**: One-click checkbox to set `model_context_window = 1000000` with auto-populated `model_auto_compact_token_limit`
+- **Disable Auto-Upgrade toggle**: Added `DISABLE_AUTOUPDATER` env var checkbox in the Claude Common Config editor to prevent Claude Code from auto-upgrading
+- **Tool Search env var toggle**: Tool Search enabled via Claude 2.1.76+ native `ENABLE_TOOL_SEARCH` environment variable in the Common Config editor — no binary patching required
 - **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
 - **Skills import rework**: Replaced implicit filesystem-based app inference with explicit `ImportSkillSelection` to prevent incorrect multi-app activation
@@ -30,14 +36,70 @@ CC Switch v3.12.3 adds a Tool Search domain restriction bypass via binary patchi

 ## New Features

-### Tool Search Domain Bypass
+### GitHub Copilot Reverse Proxy

-Added a setting to bypass Claude CLI Tool Search domain whitelist restrictions.
+Added full reverse proxy support for GitHub Copilot, enabling Copilot-authenticated requests to be forwarded through CC Switch.

- Resolves the active `claude` command from PATH and applies an equal-length byte patch to remove the domain whitelist check
- Backups stored in `~/.cc-switch/toolsearch-backups/` (SHA-256 of path) so they survive Claude Code version upgrades
- The patch auto-reapplies on app startup when the setting is enabled
- Frontend checks patch result and rolls back the setting on failure
+- Implements OAuth device flow authentication for GitHub Copilot
+- Automatic token refresh and session management
+- Request fingerprint emulation for seamless compatibility
+- Integrated into the existing proxy infrastructure alongside Claude, Codex, and Gemini handlers
+
+### Copilot Auth Center
+
+A dedicated authentication management UI for GitHub Copilot.
+
+- OAuth device flow with code display and browser-based authorization
+- Token status display showing expiration and validity
+- One-click token refresh without re-authentication
+- Integrated into the settings panel for easy access
+
+### Reasoning Effort Mapping
+
+Proxy-layer auto-mapping of reasoning effort for OpenAI o-series and GPT-5+ models.
+
+- Two-tier resolution: explicit `output_config.effort` takes priority, falling back to thinking `budget_tokens` thresholds (<4 000→low, 4 000–16 000→medium, ≥16 000→high)
+- Covers both Chat Completions and Responses API paths with 17 unit tests
+
+### OpenCode SQLite Backend
+
+Added SQLite session storage support for OpenCode alongside the existing JSON backend.
+
+- Dual-backend scan with SQLite priority on ID conflicts
+- Atomic session deletion and path validation
+- JSON backend remains functional for backwards compatibility
+
+### Codex 1M Context Window Toggle
+
+Added a one-click toggle for Codex 1M context window in the config editor.
+
+- Checkbox sets `model_context_window = 1000000` in `config.toml`
+- Auto-populates `model_auto_compact_token_limit = 900000` when enabled
+- Unchecking removes both fields cleanly
+
+### Disable Auto-Upgrade Toggle
+
+Added a checkbox in the Claude Common Config editor to disable Claude Code auto-upgrades.
+
+- Sets `DISABLE_AUTOUPDATER=1` in the environment configuration when enabled
+- Displayed alongside Teammates mode, Tool Search, and High Effort toggles
+
+### Tool Search Environment Variable Toggle
+
+Tool Search is now enabled via the native `ENABLE_TOOL_SEARCH` environment variable introduced in Claude 2.1.76+.
+
+- Toggle available in the Common Config editor under environment variables
+- Sets `ENABLE_TOOL_SEARCH=1` in the Claude environment configuration
+- No binary patching required — uses Claude's built-in support
+
+### macOS Code Signing & Notarization
+
+macOS builds are now code-signed and notarized by Apple.
+
+- Application signed with a valid Apple Developer certificate
+- Notarized through Apple's notarization service for Gatekeeper approval
+- DMG installer also signed and notarized
+- Eliminates the "unidentified developer" warning on first launch

 ### Skill Auto-Backup on Uninstall

@@ -60,6 +122,37 @@ Added management commands for skill backups created during uninstall.

 ## Changes

+### Skills Cache Strategy Optimization
+
+Optimized the Skills cache invalidation strategy for better performance.
+
+- Reduced unnecessary cache refreshes during skill operations
+- Improved cache coherence between skill install/uninstall and list queries
+
+### Claude 4.6 Context Window Update
+
+Updated Claude 4.6 model preset with the latest context window size.
+
+- Reflects the expanded context window for Claude 4.6 models
+- Updated in provider presets for accurate model information display
+
+### MiniMax M2.7 Upgrade
+
+- Updated MiniMax provider preset to M2.7 model variant
+
+### Xiaomi MiMo Upgrade
+
+- Updated Xiaomi MiMo provider preset to the latest model version
+
+### AddProviderDialog Simplification
+
+- Removed redundant OAuth tab, reducing dialog from 3 tabs to 2 (app-specific + universal)
+
+### Provider Form Advanced Options Collapse
+
+- Model mapping, API format, and other advanced fields in the Claude provider form now auto-collapse when empty
+- Auto-expands when any value is set or when a preset fills them in; does not auto-collapse when manually cleared
+
 ### Proxy Gzip Compression

 Non-streaming proxy requests now support gzip compression for reduced bandwidth usage.
@@ -71,7 +164,7 @@ Non-streaming proxy requests now support gzip compression for reduced bandwidth

 Proxy forwarding now handles OpenAI o-series model token parameters correctly.

- Chat Completions path uses `max_completion_tokens` instead of `max_tokens` for o1/o3/o4-mini models (#1451)
+- Chat Completions path uses `max_completion_tokens` instead of `max_tokens` for o1/o3/o4-mini models (#1451, thanks @Hemilt0n)
 - Responses API path kept on the correct `max_output_tokens` field instead of incorrectly injecting `max_completion_tokens`

 ### OpenCode Model Variants
@@ -91,9 +184,25 @@ The Skills import flow has been reworked for correctness and cleanup.

 ## Bug Fixes

+### WebDAV Password Clearing
+
+- Fixed an issue where the WebDAV password was silently cleared when saving unrelated settings
+
+### Tool Message Parsing
+
+- Fixed incorrect parsing of tool-use messages in certain proxy response formats
+
+### Dark Mode Styling
+
+- Fixed dark mode rendering inconsistencies in UI components
+
+### Copilot Request Fingerprint
+
+- Fixed request fingerprint generation for Copilot proxy to match expected format
+
 ### Provider Form Double Submit

- Prevented duplicate submissions on rapid button clicks in provider add/edit forms (#1352)
+- Prevented duplicate submissions on rapid button clicks in provider add/edit forms (#1352, thanks @Hexi1997)

 ### Ghostty Session Restore

@@ -101,7 +210,7 @@ The Skills import flow has been reworked for correctness and cleanup.

 ### Skill ZIP Import Extension

- Added `.skill` file extension support in ZIP import dialog (#1240, #1455)
+- Added `.skill` file extension support in ZIP import dialog (#1240, #1455, thanks @yovinchen)

 ### Skill ZIP Install Target App

@@ -109,11 +218,11 @@ The Skills import flow has been reworked for correctness and cleanup.

 ### OpenClaw Active Card Highlight

- Fixed active OpenClaw provider card not being highlighted (#1419)
+- Fixed active OpenClaw provider card not being highlighted (#1419, thanks @funnytime75)

 ### Responsive Layout with TOC

- Improved responsive design when TOC title exists (#1491)
+- Improved responsive design when TOC title exists (#1491, thanks @West-Pavilion)

 ### Import Skills Dialog White Screen

@@ -125,6 +234,18 @@ The Skills import flow has been reworked for correctness and cleanup.

 ---

+## Documentation
+
+### Pricing Model ID Normalization
+
+- Added documentation section explaining model ID normalization rules (prefix stripping, suffix trimming, `@`→`-` replacement) in EN/ZH/JA user manuals (#1591, thanks @makoMakoGo)
+
+### macOS Signed Build Messaging
+
+- Removed all `xattr` workaround instructions and "unidentified developer" warnings from README, README_ZH, installation guides (EN/ZH/JA), and FAQ pages (EN/ZH/JA); replaced with "signed and notarized by Apple" messaging
+
+---
+
 ## Download & Installation

 Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) to download the appropriate version.
@@ -148,10 +269,11 @@ Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) to dow

 | File                               | Description                                                          |
 | ---------------------------------- | -------------------------------------------------------------------- |
-| `CC-Switch-v3.12.3-macOS.zip`      | **Recommended** - Extract and drag to Applications, Universal Binary |
-| `CC-Switch-v3.12.3-macOS.tar.gz`   | For Homebrew installation and auto-update                            |
+| `CC-Switch-v3.12.3-macOS.dmg`     | **Recommended** - DMG installer, drag to Applications, Universal Binary |
+| `CC-Switch-v3.12.3-macOS.zip`     | ZIP archive, extract and drag to Applications, Universal Binary      |
+| `CC-Switch-v3.12.3-macOS.tar.gz`  | For Homebrew installation and auto-update                            |

-> **Note**: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" -> "Privacy & Security" -> click "Open Anyway", and it will open normally afterwards.
+> macOS builds are code-signed and notarized by Apple for a seamless install experience.

 ### Homebrew (macOS)

@@ -174,4 +296,4 @@ brew upgrade --cask cc-switch
 | Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`             | `sudo rpm -i CC-Switch-*.rpm` or `sudo dnf install ./CC-Switch-*.rpm`  |
 | openSUSE                                | `.rpm`             | `sudo zypper install ./CC-Switch-*.rpm`                                |
 | Arch Linux / Manjaro                    | `.AppImage`        | Add execute permission and run directly, or use AUR                    |
-| Other distributions / Unsure            | `.AppImage`        | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |
+| Other distributions / Unsure            | `.AppImage`        | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |
--- 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 ドメイン制限バイパス、Skill バックアップ/リストアライフサイクル、プロキシ Gzip 圧縮と o シリーズモデル互換性
+> GitHub Copilot リバースプロキシ、macOS コード署名と公証、Reasoning Effort マッピング、Tool Search 環境変数トグル、Skill バックアップ/リストア、OpenCode SQLite バックエンド

 **[中文版 →](v3.12.3-zh.md) | [English →](v3.12.3-en.md)**

@@ -8,19 +8,24 @@

 ## 概要

-CC Switch v3.12.3 は、バイナリパッチによる Tool Search ドメインホワイトリスト制限のバイパス機能を追加し、完全な Skill バックアップ/リストアライフサイクルを導入し、OpenAI o シリーズモデルのプロキシ互換性と gzip 圧縮を改善し、Skills インポート、プロバイダーフォーム、ターミナルセッション復元の堅牢性を修正しました。Skill はアンインストール前に自動バックアップされ、リストアと削除の管理機能が追加されました。インポートフローはファイルシステムベースの暗黙的な推論から明示的なアプリ選択に変更されました。
+CC Switch v3.12.3 は、GitHub Copilot リバースプロキシと Copilot Auth Center を追加し、Copilot トークンを使用した Claude/OpenAI API へのアクセスを実現しました。macOS ビルドに Apple コード署名と公証を導入し、「開発元を確認できません」の警告を解消しました。Reasoning Effort マッピングにより、Claude の thinking budget を OpenAI 互換の reasoning_effort パラメータに自動変換します。Tool Search は従来のバイナリパッチ方式から Claude 2.1.76+ ネイティブの `ENABLE_TOOL_SEARCH` 環境変数トグルに移行し、共通設定エディタから切り替え可能になりました。OpenCode バックエンドを JSON から SQLite に移行し、Skill バックアップ/リストアライフサイクル、プロキシ gzip 圧縮、o シリーズモデル互換性の改善も含まれます。

-**リリース日**: 2026-03-16
+**リリース日**: 2026-03-24

-**更新規模**: 17 commits | 61 files changed | +3,335 / -194 lines
+**更新規模**: 36 commits | 107 files changed | +9,124 / -802 lines

 ---

 ## ハイライト

- **Tool Search ドメインバイパス**: 等長バイナリパッチで Claude CLI Tool Search のドメインホワイトリストチェックを削除する新設定。起動時に自動バックアップと再適用
+- **GitHub Copilot リバースプロキシ**: Copilot トークンを使用して Claude/OpenAI API にアクセスするリバースプロキシを追加。Copilot Auth Center でトークンの取得と管理が可能
+- **macOS コード署名と公証**: macOS ビルドが Apple のコード署名と公証に対応し、初回起動時の警告なしでインストール可能に。DMG インストーラーを新たに提供
+- **Reasoning Effort マッピング**: プロキシ層での自動マッピング — 明示的な `output_config.effort` を優先し、`budget_tokens` 閾値（<4000→low, 4000–16000→medium, ≥16000→high）にフォールバック。o シリーズおよび GPT-5+ モデルに対応
+- **Tool Search 環境変数トグル**: バイナリパッチ方式を廃止し、Claude 2.1.76+ ネイティブの `ENABLE_TOOL_SEARCH` 環境変数による切り替えに移行。共通設定エディタから設定可能
 - **Skill バックアップ/リストアライフサイクル**: アンインストール前に Skill ファイルを自動バックアップ。バックアップリスト、リストア、削除の管理機能を追加
-
+- **OpenCode SQLite バックエンド**: OpenCode に SQLite セッションストレージを追加（既存の JSON バックエンドと併存）。ID 競合時は SQLite を優先するデュアルバックエンドスキャン
+- **Codex 1M コンテキストウィンドウトグル**: 設定エディタでワンクリックで `model_context_window = 1000000` を設定可能。`model_auto_compact_token_limit` も自動設定
+- **自動アップグレード無効化トグル**: Claude 共通設定エディタに `DISABLE_AUTOUPDATER` 環境変数のチェックボックスを追加し、Claude Code の自動アップグレードを防止
 - **プロキシ Gzip 圧縮**: 非ストリーミングプロキシリクエストが gzip 圧縮を自動ネゴシエーションし、帯域幅消費を削減
 - **o シリーズモデル互換性**: Chat Completions プロキシが o1/o3/o4-mini モデルに `max_completion_tokens` を正しく使用。Responses API は正しい `max_output_tokens` フィールドを維持
 - **Skills インポートの刷新**: ファイルシステムベースの暗黙的なアプリ推論を明示的な `ImportSkillSelection` に置き換え、複数アプリの誤った有効化を防止
@@ -30,14 +35,36 @@ CC Switch v3.12.3 は、バイナリパッチによる Tool Search ドメイン

 ## 新機能

-### Tool Search ドメイン制限バイパス
+### GitHub Copilot リバースプロキシ

-Claude CLI Tool Search のドメインホワイトリスト制限をバイパスする設定を追加しました。
+GitHub Copilot トークンを使用して Claude API および OpenAI API にアクセスするリバースプロキシ機能を追加しました。

- PATH からアクティブな `claude` コマンドを解決し、等長バイトパッチを適用してドメインホワイトリストチェックを削除
- バックアップは `~/.cc-switch/toolsearch-backups/`（パスの SHA-256）に保存され、Claude Code のバージョンアップグレード後も有効
- 設定が有効な場合、アプリ起動時にパッチを自動的に再適用
- フロントエンドがパッチ結果を確認し、失敗時に設定を自動ロールバック
+- Copilot のアクセストークンを利用し、Claude Code や Codex などのクライアントからプロキシ経由で API リクエストを転送
+- Copilot 固有のリクエストフィンガープリントとヘッダー処理に対応
+- プロバイダープリセットに Copilot 用テンプレートを追加
+
+### Copilot Auth Center
+
+Copilot トークンの取得と管理を行う認証センターを追加しました。
+
+- GitHub デバイスフローによるトークン取得をサポート
+- トークンの有効期限管理と自動リフレッシュ
+- フロントエンドから直接トークンステータスの確認と再認証が可能
+
+### Reasoning Effort マッピング
+
+OpenAI o シリーズおよび GPT-5+ モデル向けのプロキシ層自動マッピング機能を追加しました。
+
+- 二段階の解決ロジック：明示的な `output_config.effort` を優先し、thinking `budget_tokens` 閾値（<4000→low, 4000–16000→medium, ≥16000→high）にフォールバック
+- Chat Completions と Responses API の両パスをカバー、17 個のユニットテスト付き
+
+### Tool Search 環境変数トグル
+
+Claude CLI Tool Search の有効化/無効化を環境変数で制御する設定を追加しました。
+
+- Claude 2.1.76+ で導入されたネイティブの `ENABLE_TOOL_SEARCH` 環境変数を使用
+- 共通設定（Common Config）エディタから直接トグル可能
+- 従来のバイナリパッチ方式は不要になり、CLI アップデート時の再適用も不要

 ### Skill アンインストール時の自動バックアップ

@@ -56,10 +83,76 @@ Claude CLI Tool Search のドメインホワイトリスト制限をバイパス
 - 削除は確認ダイアログの後にバックアップディレクトリを削除
 - ConfirmDialog にネストされたダイアログスタッキングをサポートする設定可能な zIndex プロパティを追加

+### OpenCode SQLite バックエンド
+
+OpenCode に SQLite セッションストレージサポートを追加しました（既存の JSON バックエンドと併存）。
+
+- デュアルバックエンドスキャン、ID 競合時は SQLite を優先
+- アトミックなセッション削除とパス検証
+- JSON バックエンドは後方互換性のため引き続き機能
+
+### Codex 1M コンテキストウィンドウトグル
+
+設定エディタに Codex 1M コンテキストウィンドウのワンクリックトグルを追加しました。
+
+- チェックボックスで `config.toml` に `model_context_window = 1000000` を設定
+- 有効化時に `model_auto_compact_token_limit = 900000` を自動設定
+- 無効化時は両フィールドをクリーンに削除
+
+### 自動アップグレード無効化トグル
+
+Claude 共通設定エディタに自動アップグレードを無効化するチェックボックスを追加しました。
+
+- 有効化時に `DISABLE_AUTOUPDATER=1` 環境変数を設定し、Claude Code の自動アップグレードを防止
+- Teammates モード、Tool Search、高強度思考トグルと同じ行に表示
+
+### macOS コード署名と公証
+
+macOS ビルドに Apple のコード署名と公証を導入しました。
+
+- Apple Developer ID による署名と Apple 公証サービスによる公証を実施
+- 初回起動時の「開発元を確認できません」警告が不要に
+- DMG インストーラーを新たに提供し、ドラッグ＆ドロップでのインストールに対応
+- CI/CD パイプラインに署名・公証ステップを統合
+
 ---

 ## 変更

+### Skills キャッシュ戦略の最適化
+
+Skills のキャッシュ戦略を最適化し、パフォーマンスと信頼性を向上しました。
+
+- キャッシュの有効期限管理とインバリデーション戦略を改善
+- 不要なキャッシュ再構築を削減し、起動時間を短縮
+
+### Claude 4.6 コンテキストウィンドウ更新
+
+Claude 4.6 モデルのコンテキストウィンドウサイズを更新しました。
+
+- Claude 4.6 の最新コンテキストウィンドウサイズをプリセットに反映
+
+### MiniMax M2.7 アップグレード
+
+MiniMax モデルプリセットを M2.7 にアップグレードしました。
+
+- MiniMax プロバイダープリセットのモデル ID とパラメータを M2.7 に更新
+
+### Xiaomi MiMo アップグレード
+
+Xiaomi MiMo モデルプリセットをアップグレードしました。
+
+- MiMo プロバイダープリセットのモデル ID とパラメータを最新版に更新
+
+### AddProviderDialog の簡素化
+
+- 冗長な OAuth タブを削除し、ダイアログを 3 タブから 2 タブ（アプリ固有 + ユニバーサル）に簡素化
+
+### プロバイダーフォームの高度なオプション折りたたみ
+
+- Claude プロバイダーフォームのモデルマッピング、API フォーマットなどの高度なフィールドが未入力時にデフォルトで折りたたまれるように変更
+- プリセットが値を入力すると自動展開。手動クリア時は自動折りたたみしない
+
 ### プロキシ Gzip 圧縮

 非ストリーミングプロキシリクエストが gzip 圧縮をサポートし、帯域幅消費を削減しました。
@@ -71,7 +164,7 @@ Claude CLI Tool Search のドメインホワイトリスト制限をバイパス

 プロキシ転送が OpenAI o シリーズモデルのトークンパラメータを正しく処理するようになりました。

- Chat Completions パスが o1/o3/o4-mini モデルに `max_tokens` の代わりに `max_completion_tokens` を使用 (#1451)
+- Chat Completions パスが o1/o3/o4-mini モデルに `max_tokens` の代わりに `max_completion_tokens` を使用 (#1451、@Hemilt0n に感謝)
 - Responses API パスが正しい `max_output_tokens` フィールドを維持し、`max_completion_tokens` の誤った注入を防止

 ### OpenCode モデルバリアント
@@ -91,9 +184,25 @@ Skills インポートフローが正確性とクリーンアップのために

 ## バグ修正

+### WebDAV パスワードの消失
+
+- 無関係な設定保存時に WebDAV パスワードがサイレントにクリアされる問題を修正
+
+### ツールメッセージのパース
+
+- プロキシのツールメッセージパース処理の不具合を修正し、特定のツール呼び出しパターンでのエラーを解消
+
+### ダークモードの表示
+
+- ダークモードでの一部 UI コンポーネントの表示不具合を修正
+
+### Copilot リクエストフィンガープリント
+
+- Copilot リバースプロキシのリクエストフィンガープリント生成の不具合を修正し、認証エラーを解消
+
 ### プロバイダーフォームの二重送信

- プロバイダー追加/編集フォームでの高速連続クリックによる重複送信を防止 (#1352)
+- プロバイダー追加/編集フォームでの高速連続クリックによる重複送信を防止 (#1352、@Hexi1997 に感謝)

 ### Ghostty ターミナルセッション復元

@@ -101,7 +210,7 @@ Skills インポートフローが正確性とクリーンアップのために

 ### Skill ZIP インポート拡張子

- ZIP インポートダイアログが `.skill` ファイル拡張子をサポートするように修正 (#1240, #1455)
+- ZIP インポートダイアログが `.skill` ファイル拡張子をサポートするように修正 (#1240, #1455、@yovinchen に感謝)

 ### Skill ZIP インストール対象アプリ

@@ -109,11 +218,11 @@ Skills インポートフローが正確性とクリーンアップのために

 ### OpenClaw アクティブカードのハイライト

- OpenClaw の現在アクティブなプロバイダーカードがハイライト表示されない問題を修正 (#1419)
+- OpenClaw の現在アクティブなプロバイダーカードがハイライト表示されない問題を修正 (#1419、@funnytime75 に感謝)

 ### TOC 付きレスポンシブレイアウト

- TOC タイトルが存在する場合のレスポンシブデザインを改善 (#1491)
+- TOC タイトルが存在する場合のレスポンシブデザインを改善 (#1491、@West-Pavilion に感謝)

 ### Skills インポートダイアログの白い画面

@@ -125,6 +234,18 @@ Skills インポートフローが正確性とクリーンアップのために

 ---

+## ドキュメント
+
+### 料金モデル ID の正規化
+
+- 中英日三言語のユーザーマニュアルにモデル ID 正規化ルール（プレフィックス除去、サフィックストリミング、`@`→`-` 置換）の説明セクションを追加 (#1591、@makoMakoGo に感謝)
+
+### macOS 署名済みメッセージの更新
+
+- README、README_ZH、インストールガイド（EN/ZH/JA）、FAQ ページ（EN/ZH/JA）からすべての `xattr` 回避策と「開発元を確認できません」警告を削除し、「Apple のコード署名と公証済み」メッセージに置換
+
+---
+
 ## ダウンロードとインストール

 [Releases](https://github.com/farion1231/cc-switch/releases/latest) から適切なバージョンをダウンロードしてください。
@@ -148,10 +269,11 @@ Skills インポートフローが正確性とクリーンアップのために

 | ファイル                           | 説明                                                              |
 | ---------------------------------- | ----------------------------------------------------------------- |
-| `CC-Switch-v3.12.3-macOS.zip`      | **推奨** - 解凍して Applications にドラッグ、Universal Binary     |
-| `CC-Switch-v3.12.3-macOS.tar.gz`   | Homebrew インストールと自動更新用                                 |
+| `CC-Switch-v3.12.3-macOS.dmg`     | **推奨** - DMG インストーラー、ドラッグ＆ドロップでインストール   |
+| `CC-Switch-v3.12.3-macOS.zip`     | 解凍して Applications にドラッグ、Universal Binary                |
+| `CC-Switch-v3.12.3-macOS.tar.gz`  | Homebrew インストールと自動更新用                                 |

-> **注意**: 作者が Apple Developer アカウントを持っていないため、初回起動時に「開発元を確認できません」という警告が表示される場合があります。一度閉じてから、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックすると、その後は正常に開けます。
+> macOS 版は Apple のコード署名と公証済みで、そのままインストールしてご利用いただけます。

 ### Homebrew (macOS)

--- 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 域名限制绕过、Skill 备份/恢复生命周期、代理 Gzip 压缩与 o 系列模型兼容性
+> GitHub Copilot 反向代理、macOS 代码签名与公证、Reasoning Effort 映射、Tool Search 环境变量开关、Skill 备份/恢复生命周期

 **[English →](v3.12.3-en.md) | [日本語版 →](v3.12.3-ja.md)**

@@ -8,36 +8,84 @@

 ## 概览

-CC Switch v3.12.3 新增了通过二进制补丁绕过 Tool Search 域名白名单限制的功能，引入了完整的 Skill 备份/恢复生命周期，改进了代理对 OpenAI o 系列模型的兼容性和 gzip 压缩支持，并修复了 Skills 导入、供应商表单和终端会话恢复等方面的问题。Skill 卸载前会自动备份并支持恢复和删除管理，导入流程从基于文件系统的隐式推断改为显式应用选择。
+CC Switch v3.12.3 新增了 **GitHub Copilot 反向代理** 支持和 **Copilot Auth Center** 认证管理，引入了 **Reasoning Effort 映射** 实现跨供应商推理强度控制，通过 Claude 2.1.76+ 原生 `ENABLE_TOOL_SEARCH` 环境变量实现了 **Tool Search 开关**，新增了 **OpenCode SQLite 后端** 支持，并完成了 **macOS 代码签名与 Apple 公证**。同时引入了完整的 Skill 备份/恢复生命周期，改进了代理对 OpenAI o 系列模型的兼容性和 gzip 压缩支持，优化了 Skills 缓存策略，更新了 Claude 4.6 上下文窗口、MiniMax M2.7 和小米 MiMo 模型预设，并修复了 WebDAV 密码、工具消息解析、暗色模式和 Copilot 请求指纹等方面的问题。

-**发布日期**：2026-03-16
+**发布日期**：2026-03-24

-**更新规模**：17 commits | 61 files changed | +3,335 / -194 lines
+**更新规模**：36 commits | 107 files changed | +9,124 / -802 lines

 ---

 ## 重点内容

- **Tool Search 域名绕过**：新增设置项，通过等长二进制补丁移除 Claude CLI Tool Search 域名白名单检查，启动时自动备份和重新应用
+- **GitHub Copilot 反向代理**：新增 Copilot 反向代理支持，通过 Copilot Auth Center 管理 GitHub Token 认证，实现 Copilot 模型在 Claude Code 中的无缝使用
+- **macOS 代码签名与公证**：macOS 版本已通过 Apple 代码签名和公证，新增 DMG 安装格式，无需再手动绕过"未知开发者"警告
+- **Reasoning Effort 映射**：代理层自动映射 — 显式 `output_config.effort` 优先，回退到 `budget_tokens` 阈值（<4000→low, 4000–16000→medium, ≥16000→high），支持 o 系列和 GPT-5+ 模型
+- **Tool Search 环境变量开关**：利用 Claude 2.1.76+ 原生 `ENABLE_TOOL_SEARCH` 环境变量，在通用配置编辑器中一键启用 Tool Search
 - **Skill 备份/恢复生命周期**：卸载前自动备份 Skill 文件；新增备份列表、恢复和删除管理
-
- **代理 Gzip 压缩**：非流式代理请求现在自动协商 gzip 压缩，减少带宽消耗
- **o 系列模型兼容性**：Chat Completions 代理正确使用 `max_completion_tokens` 处理 o1/o3/o4-mini 模型；Responses API 保持使用正确的 `max_output_tokens` 字段
+- **OpenCode SQLite 后端**：为 OpenCode 新增 SQLite 会话存储（与现有 JSON 后端并存），ID 冲突时 SQLite 优先的双后端扫描
+- **Codex 1M 上下文窗口开关**：配置编辑器中一键设置 `model_context_window = 1000000`，自动填充 `model_auto_compact_token_limit`
+- **禁用自动升级开关**：通用配置编辑器中新增 `DISABLE_AUTOUPDATER` 环境变量复选框，防止 Claude Code 自动升级
+- **代理 Gzip 压缩**：非流式代理请求自动协商 gzip 压缩，减少带宽消耗
+- **o 系列模型兼容性**：Chat Completions 代理正确使用 `max_completion_tokens` 处理 o1/o3/o4-mini 模型
 - **Skills 导入重构**：将基于文件系统的隐式应用推断替换为显式的 `ImportSkillSelection`，防止多应用错误激活
- **Ghostty 终端支持**：修复在 Ghostty 终端中恢复 Claude 会话的问题

 ---

 ## 新功能

-### Tool Search 域名限制绕过
+### GitHub Copilot 反向代理

-新增设置项，可绕过 Claude CLI Tool Search 的域名白名单限制。
+新增完整的 GitHub Copilot 集成，作为 Claude Code 供应商使用。

- 从 PATH 中解析当前活跃的 `claude` 命令，应用等长字节补丁移除域名白名单检查
- 备份存储在 `~/.cc-switch/toolsearch-backups/`（以路径的 SHA-256 为文件名），Claude Code 升级后备份仍然有效
- 设置启用时，应用启动自动重新应用补丁
- 前端检查补丁结果，失败时自动回滚设置
+- 通过 OAuth Device Code 流程进行 GitHub 认证
+- 支持多账号管理和自动 Token 刷新
+- Anthropic ↔ OpenAI 格式自动转换
+- 实时获取可用模型列表和用量统计 (#930，感谢 @Mason-mengze)
+
+### Copilot Auth Center
+
+在设置中新增认证中心面板，全局管理 GitHub 账号。
+
+- 支持按供应商绑定账号（通过 `meta.authBinding`）
+- 统一的 Token 管理和刷新机制
+
+### Tool Search 开关
+
+利用 Claude 2.1.76+ 原生 `ENABLE_TOOL_SEARCH` 环境变量控制 Tool Search 功能。
+
+- 在供应商通用配置编辑器中以复选框形式暴露
+- 替代了之前的二进制补丁方案，更简洁可靠 (#930，感谢 @Mason-mengze)
+
+### Reasoning Effort 映射
+
+新增代理层自动推理强度映射，支持 OpenAI o 系列和 GPT-5+ 模型。
+
+- 两级解析：显式 `output_config.effort` 优先，回退到 `budget_tokens` 阈值（<4000→low, 4000–16000→medium, ≥16000→high）
+- 覆盖 Chat Completions 和 Responses API 两条路径，含 17 个单元测试
+
+### OpenCode SQLite 后端
+
+为 OpenCode 新增 SQLite 会话存储支持（与现有 JSON 后端并存）。
+
+- 双后端扫描，ID 冲突时 SQLite 优先
+- 原子会话删除和路径校验
+- JSON 后端保持向后兼容
+
+### Codex 1M 上下文窗口开关
+
+在配置编辑器中新增 Codex 1M 上下文窗口一键开关。
+
+- 复选框设置 `config.toml` 中的 `model_context_window = 1000000`
+- 启用时自动填充 `model_auto_compact_token_limit = 900000`
+- 关闭时干净移除两个字段
+
+### 禁用自动升级开关
+
+在 Claude 通用配置编辑器中新增禁用自动升级的复选框。
+
+- 勾选后设置 `DISABLE_AUTOUPDATER=1` 环境变量，阻止 Claude Code 自动升级
+- 与 Teammates 模式、Tool Search、高强度思考等开关同一排显示

 ### Skill 卸载自动备份

@@ -54,25 +102,33 @@ CC Switch v3.12.3 新增了通过二进制补丁绕过 Tool Search 域名白名
 - 列出所有可用的 skill 备份及元数据
 - 恢复操作将文件拷回 SSOT，保存数据库记录，并同步到当前应用，失败时自动回滚
 - 删除操作在确认对话框后移除备份目录
- ConfirmDialog 新增可配置的 zIndex 属性，支持嵌套对话框堆叠
+
+### macOS 代码签名与 Apple 公证
+
+CI 流程新增完整的 macOS 代码签名和 Apple 公证支持。
+
+- 导入 Apple Developer ID 证书，签名 Universal Binary
+- 提交 Apple 公证并将票据装订到 `.app` 和 `.dmg`
+- 硬性验证步骤（`codesign --verify` + `spctl -a` + `stapler validate`）把关发布

 ---

 ## 变更

-### 代理 Gzip 压缩
+### Skills 缓存策略优化

-非流式代理请求现在支持 gzip 压缩，减少带宽消耗。
+- 将 `invalidateQueries` 替换为直接 `setQueryData` 更新，用于 skill 安装/卸载/导入操作
+- 新增 `staleTime: Infinity` 和 `keepPreviousData`，消除加载闪烁 (#1573，感谢 @TangZhiZzz)
+
+### 代理 Gzip 压缩

 - 非流式请求允许 reqwest 自动协商 gzip 并透明解压响应
 - 流式请求保守地保持 `Accept-Encoding: identity`，避免中断的 SSE 流解压出错

 ### o1/o3 模型兼容性

-代理转发现在正确处理 OpenAI o 系列模型的 token 参数。
-
- Chat Completions 路径对 o1/o3/o4-mini 模型使用 `max_completion_tokens` 替代 `max_tokens` (#1451)
- Responses API 路径保持使用正确的 `max_output_tokens` 字段，不再错误注入 `max_completion_tokens`
+- Chat Completions 路径对 o1/o3/o4-mini 模型使用 `max_completion_tokens` 替代 `max_tokens` (#1451，感谢 @Hemilt0n)
+- Responses API 路径保持使用正确的 `max_output_tokens` 字段

 ### OpenCode 模型变体

@@ -80,20 +136,55 @@ CC Switch v3.12.3 新增了通过二进制补丁绕过 Tool Search 域名白名

 ### Skills 导入流程

-Skills 导入流程经过重构，提升正确性和清理能力。
-
 - 将基于文件系统的隐式应用推断替换为显式的 `ImportSkillSelection`，防止同一 skill 目录存在于多个应用路径下时错误激活多个应用
 - 为 `sync_to_app` 增加协调逻辑，移除已禁用/孤立的符号链接
 - MCP `sync_all_enabled` 现在会从 live 配置中移除已禁用的服务器
- 数据库迁移保留旧版应用映射快照，避免有损重建
+
+### Claude 4.6 上下文窗口
+
+- Claude Opus 4.6 和 Sonnet 4.6 上下文窗口从 200K 更新至 1M（GA 发布）
+
+### MiniMax 模型升级
+
+- MiniMax 预设从 M2.5 升级至 M2.7，更新三语合作伙伴描述
+
+### 小米 MiMo 模型升级
+
+- MiMo 预设从 mimo-v2-flash 升级至 mimo-v2-pro
+
+### 添加供应商对话框简化
+
+- 移除冗余的 OAuth 标签页，对话框从 3 个标签页减少到 2 个（应用专属 + 通用）
+
+### 供应商表单高级选项折叠
+
+- Claude 供应商表单中的模型映射、API 格式等高级字段在未填写时默认折叠
+- 预设填充值后自动展开，手动清空不会自动折叠

 ---

 ## Bug 修复

+### WebDAV 密码被静默清除
+
+- 修复 ProviderList 或 UsageScriptModal 保存设置时 WebDAV 密码被静默清除的问题
+- 前端 payload 中剥离 `webdavSync`，后端 `merge_settings_for_save()` 增加回填逻辑保护现有密码
+
+### 工具消息解析
+
+- 修复 Claude（tool_result content blocks）、Codex（function_call/function_call_output payloads）和 Gemini（array content + toolCalls extraction）的 tool_use/tool_result 消息分类 (#1401，感谢 @BlueOcean223)
+
+### 暗色模式选择器
+
+- 将 Tailwind `darkMode` 从 `["selector", "class"]` 改为 `["selector", ".dark"]`，确保暗色模式正确激活 (#1596，感谢 @qinxiandiqi)
+
+### Copilot 请求指纹
+
+- 统一所有 Copilot API 调用点的请求指纹头，防止 User-Agent 泄漏和 Stream Check 不匹配
+
 ### 供应商表单防重复提交

- 修复快速连续点击按钮时供应商添加/编辑表单重复提交的问题 (#1352)
+- 修复快速连续点击按钮时供应商添加/编辑表单重复提交的问题 (#1352，感谢 @Hexi1997)

 ### Ghostty 终端会话恢复

@@ -101,7 +192,7 @@ Skills 导入流程经过重构，提升正确性和清理能力。

 ### Skill ZIP 导入扩展名

- ZIP 导入对话框现在支持 `.skill` 文件扩展名 (#1240, #1455)
+- ZIP 导入对话框现在支持 `.skill` 文件扩展名 (#1240, #1455，感谢 @yovinchen)

 ### Skill ZIP 安装目标应用

@@ -109,11 +200,11 @@ Skills 导入流程经过重构，提升正确性和清理能力。

 ### OpenClaw 活跃供应商高亮

- 修复 OpenClaw 当前激活的供应商卡片未高亮显示的问题 (#1419)
+- 修复 OpenClaw 当前激活的供应商卡片未高亮显示的问题 (#1419，感谢 @funnytime75)

 ### 响应式布局与 TOC

- 改善存在 TOC 标题时的响应式布局 (#1491)
+- 改善存在 TOC 标题时的响应式布局 (#1491，感谢 @West-Pavilion)

 ### Skills 导入对话框白屏

@@ -125,6 +216,19 @@ Skills 导入流程经过重构，提升正确性和清理能力。

 ---

+## 文档
+
+### 定价模型 ID 归一化
+
+- 在中英日三语用户手册中新增模型 ID 归一化规则说明（前缀剥离、后缀修剪、`@`→`-` 替换）(#1591，感谢 @makoMakoGo)
+
+### macOS 签名与公证说明
+
+- 移除 README、安装指南和 FAQ 中所有 `xattr` 变通方案和"未知开发者"警告
+- 替换为"已通过 Apple 代码签名和公证"的说明
+
+---
+
 ## 下载与安装

 访问 [Releases](https://github.com/farion1231/cc-switch/releases/latest) 下载对应版本。
@@ -148,10 +252,11 @@ Skills 导入流程经过重构，提升正确性和清理能力。

 | 文件                               | 说明                                                      |
 | ---------------------------------- | --------------------------------------------------------- |
-| `CC-Switch-v3.12.3-macOS.zip`      | **推荐** - 解压后拖入 Applications 即可，Universal Binary |
-| `CC-Switch-v3.12.3-macOS.tar.gz`   | 用于 Homebrew 安装和自动更新                              |
+| `CC-Switch-v3.12.3-macOS.dmg`     | **推荐** - DMG 安装包，拖入 Applications 即可             |
+| `CC-Switch-v3.12.3-macOS.zip`     | 解压后拖入 Applications，Universal Binary                 |
+| `CC-Switch-v3.12.3-macOS.tar.gz`  | 用于 Homebrew 安装和自动更新                              |

-> **注意**：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开
+> macOS 版本已通过 Apple 代码签名和公证，可直接安装使用。

 ### Homebrew（macOS）

--- a/src-tauri/src/app_config.rs
+++ b/src-tauri/src/app_config.rs
@@ -883,6 +883,7 @@ mod tests {
        dir: TempDir,
        original_home: Option<String>,
        original_userprofile: Option<String>,
+        original_test_home: Option<String>,
    }

    impl TempHome {
@@ -890,14 +891,17 @@ mod tests {
            let dir = TempDir::new().expect("failed to create temp home");
            let original_home = env::var("HOME").ok();
            let original_userprofile = env::var("USERPROFILE").ok();
+            let original_test_home = env::var("CC_SWITCH_TEST_HOME").ok();

            env::set_var("HOME", dir.path());
            env::set_var("USERPROFILE", dir.path());
+            env::set_var("CC_SWITCH_TEST_HOME", dir.path());

            Self {
                dir,
                original_home,
                original_userprofile,
+                original_test_home,
            }
        }
    }
@@ -913,6 +917,11 @@ mod tests {
                Some(value) => env::set_var("USERPROFILE", value),
                None => env::remove_var("USERPROFILE"),
            }
+
+            match &self.original_test_home {
+                Some(value) => env::set_var("CC_SWITCH_TEST_HOME", value),
+                None => env::remove_var("CC_SWITCH_TEST_HOME"),
+            }
        }
    }

--- a/src-tauri/src/database/tests.rs
+++ b/src-tauri/src/database/tests.rs
@@ -296,6 +296,14 @@ fn schema_migration_v4_adds_pricing_model_columns() {
    let conn = Connection::open_in_memory().expect("open memory db");
    conn.execute_batch(
        r#"
+        CREATE TABLE providers (
+            id TEXT NOT NULL,
+            app_type TEXT NOT NULL,
+            name TEXT NOT NULL,
+            settings_config TEXT NOT NULL DEFAULT '{}',
+            meta TEXT NOT NULL DEFAULT '{}',
+            PRIMARY KEY (id, app_type)
+        );
        CREATE TABLE proxy_config (app_type TEXT PRIMARY KEY);
        CREATE TABLE proxy_request_logs (request_id TEXT PRIMARY KEY, model TEXT NOT NULL);
        CREATE TABLE mcp_servers (
--- a/tests/components/UnifiedSkillsPanel.test.tsx
+++ b/tests/components/UnifiedSkillsPanel.test.tsx
@@ -11,6 +11,8 @@ const toggleSkillAppMock = vi.fn();
 const uninstallSkillMock = vi.fn();
 const importSkillsMock = vi.fn();
 const installFromZipMock = vi.fn();
+const deleteSkillBackupMock = vi.fn();
+const restoreSkillBackupMock = vi.fn();

 vi.mock("sonner", () => ({
  toast: {
@@ -25,9 +27,22 @@ vi.mock("@/hooks/useSkills", () => ({
    data: [],
    isLoading: false,
  }),
+  useSkillBackups: () => ({
+    data: [],
+    refetch: vi.fn(),
+    isFetching: false,
+  }),
+  useDeleteSkillBackup: () => ({
+    mutateAsync: deleteSkillBackupMock,
+    isPending: false,
+  }),
  useToggleSkillApp: () => ({
    mutateAsync: toggleSkillAppMock,
  }),
+  useRestoreSkillBackup: () => ({
+    mutateAsync: restoreSkillBackupMock,
+    isPending: false,
+  }),
  useUninstallSkill: () => ({
    mutateAsync: uninstallSkillMock,
  }),
@@ -68,6 +83,8 @@ describe("UnifiedSkillsPanel", () => {
    uninstallSkillMock.mockReset();
    importSkillsMock.mockReset();
    installFromZipMock.mockReset();
+    deleteSkillBackupMock.mockReset();
+    restoreSkillBackupMock.mockReset();
  });

  it("opens the import dialog without crashing when app toggles render", async () => {