style(provider): improve type annotation formatting in EditProviderDialog

This commit implements a three-layer fix to restore the "Sync to other side"
feature when adding or editing MCP servers across Claude and Codex.

Root Cause Analysis:
1. Frontend issue: New MCP entries had their `enabled` field deleted
2. Backend issue: Default value was `false` when `enabled` was missing
3. Core issue: MCP entries were never copied to the other app's servers

Changes:

Frontend (McpFormModal.tsx):
- Set `enabled=true` by default for new MCP entries
- Preserve existing `enabled` state when editing

Backend (services/mcp.rs):
- Change default value from `unwrap_or(false)` to `unwrap_or(true)`
- Implement cross-app MCP replication when `sync_other_side=true`
- Clone MCP entry to other app's servers before syncing to live files

Impact:
- "Sync to Codex" checkbox now correctly adds MCP to both Claude and Codex
- "Sync to Claude" checkbox now correctly adds MCP to both Codex and Claude
- Both config.json and live files (~/.claude.json, ~/.codex/config.toml) are updated
- Fixes regression introduced during project restructure

Tested:
- TypeScript type checking passed
- Rust clippy linting passed
- Manual testing: MCP sync works bidirectionally

.gitattributes

@@ -0,0 +1,38 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Explicitly declare text files you want to always be normalized and converted
+# to native line endings on checkout.
+*.rs text eol=lf
+*.toml text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.txt text eol=lf
+
+# TypeScript/JavaScript files
+*.ts text eol=lf
+*.tsx text eol=lf
+*.js text eol=lf
+*.jsx text eol=lf
+
+# HTML/CSS files
+*.html text eol=lf
+*.css text eol=lf
+*.scss text eol=lf
+
+# Shell scripts
+*.sh text eol=lf
+
+# Denote all files that are truly binary and should not be modified.
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.exe binary
+*.dll binary

.github/workflows/release.yml

@@ -8,100 +8,397 @@ on:
 permissions:
   contents: write
 
+concurrency:
+  group: release-${{ github.ref_name }}
+  cancel-in-progress: true
+
 jobs:
   release:
     runs-on: ${{ matrix.os }}
-    
     strategy:
       matrix:
         include:
-          - os: windows-latest
-            platform: win32
-          - os: ubuntu-latest  
-            platform: linux
-          - os: macos-latest
-            platform: darwin
-    
+          - os: windows-2022
+          - os: ubuntu-22.04
+          - os: macos-14
+
     steps:
-      - name: Checkout code
+      - name: Checkout
         uses: actions/checkout@v4
-      
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-      
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Add macOS targets
+        if: runner.os == 'macOS'
+        run: |
+          rustup target add aarch64-apple-darwin x86_64-apple-darwin
+
+      - name: Install Linux system deps
+        if: runner.os == 'Linux'
+        shell: bash
+        run: |
+          set -euxo pipefail
+          sudo apt-get update
+          # Core build tools and pkg-config
+          sudo apt-get install -y --no-install-recommends \
+            build-essential \
+            pkg-config \
+            curl \
+            wget \
+            file \
+            patchelf \
+            libssl-dev
+          # GTK/GLib stack for gdk-3.0, glib-2.0, gio-2.0
+          sudo apt-get install -y --no-install-recommends \
+            libgtk-3-dev \
+            librsvg2-dev \
+            libayatana-appindicator3-dev
+          # WebKit2GTK (version differs across Ubuntu images; try 4.1 then 4.0)
+          sudo apt-get install -y --no-install-recommends libwebkit2gtk-4.1-dev \
+            || sudo apt-get install -y --no-install-recommends libwebkit2gtk-4.0-dev
+          # libsoup also changed major version; prefer 3.0 with fallback to 2.4
+          sudo apt-get install -y --no-install-recommends libsoup-3.0-dev \
+            || sudo apt-get install -y --no-install-recommends libsoup2.4-dev
+
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
           version: 10.12.3
           run_install: false
-      
+
       - name: Get pnpm store directory
+        id: pnpm-store
         shell: bash
-        run: |
-          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
-      
+        run: echo "path=$(pnpm store path --silent)" >> $GITHUB_OUTPUT
+
       - name: Setup pnpm cache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
-          path: ${{ env.STORE_PATH }}
+          path: ${{ steps.pnpm-store.outputs.path }}
           key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-pnpm-store-
-      
-      - name: Install dependencies
+          restore-keys: ${{ runner.os }}-pnpm-store-
+
+      - name: Install frontend deps
         run: pnpm install --frozen-lockfile
-      
-      - name: Build application
-        run: |
-          pnpm run build
-          pnpm run dist
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          CSC_IDENTITY_AUTO_DISCOVERY: false
-      
-      - name: List build files (debug)
+
+      - name: Prepare Tauri signing key
         shell: bash
         run: |
-          echo "Listing release directory:"
-          ls -la release/ || echo "No release directory found"
-          find . -name "*.exe" -o -name "*.dmg" -o -name "*.AppImage" -o -name "*.deb" -o -name "*.rpm" || echo "No build files found"
-      
+          # 调试：检查 Secret 是否存在
+          if [ -z "${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}" ]; then
+            echo "❌ TAURI_SIGNING_PRIVATE_KEY Secret 为空或不存在" >&2
+            echo "请检查 GitHub 仓库 Settings > Secrets and variables > Actions" >&2
+            exit 1
+          fi
+          
+          RAW="${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}"
+          # 目标：提供正确的私钥“文件路径”给 Tauri CLI，避免内容解码歧义
+          KEY_PATH="$RUNNER_TEMP/tauri_signing.key"
+          # 情况 1：原始两行文本（第一行以 "untrusted comment:" 开头）
+          if echo "$RAW" | head -n1 | grep -q '^untrusted comment:'; then
+            printf '%s\n' "$RAW" > "$KEY_PATH"
+            echo "✅ 使用原始两行密钥文件格式"
+          else
+            # 情况 2：整体被 base64 包裹（解包后应当是两行）
+            if DECODED=$(printf '%s' "$RAW" | (base64 --decode 2>/dev/null || base64 -D 2>/dev/null)) \
+               && echo "$DECODED" | head -n1 | grep -q '^untrusted comment:'; then
+              printf '%s\n' "$DECODED" > "$KEY_PATH"
+              echo "✅ 成功解码 base64 包裹密钥，已还原为两行文件"
+            else
+              # 情况 3：已是第二行（纯 Base64 一行）→ 构造两行文件
+              if echo "$RAW" | grep -Eq '^[A-Za-z0-9+/=]+$'; then
+                ONE=$(printf '%s' "$RAW" | tr -d '\r\n')
+                printf '%s\n%s\n' "untrusted comment: tauri signing key" "$ONE" > "$KEY_PATH"
+                echo "✅ 使用一行 Base64 私钥，已构造两行文件"
+              else
+                echo "❌ TAURI_SIGNING_PRIVATE_KEY 格式无法识别：既不是两行原文，也不是其 base64，亦非一行 base64" >&2
+                echo "密钥前10个字符: $(echo "$RAW" | head -c 10)..." >&2
+                exit 1
+              fi
+            fi
+          fi
+          # 将“完整两行内容”作为环境变量注入（Tauri 支持传入完整私钥文本或文件路径）
+          # 使用多行写入语法，保持换行以便解析
+          # 将完整两行私钥内容进行 base64 编码，作为单行内容注入环境变量
+          if command -v base64 >/dev/null 2>&1; then
+            KEY_B64=$(base64 < "$KEY_PATH" | tr -d '\r\n')
+          elif command -v openssl >/dev/null 2>&1; then
+            KEY_B64=$(openssl base64 -A -in "$KEY_PATH")
+          else
+            KEY_B64=$(KEY_PATH="$KEY_PATH" node -e "process.stdout.write(require('fs').readFileSync(process.env.KEY_PATH).toString('base64'))")
+          fi
+          if [ -z "$KEY_B64" ]; then
+            echo "❌ 无法生成私钥 base64 内容" >&2
+            exit 1
+          fi
+          echo "TAURI_SIGNING_PRIVATE_KEY=$KEY_B64" >> "$GITHUB_ENV"
+          if [ -n "${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}" ]; then
+            echo "TAURI_SIGNING_PRIVATE_KEY_PASSWORD=${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}" >> $GITHUB_ENV
+          fi
+          echo "✅ Tauri signing key prepared"
+
+      - name: Build Tauri App (macOS)
+        if: runner.os == 'macOS'
+        run: pnpm tauri build --target universal-apple-darwin
+
+      - name: Build Tauri App (Windows)
+        if: runner.os == 'Windows'
+        run: pnpm tauri build
+
+      - name: Build Tauri App (Linux)
+        if: runner.os == 'Linux'
+        run: pnpm tauri build
+
+      - name: Prepare macOS Assets
+        if: runner.os == 'macOS'
+        shell: bash
+        run: |
+          set -euxo pipefail
+          mkdir -p release-assets
+          VERSION="${GITHUB_REF_NAME}"  # e.g., v3.5.0
+          echo "Looking for updater artifact (.tar.gz) and .app for zip..."
+          TAR_GZ=""; APP_PATH=""
+          for path in \
+            "src-tauri/target/universal-apple-darwin/release/bundle/macos" \
+            "src-tauri/target/aarch64-apple-darwin/release/bundle/macos" \
+            "src-tauri/target/x86_64-apple-darwin/release/bundle/macos" \
+            "src-tauri/target/release/bundle/macos"; do
+            if [ -d "$path" ]; then
+              [ -z "$TAR_GZ" ] && TAR_GZ=$(find "$path" -maxdepth 1 -name "*.tar.gz" -type f | head -1 || true)
+              [ -z "$APP_PATH" ] && APP_PATH=$(find "$path" -maxdepth 1 -name "*.app" -type d | head -1 || true)
+            fi
+          done
+          if [ -z "$TAR_GZ" ]; then
+            echo "No macOS .tar.gz updater artifact found" >&2
+            exit 1
+          fi
+          # 重命名 tar.gz 为统一格式
+          NEW_TAR_GZ="CC-Switch-${VERSION}-macOS.tar.gz"
+          cp "$TAR_GZ" "release-assets/$NEW_TAR_GZ"
+          [ -f "$TAR_GZ.sig" ] && cp "$TAR_GZ.sig" "release-assets/$NEW_TAR_GZ.sig" || echo ".sig for macOS not found yet"
+          echo "macOS updater artifact copied: $NEW_TAR_GZ"
+          if [ -n "$APP_PATH" ]; then
+            APP_DIR=$(dirname "$APP_PATH"); APP_NAME=$(basename "$APP_PATH")
+            NEW_ZIP="CC-Switch-${VERSION}-macOS.zip"
+            cd "$APP_DIR"
+            ditto -c -k --sequesterRsrc --keepParent "$APP_NAME" "$NEW_ZIP"
+            mv "$NEW_ZIP" "$GITHUB_WORKSPACE/release-assets/"
+            echo "macOS zip ready: $NEW_ZIP"
+          else
+            echo "No .app found to zip (optional)" >&2
+          fi
+
+      - name: Prepare Windows Assets
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = 'Stop'
+          New-Item -ItemType Directory -Force -Path release-assets | Out-Null
+          $VERSION = $env:GITHUB_REF_NAME  # e.g., v3.5.0
+          # 仅打包 MSI 安装器 + .sig（用于 Updater）
+          $msi = Get-ChildItem -Path 'src-tauri/target/release/bundle/msi' -Recurse -Include *.msi -ErrorAction SilentlyContinue | Select-Object -First 1
+          if ($null -eq $msi) {
+            # 兜底：全局搜索 .msi
+            $msi = Get-ChildItem -Path 'src-tauri/target/release/bundle' -Recurse -Include *.msi -ErrorAction SilentlyContinue | Select-Object -First 1
+          }
+          if ($null -ne $msi) {
+            $dest = "CC-Switch-$VERSION-Windows.msi"
+            Copy-Item $msi.FullName (Join-Path release-assets $dest)
+            Write-Host "Installer copied: $dest"
+            $sigPath = "$($msi.FullName).sig"
+            if (Test-Path $sigPath) {
+              Copy-Item $sigPath (Join-Path release-assets ("$dest.sig"))
+              Write-Host "Signature copied: $dest.sig"
+            } else {
+              Write-Warning "Signature not found for $($msi.Name)"
+            }
+          } else {
+            Write-Warning 'No Windows MSI installer found'
+          }
+          # 绿色版（portable）：仅可执行文件打 zip（不参与 Updater）
+          $exeCandidates = @(
+            'src-tauri/target/release/cc-switch.exe',
+            'src-tauri/target/x86_64-pc-windows-msvc/release/cc-switch.exe'
+          )
+          $exePath = $exeCandidates | Where-Object { Test-Path $_ } | Select-Object -First 1
+          if ($null -ne $exePath) {
+            $portableDir = 'release-assets/CC-Switch-Portable'
+            New-Item -ItemType Directory -Force -Path $portableDir | Out-Null
+            Copy-Item $exePath $portableDir
+            $portableIniPath = Join-Path $portableDir 'portable.ini'
+            $portableContent = @(
+              '# CC Switch portable build marker',
+              'portable=true'
+            )
+            $portableContent | Set-Content -Path $portableIniPath -Encoding UTF8
+            $portableZip = "release-assets/CC-Switch-$VERSION-Windows-Portable.zip"
+            Compress-Archive -Path "$portableDir/*" -DestinationPath $portableZip -Force
+            Remove-Item -Recurse -Force $portableDir
+            Write-Host "Windows portable zip created: CC-Switch-$VERSION-Windows-Portable.zip"
+          } else {
+            Write-Warning 'Portable exe not found'
+          }
+
+      - name: Prepare Linux Assets
+        if: runner.os == 'Linux'
+        shell: bash
+        run: |
+          set -euxo pipefail
+          mkdir -p release-assets
+          VERSION="${GITHUB_REF_NAME}"  # e.g., v3.5.0
+          # Updater artifact: AppImage（含对应 .sig）
+          APPIMAGE=$(find src-tauri/target/release/bundle -name "*.AppImage" | head -1 || true)
+          if [ -n "$APPIMAGE" ]; then
+            NEW_APPIMAGE="CC-Switch-${VERSION}-Linux.AppImage"
+            cp "$APPIMAGE" "release-assets/$NEW_APPIMAGE"
+            [ -f "$APPIMAGE.sig" ] && cp "$APPIMAGE.sig" "release-assets/$NEW_APPIMAGE.sig" || echo ".sig for AppImage not found"
+            echo "AppImage copied: $NEW_APPIMAGE"
+          else
+            echo "No AppImage found under target/release/bundle" >&2
+          fi
+          # 额外上传 .deb（用于手动安装，不参与 Updater）
+          DEB=$(find src-tauri/target/release/bundle -name "*.deb" | head -1 || true)
+          if [ -n "$DEB" ]; then
+            NEW_DEB="CC-Switch-${VERSION}-Linux.deb"
+            cp "$DEB" "release-assets/$NEW_DEB"
+            echo "Deb package copied: $NEW_DEB"
+          else
+            echo "No .deb found (optional)"
+          fi
+
+      - name: List prepared assets
+        shell: bash
+        run: |
+          ls -la release-assets || true
+
+      - name: Collect Signatures
+        shell: bash
+        run: |
+          set -euo pipefail
+          echo "Collected signatures (if any alongside artifacts):"
+          ls -la release-assets/*.sig || echo "No signatures found"
+
       - name: Upload Release Assets
-        uses: softprops/action-gh-release@v1
-        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
         with:
-          files: |
-            release/*.exe
-            release/*.zip
-            release/*.AppImage
-          name: "CC Switch ${{ github.ref_name }}"
+          tag_name: ${{ github.ref_name }}
+          name: CC Switch ${{ github.ref_name }}
+          prerelease: true
           body: |
             ## CC Switch ${{ github.ref_name }}
-            
+
             Claude Code 供应商切换工具
-            
+
             ### 下载
-            
-            #### Windows 用户
-            - **安装版 (推荐)**: `CC Switch Setup ${{ github.ref_name }}.exe`
-            - **便携版**: `CC Switch ${{ github.ref_name }}.exe`
-            
-            #### macOS 用户（推荐使用通用版本）
-            - **通用版本**: `CC Switch-${{ github.ref_name }}-mac.zip` - 兼容所有Mac（Intel + M系列）
-            
-            #### Linux 用户
-            - **AppImage**: `CC Switch-${{ github.ref_name }}.AppImage`
-            
-            ### macOS 安装说明
-            1. 下载 ZIP 文件后解压
-            2. 首次打开可能出现"未知开发者"警告
-            3. 前往"系统设置" → "隐私与安全性" → 点击"仍要打开"
-            4. 或者使用命令: `xattr -cr "/path/to/CC Switch.app"`
-            
-            ### 注意事项
-            - macOS 版本使用 Intel 架构，通过 Rosetta 2 在 M 系列芯片上运行
-            - 兼容性和稳定性最佳，性能损失minimal
+
+            - **macOS**: `CC-Switch-${{ github.ref_name }}-macOS.zip`（解压即用）或 `CC-Switch-${{ github.ref_name }}-macOS.tar.gz`（Homebrew）
+            - **Windows**: `CC-Switch-${{ github.ref_name }}-Windows.msi`（安装版）或 `CC-Switch-${{ github.ref_name }}-Windows-Portable.zip`（绿色版）
+            - **Linux**: `CC-Switch-${{ github.ref_name }}-Linux.AppImage`（AppImage）或 `CC-Switch-${{ github.ref_name }}-Linux.deb`（Debian/Ubuntu）
+
+            ---
+            提示：macOS 如遇"已损坏"提示，可在终端执行：`xattr -cr "/Applications/CC Switch.app"`
+          files: release-assets/*
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: List generated bundles (debug)
+        if: always()
+        shell: bash
+        run: |
+          echo "Listing bundles in src-tauri/target..."
+          find src-tauri/target -maxdepth 4 -type f -name "*.*" 2>/dev/null || true
+
+  assemble-latest-json:
+    name: Assemble latest.json
+    runs-on: ubuntu-22.04
+    needs: release
+    permissions:
+      contents: write
+    steps:
+      - name: Prepare GH
+        run: |
+          gh --version || (type -p curl >/dev/null && sudo apt-get update && sudo apt-get install -y gh || true)
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Download all release assets
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euxo pipefail
+          TAG="${GITHUB_REF_NAME}"
+          mkdir -p dl
+          gh release download "$TAG" --dir dl --repo "$GITHUB_REPOSITORY"
+          ls -la dl || true
+      - name: Generate latest.json
+        env:
+          REPO: ${{ github.repository }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          VERSION="${TAG#v}"
+          PUB_DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+          base_url="https://github.com/$REPO/releases/download/$TAG"
+          # 初始化空平台映射
+          mac_url=""; mac_sig=""
+          win_url=""; win_sig=""
+          linux_url=""; linux_sig=""
+          shopt -s nullglob
+          for sig in dl/*.sig; do
+            base=${sig%.sig}
+            fname=$(basename "$base")
+            url="$base_url/$fname"
+            sig_content=$(cat "$sig")
+            case "$fname" in
+              *.tar.gz)
+                # 视为 macOS updater artifact
+                mac_url="$url"; mac_sig="$sig_content";;
+              *.AppImage|*.appimage)
+                linux_url="$url"; linux_sig="$sig_content";;
+              *.msi|*.exe)
+                win_url="$url"; win_sig="$sig_content";;
+            esac
+          done
+          # 构造 JSON（仅包含存在的目标）
+          tmp_json=$(mktemp)
+          {
+            echo '{'
+            echo "  \"version\": \"$VERSION\",";
+            echo "  \"notes\": \"Release $TAG\",";
+            echo "  \"pub_date\": \"$PUB_DATE\",";
+            echo '  "platforms": {'
+            first=1
+            if [ -n "$mac_url" ] && [ -n "$mac_sig" ]; then
+              # 为兼容 arm64 / x64，重复写入两个键，指向同一 universal 包
+              for key in darwin-aarch64 darwin-x86_64; do
+                [ $first -eq 0 ] && echo ','
+                echo "    \"$key\": {\"signature\": \"$mac_sig\", \"url\": \"$mac_url\"}"
+                first=0
+              done
+            fi
+            if [ -n "$win_url" ] && [ -n "$win_sig" ]; then
+              [ $first -eq 0 ] && echo ','
+              echo "    \"windows-x86_64\": {\"signature\": \"$win_sig\", \"url\": \"$win_url\"}"
+              first=0
+            fi
+            if [ -n "$linux_url" ] && [ -n "$linux_sig" ]; then
+              [ $first -eq 0 ] && echo ','
+              echo "    \"linux-x86_64\": {\"signature\": \"$linux_sig\", \"url\": \"$linux_url\"}"
+              first=0
+            fi
+            echo '  }'
+            echo '}'
+          } > "$tmp_json"
+          echo "Generated latest.json:" && cat "$tmp_json"
+          mv "$tmp_json" latest.json
+      - name: Upload latest.json to release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euxo pipefail
+          gh release upload "$GITHUB_REF_NAME" latest.json --clobber --repo "$GITHUB_REPOSITORY"

.gitignore

@@ -6,4 +6,8 @@ release/
 .env
 .env.local
 *.tsbuildinfo
-.npmrc
+.npmrc
+CLAUDE.md
+AGENTS.md
+/.claude
+/.vscode

.node-version

@@ -0,0 +1 @@
+v22.4.1

CHANGELOG.md

@@ -0,0 +1,269 @@
+# Changelog
+
+All notable changes to CC Switch will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.5.0] - 2025-01-15
+
+### ⚠ Breaking Changes
+
+- Tauri 命令仅接受参数 `app`（取值：`claude`/`codex`）；移除对 `app_type`/`appType` 的兼容。
+- 前端类型命名统一为 `AppId`（移除 `AppType` 导出），变量命名统一为 `appId`。
+
+### ✨ New Features
+
+- **MCP (Model Context Protocol) Management** - Complete MCP server configuration management system
+  - Add, edit, delete, and toggle MCP servers in `~/.claude.json`
+  - Support for stdio and http server types with command validation
+  - Built-in templates for popular MCP servers (mcp-fetch, etc.)
+  - Real-time enable/disable toggle for MCP servers
+  - Atomic file writing to prevent configuration corruption
+- **Configuration Import/Export** - Backup and restore your provider configurations
+  - Export all configurations to JSON file with one click
+  - Import configurations with validation and automatic backup
+  - Automatic backup rotation (keeps 10 most recent backups)
+  - Progress modal with detailed status feedback
+- **Endpoint Speed Testing** - Test API endpoint response times
+  - Measure latency to different provider endpoints
+  - Visual indicators for connection quality
+  - Help users choose the fastest provider
+
+### 🔧 Improvements
+
+- Complete internationalization (i18n) coverage for all UI components
+- Enhanced error handling and user feedback throughout the application
+- Improved configuration file management with better validation
+- Added new provider presets: Longcat, kat-coder
+- Updated GLM provider configurations with latest models
+- Refined UI/UX with better spacing, icons, and visual feedback
+- Enhanced tray menu functionality and responsiveness
+- **Standardized release artifact naming** - All platform releases now use consistent version-tagged filenames:
+  - macOS: `CC-Switch-v{version}-macOS.tar.gz` / `.zip`
+  - Windows: `CC-Switch-v{version}-Windows.msi` / `-Portable.zip`
+  - Linux: `CC-Switch-v{version}-Linux.AppImage` / `.deb`
+
+### 🐛 Bug Fixes
+
+- Fixed layout shifts during provider switching
+- Improved config file path handling across different platforms
+- Better error messages for configuration validation failures
+- Fixed various edge cases in configuration import/export
+
+### 📦 Technical Details
+
+- Enhanced `import_export.rs` module with backup management
+- New `claude_mcp.rs` module for MCP configuration handling
+- Improved state management and lock handling in Rust backend
+- Better TypeScript type safety across the codebase
+
+## [3.4.0] - 2025-10-01
+
+### ✨ Features
+
+- Enable internationalization via i18next with a Chinese default and English fallback, plus an in-app language switcher
+- Add Claude plugin sync while retiring the legacy VS Code integration controls (Codex no longer requires settings.json edits)
+- Extend provider presets with optional API key URLs and updated models, including DeepSeek-V3.1-Terminus and Qwen3-Max
+- Support portable mode launches and enforce a single running instance to avoid conflicts
+
+### 🔧 Improvements
+
+- Allow minimizing the window to the system tray and add macOS Dock visibility management for tray workflows
+- Refresh the Settings modal with a scrollable layout, save icon, and cleaner language section
+- Smooth provider toggle states with consistent button widths/icons and prevent layout shifts when switching between Claude and Codex
+- Adjust the Windows MSI installer to target per-user LocalAppData and improve component tracking reliability
+
+### 🐛 Fixes
+
+- Remove the unnecessary OpenAI auth requirement from third-party provider configurations
+- Fix layout shifts while switching app types with Claude plugin sync enabled
+- Align Enable/In Use button states to avoid visual jank across app views
+
+## [3.3.0] - 2025-09-22
+
+### ✨ Features
+
+- Add “Apply to VS Code / Remove from VS Code” actions on provider cards, writing settings for Code/Insiders/VSCodium variants _(Removed in 3.4.x)_
+- Enable VS Code auto-sync by default with window broadcast and tray hooks so Codex switches sync silently _(Removed in 3.4.x)_
+- Extend the Codex provider wizard with display name, dedicated API key URL, and clearer guidance
+- Introduce shared common config snippets with JSON/TOML reuse, validation, and consistent error surfaces
+
+### 🔧 Improvements
+
+- Keep the tray menu responsive when the window is hidden and standardize button styling and copy
+- Disable modal backdrop blur on Linux (WebKitGTK/Wayland) to avoid freezes; restore the window when clicking the macOS Dock icon
+- Support overriding config directories on WSL, refine placeholders/descriptions, and fix VS Code button wrapping on Windows
+- Add a `created_at` timestamp to provider records for future sorting and analytics
+
+### 🐛 Fixes
+
+- Correct regex escapes and common snippet trimming in the Codex wizard to prevent validation issues
+- Harden the VS Code sync flow with more reliable TOML/JSON parsing while reducing layout jank
+- Bundle `@codemirror/lint` to reinstate live linting in config editors
+
+## [3.2.0] - 2025-09-13
+
+### ✨ New Features
+
+- System tray provider switching with dynamic menu for Claude/Codex
+- Frontend receives `provider-switched` events and refreshes active app
+- Built-in update flow via Tauri Updater plugin with dismissible UpdateBadge
+
+### 🔧 Improvements
+
+- Single source of truth for provider configs; no duplicate copy files
+- One-time migration imports existing copies into `config.json` and archives originals
+- Duplicate provider de-duplication by name + API key at startup
+- Atomic writes for Codex `auth.json` + `config.toml` with rollback on failure
+- Logging standardized (Rust): use `log::{info,warn,error}` instead of stdout prints
+- Tailwind v4 integration and refined dark mode handling
+
+### 🐛 Fixes
+
+- Remove/minimize debug console logs in production builds
+- Fix CSS minifier warnings for scrollbar pseudo-elements
+- Prettier formatting across codebase for consistent style
+
+### 📦 Dependencies
+
+- Tauri: 2.8.x (core, updater, process, opener, log plugins)
+- React: 18.2.x · TypeScript: 5.3.x · Vite: 5.x
+
+### 🔄 Notes
+
+- `connect-src` CSP remains permissive for compatibility; can be tightened later as needed
+
+## [3.1.1] - 2025-09-03
+
+### 🐛 Bug Fixes
+
+- Fixed the default codex config.toml to match the latest modifications
+- Improved provider configuration UX with custom option
+
+### 📝 Documentation
+
+- Updated README with latest information
+
+## [3.1.0] - 2025-09-01
+
+### ✨ New Features
+
+- **Added Codex application support** - Now supports both Claude Code and Codex configuration management
+  - Manage auth.json and config.toml for Codex
+  - Support for backup and restore operations
+  - Preset providers for Codex (Official, PackyCode)
+  - API Key auto-write to auth.json when using presets
+- **New UI components**
+  - App switcher with segmented control design
+  - Dual editor form for Codex configuration
+  - Pills-style app switcher with consistent button widths
+- **Enhanced configuration management**
+  - Multi-app config v2 structure (claude/codex)
+  - Automatic v1→v2 migration with backup
+  - OPENAI_API_KEY validation for non-official presets
+  - TOML syntax validation for config.toml
+
+### 🔧 Technical Improvements
+
+- Unified Tauri command API with app_type parameter
+- Backward compatibility for app/appType parameters
+- Added get_config_status/open_config_folder/open_external commands
+- Improved error handling for empty config.toml
+
+### 🐛 Bug Fixes
+
+- Fixed config path reporting and folder opening for Codex
+- Corrected default import behavior when main config is missing
+- Fixed non_snake_case warnings in commands.rs
+
+## [3.0.0] - 2025-08-27
+
+### 🚀 Major Changes
+
+- **Complete migration from Electron to Tauri 2.0** - The application has been completely rewritten using Tauri, resulting in:
+  - **90% reduction in bundle size** (from ~150MB to ~15MB)
+  - **Significantly improved startup performance**
+  - **Native system integration** without Chromium overhead
+  - **Enhanced security** with Rust backend
+
+### ✨ New Features
+
+- **Native window controls** with transparent title bar on macOS
+- **Improved file system operations** using Rust for better performance
+- **Enhanced security model** with explicit permission declarations
+- **Better platform detection** using Tauri's native APIs
+
+### 🔧 Technical Improvements
+
+- Migrated from Electron IPC to Tauri command system
+- Replaced Node.js file operations with Rust implementations
+- Implemented proper CSP (Content Security Policy) for enhanced security
+- Added TypeScript strict mode for better type safety
+- Integrated Rust cargo fmt and clippy for code quality
+
+### 🐛 Bug Fixes
+
+- Fixed bundle identifier conflict on macOS (changed from .app to .desktop)
+- Resolved platform detection issues
+- Improved error handling in configuration management
+
+### 📦 Dependencies
+
+- **Tauri**: 2.8.2
+- **React**: 18.2.0
+- **TypeScript**: 5.3.0
+- **Vite**: 5.0.0
+
+### 🔄 Migration Notes
+
+For users upgrading from v2.x (Electron version):
+
+- Configuration files remain compatible - no action required
+- The app will automatically migrate your existing provider configurations
+- Window position and size preferences have been reset to defaults
+
+#### Backup on v1→v2 Migration (cc-switch internal config)
+
+- When the app detects an old v1 config structure at `~/.cc-switch/config.json`, it now creates a timestamped backup before writing the new v2 structure.
+- Backup location: `~/.cc-switch/config.v1.backup.<timestamp>.json`
+- This only concerns cc-switch's own metadata file; your actual provider files under `~/.claude/` and `~/.codex/` are untouched.
+
+### 🛠️ Development
+
+- Added `pnpm typecheck` command for TypeScript validation
+- Added `pnpm format` and `pnpm format:check` for code formatting
+- Rust code now uses cargo fmt for consistent formatting
+
+## [2.0.0] - Previous Electron Release
+
+### Features
+
+- Multi-provider configuration management
+- Quick provider switching
+- Import/export configurations
+- Preset provider templates
+
+---
+
+## [1.0.0] - Initial Release
+
+### Features
+
+- Basic provider management
+- Claude Code integration
+- Configuration file handling
+## [Unreleased]
+
+### ⚠️ Breaking Changes
+
+- Tauri 命令统一仅接受 `app` 参数，移除历史 `app_type`/`appType` 兼容路径；传入未知 `app` 时会明确报错，并提示可选值。
+
+### 🔧 Improvements
+
+- 统一 `AppType` 解析：集中到 `FromStr` 实现，命令层不再各自实现 `parse_app()`，减少重复与漂移。
+- 错误消息本地化与更友好：对不支持的 `app` 返回中英双语提示，并包含可选值清单。
+
+### 🧪 Tests
+
+- 新增单元测试覆盖 `AppType::from_str`：大小写、裁剪空白、未知值错误消息。

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jason Young
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,14 +1,42 @@
-# Claude Code 供应商切换器
+# Claude Code & Codex 供应商切换器
 
-一个用于管理和切换 Claude Code 不同供应商配置的桌面应用。
+[![Version](https://img.shields.io/badge/version-3.5.1-blue.svg)](https://github.com/farion1231/cc-switch/releases)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases)
+[![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-orange.svg)](https://tauri.app/)
 
-## 功能特性
+一个用于管理和切换 Claude Code 与 Codex 不同供应商配置的桌面应用。
 
-- 一键切换不同供应商
-- 智谱 GLM、Qwen coder、DeepSeek v3.1、packycode 等预设供应商只需要填写 key 即可一键配置
-- 支持添加自定义供应商
-- 简洁美观的图形界面
-- 信息存储在本地 ~/.cc-switch/config.json，无隐私风险
+> v3.5.0 ：新增 **MCP 管理**、**配置导入/导出**、**端点速度测试**功能，完善国际化覆盖，新增 Longcat、kat-coder 预设，标准化发布文件命名规范。
+
+> v3.4.0 ：新增 i18next 国际化（还有部分未完成）、对新模型（qwen-3-max, GLM-4.6, DeepSeek-V3.2-Exp）的支持、Claude 插件、单实例守护、托盘最小化及安装器优化等。
+
+> v3.3.0 ：VS Code Codex 插件一键配置/移除（默认自动同步）、Codex 通用配置片段与自定义向导增强、WSL 环境支持、跨平台托盘与 UI 优化。（该 VS Code 写入功能已在 v3.4.x 停用）
+
+> v3.2.0 ：全新 UI、macOS系统托盘、内置更新器、原子写入与回滚、改进暗色样式、单一事实源（SSOT）与一次性迁移/归档。
+
+> v3.1.0 ：新增 Codex 供应商管理与一键切换，支持导入当前 Codex 配置为默认供应商，并在内部配置从 v1 → v2 迁移前自动备份（详见下文“迁移与归档”）。
+
+> v3.0.0 重大更新：从 Electron 完全迁移到 Tauri 2.0，应用体积显著降低、启动性能大幅提升。
+
+## 功能特性（v3.5.0）
+
+- **MCP (Model Context Protocol) 管理**：完整的 MCP 服务器配置管理系统
+  - 支持 stdio 和 http 服务器类型，并提供命令校验
+  - 内置常用 MCP 服务器模板（如 mcp-fetch 等）
+  - 实时启用/禁用 MCP 服务器，原子文件写入防止配置损坏
+- **配置导入/导出**：备份和恢复你的供应商配置
+  - 一键导出所有配置到 JSON 文件
+  - 导入配置时自动验证并备份，自动轮换备份（保留最近 10 个）
+  - 带有详细状态反馈的进度模态框
+- **端点速度测试**：测试 API 端点响应时间
+  - 测量不同供应商端点的延迟，可视化连接质量指示器
+  - 帮助用户选择最快的供应商
+- **国际化与语言切换**：完整的 i18next 国际化覆盖，默认显示中文，可在设置中快速切换到英文，界面文案自动实时刷新。
+- **Claude 插件同步**：内置按钮可一键应用或恢复 Claude 插件配置，切换供应商后立即生效。
+- **供应商预设扩展**：新增 Longcat、kat-coder 等预设，更新 GLM 供应商配置至最新模型。
+- **系统托盘与窗口行为**：窗口关闭可最小化到托盘，macOS 支持托盘模式下隐藏/显示 Dock，托盘切换时同步 Claude/Codex/插件状态。
+- **单实例**：保证同一时间仅运行一个实例，避免多开冲突。
+- **标准化发布命名**：所有平台发布文件使用一致的版本标签命名（macOS: `.tar.gz` / `.zip`，Windows: `.msi` / `-Portable.zip`，Linux: `.AppImage` / `.deb`）。
 
 ## 界面预览
 
@@ -22,109 +50,240 @@
 
 ## 下载安装
 
+### 系统要求
+
+- **Windows**: Windows 10 及以上
+- **macOS**: macOS 10.15 (Catalina) 及以上
+- **Linux**: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版
+
 ### Windows 用户
 
-从 [Releases](../../releases) 页面下载：
-
-- **安装版 (推荐)**: `CC-Switch-Setup-x.x.x.exe`
-  - 完整系统集成，正确显示应用图标
-  - 自动创建桌面快捷方式和开始菜单项
-- **便携版**: `CC-Switch-Portable-x.x.x.exe`
-  - 无需安装，直接运行
-  - 适合需要绿色软件的用户
+从 [Releases](../../releases) 页面下载最新版本的 `CC-Switch-v{版本号}-Windows.msi` 安装包或者 `CC-Switch-v{版本号}-Windows-Portable.zip` 绿色版。
 
 ### macOS 用户
 
-从 [Releases](../../releases) 页面下载：
+**方式一：通过 Homebrew 安装（推荐）**
 
-- **通用版本（推荐）**: `CC Switch-x.x.x-mac.zip` - Intel 版本，兼容所有 Mac（包括 M 系列芯片）
+```bash
+brew tap farion1231/ccswitch
+brew install --cask cc-switch
+```
 
-#### macOS 安装说明
+更新：
 
-**推荐使用通用版本**，它通过 Rosetta 2 在 M 系列 Mac 上运行良好，兼容性最佳。
+```bash
+brew upgrade --cask cc-switch
+```
 
-由于作者没有苹果开发者账号，应用使用 ad-hoc 签名（未经苹果官方认证），首次打开时可能出现"未知开发者"警告。这是正常的安全提示，处理方法：
+**方式二：手动下载**
 
-**方法 1 - 系统设置**：
+从 [Releases](../../releases) 页面下载 `CC-Switch-v{版本号}-macOS.zip` 解压使用。
 
-1. 双击应用时选择"取消"
-2. 打开"系统设置" → "隐私与安全性"
-3. 在底部找到被阻止的应用，点击"仍要打开"
-4. 确认后即可正常使用
-
-**方法 2 - 自行编译**：
-
-1. Clone 代码到本地：`git clone https://github.com/farion1231/cc-switch.git`
-2. 安装依赖：`pnpm install`
-3. 编译代码：`pnpm run build`
-4. 打包应用：`pnpm run dist`
-5. 在项目 release 目录找到编译好的应用包
-
-**安全保障**：
-
-- 应用已通过 ad-hoc 代码签名，确保文件完整性
-- 源代码完全开源，可在 GitHub 审查
-- 本地存储配置，无网络传输风险
-
-**技术说明**：
-
-- 使用 Intel x64 架构，通过 Rosetta 2 在 M 系列芯片上运行
-- 兼容性和稳定性最佳，性能损失 minimal
-- 避免了 ARM64 原生版本的签名复杂性问题
+> **注意**：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开
 
 ### Linux 用户
 
-- **AppImage**: `CC Switch-x.x.x.AppImage`
-
-下载后添加执行权限：
-
-```bash
-chmod +x CC-Switch-x.x.x.AppImage
-```
+从 [Releases](../../releases) 页面下载最新版本的 `CC-Switch-v{版本号}-Linux.deb` 包或者 `CC-Switch-v{版本号}-Linux.AppImage` 安装包。
 
 ## 使用说明
 
 1. 点击"添加供应商"添加你的 API 配置
-2. 选择要使用的供应商，点击单选按钮切换
-3. 配置会自动保存到 Claude Code 的配置文件中
-4. 重启或者新打开 Claude Code 终端以生效
+2. 切换方式：
+   - 在主界面选择供应商后点击切换
+   - 或通过“系统托盘（菜单栏）”直接选择目标供应商，立即生效
+3. 切换会写入对应应用的“live 配置文件”（Claude：`settings.json`；Codex：`auth.json` + `config.toml`）
+4. 重启或新开终端以确保生效
+5. 若需切回官方登录，在预设中选择“官方登录”并切换即可；重启终端后按官方流程登录
+
+### MCP 配置说明（v3.5.x）
+
+- 管理位置：所有 MCP 服务器定义集中保存在 `~/.cc-switch/config.json`（按客户端 `claude` / `codex` 分类）
+- 同步机制：
+  - 启用的 Claude MCP 会投影到 `~/.claude.json`（路径可随覆盖目录而变化）
+  - 启用的 Codex MCP 会投影到 `~/.codex/config.toml`
+- 校验与归一化：新增/导入时自动校验字段合法性（stdio/http），并自动修复/填充 `id` 等键名
+- 导入来源：支持从 `~/.claude.json` 与 `~/.codex/config.toml` 导入；已存在条目只强制 `enabled=true`，不覆盖其他字段
+
+### 检查更新
+
+- 在“设置”中点击“检查更新”，若内置 Updater 配置可用将直接检测与下载；否则会回退打开 Releases 页面
+
+### Codex 说明（SSOT）
+
+- 配置目录：`~/.codex/`
+  - live 主配置：`auth.json`（必需）、`config.toml`（可为空）
+- API Key 字段：`auth.json` 中使用 `OPENAI_API_KEY`
+- 切换行为（不再写“副本文件”）：
+  - 供应商配置统一保存在 `~/.cc-switch/config.json`
+  - 切换时将目标供应商写回 live 文件（`auth.json` + `config.toml`）
+  - 采用“原子写入 + 失败回滚”，避免半写状态；`config.toml` 可为空
+- 导入默认：当该应用无任何供应商时，从现有 live 主配置创建一条默认项并设为当前
+- 官方登录：可切换到预设“Codex 官方登录”，重启终端后按官方流程登录
+
+### Claude Code 说明（SSOT）
+
+- 配置目录：`~/.claude/`
+  - live 主配置：`settings.json`（优先）或历史兼容 `claude.json`
+- API Key 字段：`env.ANTHROPIC_AUTH_TOKEN`
+- 切换行为（不再写“副本文件”）：
+  - 供应商配置统一保存在 `~/.cc-switch/config.json`
+  - 切换时将目标供应商 JSON 直接写入 live 文件（优先 `settings.json`）
+  - 编辑当前供应商时，先写 live 成功，再更新应用主配置，保证一致性
+- 导入默认：当该应用无任何供应商时，从现有 live 主配置创建一条默认项并设为当前
+- 官方登录：可切换到预设“Claude 官方登录”，重启终端后可使用 `/login` 完成登录
+
+### 迁移与归档（自 v3.2.0 起）
+
+- 一次性迁移：首次启动 3.2.0 及以上版本会扫描旧的“副本文件”并合并到 `~/.cc-switch/config.json`
+  - Claude：`~/.claude/settings-*.json`（排除 `settings.json` / 历史 `claude.json`）
+  - Codex：`~/.codex/auth-*.json` 与 `config-*.toml`（按名称成对合并）
+- 去重与当前项：按“名称（忽略大小写）+ API Key”去重；若当前为空，将 live 合并项设为当前
+- 归档与清理：
+  - 归档目录：`~/.cc-switch/archive/<timestamp>/<category>/...`
+  - 归档成功后删除原副本；失败则保留原文件（保守策略）
+- v1 → v2 结构升级：会额外生成 `~/.cc-switch/config.v1.backup.<timestamp>.json` 以便回滚
+- 注意：迁移后不再持续归档日常切换/编辑操作，如需长期审计请自备备份方案
+
+## 架构总览（v3.5.x）
+
+- 前端（Renderer）
+  - 技术栈：TypeScript + React 18 + Vite + TailwindCSS
+  - 数据层：TanStack React Query 统一查询与变更（`@/lib/query`），Tauri API 统一封装（`@/lib/api`）
+  - 事件流：监听后端 `provider-switched` 事件，驱动 UI 刷新与托盘状态一致
+  - 组织结构：按领域拆分组件（providers/settings/mcp），动作逻辑下沉至 Hooks（如 `useProviderActions`）
+
+- 后端（Tauri + Rust）
+  - Commands（接口层）：`src-tauri/src/commands/*` 按领域拆分（provider/config/mcp 等）
+  - Services（业务层）：`src-tauri/src/services/*` 承载核心逻辑（Provider/MCP/Config/Speedtest）
+  - 模型与状态：`provider.rs`（领域模型）+ `app_config.rs`（多应用配置）+ `store.rs`（全局 RwLock）
+  - 可靠性：
+    - 统一错误类型 `AppError`（包含本地化消息）
+    - 事务式变更（配置快照 + 失败回滚）与原子写入（避免半写入）
+    - 托盘菜单与事件：切换后重建菜单并向前端发射 `provider-switched` 事件
+
+- 设计要点（SSOT）
+  - 单一事实源：供应商配置集中存放于 `~/.cc-switch/config.json`
+  - 切换时仅写 live 配置（Claude: `settings.json`；Codex: `auth.json` + `config.toml`）
+  - 首次缺省导入：当某应用无任何供应商时，会从已有 live 配置生成默认项
+
+- 兼容性与变更
+  - 命令参数统一：Tauri 命令仅接受 `app`（值为 `claude` / `codex`）
+  - 前端类型统一：使用 `AppId` 表达应用标识（替代历史 `AppType` 导出）
 
 ## 开发
 
+### 环境要求
+
+- Node.js 18+
+- pnpm 8+
+- Rust 1.75+
+- Tauri CLI 2.0+
+
+### 开发命令
+
 ```bash
 # 安装依赖
 pnpm install
-# 或
-npm install
 
-# 开发模式
-pnpm run dev
+# 开发模式（热重载）
+pnpm dev
+
+# 类型检查
+pnpm typecheck
+
+# 代码格式化
+pnpm format
+
+# 检查代码格式
+pnpm format:check
+
+# 运行前端单元测试
+pnpm test:unit
+
+# 监听模式运行测试
+pnpm test:unit:watch
 
 # 构建应用
-pnpm run build
+pnpm build
 
-# 打包发布
-pnpm run dist
+# 构建调试版本
+pnpm tauri build --debug
+```
+
+### Rust 后端开发
+
+```bash
+cd src-tauri
+
+# 格式化 Rust 代码
+cargo fmt
+
+# 运行 clippy 检查
+cargo clippy
+
+# 运行测试
+cargo test
 ```
 
 ## 技术栈
 
-- Electron
-- React
-- TypeScript
-- Vite
+- **[Tauri 2](https://tauri.app/)** - 跨平台桌面应用框架（集成 updater/process/opener/log/tray-icon）
+- **[React 18](https://react.dev/)** - 用户界面库
+- **[TypeScript](https://www.typescriptlang.org/)** - 类型安全的 JavaScript
+- **[Vite](https://vitejs.dev/)** - 极速的前端构建工具
+- **[Rust](https://www.rust-lang.org/)** - 系统级编程语言（后端）
+- **[TanStack Query](https://tanstack.com/query/latest)** - 前端数据获取与缓存
+- **[i18next](https://www.i18next.com/)** - 国际化框架
 
 ## 项目结构
 
 ```
-├── src/
-│   ├── main/          # 主进程代码
-│   ├── renderer/      # 渲染进程代码
-│   └── shared/        # 共享类型和工具
-├── build/             # 应用图标资源
-└── dist/              # 构建输出目录
+├── src/                    # 前端代码 (React + TypeScript)
+│   ├── components/         # React 组件（providers/settings/mcp/ui 等）
+│   ├── hooks/              # 领域动作与状态（如 useProviderActions）
+│   ├── lib/
+│   │   ├── api/            # Tauri API 封装（providers/settings/mcp 等）
+│   │   └── query/          # TanStack Query 查询/变更与 client
+│   ├── i18n/               # 国际化资源
+│   ├── config/             # 供应商/MCP 预设
+│   └── utils/              # 工具函数
+├── src-tauri/            # 后端代码 (Rust)
+│   ├── src/             # Rust 源代码
+│   │   ├── commands/    # Tauri 命令定义（按域拆分）
+│   │   ├── services/    # 领域服务（Provider/MCP/Speedtest 等）
+│   │   ├── mcp.rs       # MCP 同步与规范化
+│   │   ├── migration.rs # 配置迁移逻辑
+│   │   ├── config.rs    # 配置文件管理
+│   │   ├── provider.rs  # 供应商管理逻辑
+│   │   └── store.rs     # 状态管理
+│   ├── capabilities/    # 权限配置
+│   └── icons/           # 应用图标资源
+└── screenshots/          # 界面截图
 ```
 
+## 更新日志
+
+查看 [CHANGELOG.md](CHANGELOG.md) 了解版本更新详情。
+
+## Electron 旧版
+
+[Releases](../../releases) 里保留 v2.0.3 Electron 旧版
+
+如果需要旧版 Electron 代码，可以拉取 electron-legacy 分支
+
+## 贡献
+
+欢迎提交 Issue 反馈问题和建议！
+
+提交 PR 前请确保：
+- 通过类型检查：`pnpm typecheck`
+- 通过格式检查：`pnpm format:check`
+- 通过单元测试：`pnpm test:unit`
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=farion1231/cc-switch&type=Date)](https://www.star-history.com/#farion1231/cc-switch&Date)
+
 ## License
 
-MIT
+MIT © Jason Young

README_i18n.md

@@ -0,0 +1,76 @@
+# CC Switch 国际化功能说明
+
+## 已完成的工作
+
+1. **安装依赖**：添加了 `react-i18next` 和 `i18next` 包
+2. **配置国际化**：在 `src/i18n/` 目录下创建了配置文件
+3. **翻译文件**：创建了英文和中文翻译文件
+4. **组件更新**：替换了主要组件中的硬编码文案
+5. **语言切换器**：添加了语言切换按钮
+
+## 文件结构
+
+```
+src/
+├── i18n/
+│   ├── index.ts          # 国际化配置文件
+│   └── locales/
+│       ├── en.json       # 英文翻译
+│       └── zh.json       # 中文翻译
+├── components/
+│   └── LanguageSwitcher.tsx  # 语言切换组件
+└── main.tsx              # 导入国际化配置
+```
+
+## 默认语言设置
+
+- **默认语言**：英文 (en)
+- **回退语言**：英文 (en)
+
+## 使用方式
+
+1. 在组件中导入 `useTranslation`：
+   ```tsx
+   import { useTranslation } from 'react-i18next';
+
+   function MyComponent() {
+     const { t } = useTranslation();
+     return <div>{t('common.save')}</div>;
+   }
+   ```
+
+2. 切换语言：
+   ```tsx
+   const { i18n } = useTranslation();
+   i18n.changeLanguage('zh'); // 切换到中文
+   ```
+
+## 翻译键结构
+
+- `common.*` - 通用文案（保存、取消、设置等）
+- `header.*` - 头部相关文案
+- `provider.*` - 供应商相关文案
+- `notifications.*` - 通知消息
+- `settings.*` - 设置页面文案
+- `apps.*` - 应用名称
+- `console.*` - 控制台日志信息
+
+## 测试功能
+
+应用已添加了语言切换按钮（地球图标），点击可以在中英文之间切换，验证国际化功能是否正常工作。
+
+## 已更新的组件
+
+- ✅ App.tsx - 主应用组件
+- ✅ ConfirmDialog.tsx - 确认对话框
+- ✅ AddProviderModal.tsx - 添加供应商弹窗
+- ✅ EditProviderModal.tsx - 编辑供应商弹窗
+- ✅ ProviderList.tsx - 供应商列表
+- ✅ LanguageSwitcher.tsx - 语言切换器
+- ✅ settings/SettingsDialog.tsx - 设置对话框
+
+## 注意事项
+
+1. 所有新的文案都应该添加到翻译文件中，而不是硬编码
+2. 翻译键名应该有意义且结构化
+3. 可以通过修改 `src/i18n/index.ts` 中的 `lng` 配置来更改默认语言

components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.js",
+    "css": "src/index.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

docs/BACKEND_REFACTOR_PLAN.md

@@ -0,0 +1,169 @@
+# CC Switch Rust 后端重构方案
+
+## 目录
+- [背景与现状](#背景与现状)
+- [问题确认](#问题确认)
+- [方案评估](#方案评估)
+- [渐进式重构路线](#渐进式重构路线)
+- [测试策略](#测试策略)
+- [风险与对策](#风险与对策)
+- [总结](#总结)
+
+## 背景与现状
+- 前端已完成重构，后端 (Tauri + Rust) 仍维持历史结构。
+- 核心文件集中在 `src-tauri/src/commands.rs`、`lib.rs` 等超大文件中，业务逻辑与界面事件耦合严重。
+- 测试覆盖率低，只有零散单元测试，缺乏集成验证。
+
+## 问题确认
+
+| 提案问题 | 实际情况 | 严重程度 |
+| --- | --- | --- |
+| `commands.rs` 过长 | ✅ 1526 行，包含 32 个命令，职责混杂 | 🔴 高 |
+| `lib.rs` 缺少服务层 | ✅ 541 行，托盘/事件/业务逻辑耦合 | 🟡 中 |
+| `Result<T, String>` 泛滥 | ✅ 118 处，错误上下文丢失 | 🟡 中 |
+| 全局 `Mutex` 阻塞 | ✅ 31 处 `.lock()` 调用，读写不分离 | 🟡 中 |
+| 配置逻辑分散 | ✅ 分布在 5 个文件 (`config`/`app_config`/`app_store`/`settings`/`codex_config`) | 🟢 低 |
+
+代码规模分布（约 5.4k SLOC）：
+- `commands.rs`: 1526 行（28%）→ 第一优先级 🎯
+- `lib.rs`: 541 行（10%）→ 托盘逻辑与业务耦合
+- `mcp.rs`: 732 行（14%）→ 相对清晰
+- `migration.rs`: 431 行（8%）→ 一次性逻辑
+- 其他文件合计：2156 行（40%）
+
+## 方案评估
+
+### ✅ 优点
+1. **分层架构清晰**  
+   - `commands/`：Tauri 命令薄层  
+   - `services/`：业务流程，如供应商切换、MCP 同步  
+   - `infrastructure/`：配置读写、外设交互  
+   - `domain/`：数据模型 (`Provider`, `AppType` 等)  
+   → 提升可测试性、降低耦合度、方便团队协作。
+
+2. **统一错误处理**  
+   - 引入 `AppError`（`thiserror`），保留错误链和上下文。  
+   - Tauri 命令仍返回 `Result<T, String>`，通过 `From<AppError>` 自动转换。  
+   - 改善日志可读性，利于排查。
+
+3. **并发优化**  
+   - `AppState` 切换为 `RwLock<MultiAppConfig>`。  
+   - 读多写少的场景提升吞吐（如频繁查询供应商列表）。
+
+### ⚠️ 风险
+1. **过度设计**  
+   - 完整 DDD 四层在 5k 行项目中会增加 30-50% 维护成本。  
+   - Rust trait + repository 样板较多，收益不足。  
+   - 推荐“轻量分层”而非正统 DDD。
+
+2. **迁移成本高**  
+   - `commands.rs` 拆分、错误统一、锁改造触及多文件。  
+   - 测试缺失导致重构风险高，需先补测试。  
+   - 估算完整改造需 5-6 周；建议分阶段输出可落地价值。
+
+3. **技术选型需谨慎**  
+   - `parking_lot` 相比标准库 `RwLock` 提升有限，不必引入。  
+   - `spawn_blocking` 仅用于 >100ms 的阻塞任务，避免滥用。  
+   - 以现有依赖为主，控制复杂度。
+
+## 实施进度
+- **阶段 1：统一错误处理 ✅**  
+  - 引入 `thiserror` 并在 `src-tauri/src/error.rs` 定义 `AppError`，提供常用构造函数和 `From<AppError> for String`，保留错误链路。  
+  - 配置、存储、同步等核心模块（`config.rs`、`app_config.rs`、`app_store.rs`、`store.rs`、`codex_config.rs`、`claude_mcp.rs`、`claude_plugin.rs`、`import_export.rs`、`mcp.rs`、`migration.rs`、`speedtest.rs`、`usage_script.rs`、`settings.rs`、`lib.rs` 等）已统一返回 `Result<_, AppError>`，避免字符串错误丢失上下文。  
+  - Tauri 命令层继续返回 `Result<_, String>`，通过 `?` + `Into<String>` 统一转换，前端无需调整。  
+  - `cargo check` 通过，`rg "Result<[^>]+, String"` 巡检确认除命令层外已无字符串错误返回。
+- **阶段 2：拆分命令层 ✅**  
+  - 已将单一 `src-tauri/src/commands.rs` 拆分为 `commands/{provider,mcp,config,settings,misc,plugin}.rs` 并通过 `commands/mod.rs` 统一导出，保持对外 API 不变。  
+  - 每个文件聚焦单一功能域（供应商、MCP、配置、设置、杂项、插件），命令函数平均 150-250 行，可读性与后续维护性显著提升。  
+  - 相关依赖调整后 `cargo check` 通过，静态巡检确认无重复定义或未注册命令。
+- **阶段 3：补充测试 ✅**  
+  - `tests/import_export_sync.rs` 集成测试涵盖配置备份、Claude/Codex live 同步、MCP 投影与 Codex/Claude 双向导入流程，并新增启用项清理、非法 TOML 抛错等失败场景验证；统一使用隔离 HOME 目录避免污染真实用户环境。  
+  - 扩展 `lib.rs` re-export，暴露 `AppType`、`MultiAppConfig`、`AppError`、配置 IO 以及 Codex/Claude MCP 路径与同步函数，方便服务层及测试直接复用核心逻辑。  
+  - 新增负向测试验证 Codex 供应商缺少 `auth` 字段时的错误返回，并补充备份数量上限测试；顺带修复 `create_backup` 采用内存读写避免拷贝继承旧的修改时间，确保最新备份不会在清理阶段被误删。  
+  - 针对 `codex_config::write_codex_live_atomic` 补充成功与失败场景测试，覆盖 auth/config 原子写入与失败回滚逻辑（模拟目标路径为目录时的 rename 失败），降低 Codex live 写入回归风险。  
+  - 新增 `tests/provider_commands.rs` 覆盖 `switch_provider` 的 Codex 正常流程与供应商缺失分支，并抽取 `switch_provider_internal` 以复用 `AppError`，通过 `switch_provider_test_hook` 暴露测试入口；同时共享 `tests/support.rs` 提供隔离 HOME / 互斥工具函数。  
+  - 补充 Claude 切换集成测试，验证 live `settings.json` 覆写、新旧供应商快照回填以及 `.cc-switch/config.json` 持久化结果，确保阶段四提取服务层时拥有可回归的用例。  
+  - 增加 Codex 缺失 `auth` 场景测试，确认 `switch_provider_internal` 在关键字段缺失时返回带上下文的 `AppError`，同时保持内存状态未被污染。  
+  - 为配置导入命令抽取复用逻辑 `import_config_from_path` 并补充成功/失败集成测试，校验备份生成、状态同步、JSON 解析与文件缺失等错误回退路径；`export_config_to_file` 亦具备成功/缺失源文件的命令级回归。  
+  - 新增 `tests/mcp_commands.rs`，通过测试钩子覆盖 `import_default_config`、`import_mcp_from_claude`、`set_mcp_enabled` 等命令层行为，验证缺失文件/非法 JSON 的错误回滚以及成功路径落盘效果；阶段三目标达成，命令层关键边界已具备回归保障。
+- **阶段 4：服务层抽象 🚧（进行中）**  
+  - 新增 `services/provider.rs` 并实现 `ProviderService::switch` / `delete`，集中处理供应商切换、回填、MCP 同步等核心业务；命令层改为薄封装并在 `tests/provider_service.rs`、`tests/provider_commands.rs` 中完成成功与失败路径的集成验证。  
+  - 新增 `services/mcp.rs` 提供 `McpService`，封装 MCP 服务器的查询、增删改、启用同步与导入流程；命令层改为参数解析 + 调用服务，`tests/mcp_commands.rs` 直接使用 `McpService` 验证成功与失败路径，阶段三测试继续适配。  
+  - `McpService` 在内部先复制内存快照、释放写锁，再执行文件同步，避免阶段五升级后的 `RwLock` 在 I/O 场景被长时间占用；`upsert/delete/set_enabled/sync_enabled` 均已修正。  
+  - 新增 `services/config.rs` 提供 `ConfigService`，统一处理配置导入导出、备份与 live 同步；命令层迁移至 `commands/import_export.rs`，在落盘操作前释放锁并复用现有集成测试。  
+  - 新增 `services/speedtest.rs` 并实现 `SpeedtestService::test_endpoints`，将 URL 校验、超时裁剪与网络请求封装在服务层，命令改为薄封装；补充单元测试覆盖空列表与非法 URL 分支。  
+  - 后续可选：应用设置（Store）命令仍较薄，可按需评估是否抽象；当前阶段四核心服务已基本齐备。  
+- **阶段 5：锁与阻塞优化 ✅（首轮）**  
+  - `AppState` 已由 `Mutex<MultiAppConfig>` 切换为 `RwLock<MultiAppConfig>`，托盘、命令与测试均按读写语义区分 `read()` / `write()`；`cargo test` 全量通过验证并未破坏现有流程。  
+  - 针对高开销 IO 的配置导入/导出命令提取 `load_config_for_import`，并通过 `tauri::async_runtime::spawn_blocking` 将文件读写与备份迁至阻塞线程，保持命令处理线程轻量。  
+  - 其余命令梳理后确认仍属轻量同步操作，暂不额外引入 `spawn_blocking`；若后续出现新的长耗时流程，再按同一模式扩展。  
+
+## 渐进式重构路线
+
+### 阶段 1：统一错误处理（高收益 / 低风险）
+- 新增 `src-tauri/src/error.rs`，定义 `AppError`。  
+- 底层文件 IO、配置解析等函数返回 `Result<T, AppError>`。  
+- 命令层通过 `?` 自动传播，最终 `.map_err(Into::into)`。
+- 预估 3-5 天，立即启动。
+
+### 阶段 2：拆分 `commands.rs`（高收益 / 中风险）
+- 按业务拆分为 `commands/provider.rs`、`commands/mcp.rs`、`commands/config.rs`、`commands/settings.rs`、`commands/misc.rs`。  
+- `commands/mod.rs` 统一导出和注册。  
+- 文件行数降低到 200-300 行/文件，职责单一。  
+- 预估 5-7 天，可并行进行部分重构。
+
+### 阶段 3：补充测试（中收益 / 中风险）
+- 引入 `tests/` 或 `src-tauri/tests/` 集成测试，覆盖供应商切换、MCP 同步、配置迁移。  
+- 使用 `tempfile`/`tempdir` 隔离文件系统，组合少量回归脚本。  
+- 预估 5-7 天，为后续重构提供安全网。
+
+### 阶段 4：提取轻量服务层（中收益 / 中风险）
+- 新增 `services/provider_service.rs`、`services/mcp_service.rs`。  
+- 不强制使用 trait；直接以自由函数/结构体实现业务流程。  
+   ```rust
+   pub struct ProviderService;
+   impl ProviderService {
+       pub fn switch(config: &mut MultiAppConfig, app: AppType, id: &str) -> Result<(), AppError> {
+           // 业务流程：验证、回填、落盘、更新 current、触发事件
+       }
+   }
+   ```
+- 命令层负责参数解析，服务层处理业务逻辑，托盘逻辑重用同一接口。  
+- 预估 7-10 天，可在测试补齐后执行。
+
+### 阶段 5：锁与阻塞优化（低收益 / 低风险）
+- ✅ `AppState` 已从 `Mutex` 切换为 `RwLock`，命令与托盘读写按需区分，现有测试全部通过。  
+- ✅ 配置导入/导出命令通过 `spawn_blocking` 处理高开销文件 IO；其他命令维持同步执行以避免不必要调度。  
+- 🔄 持续监控：若后续引入新的批量迁移或耗时任务，再按相同模式扩展到阻塞线程；观察运行时锁竞争情况，必要时考虑进一步拆分状态或引入缓存。  
+
+## 测试策略
+- **优先覆盖场景**  
+  - 供应商切换：状态更新 + live 配置同步  
+  - MCP 同步：enabled 服务器快照与落盘  
+  - 配置迁移：归档、备份与版本升级
+- **推荐结构**
+  ```rust
+  #[cfg(test)]
+  mod integration {
+      use super::*;
+      #[test]
+      fn switch_provider_updates_live_config() { /* ... */ }
+      #[test]
+      fn sync_mcp_to_codex_updates_claude_config() { /* ... */ }
+      #[test]
+      fn migration_preserves_backup() { /* ... */ }
+  }
+  ```
+- 目标覆盖率：关键路径 >80%，文件 IO/迁移 >70%。
+
+## 风险与对策
+- **测试不足** → 阶段 3 强制补齐，建立基础集成测试。  
+- **重构跨度大** → 按阶段在独立分支推进（如 `refactor/backend-step1` 等）。  
+- **回滚困难** → 每阶段结束打 tag（如 `v3.6.0-backend-step1`），保留回滚点。  
+- **功能回归** → 重构后执行手动冒烟流程：供应商切换、托盘操作、MCP 同步、配置导入导出。
+
+## 总结
+- 当前规模下不建议整体引入完整 DDD/四层架构，避免过度设计。  
+- 建议遵循“错误统一 → 命令拆分 → 补测试 → 服务层抽象 → 锁优化”的渐进式策略。  
+- 完成阶段 1-3 后即可显著提升可维护性与可靠性；阶段 4-5 可根据资源灵活安排。  
+- 重构过程中同步维护文档与测试，确保团队成员对架构演进保持一致认知。

docs/REFACTORING_CHECKLIST.md

@@ -0,0 +1,490 @@
+# CC Switch 重构实施清单
+
+> 用于跟踪重构进度的详细检查清单
+
+**开始日期**: ___________
+**预计完成**: ___________
+**当前阶段**: ___________
+
+---
+
+## 📋 阶段 0: 准备阶段 (预计 1 天)
+
+### 环境准备
+
+- [ ] 创建新分支 `refactor/modernization`
+- [ ] 创建备份标签 `git tag backup-before-refactor`
+- [ ] 备份用户配置文件 `~/.cc-switch/config.json`
+- [ ] 通知团队成员重构开始
+
+### 依赖安装
+
+```bash
+pnpm add @tanstack/react-query
+pnpm add react-hook-form @hookform/resolvers
+pnpm add zod
+pnpm add sonner
+pnpm add next-themes
+pnpm add @radix-ui/react-dialog @radix-ui/react-dropdown-menu
+pnpm add @radix-ui/react-label @radix-ui/react-select
+pnpm add @radix-ui/react-slot @radix-ui/react-switch @radix-ui/react-tabs
+pnpm add class-variance-authority clsx tailwind-merge tailwindcss-animate
+```
+
+- [ ] 安装核心依赖 (上述命令)
+- [ ] 验证依赖安装成功 `pnpm install`
+- [ ] 验证编译通过 `pnpm typecheck`
+
+### 配置文件
+
+- [ ] 创建 `components.json`
+- [ ] 更新 `tsconfig.json` 添加路径别名
+- [ ] 更新 `vite.config.mts` 添加路径解析
+- [ ] 验证开发服务器启动 `pnpm dev`
+
+**完成时间**: ___________
+**遇到的问题**: ___________
+
+---
+
+## 📋 阶段 1: 基础设施 (预计 2-3 天)
+
+### 1.1 工具函数和基础组件
+
+- [ ] 创建 `src/lib/utils.ts` (cn 函数)
+- [ ] 创建 `src/components/ui/button.tsx`
+- [ ] 创建 `src/components/ui/dialog.tsx`
+- [ ] 创建 `src/components/ui/input.tsx`
+- [ ] 创建 `src/components/ui/label.tsx`
+- [ ] 创建 `src/components/ui/textarea.tsx`
+- [ ] 创建 `src/components/ui/select.tsx`
+- [ ] 创建 `src/components/ui/switch.tsx`
+- [ ] 创建 `src/components/ui/tabs.tsx`
+- [ ] 创建 `src/components/ui/sonner.tsx`
+- [ ] 创建 `src/components/ui/form.tsx`
+
+**测试**:
+- [ ] 验证所有 UI 组件可以正常导入
+- [ ] 创建一个测试页面验证组件样式
+
+### 1.2 Query Client 设置
+
+- [ ] 创建 `src/lib/query/queryClient.ts`
+- [ ] 配置默认选项 (retry, staleTime 等)
+- [ ] 导出 queryClient 实例
+
+### 1.3 API 层
+
+- [ ] 创建 `src/lib/api/providers.ts`
+  - [ ] getAll
+  - [ ] getCurrent
+  - [ ] add
+  - [ ] update
+  - [ ] delete
+  - [ ] switch
+  - [ ] importDefault
+  - [ ] updateTrayMenu
+
+- [ ] 创建 `src/lib/api/settings.ts`
+  - [ ] get
+  - [ ] save
+
+- [ ] 创建 `src/lib/api/mcp.ts`
+  - [ ] getConfig
+  - [ ] upsertServer
+  - [ ] deleteServer
+
+- [ ] 创建 `src/lib/api/index.ts` (聚合导出)
+
+**测试**:
+- [ ] 验证 API 调用不会出现运行时错误
+- [ ] 确认类型定义正确
+
+### 1.4 Query Hooks
+
+- [ ] 创建 `src/lib/query/queries.ts`
+  - [ ] useProvidersQuery
+  - [ ] useSettingsQuery
+  - [ ] useMcpConfigQuery
+
+- [ ] 创建 `src/lib/query/mutations.ts`
+  - [ ] useAddProviderMutation
+  - [ ] useSwitchProviderMutation
+  - [ ] useDeleteProviderMutation
+  - [ ] useUpdateProviderMutation
+  - [ ] useSaveSettingsMutation
+
+- [ ] 创建 `src/lib/query/index.ts` (聚合导出)
+
+**测试**:
+- [ ] 在临时组件中测试每个 hook
+- [ ] 验证 loading/error 状态正确
+- [ ] 验证缓存和自动刷新工作
+
+**完成时间**: ___________
+**遇到的问题**: ___________
+
+---
+
+## 📋 阶段 2: 核心功能重构 (预计 3-4 天)
+
+### 2.1 主题系统
+
+- [ ] 创建 `src/components/theme-provider.tsx`
+- [ ] 创建 `src/components/mode-toggle.tsx`
+- [ ] 更新 `src/index.css` 添加主题变量
+- [ ] 删除 `src/hooks/useDarkMode.ts`
+- [ ] 更新所有组件使用新的主题系统
+
+**测试**:
+- [ ] 验证主题切换正常工作
+- [ ] 验证系统主题跟随功能
+- [ ] 验证主题持久化
+
+### 2.2 更新 main.tsx
+
+- [ ] 引入 QueryClientProvider
+- [ ] 引入 ThemeProvider
+- [ ] 添加 Toaster 组件
+- [ ] 移除旧的 API 导入
+
+**测试**:
+- [ ] 验证应用可以正常启动
+- [ ] 验证 Context 正确传递
+
+### 2.3 重构 App.tsx
+
+- [ ] 使用 useProvidersQuery 替代手动状态管理
+- [ ] 移除所有 loadProviders 相关代码
+- [ ] 移除手动 notification 状态
+- [ ] 简化事件监听逻辑
+- [ ] 更新对话框为新的 Dialog 组件
+
+**目标**: 将 412 行代码减少到 ~100 行
+
+**测试**:
+- [ ] 验证供应商列表正常加载
+- [ ] 验证切换 Claude/Codex 正常工作
+- [ ] 验证事件监听正常工作
+
+### 2.4 重构 ProviderList
+
+- [ ] 创建 `src/components/providers/ProviderList.tsx`
+- [ ] 使用 mutation hooks 处理操作
+- [ ] 移除 onNotify prop
+- [ ] 移除手动状态管理
+
+**测试**:
+- [ ] 验证供应商列表渲染
+- [ ] 验证切换操作
+- [ ] 验证删除操作
+
+### 2.5 重构表单系统
+
+- [ ] 创建 `src/lib/schemas/provider.ts` (Zod schema)
+- [ ] 创建 `src/components/providers/ProviderForm.tsx`
+  - [ ] 使用 react-hook-form
+  - [ ] 使用 zodResolver
+  - [ ] 字段级验证
+
+- [ ] 创建 `src/components/providers/AddProviderDialog.tsx`
+  - [ ] 使用新的 Dialog 组件
+  - [ ] 集成 ProviderForm
+  - [ ] 使用 useAddProviderMutation
+
+- [ ] 创建 `src/components/providers/EditProviderDialog.tsx`
+  - [ ] 使用新的 Dialog 组件
+  - [ ] 集成 ProviderForm
+  - [ ] 使用 useUpdateProviderMutation
+
+**测试**:
+- [ ] 验证表单验证正常工作
+- [ ] 验证错误提示显示正确
+- [ ] 验证提交操作成功
+- [ ] 验证表单重置功能
+
+### 2.6 清理旧组件
+
+- [x] 删除 `src/components/AddProviderModal.tsx`
+- [x] 删除 `src/components/EditProviderModal.tsx`
+- [x] 更新所有引用这些组件的地方
+- [x] 删除 `src/components/ProviderForm.tsx` 及 `src/components/ProviderForm/`
+
+**完成时间**: ___________
+**遇到的问题**: ___________
+
+---
+
+## 📋 阶段 3: 设置和辅助功能 (预计 2-3 天)
+
+### 3.1 重构 SettingsDialog
+
+- [ ] 创建 `src/components/settings/SettingsDialog.tsx`
+  - [ ] 使用 Tabs 组件
+  - [ ] 集成各个设置子组件
+
+- [ ] 创建 `src/components/settings/GeneralSettings.tsx`
+  - [ ] 语言设置
+  - [ ] 配置目录设置
+  - [ ] 其他通用设置
+
+- [ ] 创建 `src/components/settings/AboutSection.tsx`
+  - [ ] 版本信息
+  - [ ] 更新检查
+  - [ ] 链接
+
+- [ ] 创建 `src/components/settings/ImportExportSection.tsx`
+  - [ ] 导入功能
+  - [ ] 导出功能
+
+**目标**: 将 643 行拆分为 4-5 个小组件，每个 100-150 行
+
+**测试**:
+- [ ] 验证设置保存功能
+- [ ] 验证导入导出功能
+- [ ] 验证更新检查功能
+
+### 3.2 重构通知系统
+
+- [ ] 在所有 mutations 中使用 `toast` 替代 `showNotification`
+- [ ] 移除 App.tsx 中的 notification 状态
+- [ ] 移除自定义通知组件
+
+**测试**:
+- [ ] 验证成功通知显示
+- [ ] 验证错误通知显示
+- [ ] 验证通知自动消失
+
+### 3.3 重构确认对话框
+
+- [ ] 更新 `src/components/ConfirmDialog.tsx` 使用新的 Dialog
+- [ ] 或者直接使用 shadcn/ui 的 AlertDialog
+
+**测试**:
+- [ ] 验证删除确认对话框
+- [ ] 验证其他确认场景
+
+**完成时间**: ___________
+**遇到的问题**: ___________
+
+---
+
+## 📋 阶段 4: 清理和优化 (预计 1-2 天)
+
+### 4.1 移除旧代码
+
+- [x] 删除 `src/lib/styles.ts`
+- [x] 从 `src/lib/tauri-api.ts` 移除 `window.api` 绑定
+- [x] 精简 `src/lib/tauri-api.ts`，只保留事件监听相关
+- [x] 删除或更新 `src/vite-env.d.ts` 中的过时类型
+
+### 4.2 代码审查
+
+- [ ] 检查所有 TODO 注释
+- [x] 检查是否还有 `window.api` 调用
+- [ ] 检查是否还有手动状态管理
+- [x] 统一代码风格
+
+### 4.3 类型检查
+
+- [x] 运行 `pnpm typecheck` 确保无错误
+- [x] 修复所有类型错误
+- [x] 更新类型定义
+
+### 4.4 性能优化
+
+- [ ] 检查是否有不必要的重渲染
+- [ ] 添加必要的 React.memo
+- [ ] 优化 Query 缓存配置
+
+**完成时间**: ___________
+**遇到的问题**: ___________
+
+---
+
+## 📋 阶段 5: 测试和修复 (预计 2-3 天)
+
+### 5.1 功能测试
+
+#### 供应商管理
+- [ ] 添加供应商 (Claude)
+- [ ] 添加供应商 (Codex)
+- [ ] 编辑供应商
+- [ ] 删除供应商
+- [ ] 切换供应商
+- [ ] 导入默认配置
+
+#### 应用切换
+- [ ] Claude <-> Codex 切换
+- [ ] 切换后数据正确加载
+- [ ] 切换后托盘菜单更新
+
+#### 设置
+- [ ] 保存通用设置
+- [ ] 切换语言
+- [ ] 配置目录选择
+- [ ] 导入配置
+- [ ] 导出配置
+
+#### UI 交互
+- [ ] 主题切换 (亮色/暗色)
+- [ ] 对话框打开/关闭
+- [ ] 表单验证
+- [ ] Toast 通知
+
+#### MCP 管理
+- [ ] 列表显示
+- [ ] 添加 MCP
+- [ ] 编辑 MCP
+- [ ] 删除 MCP
+- [ ] 启用/禁用 MCP
+
+### 5.2 边界情况测试
+
+- [ ] 空供应商列表
+- [ ] 无效配置文件
+- [ ] 网络错误
+- [ ] 后端错误响应
+- [ ] 并发操作
+- [ ] 表单输入边界值
+
+### 5.3 兼容性测试
+
+- [ ] Windows 测试
+- [ ] macOS 测试
+- [ ] Linux 测试
+
+### 5.4 性能测试
+
+- [ ] 100+ 供应商加载速度
+- [ ] 快速切换供应商
+- [ ] 内存使用情况
+- [ ] CPU 使用情况
+
+### 5.5 Bug 修复
+
+**Bug 列表** (发现后记录):
+
+1. ___________
+   - [ ] 已修复
+   - [ ] 已验证
+
+2. ___________
+   - [ ] 已修复
+   - [ ] 已验证
+
+**完成时间**: ___________
+**遇到的问题**: ___________
+
+---
+
+## 📋 最终检查
+
+### 代码质量
+
+- [ ] 所有 TypeScript 错误已修复
+- [ ] 运行 `pnpm format` 格式化代码
+- [ ] 运行 `pnpm typecheck` 通过
+- [ ] 代码审查完成
+
+### 文档更新
+
+- [ ] 更新 `CLAUDE.md` 反映新架构
+- [ ] 更新 `README.md` (如有必要)
+- [ ] 添加 Migration Guide (可选)
+
+### 性能基准
+
+记录性能数据:
+
+**旧版本**:
+- 启动时间: _____ms
+- 供应商加载: _____ms
+- 内存占用: _____MB
+
+**新版本**:
+- 启动时间: _____ms
+- 供应商加载: _____ms
+- 内存占用: _____MB
+
+### 代码统计
+
+**代码行数对比**:
+
+| 文件 | 旧版本 | 新版本 | 减少 |
+|------|--------|--------|------|
+| App.tsx | 412 | ~100 | -76% |
+| tauri-api.ts | 712 | ~50 | -93% |
+| ProviderForm.tsx | 271 | ~150 | -45% |
+| settings 模块 | 1046 | ~470 (拆分) | -55% |
+| **总计** | 2038 | ~700 | **-66%** |
+
+---
+
+## 📦 发布准备
+
+### Pre-release 测试
+
+- [ ] 创建 beta 版本 `v4.0.0-beta.1`
+- [ ] 在测试环境验证
+- [ ] 收集用户反馈
+
+### 正式发布
+
+- [ ] 合并到 main 分支
+- [ ] 创建 Release Tag `v4.0.0`
+- [ ] 更新 Changelog
+- [ ] 发布 GitHub Release
+- [ ] 通知用户更新
+
+---
+
+## 🚨 回滚触发条件
+
+如果出现以下情况，考虑回滚:
+
+- [ ] 重大功能无法使用
+- [ ] 用户数据丢失
+- [ ] 严重性能问题
+- [ ] 无法修复的兼容性问题
+
+**回滚命令**:
+```bash
+git reset --hard backup-before-refactor
+# 或
+git revert <commit-range>
+```
+
+---
+
+## 📝 总结报告
+
+### 成功指标
+
+- [ ] 所有现有功能正常工作
+- [ ] 代码量减少 40%+
+- [ ] 无用户数据丢失
+- [ ] 性能未下降
+
+### 经验教训
+
+**遇到的主要挑战**:
+1. ___________
+2. ___________
+3. ___________
+
+**解决方案**:
+1. ___________
+2. ___________
+3. ___________
+
+**未来改进**:
+1. ___________
+2. ___________
+3. ___________
+
+---
+
+**重构完成日期**: ___________
+**总耗时**: _____ 天
+**参与人员**: ___________

docs/REFACTORING_REFERENCE.md

@@ -0,0 +1,834 @@
+# 重构快速参考指南
+
+> 常见模式和代码示例的速查表
+
+---
+
+## 📑 目录
+
+1. [React Query 使用](#react-query-使用)
+2. [react-hook-form 使用](#react-hook-form-使用)
+3. [shadcn/ui 组件使用](#shadcnui-组件使用)
+4. [代码迁移示例](#代码迁移示例)
+
+---
+
+## React Query 使用
+
+### 基础查询
+
+```typescript
+// 定义查询 Hook
+export const useProvidersQuery = (appId: AppId) => {
+  return useQuery({
+    queryKey: ['providers', appId],
+    queryFn: async () => {
+      const data = await providersApi.getAll(appId)
+      return data
+    },
+  })
+}
+
+// 在组件中使用
+function MyComponent() {
+  const { data, isLoading, error } = useProvidersQuery('claude')
+
+  if (isLoading) return <div>Loading...</div>
+  if (error) return <div>Error: {error.message}</div>
+
+  return <div>{/* 使用 data */}</div>
+}
+```
+
+### Mutation (变更操作)
+
+```typescript
+// 定义 Mutation Hook
+export const useAddProviderMutation = (appId: AppId) => {
+  const queryClient = useQueryClient()
+
+  return useMutation({
+    mutationFn: async (provider: Provider) => {
+      return await providersApi.add(provider, appId)
+    },
+    onSuccess: () => {
+      // 重新获取数据
+      queryClient.invalidateQueries({ queryKey: ['providers', appId] })
+      toast.success('添加成功')
+    },
+    onError: (error: Error) => {
+      toast.error(`添加失败: ${error.message}`)
+    },
+  })
+}
+
+// 在组件中使用
+function AddProviderDialog() {
+const mutation = useAddProviderMutation('claude')
+
+  const handleSubmit = (data: Provider) => {
+    mutation.mutate(data)
+  }
+
+  return (
+    <button
+      onClick={() => handleSubmit(formData)}
+      disabled={mutation.isPending}
+    >
+      {mutation.isPending ? '添加中...' : '添加'}
+    </button>
+  )
+}
+```
+
+### 乐观更新
+
+```typescript
+export const useSwitchProviderMutation = (appId: AppId) => {
+  const queryClient = useQueryClient()
+
+  return useMutation({
+    mutationFn: async (providerId: string) => {
+      return await providersApi.switch(providerId, appId)
+    },
+    // 乐观更新: 在请求发送前立即更新 UI
+    onMutate: async (providerId) => {
+      // 取消正在进行的查询
+      await queryClient.cancelQueries({ queryKey: ['providers', appId] })
+
+      // 保存当前数据(以便回滚)
+      const previousData = queryClient.getQueryData(['providers', appId])
+
+      // 乐观更新
+      queryClient.setQueryData(['providers', appId], (old: any) => ({
+        ...old,
+        currentProviderId: providerId,
+      }))
+
+      return { previousData }
+    },
+    // 如果失败，回滚
+    onError: (err, providerId, context) => {
+      queryClient.setQueryData(['providers', appId], context?.previousData)
+      toast.error('切换失败')
+    },
+    // 无论成功失败，都重新获取数据
+    onSettled: () => {
+      queryClient.invalidateQueries({ queryKey: ['providers', appId] })
+    },
+  })
+}
+```
+
+### 依赖查询
+
+```typescript
+// 第二个查询依赖第一个查询的结果
+const { data: providers } = useProvidersQuery(appId)
+const currentProviderId = providers?.currentProviderId
+
+const { data: currentProvider } = useQuery({
+  queryKey: ['provider', currentProviderId],
+  queryFn: () => providersApi.getById(currentProviderId!),
+  enabled: !!currentProviderId, // 只有当 ID 存在时才执行
+})
+```
+
+---
+
+## react-hook-form 使用
+
+### 基础表单
+
+```typescript
+import { useForm } from 'react-hook-form'
+import { zodResolver } from '@hookform/resolvers/zod'
+import { z } from 'zod'
+
+// 定义验证 schema
+const schema = z.object({
+  name: z.string().min(1, '请输入名称'),
+  email: z.string().email('邮箱格式不正确'),
+  age: z.number().min(18, '年龄必须大于18'),
+})
+
+type FormData = z.infer<typeof schema>
+
+function MyForm() {
+  const form = useForm<FormData>({
+    resolver: zodResolver(schema),
+    defaultValues: {
+      name: '',
+      email: '',
+      age: 0,
+    },
+  })
+
+  const onSubmit = (data: FormData) => {
+    console.log(data)
+  }
+
+  return (
+    <form onSubmit={form.handleSubmit(onSubmit)}>
+      <input {...form.register('name')} />
+      {form.formState.errors.name && (
+        <span>{form.formState.errors.name.message}</span>
+      )}
+
+      <button type="submit">提交</button>
+    </form>
+  )
+}
+```
+
+### 使用 shadcn/ui Form 组件
+
+```typescript
+import { useForm } from 'react-hook-form'
+import { zodResolver } from '@hookform/resolvers/zod'
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from '@/components/ui/form'
+import { Input } from '@/components/ui/input'
+import { Button } from '@/components/ui/button'
+
+function MyForm() {
+  const form = useForm<FormData>({
+    resolver: zodResolver(schema),
+  })
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-4">
+        <FormField
+          control={form.control}
+          name="name"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>名称</FormLabel>
+              <FormControl>
+                <Input placeholder="请输入名称" {...field} />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+
+        <Button type="submit">提交</Button>
+      </form>
+    </Form>
+  )
+}
+```
+
+### 动态表单验证
+
+```typescript
+// 根据条件动态验证
+const schema = z.object({
+  type: z.enum(['official', 'custom']),
+  apiKey: z.string().optional(),
+  baseUrl: z.string().optional(),
+}).refine(
+  (data) => {
+    // 如果是自定义供应商，必须填写 baseUrl
+    if (data.type === 'custom') {
+      return !!data.baseUrl
+    }
+    return true
+  },
+  {
+    message: '自定义供应商必须填写 Base URL',
+    path: ['baseUrl'],
+  }
+)
+```
+
+### 手动触发验证
+
+```typescript
+function MyForm() {
+  const form = useForm<FormData>()
+
+  const handleBlur = async () => {
+    // 验证单个字段
+    await form.trigger('name')
+
+    // 验证多个字段
+    await form.trigger(['name', 'email'])
+
+    // 验证所有字段
+    const isValid = await form.trigger()
+  }
+
+  return <form>...</form>
+}
+```
+
+---
+
+## shadcn/ui 组件使用
+
+### Dialog (对话框)
+
+```typescript
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogDescription,
+  DialogFooter,
+} from '@/components/ui/dialog'
+import { Button } from '@/components/ui/button'
+
+function MyDialog() {
+  const [open, setOpen] = useState(false)
+
+  return (
+    <Dialog open={open} onOpenChange={setOpen}>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>标题</DialogTitle>
+          <DialogDescription>描述信息</DialogDescription>
+        </DialogHeader>
+
+        {/* 内容 */}
+        <div>对话框内容</div>
+
+        <DialogFooter>
+          <Button variant="outline" onClick={() => setOpen(false)}>
+            取消
+          </Button>
+          <Button onClick={handleConfirm}>确认</Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  )
+}
+```
+
+### Select (选择器)
+
+```typescript
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from '@/components/ui/select'
+
+function MySelect() {
+  const [value, setValue] = useState('')
+
+  return (
+    <Select value={value} onValueChange={setValue}>
+      <SelectTrigger>
+        <SelectValue placeholder="请选择" />
+      </SelectTrigger>
+      <SelectContent>
+        <SelectItem value="option1">选项1</SelectItem>
+        <SelectItem value="option2">选项2</SelectItem>
+        <SelectItem value="option3">选项3</SelectItem>
+      </SelectContent>
+    </Select>
+  )
+}
+```
+
+### Tabs (标签页)
+
+```typescript
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'
+
+function MyTabs() {
+  return (
+    <Tabs defaultValue="tab1">
+      <TabsList>
+        <TabsTrigger value="tab1">标签1</TabsTrigger>
+        <TabsTrigger value="tab2">标签2</TabsTrigger>
+        <TabsTrigger value="tab3">标签3</TabsTrigger>
+      </TabsList>
+
+      <TabsContent value="tab1">
+        <div>标签1的内容</div>
+      </TabsContent>
+
+      <TabsContent value="tab2">
+        <div>标签2的内容</div>
+      </TabsContent>
+
+      <TabsContent value="tab3">
+        <div>标签3的内容</div>
+      </TabsContent>
+    </Tabs>
+  )
+}
+```
+
+### Toast 通知 (Sonner)
+
+```typescript
+import { toast } from 'sonner'
+
+// 成功通知
+toast.success('操作成功')
+
+// 错误通知
+toast.error('操作失败')
+
+// 加载中
+const toastId = toast.loading('处理中...')
+// 完成后更新
+toast.success('处理完成', { id: toastId })
+// 或
+toast.dismiss(toastId)
+
+// 自定义持续时间
+toast.success('消息', { duration: 5000 })
+
+// 带操作按钮
+toast('确认删除?', {
+  action: {
+    label: '删除',
+    onClick: () => handleDelete(),
+  },
+})
+```
+
+---
+
+## 代码迁移示例
+
+### 示例 1: 状态管理迁移
+
+**旧代码** (手动状态管理):
+
+```typescript
+const [providers, setProviders] = useState<Record<string, Provider>>({})
+const [currentProviderId, setCurrentProviderId] = useState('')
+const [loading, setLoading] = useState(false)
+const [error, setError] = useState<Error | null>(null)
+
+useEffect(() => {
+  const load = async () => {
+    setLoading(true)
+    setError(null)
+    try {
+      const data = await window.api.getProviders(appType)
+      const currentId = await window.api.getCurrentProvider(appType)
+      setProviders(data)
+      setCurrentProviderId(currentId)
+    } catch (err) {
+      setError(err as Error)
+    } finally {
+      setLoading(false)
+    }
+  }
+  load()
+}, [appId])
+```
+
+**新代码** (React Query):
+
+```typescript
+const { data, isLoading, error } = useProvidersQuery(appId)
+const providers = data?.providers || {}
+const currentProviderId = data?.currentProviderId || ''
+```
+
+**减少**: 从 20+ 行到 3 行
+
+---
+
+### 示例 2: 表单验证迁移
+
+**旧代码** (手动验证):
+
+```typescript
+const [name, setName] = useState('')
+const [nameError, setNameError] = useState('')
+const [apiKey, setApiKey] = useState('')
+const [apiKeyError, setApiKeyError] = useState('')
+
+const validate = () => {
+  let valid = true
+
+  if (!name.trim()) {
+    setNameError('请输入名称')
+    valid = false
+  } else {
+    setNameError('')
+  }
+
+  if (!apiKey.trim()) {
+    setApiKeyError('请输入 API Key')
+    valid = false
+  } else if (apiKey.length < 10) {
+    setApiKeyError('API Key 长度不足')
+    valid = false
+  } else {
+    setApiKeyError('')
+  }
+
+  return valid
+}
+
+const handleSubmit = () => {
+  if (validate()) {
+    // 提交
+  }
+}
+
+return (
+  <form>
+    <input value={name} onChange={e => setName(e.target.value)} />
+    {nameError && <span>{nameError}</span>}
+
+    <input value={apiKey} onChange={e => setApiKey(e.target.value)} />
+    {apiKeyError && <span>{apiKeyError}</span>}
+
+    <button onClick={handleSubmit}>提交</button>
+  </form>
+)
+```
+
+**新代码** (react-hook-form + zod):
+
+```typescript
+const schema = z.object({
+  name: z.string().min(1, '请输入名称'),
+  apiKey: z.string().min(10, 'API Key 长度不足'),
+})
+
+const form = useForm({
+  resolver: zodResolver(schema),
+})
+
+return (
+  <Form {...form}>
+    <form onSubmit={form.handleSubmit(onSubmit)}>
+      <FormField
+        control={form.control}
+        name="name"
+        render={({ field }) => (
+          <FormItem>
+            <FormControl>
+              <Input {...field} />
+            </FormControl>
+            <FormMessage />
+          </FormItem>
+        )}
+      />
+
+      <FormField
+        control={form.control}
+        name="apiKey"
+        render={({ field }) => (
+          <FormItem>
+            <FormControl>
+              <Input {...field} />
+            </FormControl>
+            <FormMessage />
+          </FormItem>
+        )}
+      />
+
+      <Button type="submit">提交</Button>
+    </form>
+  </Form>
+)
+```
+
+**减少**: 从 40+ 行到 30 行，且更健壮
+
+---
+
+### 示例 3: 通知系统迁移
+
+**旧代码** (自定义通知):
+
+```typescript
+const [notification, setNotification] = useState<{
+  message: string
+  type: 'success' | 'error'
+} | null>(null)
+const [isVisible, setIsVisible] = useState(false)
+
+const showNotification = (message: string, type: 'success' | 'error') => {
+  setNotification({ message, type })
+  setIsVisible(true)
+  setTimeout(() => {
+    setIsVisible(false)
+    setTimeout(() => setNotification(null), 300)
+  }, 3000)
+}
+
+return (
+  <>
+    {notification && (
+      <div className={`notification ${isVisible ? 'visible' : ''} ${notification.type}`}>
+        {notification.message}
+      </div>
+    )}
+    {/* 其他内容 */}
+  </>
+)
+```
+
+**新代码** (Sonner):
+
+```typescript
+import { toast } from 'sonner'
+
+// 在需要的地方直接调用
+toast.success('操作成功')
+toast.error('操作失败')
+
+// 在 main.tsx 中只需添加一次
+import { Toaster } from '@/components/ui/sonner'
+
+<Toaster />
+```
+
+**减少**: 从 20+ 行到 1 行调用
+
+---
+
+### 示例 4: 对话框迁移
+
+**旧代码** (自定义 Modal):
+
+```typescript
+const [isOpen, setIsOpen] = useState(false)
+
+return (
+  <>
+    <button onClick={() => setIsOpen(true)}>打开</button>
+
+    {isOpen && (
+      <div className="modal-backdrop" onClick={() => setIsOpen(false)}>
+        <div className="modal-content" onClick={e => e.stopPropagation()}>
+          <div className="modal-header">
+            <h2>标题</h2>
+            <button onClick={() => setIsOpen(false)}>×</button>
+          </div>
+          <div className="modal-body">
+            {/* 内容 */}
+          </div>
+          <div className="modal-footer">
+            <button onClick={() => setIsOpen(false)}>取消</button>
+            <button onClick={handleConfirm}>确认</button>
+          </div>
+        </div>
+      </div>
+    )}
+  </>
+)
+```
+
+**新代码** (shadcn/ui Dialog):
+
+```typescript
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@/components/ui/dialog'
+
+const [isOpen, setIsOpen] = useState(false)
+
+return (
+  <>
+    <Button onClick={() => setIsOpen(true)}>打开</Button>
+
+    <Dialog open={isOpen} onOpenChange={setIsOpen}>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>标题</DialogTitle>
+        </DialogHeader>
+        {/* 内容 */}
+        <DialogFooter>
+          <Button variant="outline" onClick={() => setIsOpen(false)}>取消</Button>
+          <Button onClick={handleConfirm}>确认</Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  </>
+)
+```
+
+**优势**:
+- 无需自定义样式
+- 内置无障碍支持
+- 自动管理焦点和 ESC 键
+
+---
+
+### 示例 5: API 调用迁移
+
+**旧代码** (window.api):
+
+```typescript
+// 添加供应商
+const handleAdd = async (provider: Provider) => {
+  try {
+    await window.api.addProvider(provider, appType)
+    await loadProviders()
+    showNotification('添加成功', 'success')
+  } catch (error) {
+    showNotification('添加失败', 'error')
+  }
+}
+```
+
+**新代码** (React Query Mutation):
+
+```typescript
+// 在组件中
+const addMutation = useAddProviderMutation(appId)
+
+const handleAdd = (provider: Provider) => {
+  addMutation.mutate(provider)
+  // 成功和错误处理已在 mutation 定义中处理
+}
+```
+
+**优势**:
+- 自动处理 loading 状态
+- 统一的错误处理
+- 自动刷新数据
+- 更少的样板代码
+
+---
+
+## 常见问题
+
+### Q: 如何在 mutation 成功后关闭对话框?
+
+```typescript
+const mutation = useAddProviderMutation(appId)
+
+const handleSubmit = (data: Provider) => {
+  mutation.mutate(data, {
+    onSuccess: () => {
+      setIsOpen(false) // 关闭对话框
+    },
+  })
+}
+```
+
+### Q: 如何在表单中使用异步验证?
+
+```typescript
+const schema = z.object({
+  name: z.string().refine(
+    async (name) => {
+      // 检查名称是否已存在
+      const exists = await checkNameExists(name)
+      return !exists
+    },
+    { message: '名称已存在' }
+  ),
+})
+```
+
+### Q: 如何手动刷新 Query 数据?
+
+```typescript
+const queryClient = useQueryClient()
+
+// 方式1: 使缓存失效，触发重新获取
+queryClient.invalidateQueries({ queryKey: ['providers', appId] })
+
+// 方式2: 直接刷新
+queryClient.refetchQueries({ queryKey: ['providers', appId] })
+
+// 方式3: 更新缓存数据
+queryClient.setQueryData(['providers', appId], newData)
+```
+
+### Q: 如何在组件外部使用 toast?
+
+```typescript
+// 直接导入并使用即可
+import { toast } from 'sonner'
+
+export const someUtil = () => {
+  toast.success('工具函数中的通知')
+}
+```
+
+---
+
+## 调试技巧
+
+### React Query DevTools
+
+```typescript
+// 在 main.tsx 中添加
+import { ReactQueryDevtools } from '@tanstack/react-query-devtools'
+
+<QueryClientProvider client={queryClient}>
+  <App />
+  <ReactQueryDevtools initialIsOpen={false} />
+</QueryClientProvider>
+```
+
+### 查看表单状态
+
+```typescript
+const form = useForm()
+
+// 在开发模式下打印表单状态
+console.log('Form values:', form.watch())
+console.log('Form errors:', form.formState.errors)
+console.log('Is valid:', form.formState.isValid)
+```
+
+---
+
+## 性能优化建议
+
+### 1. 避免不必要的重渲染
+
+```typescript
+// 使用 React.memo
+export const ProviderCard = React.memo(({ provider, onEdit }: Props) => {
+  // ...
+})
+
+// 或使用 useMemo
+const sortedProviders = useMemo(
+  () => Object.values(providers).sort(...),
+  [providers]
+)
+```
+
+### 2. Query 配置优化
+
+```typescript
+const { data } = useQuery({
+  queryKey: ['providers', appId],
+  queryFn: fetchProviders,
+  staleTime: 1000 * 60 * 5, // 5分钟内不重新获取
+  gcTime: 1000 * 60 * 10, // 10分钟后清除缓存
+})
+```
+
+### 3. 表单性能优化
+
+```typescript
+// 使用 mode 控制验证时机
+const form = useForm({
+  mode: 'onBlur', // 失去焦点时验证
+  // mode: 'onChange', // 每次输入都验证(较慢)
+  // mode: 'onSubmit', // 提交时验证(最快)
+})
+```
+
+---
+
+**提示**: 将此文档保存在浏览器书签或编辑器中，方便随时查阅！

docs/TEST_DEVELOPMENT_PLAN.md

@@ -0,0 +1,73 @@
+# 前端测试开发计划
+
+## 1. 背景与目标
+- **背景**：v3.5.0 起前端功能快速扩张（供应商管理、MCP、导入导出、端点测速、国际化），缺失系统化测试导致回归风险与人工验证成本攀升。
+- **目标**：在 3 个迭代内建立覆盖关键业务的自动化测试体系，形成稳定的手动冒烟流程，并将测试执行纳入 CI/CD。
+
+## 2. 范围与优先级
+| 范围 | 内容 | 优先级 |
+| --- | --- | --- |
+| 供应商管理 | 列表、排序、预设/自定义表单、切换、复制、删除 | P0 |
+| 配置导入导出 | JSON 校验、备份、进度反馈、失败回滚 | P0 |
+| MCP 管理 | 列表、启停、模板、命令校验 | P1 |
+| 设置面板 | 主题/语言切换、目录设置、关于、更新检查 | P1 |
+| 端点速度测试 & 使用脚本 | 启动测试、状态指示、脚本保存 | P2 |
+| 国际化 | 中英切换、缺省文案回退 | P2 |
+
+## 3. 测试分层策略
+- **单元测试（Vitest）**：纯函数与 Hook（`useProviderActions`、`useSettingsForm`、`useDragSort`、`useImportExport` 等）验证数据处理、错误分支、排序逻辑。
+- **组件测试（React Testing Library）**：关键组件（`ProviderList`、`AddProviderDialog`、`SettingsDialog`、`McpPanel`）模拟交互、校验、提示；结合 MSW 模拟 API。
+- **集成测试（App 级别）**：挂载 `App.tsx`，覆盖应用切换、编辑模式、导入导出回调、语言切换，验证状态同步与 toast 提示。
+- **端到端测试（Playwright）**：依赖 `pnpm dev:renderer`，串联供应商 CRUD、排序拖拽、MCP 启停、语言切换即时刷新、更新检查跳转。
+- **手动冒烟**：Tauri 桌面包 + dev server 双通道，验证托盘、系统权限、真实文件写入。
+
+## 4. 环境与工具
+- 依赖：Node 18+、pnpm 8+、Vitest、React Testing Library、MSW、Playwright、Testing Library User Event、Playwright Trace Viewer。
+- 配置要点：
+  - 在 `tsconfig` 中共享别名，Vitest 配合 `vite.config.mts`。
+  - `setupTests.ts` 统一注册 MSW/RTL、自定义 matcher。
+  - Playwright 使用多浏览器矩阵（Chromium 必选，WebKit 可选），并共享 `.env.test`。
+  - Mock `@tauri-apps/api` 与 `providersApi`/`settingsApi`，隔离 Rust 层。
+
+## 5. 自动化建设里程碑
+| 周期 | 目标 | 交付 |
+| --- | --- | --- |
+| Sprint 1 | Vitest 基础设施、核心 Hook 单测（P0） | `pnpm test:unit`、覆盖率报告、10+ 用例 |
+| Sprint 2 | 组件/集成测试、MSW Mock 层 | `pnpm test:component`、App 主流程用例 |
+| Sprint 3 | Playwright E2E、CI 接入 | `pnpm test:e2e`、CI job、冒烟脚本 |
+| 持续 | 回归用例补齐、视觉比对探索 | Playwright Trace、截图基线 |
+
+## 6. 用例规划概览
+- **供应商管理**：新增（预设+自定义）、编辑校验、复制排序、切换失败回退、删除确认、使用脚本保存。
+- **导入导出**：成功、重复导入、校验失败、备份失败提示、导入后托盘刷新。
+- **MCP**：模板应用、协议切换（stdio/http）、命令校验、启停状态持久化。
+- **设置**：主题/语言即时生效、目录路径更新、更新检查按钮外链、关于信息渲染。
+- **端点速度测试**：触发测试、loading/成功/失败状态、指示器颜色、测速数据排序。
+- **国际化**：默认中文、切换英文后主界面/对话框文案变化、缺失 key fallback。
+
+## 7. 数据与 Mock 策略
+- 在 `tests/fixtures/` 维护标准供应商、MCP、设置数据集。
+- 使用 MSW 拦截 `providersApi`、`settingsApi`、`providersApi.onSwitched` 等调用；提供延迟/错误注入接口以覆盖异常分支。
+- Playwright 端提供临时用户目录（`TMP_CC_SWITCH_HOME`）+ 伪配置文件，以验证真实文件交互路径。
+
+## 8. 质量门禁与指标
+- 覆盖率目标：单元 ≥75%，分支 ≥70%，逐步提升至 80%+。
+- CI 阶段：`pnpm typecheck` → `pnpm format:check` → `pnpm test:unit` → `pnpm test:component` → `pnpm test:e2e`（可在 nightly 执行）。
+- 缺陷处理：修复前补充最小复现测试；E2E 冒烟必须陪跑重大功能发布。
+
+## 9. 工作流与职责
+- **测试负责人**：前端工程师轮值；负责测试计划维护、PR 流水线健康。
+- **开发者职责**：提交功能需附新增/更新测试、列出手动验证步骤、如涉及 UI 提交截图。
+- **Code Review 检查**：测试覆盖说明、mock 合理性、易读性。
+
+## 10. 风险与缓解
+| 风险 | 影响 | 缓解 |
+| --- | --- | --- |
+| Tauri API Mock 难度高 | 单测无法稳定 | 抽象 API 适配层 + MSW 统一模拟 |
+| Playwright 运行时间长 | CI 变慢 | 拆分冒烟/完整版，冒烟只跑关键路径 |
+| 国际化文案频繁变化 | 用例脆弱 | 优先断言 data-testid/结构，文案使用翻译 key |
+
+## 11. 输出与维护
+- 文档维护者：前端团队；每个版本更新后检查测试覆盖清单。
+- 交付物：测试报告（CI artifact）、Playwright Trace、覆盖率摘要。
+- 复盘：每次发布后召开 30 分钟测试复盘，记录缺陷、补齐用例。

docs/roadmap.md

@@ -0,0 +1,9 @@
+- 自动升级自定义路径 ✅
+- win 绿色版报毒问题 ✅
+- mcp 管理器 ✅
+- i18n ✅
+- gemini cli
+- homebrew 支持
+- memory 管理
+- codex 更多预设供应商
+- 云同步

package.json

@@ -1,91 +1,79 @@
 {
   "name": "cc-switch",
-  "version": "2.0.3",
-  "description": "Claude Code 供应商切换工具",
-  "main": "dist/main/index.js",
+  "version": "3.5.1",
+  "description": "Claude Code & Codex 供应商切换工具",
   "scripts": {
-    "dev": "concurrently -k \"npm:dev:renderer\" \"npm:dev:electron:watch\"",
-    "dev:electron": "tsc -p tsconfig.main.json && electron .",
-    "dev:electron:watch": "tsc -p tsconfig.main.json && concurrently -k \"tsc -w -p tsconfig.main.json\" \"npm:electron\"",
-    "electron": "electron .",
+    "dev": "pnpm tauri dev",
+    "build": "pnpm tauri build",
+    "tauri": "tauri",
     "dev:renderer": "vite",
-    "build": "npm run build:renderer && npm run build:main",
-    "build:main": "tsc -p tsconfig.main.json",
     "build:renderer": "vite build",
-    "start": "electron .",
-    "dist": "electron-builder"
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.{js,jsx,ts,tsx,css,json}\"",
+    "format:check": "prettier --check \"src/**/*.{js,jsx,ts,tsx,css,json}\"",
+    "test:unit": "vitest run",
+    "test:unit:watch": "vitest watch"
   },
   "keywords": [],
   "author": "Jason Young",
   "license": "MIT",
   "devDependencies": {
+    "@tauri-apps/cli": "^2.8.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.0.1",
+    "@testing-library/user-event": "^14.5.2",
     "@types/node": "^20.0.0",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "@vitejs/plugin-react": "^4.2.0",
-    "concurrently": "^8.2.0",
-    "electron": "^32.3.3",
-    "electron-builder": "^24.0.0",
+    "cross-fetch": "^4.1.0",
+    "jsdom": "^25.0.0",
+    "msw": "^2.11.6",
+    "prettier": "^3.6.2",
     "typescript": "^5.3.0",
-    "vite": "^5.0.0"
+    "vite": "^5.0.0",
+    "vitest": "^2.0.5"
   },
   "dependencies": {
+    "@codemirror/lang-javascript": "^6.2.4",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lint": "^6.8.5",
+    "@codemirror/state": "^6.5.2",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.38.2",
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@hookform/resolvers": "^5.2.2",
+    "@radix-ui/react-checkbox": "^1.3.3",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-switch": "^1.2.6",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@tailwindcss/vite": "^4.1.13",
+    "@tanstack/react-query": "^5.90.3",
+    "@tauri-apps/api": "^2.8.0",
+    "@tauri-apps/plugin-dialog": "^2.4.0",
+    "@tauri-apps/plugin-process": "^2.0.0",
+    "@tauri-apps/plugin-store": "^2.0.0",
+    "@tauri-apps/plugin-updater": "^2.0.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "codemirror": "^6.0.2",
+    "i18next": "^25.5.2",
+    "jsonc-parser": "^3.2.1",
+    "lucide-react": "^0.542.0",
     "react": "^18.2.0",
-    "react-dom": "^18.2.0"
-  },
-  "build": {
-    "appId": "com.ccswitch.app",
-    "productName": "CC Switch",
-    "compression": "maximum",
-    "publish": null,
-    "directories": {
-      "output": "release"
-    },
-    "icon": "build/icon.ico",
-    "files": [
-      "dist/**/*",
-      "node_modules/**/*"
-    ],
-    "nsis": {
-      "oneClick": false,
-      "allowToChangeInstallationDirectory": true
-    },
-    "mac": {
-      "category": "public.app-category.developer-tools",
-      "icon": "build/icon.icns",
-      "identity": "-",
-      "hardenedRuntime": false,
-      "entitlements": null,
-      "entitlementsInherit": null,
-      "target": [
-        {
-          "target": "zip",
-          "arch": [
-            "x64"
-          ]
-        }
-      ]
-    },
-    "win": {
-      "target": [
-        {
-          "target": "nsis",
-          "arch": [
-            "x64"
-          ]
-        },
-        {
-          "target": "portable",
-          "arch": [
-            "x64"
-          ]
-        }
-      ],
-      "icon": "build/icon.ico"
-    },
-    "linux": {
-      "target": "AppImage",
-      "icon": "build/icon.png"
-    }
+    "react-dom": "^18.2.0",
+    "react-hook-form": "^7.65.0",
+    "react-i18next": "^16.0.0",
+    "smol-toml": "^1.4.2",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.3.1",
+    "tailwindcss": "^4.1.13",
+    "zod": "^4.1.12"
   }
 }

pnpm-workspace.yaml

@@ -0,0 +1,4 @@
+packages: []
+
+onlyBuiltDependencies:
+  - '@tailwindcss/oxide'

src-tauri/.gitignore

@@ -0,0 +1,4 @@
+# Generated by Cargo
+# will have compiled files and executables
+/target/
+/gen/schemas

src-tauri/Cargo.toml

@@ -0,0 +1,59 @@
+[package]
+name = "cc-switch"
+version = "3.5.1"
+description = "Claude Code & Codex 供应商配置管理工具"
+authors = ["Jason Young"]
+license = "MIT"
+repository = "https://github.com/farion1231/cc-switch"
+edition = "2021"
+rust-version = "1.85.0"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[lib]
+name = "cc_switch_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[features]
+default = []
+test-hooks = []
+
+[build-dependencies]
+tauri-build = { version = "2.4.0", features = [] }
+
+[dependencies]
+serde_json = "1.0"
+serde = { version = "1.0", features = ["derive"] }
+log = "0.4"
+chrono = "0.4"
+tauri = { version = "2.8.2", features = ["tray-icon"] }
+tauri-plugin-log = "2"
+tauri-plugin-opener = "2"
+tauri-plugin-process = "2"
+tauri-plugin-updater = "2"
+tauri-plugin-dialog = "2"
+tauri-plugin-store = "2"
+dirs = "5.0"
+toml = "0.8"
+toml_edit = "0.22"
+reqwest = { version = "0.12", default-features = false, features = ["rustls-tls", "json"] }
+tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }
+futures = "0.3"
+regex = "1.10"
+rquickjs = { version = "0.8", features = ["array-buffer", "classes"] }
+thiserror = "1.0"
+
+[target.'cfg(any(target_os = "macos", target_os = "windows", target_os = "linux"))'.dependencies]
+tauri-plugin-single-instance = "2"
+
+[target.'cfg(target_os = "macos")'.dependencies]
+objc2 = "0.5"
+objc2-app-kit = { version = "0.2", features = ["NSColor"] }
+
+# Optimize release binary size to help reduce AppImage footprint
+[profile.release]
+codegen-units = 1
+lto = "thin"
+opt-level = "s"
+panic = "abort"
+strip = "symbols"

src-tauri/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}

src-tauri/capabilities/default.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "enables the default permissions",
+  "windows": [
+    "main"
+  ],
+  "permissions": [
+    "core:default",
+    "opener:default",
+    "updater:default",
+    "core:window:allow-set-skip-taskbar",
+    "process:allow-restart",
+    "dialog:default"
+  ]
+}

src-tauri/src/app_config.rs

@@ -0,0 +1,194 @@
+use serde::{Deserialize, Serialize};
+use std::collections::HashMap;
+use std::str::FromStr;
+
+/// MCP 配置：单客户端维度（claude 或 codex 下的一组服务器）
+#[derive(Debug, Clone, Serialize, Deserialize, Default)]
+pub struct McpConfig {
+    /// 以 id 为键的服务器定义（宽松 JSON 对象，包含 enabled/source 等 UI 辅助字段）
+    #[serde(default)]
+    pub servers: HashMap<String, serde_json::Value>,
+}
+
+/// MCP 根：按客户端分开维护（无历史兼容压力，直接以 v2 结构落地）
+#[derive(Debug, Clone, Serialize, Deserialize, Default)]
+pub struct McpRoot {
+    #[serde(default)]
+    pub claude: McpConfig,
+    #[serde(default)]
+    pub codex: McpConfig,
+}
+
+use crate::config::{copy_file, get_app_config_dir, get_app_config_path, write_json_file};
+use crate::error::AppError;
+use crate::provider::ProviderManager;
+
+/// 应用类型
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "lowercase")]
+pub enum AppType {
+    Claude,
+    Codex,
+}
+
+impl AppType {
+    pub fn as_str(&self) -> &str {
+        match self {
+            AppType::Claude => "claude",
+            AppType::Codex => "codex",
+        }
+    }
+}
+
+impl FromStr for AppType {
+    type Err = AppError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        let normalized = s.trim().to_lowercase();
+        match normalized.as_str() {
+            "claude" => Ok(AppType::Claude),
+            "codex" => Ok(AppType::Codex),
+            other => Err(AppError::localized(
+                "unsupported_app",
+                format!("不支持的应用标识: '{other}'。可选值: claude, codex。"),
+                format!("Unsupported app id: '{other}'. Allowed: claude, codex."),
+            )),
+        }
+    }
+}
+
+/// 多应用配置结构（向后兼容）
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct MultiAppConfig {
+    #[serde(default = "default_version")]
+    pub version: u32,
+    /// 应用管理器（claude/codex）
+    #[serde(flatten)]
+    pub apps: HashMap<String, ProviderManager>,
+    /// MCP 配置（按客户端分治）
+    #[serde(default)]
+    pub mcp: McpRoot,
+}
+
+fn default_version() -> u32 {
+    2
+}
+
+impl Default for MultiAppConfig {
+    fn default() -> Self {
+        let mut apps = HashMap::new();
+        apps.insert("claude".to_string(), ProviderManager::default());
+        apps.insert("codex".to_string(), ProviderManager::default());
+
+        Self {
+            version: 2,
+            apps,
+            mcp: McpRoot::default(),
+        }
+    }
+}
+
+impl MultiAppConfig {
+    /// 从文件加载配置（处理v1到v2的迁移）
+    pub fn load() -> Result<Self, AppError> {
+        let config_path = get_app_config_path();
+
+        if !config_path.exists() {
+            log::info!("配置文件不存在，创建新的多应用配置");
+            return Ok(Self::default());
+        }
+
+        // 尝试读取文件
+        let content =
+            std::fs::read_to_string(&config_path).map_err(|e| AppError::io(&config_path, e))?;
+
+        // 检查是否是旧版本格式（v1）
+        if let Ok(v1_config) = serde_json::from_str::<ProviderManager>(&content) {
+            log::info!("检测到v1配置，自动迁移到v2");
+
+            // 迁移到新格式
+            let mut apps = HashMap::new();
+            apps.insert("claude".to_string(), v1_config);
+            apps.insert("codex".to_string(), ProviderManager::default());
+
+            let config = Self {
+                version: 2,
+                apps,
+                mcp: McpRoot::default(),
+            };
+
+            // 迁移前备份旧版(v1)配置文件
+            let backup_dir = get_app_config_dir();
+            let ts = std::time::SystemTime::now()
+                .duration_since(std::time::UNIX_EPOCH)
+                .unwrap_or_default()
+                .as_secs();
+            let backup_path = backup_dir.join(format!("config.v1.backup.{}.json", ts));
+
+            match copy_file(&config_path, &backup_path) {
+                Ok(()) => log::info!(
+                    "已备份旧版配置文件: {} -> {}",
+                    config_path.display(),
+                    backup_path.display()
+                ),
+                Err(e) => log::warn!("备份旧版配置文件失败: {}", e),
+            }
+
+            // 保存迁移后的配置
+            config.save()?;
+            return Ok(config);
+        }
+
+        // 尝试读取v2格式
+        serde_json::from_str::<Self>(&content).map_err(|e| AppError::json(&config_path, e))
+    }
+
+    /// 保存配置到文件
+    pub fn save(&self) -> Result<(), AppError> {
+        let config_path = get_app_config_path();
+        // 先备份旧版（若存在）到 ~/.cc-switch/config.json.bak，再写入新内容
+        if config_path.exists() {
+            let backup_path = get_app_config_dir().join("config.json.bak");
+            if let Err(e) = copy_file(&config_path, &backup_path) {
+                log::warn!("备份 config.json 到 .bak 失败: {}", e);
+            }
+        }
+
+        write_json_file(&config_path, self)?;
+        Ok(())
+    }
+
+    /// 获取指定应用的管理器
+    pub fn get_manager(&self, app: &AppType) -> Option<&ProviderManager> {
+        self.apps.get(app.as_str())
+    }
+
+    /// 获取指定应用的管理器（可变引用）
+    pub fn get_manager_mut(&mut self, app: &AppType) -> Option<&mut ProviderManager> {
+        self.apps.get_mut(app.as_str())
+    }
+
+    /// 确保应用存在
+    pub fn ensure_app(&mut self, app: &AppType) {
+        if !self.apps.contains_key(app.as_str()) {
+            self.apps
+                .insert(app.as_str().to_string(), ProviderManager::default());
+        }
+    }
+
+    /// 获取指定客户端的 MCP 配置（不可变引用）
+    pub fn mcp_for(&self, app: &AppType) -> &McpConfig {
+        match app {
+            AppType::Claude => &self.mcp.claude,
+            AppType::Codex => &self.mcp.codex,
+        }
+    }
+
+    /// 获取指定客户端的 MCP 配置（可变引用）
+    pub fn mcp_for_mut(&mut self, app: &AppType) -> &mut McpConfig {
+        match app {
+            AppType::Claude => &mut self.mcp.claude,
+            AppType::Codex => &mut self.mcp.codex,
+        }
+    }
+}

src-tauri/src/app_store.rs

@@ -0,0 +1,139 @@
+use serde_json::Value;
+use std::path::PathBuf;
+use std::sync::{OnceLock, RwLock};
+use tauri_plugin_store::StoreExt;
+
+use crate::error::AppError;
+
+/// Store 中的键名
+const STORE_KEY_APP_CONFIG_DIR: &str = "app_config_dir_override";
+
+/// 缓存当前的 app_config_dir 覆盖路径，避免存储 AppHandle
+static APP_CONFIG_DIR_OVERRIDE: OnceLock<RwLock<Option<PathBuf>>> = OnceLock::new();
+
+fn override_cache() -> &'static RwLock<Option<PathBuf>> {
+    APP_CONFIG_DIR_OVERRIDE.get_or_init(|| RwLock::new(None))
+}
+
+fn update_cached_override(value: Option<PathBuf>) {
+    if let Ok(mut guard) = override_cache().write() {
+        *guard = value;
+    }
+}
+
+/// 获取缓存中的 app_config_dir 覆盖路径
+pub fn get_app_config_dir_override() -> Option<PathBuf> {
+    override_cache().read().ok()?.clone()
+}
+
+fn read_override_from_store(app: &tauri::AppHandle) -> Option<PathBuf> {
+    let store = match app.store_builder("app_paths.json").build() {
+        Ok(store) => store,
+        Err(e) => {
+            log::warn!("无法创建 Store: {}", e);
+            return None;
+        }
+    };
+
+    match store.get(STORE_KEY_APP_CONFIG_DIR) {
+        Some(Value::String(path_str)) => {
+            let path_str = path_str.trim();
+            if path_str.is_empty() {
+                return None;
+            }
+
+            let path = resolve_path(path_str);
+
+            if !path.exists() {
+                log::warn!(
+                    "Store 中配置的 app_config_dir 不存在: {:?}\n\
+                     将使用默认路径。",
+                    path
+                );
+                return None;
+            }
+
+            log::info!("使用 Store 中的 app_config_dir: {:?}", path);
+            Some(path)
+        }
+        Some(_) => {
+            log::warn!(
+                "Store 中的 {} 类型不正确，应为字符串",
+                STORE_KEY_APP_CONFIG_DIR
+            );
+            None
+        }
+        None => None,
+    }
+}
+
+/// 从 Store 刷新 app_config_dir 覆盖值并更新缓存
+pub fn refresh_app_config_dir_override(app: &tauri::AppHandle) -> Option<PathBuf> {
+    let value = read_override_from_store(app);
+    update_cached_override(value.clone());
+    value
+}
+
+/// 写入 app_config_dir 到 Tauri Store
+pub fn set_app_config_dir_to_store(
+    app: &tauri::AppHandle,
+    path: Option<&str>,
+) -> Result<(), AppError> {
+    let store = app
+        .store_builder("app_paths.json")
+        .build()
+        .map_err(|e| AppError::Message(format!("创建 Store 失败: {}", e)))?;
+
+    match path {
+        Some(p) => {
+            let trimmed = p.trim();
+            if !trimmed.is_empty() {
+                store.set(STORE_KEY_APP_CONFIG_DIR, Value::String(trimmed.to_string()));
+                log::info!("已将 app_config_dir 写入 Store: {}", trimmed);
+            } else {
+                store.delete(STORE_KEY_APP_CONFIG_DIR);
+                log::info!("已从 Store 中删除 app_config_dir 配置");
+            }
+        }
+        None => {
+            store.delete(STORE_KEY_APP_CONFIG_DIR);
+            log::info!("已从 Store 中删除 app_config_dir 配置");
+        }
+    }
+
+    store
+        .save()
+        .map_err(|e| AppError::Message(format!("保存 Store 失败: {}", e)))?;
+
+    refresh_app_config_dir_override(app);
+    Ok(())
+}
+
+/// 解析路径，支持 ~ 开头的相对路径
+fn resolve_path(raw: &str) -> PathBuf {
+    if raw == "~" {
+        if let Some(home) = dirs::home_dir() {
+            return home;
+        }
+    } else if let Some(stripped) = raw.strip_prefix("~/") {
+        if let Some(home) = dirs::home_dir() {
+            return home.join(stripped);
+        }
+    } else if let Some(stripped) = raw.strip_prefix("~\\") {
+        if let Some(home) = dirs::home_dir() {
+            return home.join(stripped);
+        }
+    }
+
+    PathBuf::from(raw)
+}
+
+/// 从旧的 settings.json 迁移 app_config_dir 到 Store
+pub fn migrate_app_config_dir_from_settings(app: &tauri::AppHandle) -> Result<(), AppError> {
+    // app_config_dir 已从 settings.json 移除，此函数保留但不再执行迁移
+    // 如果用户在旧版本设置过 app_config_dir，需要在 Store 中手动配置
+    log::info!("app_config_dir 迁移功能已移除，请在设置中重新配置");
+
+    let _ = refresh_app_config_dir_override(app);
+    Ok(())
+}

src-tauri/src/claude_mcp.rs

@@ -0,0 +1,286 @@
+use serde::{Deserialize, Serialize};
+use serde_json::{Map, Value};
+use std::env;
+use std::fs;
+use std::path::{Path, PathBuf};
+
+use crate::config::{atomic_write, get_claude_mcp_path, get_default_claude_mcp_path};
+use crate::error::AppError;
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct McpStatus {
+    pub user_config_path: String,
+    pub user_config_exists: bool,
+    pub server_count: usize,
+}
+
+fn user_config_path() -> PathBuf {
+    ensure_mcp_override_migrated();
+    get_claude_mcp_path()
+}
+
+fn ensure_mcp_override_migrated() {
+    if crate::settings::get_claude_override_dir().is_none() {
+        return;
+    }
+
+    let new_path = get_claude_mcp_path();
+    if new_path.exists() {
+        return;
+    }
+
+    let legacy_path = get_default_claude_mcp_path();
+    if !legacy_path.exists() {
+        return;
+    }
+
+    if let Some(parent) = new_path.parent() {
+        if let Err(err) = fs::create_dir_all(parent) {
+            log::warn!("创建 MCP 目录失败: {}", err);
+            return;
+        }
+    }
+
+    match fs::copy(&legacy_path, &new_path) {
+        Ok(_) => {
+            log::info!(
+                "已根据覆盖目录复制 MCP 配置: {} -> {}",
+                legacy_path.display(),
+                new_path.display()
+            );
+        }
+        Err(err) => {
+            log::warn!(
+                "复制 MCP 配置失败: {} -> {}: {}",
+                legacy_path.display(),
+                new_path.display(),
+                err
+            );
+        }
+    }
+}
+
+fn read_json_value(path: &Path) -> Result<Value, AppError> {
+    if !path.exists() {
+        return Ok(serde_json::json!({}));
+    }
+    let content = fs::read_to_string(path).map_err(|e| AppError::io(path, e))?;
+    let value: Value = serde_json::from_str(&content).map_err(|e| AppError::json(path, e))?;
+    Ok(value)
+}
+
+fn write_json_value(path: &Path, value: &Value) -> Result<(), AppError> {
+    if let Some(parent) = path.parent() {
+        fs::create_dir_all(parent).map_err(|e| AppError::io(parent, e))?;
+    }
+    let json =
+        serde_json::to_string_pretty(value).map_err(|e| AppError::JsonSerialize { source: e })?;
+    atomic_write(path, json.as_bytes())
+}
+
+pub fn get_mcp_status() -> Result<McpStatus, AppError> {
+    let path = user_config_path();
+    let (exists, count) = if path.exists() {
+        let v = read_json_value(&path)?;
+        let servers = v.get("mcpServers").and_then(|x| x.as_object());
+        (true, servers.map(|m| m.len()).unwrap_or(0))
+    } else {
+        (false, 0)
+    };
+
+    Ok(McpStatus {
+        user_config_path: path.to_string_lossy().to_string(),
+        user_config_exists: exists,
+        server_count: count,
+    })
+}
+
+pub fn read_mcp_json() -> Result<Option<String>, AppError> {
+    let path = user_config_path();
+    if !path.exists() {
+        return Ok(None);
+    }
+    let content = fs::read_to_string(&path).map_err(|e| AppError::io(&path, e))?;
+    Ok(Some(content))
+}
+
+pub fn upsert_mcp_server(id: &str, spec: Value) -> Result<bool, AppError> {
+    if id.trim().is_empty() {
+        return Err(AppError::InvalidInput("MCP 服务器 ID 不能为空".into()));
+    }
+    // 基础字段校验（尽量宽松）
+    if !spec.is_object() {
+        return Err(AppError::McpValidation(
+            "MCP 服务器定义必须为 JSON 对象".into(),
+        ));
+    }
+    let t_opt = spec.get("type").and_then(|x| x.as_str());
+    let is_stdio = t_opt.map(|t| t == "stdio").unwrap_or(true); // 兼容缺省（按 stdio 处理）
+    let is_http = t_opt.map(|t| t == "http").unwrap_or(false);
+    if !(is_stdio || is_http) {
+        return Err(AppError::McpValidation(
+            "MCP 服务器 type 必须是 'stdio' 或 'http'（或省略表示 stdio）".into(),
+        ));
+    }
+
+    // stdio 类型必须有 command
+    if is_stdio {
+        let cmd = spec.get("command").and_then(|x| x.as_str()).unwrap_or("");
+        if cmd.is_empty() {
+            return Err(AppError::McpValidation(
+                "stdio 类型的 MCP 服务器缺少 command 字段".into(),
+            ));
+        }
+    }
+
+    // http 类型必须有 url
+    if is_http {
+        let url = spec.get("url").and_then(|x| x.as_str()).unwrap_or("");
+        if url.is_empty() {
+            return Err(AppError::McpValidation(
+                "http 类型的 MCP 服务器缺少 url 字段".into(),
+            ));
+        }
+    }
+
+    let path = user_config_path();
+    let mut root = if path.exists() {
+        read_json_value(&path)?
+    } else {
+        serde_json::json!({})
+    };
+
+    // 确保 mcpServers 对象存在
+    {
+        let obj = root
+            .as_object_mut()
+            .ok_or_else(|| AppError::Config("mcp.json 根必须是对象".into()))?;
+        if !obj.contains_key("mcpServers") {
+            obj.insert("mcpServers".into(), serde_json::json!({}));
+        }
+    }
+
+    let before = root.clone();
+    if let Some(servers) = root.get_mut("mcpServers").and_then(|v| v.as_object_mut()) {
+        servers.insert(id.to_string(), spec);
+    }
+
+    if before == root && path.exists() {
+        return Ok(false);
+    }
+
+    write_json_value(&path, &root)?;
+    Ok(true)
+}
+
+pub fn delete_mcp_server(id: &str) -> Result<bool, AppError> {
+    if id.trim().is_empty() {
+        return Err(AppError::InvalidInput("MCP 服务器 ID 不能为空".into()));
+    }
+    let path = user_config_path();
+    if !path.exists() {
+        return Ok(false);
+    }
+    let mut root = read_json_value(&path)?;
+    let Some(servers) = root.get_mut("mcpServers").and_then(|v| v.as_object_mut()) else {
+        return Ok(false);
+    };
+    let existed = servers.remove(id).is_some();
+    if !existed {
+        return Ok(false);
+    }
+    write_json_value(&path, &root)?;
+    Ok(true)
+}
+
+pub fn validate_command_in_path(cmd: &str) -> Result<bool, AppError> {
+    if cmd.trim().is_empty() {
+        return Ok(false);
+    }
+    // 如果包含路径分隔符，直接判断是否存在可执行文件
+    if cmd.contains('/') || cmd.contains('\\') {
+        return Ok(Path::new(cmd).exists());
+    }
+
+    let path_var = env::var_os("PATH").unwrap_or_default();
+    let paths = env::split_paths(&path_var);
+
+    #[cfg(windows)]
+    let exts: Vec<String> = env::var("PATHEXT")
+        .unwrap_or(".COM;.EXE;.BAT;.CMD".into())
+        .split(';')
+        .map(|s| s.trim().to_uppercase())
+        .collect();
+
+    for p in paths {
+        let candidate = p.join(cmd);
+        if candidate.is_file() {
+            return Ok(true);
+        }
+        #[cfg(windows)]
+        {
+            for ext in &exts {
+                let cand = p.join(format!("{}{}", cmd, ext));
+                if cand.is_file() {
+                    return Ok(true);
+                }
+            }
+        }
+    }
+    Ok(false)
+}
+
+/// 将给定的启用 MCP 服务器映射写入到用户级 ~/.claude.json 的 mcpServers 字段
+/// 仅覆盖 mcpServers，其他字段保持不变
+pub fn set_mcp_servers_map(
+    servers: &std::collections::HashMap<String, Value>,
+) -> Result<(), AppError> {
+    let path = user_config_path();
+    let mut root = if path.exists() {
+        read_json_value(&path)?
+    } else {
+        serde_json::json!({})
+    };
+
+    // 构建 mcpServers 对象：移除 UI 辅助字段（enabled/source），仅保留实际 MCP 规范
+    let mut out: Map<String, Value> = Map::new();
+    for (id, spec) in servers.iter() {
+        let mut obj = if let Some(map) = spec.as_object() {
+            map.clone()
+        } else {
+            return Err(AppError::McpValidation(format!(
+                "MCP 服务器 '{}' 不是对象",
+                id
+            )));
+        };
+
+        if let Some(server_val) = obj.remove("server") {
+            let server_obj = server_val.as_object().cloned().ok_or_else(|| {
+                AppError::McpValidation(format!("MCP 服务器 '{}' server 字段不是对象", id))
+            })?;
+            obj = server_obj;
+        }
+
+        obj.remove("enabled");
+        obj.remove("source");
+        obj.remove("id");
+        obj.remove("name");
+        obj.remove("description");
+        obj.remove("tags");
+        obj.remove("homepage");
+        obj.remove("docs");
+
+        out.insert(id.clone(), Value::Object(obj));
+    }
+
+    {
+        let obj = root
+            .as_object_mut()
+            .ok_or_else(|| AppError::Config("~/.claude.json 根必须是对象".into()))?;
+        obj.insert("mcpServers".into(), Value::Object(out));
+    }
+
+    write_json_value(&path, &root)?;
+    Ok(())
+}

src-tauri/src/claude_plugin.rs

@@ -0,0 +1,131 @@
+use std::fs;
+use std::path::PathBuf;
+
+use crate::error::AppError;
+
+const CLAUDE_DIR: &str = ".claude";
+const CLAUDE_CONFIG_FILE: &str = "config.json";
+
+fn claude_dir() -> Result<PathBuf, AppError> {
+    // 优先使用设置中的覆盖目录
+    if let Some(dir) = crate::settings::get_claude_override_dir() {
+        return Ok(dir);
+    }
+    let home = dirs::home_dir().ok_or_else(|| AppError::Config("无法获取用户主目录".into()))?;
+    Ok(home.join(CLAUDE_DIR))
+}
+
+pub fn claude_config_path() -> Result<PathBuf, AppError> {
+    Ok(claude_dir()?.join(CLAUDE_CONFIG_FILE))
+}
+
+pub fn ensure_claude_dir_exists() -> Result<PathBuf, AppError> {
+    let dir = claude_dir()?;
+    if !dir.exists() {
+        fs::create_dir_all(&dir).map_err(|e| AppError::io(&dir, e))?;
+    }
+    Ok(dir)
+}
+
+pub fn read_claude_config() -> Result<Option<String>, AppError> {
+    let path = claude_config_path()?;
+    if path.exists() {
+        let content = fs::read_to_string(&path).map_err(|e| AppError::io(&path, e))?;
+        Ok(Some(content))
+    } else {
+        Ok(None)
+    }
+}
+
+fn is_managed_config(content: &str) -> bool {
+    match serde_json::from_str::<serde_json::Value>(content) {
+        Ok(value) => value
+            .get("primaryApiKey")
+            .and_then(|v| v.as_str())
+            .map(|val| val == "any")
+            .unwrap_or(false),
+        Err(_) => false,
+    }
+}
+
+pub fn write_claude_config() -> Result<bool, AppError> {
+    // 增量写入：仅设置 primaryApiKey = "any"，保留其它字段
+    let path = claude_config_path()?;
+    ensure_claude_dir_exists()?;
+
+    // 尝试读取并解析为对象
+    let mut obj = match read_claude_config()? {
+        Some(existing) => match serde_json::from_str::<serde_json::Value>(&existing) {
+            Ok(serde_json::Value::Object(map)) => serde_json::Value::Object(map),
+            _ => serde_json::json!({}),
+        },
+        None => serde_json::json!({}),
+    };
+
+    let mut changed = false;
+    if let Some(map) = obj.as_object_mut() {
+        let cur = map
+            .get("primaryApiKey")
+            .and_then(|v| v.as_str())
+            .unwrap_or("");
+        if cur != "any" {
+            map.insert(
+                "primaryApiKey".to_string(),
+                serde_json::Value::String("any".to_string()),
+            );
+            changed = true;
+        }
+    }
+
+    if changed || !path.exists() {
+        let serialized = serde_json::to_string_pretty(&obj)
+            .map_err(|e| AppError::JsonSerialize { source: e })?;
+        fs::write(&path, format!("{}\n", serialized)).map_err(|e| AppError::io(&path, e))?;
+        Ok(true)
+    } else {
+        Ok(false)
+    }
+}
+
+pub fn clear_claude_config() -> Result<bool, AppError> {
+    let path = claude_config_path()?;
+    if !path.exists() {
+        return Ok(false);
+    }
+
+    let content = match read_claude_config()? {
+        Some(content) => content,
+        None => return Ok(false),
+    };
+
+    let mut value = match serde_json::from_str::<serde_json::Value>(&content) {
+        Ok(value) => value,
+        Err(_) => return Ok(false),
+    };
+
+    let obj = match value.as_object_mut() {
+        Some(obj) => obj,
+        None => return Ok(false),
+    };
+
+    if obj.remove("primaryApiKey").is_none() {
+        return Ok(false);
+    }
+
+    let serialized =
+        serde_json::to_string_pretty(&value).map_err(|e| AppError::JsonSerialize { source: e })?;
+    fs::write(&path, format!("{}\n", serialized)).map_err(|e| AppError::io(&path, e))?;
+    Ok(true)
+}
+
+pub fn claude_config_status() -> Result<(bool, PathBuf), AppError> {
+    let path = claude_config_path()?;
+    Ok((path.exists(), path))
+}
+
+pub fn is_claude_config_applied() -> Result<bool, AppError> {
+    match read_claude_config()? {
+        Some(content) => Ok(is_managed_config(&content)),
+        None => Ok(false),
+    }
+}

src-tauri/src/codex_config.rs

@@ -0,0 +1,152 @@
+// unused imports removed
+use std::path::PathBuf;
+
+use crate::config::{
+    atomic_write, delete_file, sanitize_provider_name, write_json_file, write_text_file,
+};
+use crate::error::AppError;
+use serde_json::Value;
+use std::fs;
+use std::path::Path;
+
+/// 获取 Codex 配置目录路径
+pub fn get_codex_config_dir() -> PathBuf {
+    if let Some(custom) = crate::settings::get_codex_override_dir() {
+        return custom;
+    }
+
+    dirs::home_dir().expect("无法获取用户主目录").join(".codex")
+}
+
+/// 获取 Codex auth.json 路径
+pub fn get_codex_auth_path() -> PathBuf {
+    get_codex_config_dir().join("auth.json")
+}
+
+/// 获取 Codex config.toml 路径
+pub fn get_codex_config_path() -> PathBuf {
+    get_codex_config_dir().join("config.toml")
+}
+
+/// 获取 Codex 供应商配置文件路径
+pub fn get_codex_provider_paths(
+    provider_id: &str,
+    provider_name: Option<&str>,
+) -> (PathBuf, PathBuf) {
+    let base_name = provider_name
+        .map(sanitize_provider_name)
+        .unwrap_or_else(|| sanitize_provider_name(provider_id));
+
+    let auth_path = get_codex_config_dir().join(format!("auth-{}.json", base_name));
+    let config_path = get_codex_config_dir().join(format!("config-{}.toml", base_name));
+
+    (auth_path, config_path)
+}
+
+/// 删除 Codex 供应商配置文件
+pub fn delete_codex_provider_config(
+    provider_id: &str,
+    provider_name: &str,
+) -> Result<(), AppError> {
+    let (auth_path, config_path) = get_codex_provider_paths(provider_id, Some(provider_name));
+
+    delete_file(&auth_path).ok();
+    delete_file(&config_path).ok();
+
+    Ok(())
+}
+
+//（移除未使用的备份/保存/恢复/导入函数，避免 dead_code 告警）
+
+/// 原子写 Codex 的 `auth.json` 与 `config.toml`，在第二步失败时回滚第一步
+pub fn write_codex_live_atomic(
+    auth: &Value,
+    config_text_opt: Option<&str>,
+) -> Result<(), AppError> {
+    let auth_path = get_codex_auth_path();
+    let config_path = get_codex_config_path();
+
+    if let Some(parent) = auth_path.parent() {
+        std::fs::create_dir_all(parent).map_err(|e| AppError::io(parent, e))?;
+    }
+
+    // 读取旧内容用于回滚
+    let old_auth = if auth_path.exists() {
+        Some(fs::read(&auth_path).map_err(|e| AppError::io(&auth_path, e))?)
+    } else {
+        None
+    };
+    let _old_config = if config_path.exists() {
+        Some(fs::read(&config_path).map_err(|e| AppError::io(&config_path, e))?)
+    } else {
+        None
+    };
+
+    // 准备写入内容
+    let cfg_text = match config_text_opt {
+        Some(s) => s.to_string(),
+        None => String::new(),
+    };
+    if !cfg_text.trim().is_empty() {
+        toml::from_str::<toml::Table>(&cfg_text).map_err(|e| AppError::toml(&config_path, e))?;
+    }
+
+    // 第一步：写 auth.json
+    write_json_file(&auth_path, auth)?;
+
+    // 第二步：写 config.toml（失败则回滚 auth.json）
+    if let Err(e) = write_text_file(&config_path, &cfg_text) {
+        // 回滚 auth.json
+        if let Some(bytes) = old_auth {
+            let _ = atomic_write(&auth_path, &bytes);
+        } else {
+            let _ = delete_file(&auth_path);
+        }
+        return Err(e);
+    }
+
+    Ok(())
+}
+
+/// 读取 `~/.codex/config.toml`，若不存在返回空字符串
+pub fn read_codex_config_text() -> Result<String, AppError> {
+    let path = get_codex_config_path();
+    if path.exists() {
+        std::fs::read_to_string(&path).map_err(|e| AppError::io(&path, e))
+    } else {
+        Ok(String::new())
+    }
+}
+
+/// 从给定路径读取 config.toml 文本（路径存在时）；路径不存在则返回空字符串
+pub fn read_config_text_from_path(path: &Path) -> Result<String, AppError> {
+    if path.exists() {
+        std::fs::read_to_string(path).map_err(|e| AppError::io(path, e))
+    } else {
+        Ok(String::new())
+    }
+}
+
+/// 对非空的 TOML 文本进行语法校验
+pub fn validate_config_toml(text: &str) -> Result<(), AppError> {
+    if text.trim().is_empty() {
+        return Ok(());
+    }
+    toml::from_str::<toml::Table>(text)
+        .map(|_| ())
+        .map_err(|e| AppError::toml(Path::new("config.toml"), e))
+}
+
+/// 读取并校验 `~/.codex/config.toml`，返回文本（可能为空）
+pub fn read_and_validate_codex_config_text() -> Result<String, AppError> {
+    let s = read_codex_config_text()?;
+    validate_config_toml(&s)?;
+    Ok(s)
+}
+
+/// 从指定路径读取并校验 config.toml，返回文本（可能为空）
+pub fn read_and_validate_config_from_path(path: &Path) -> Result<String, AppError> {
+    let s = read_config_text_from_path(path)?;
+    validate_config_toml(&s)?;
+    Ok(s)
+}

src-tauri/src/commands/config.rs

@@ -0,0 +1,126 @@
+#![allow(non_snake_case)]
+
+use tauri::AppHandle;
+use tauri_plugin_dialog::DialogExt;
+use tauri_plugin_opener::OpenerExt;
+
+use crate::app_config::AppType;
+use crate::codex_config;
+use crate::config::{self, get_claude_settings_path, ConfigStatus};
+
+/// 获取 Claude Code 配置状态
+#[tauri::command]
+pub async fn get_claude_config_status() -> Result<ConfigStatus, String> {
+    Ok(config::get_claude_config_status())
+}
+
+use std::str::FromStr;
+
+#[tauri::command]
+pub async fn get_config_status(app: String) -> Result<ConfigStatus, String> {
+    match AppType::from_str(&app).map_err(|e| e.to_string())? {
+        AppType::Claude => Ok(config::get_claude_config_status()),
+        AppType::Codex => {
+            let auth_path = codex_config::get_codex_auth_path();
+            let exists = auth_path.exists();
+            let path = codex_config::get_codex_config_dir()
+                .to_string_lossy()
+                .to_string();
+
+            Ok(ConfigStatus { exists, path })
+        }
+    }
+}
+
+/// 获取 Claude Code 配置文件路径
+#[tauri::command]
+pub async fn get_claude_code_config_path() -> Result<String, String> {
+    Ok(get_claude_settings_path().to_string_lossy().to_string())
+}
+
+/// 获取当前生效的配置目录
+#[tauri::command]
+pub async fn get_config_dir(app: String) -> Result<String, String> {
+    let dir = match AppType::from_str(&app).map_err(|e| e.to_string())? {
+        AppType::Claude => config::get_claude_config_dir(),
+        AppType::Codex => codex_config::get_codex_config_dir(),
+    };
+
+    Ok(dir.to_string_lossy().to_string())
+}
+
+/// 打开配置文件夹
+#[tauri::command]
+pub async fn open_config_folder(handle: AppHandle, app: String) -> Result<bool, String> {
+    let config_dir = match AppType::from_str(&app).map_err(|e| e.to_string())? {
+        AppType::Claude => config::get_claude_config_dir(),
+        AppType::Codex => codex_config::get_codex_config_dir(),
+    };
+
+    if !config_dir.exists() {
+        std::fs::create_dir_all(&config_dir).map_err(|e| format!("创建目录失败: {}", e))?;
+    }
+
+    handle
+        .opener()
+        .open_path(config_dir.to_string_lossy().to_string(), None::<String>)
+        .map_err(|e| format!("打开文件夹失败: {}", e))?;
+
+    Ok(true)
+}
+
+/// 弹出系统目录选择器并返回用户选择的路径
+#[tauri::command]
+pub async fn pick_directory(
+    app: AppHandle,
+    default_path: Option<String>,
+) -> Result<Option<String>, String> {
+    let initial = default_path
+        .map(|p| p.trim().to_string())
+        .filter(|p| !p.is_empty());
+
+    let result = tauri::async_runtime::spawn_blocking(move || {
+        let mut builder = app.dialog().file();
+        if let Some(path) = initial {
+            builder = builder.set_directory(path);
+        }
+        builder.blocking_pick_folder()
+    })
+    .await
+    .map_err(|e| format!("弹出目录选择器失败: {}", e))?;
+
+    match result {
+        Some(file_path) => {
+            let resolved = file_path
+                .simplified()
+                .into_path()
+                .map_err(|e| format!("解析选择的目录失败: {}", e))?;
+            Ok(Some(resolved.to_string_lossy().to_string()))
+        }
+        None => Ok(None),
+    }
+}
+
+/// 获取应用配置文件路径
+#[tauri::command]
+pub async fn get_app_config_path() -> Result<String, String> {
+    let config_path = config::get_app_config_path();
+    Ok(config_path.to_string_lossy().to_string())
+}
+
+/// 打开应用配置文件夹
+#[tauri::command]
+pub async fn open_app_config_folder(handle: AppHandle) -> Result<bool, String> {
+    let config_dir = config::get_app_config_dir();
+
+    if !config_dir.exists() {
+        std::fs::create_dir_all(&config_dir).map_err(|e| format!("创建目录失败: {}", e))?;
+    }
+
+    handle
+        .opener()
+        .open_path(config_dir.to_string_lossy().to_string(), None::<String>)
+        .map_err(|e| format!("打开文件夹失败: {}", e))?;
+
+    Ok(true)
+}

src-tauri/src/commands/import_export.rs

@@ -0,0 +1,104 @@
+#![allow(non_snake_case)]
+
+use serde_json::{json, Value};
+use std::path::PathBuf;
+use tauri::State;
+use tauri_plugin_dialog::DialogExt;
+
+use crate::error::AppError;
+use crate::services::ConfigService;
+use crate::store::AppState;
+
+/// 导出配置文件
+#[tauri::command]
+pub async fn export_config_to_file(file_path: String) -> Result<Value, String> {
+    tauri::async_runtime::spawn_blocking(move || {
+        let target_path = PathBuf::from(&file_path);
+        ConfigService::export_config_to_path(&target_path)?;
+        Ok::<_, AppError>(json!({
+            "success": true,
+            "message": "Configuration exported successfully",
+            "filePath": file_path
+        }))
+    })
+    .await
+    .map_err(|e| format!("导出配置失败: {}", e))?
+    .map_err(|e: AppError| e.to_string())
+}
+
+/// 从文件导入配置
+#[tauri::command]
+pub async fn import_config_from_file(
+    file_path: String,
+    state: State<'_, AppState>,
+) -> Result<Value, String> {
+    let (new_config, backup_id) = tauri::async_runtime::spawn_blocking(move || {
+        let path_buf = PathBuf::from(&file_path);
+        ConfigService::load_config_for_import(&path_buf)
+    })
+    .await
+    .map_err(|e| format!("导入配置失败: {}", e))?
+    .map_err(|e: AppError| e.to_string())?;
+
+    {
+        let mut guard = state
+            .config
+            .write()
+            .map_err(|e| AppError::from(e).to_string())?;
+        *guard = new_config;
+    }
+
+    Ok(json!({
+        "success": true,
+        "message": "Configuration imported successfully",
+        "backupId": backup_id
+    }))
+}
+
+/// 同步当前供应商配置到对应的 live 文件
+#[tauri::command]
+pub async fn sync_current_providers_live(state: State<'_, AppState>) -> Result<Value, String> {
+    {
+        let mut config_state = state
+            .config
+            .write()
+            .map_err(|e| AppError::from(e).to_string())?;
+        ConfigService::sync_current_providers_to_live(&mut config_state)
+            .map_err(|e| e.to_string())?;
+    }
+
+    Ok(json!({
+        "success": true,
+        "message": "Live configuration synchronized"
+    }))
+}
+
+/// 保存文件对话框
+#[tauri::command]
+pub async fn save_file_dialog<R: tauri::Runtime>(
+    app: tauri::AppHandle<R>,
+    default_name: String,
+) -> Result<Option<String>, String> {
+    let dialog = app.dialog();
+    let result = dialog
+        .file()
+        .add_filter("JSON", &["json"])
+        .set_file_name(&default_name)
+        .blocking_save_file();
+
+    Ok(result.map(|p| p.to_string()))
+}
+
+/// 打开文件对话框
+#[tauri::command]
+pub async fn open_file_dialog<R: tauri::Runtime>(
+    app: tauri::AppHandle<R>,
+) -> Result<Option<String>, String> {
+    let dialog = app.dialog();
+    let result = dialog
+        .file()
+        .add_filter("JSON", &["json"])
+        .blocking_pick_file();
+
+    Ok(result.map(|p| p.to_string()))
+}

src-tauri/src/commands/mcp.rs

@@ -0,0 +1,131 @@
+#![allow(non_snake_case)]
+
+use std::collections::HashMap;
+
+use serde::Serialize;
+use tauri::State;
+
+use crate::app_config::AppType;
+use crate::claude_mcp;
+use crate::services::McpService;
+use crate::store::AppState;
+
+/// 获取 Claude MCP 状态
+#[tauri::command]
+pub async fn get_claude_mcp_status() -> Result<claude_mcp::McpStatus, String> {
+    claude_mcp::get_mcp_status().map_err(|e| e.to_string())
+}
+
+/// 读取 mcp.json 文本内容
+#[tauri::command]
+pub async fn read_claude_mcp_config() -> Result<Option<String>, String> {
+    claude_mcp::read_mcp_json().map_err(|e| e.to_string())
+}
+
+/// 新增或更新一个 MCP 服务器条目
+#[tauri::command]
+pub async fn upsert_claude_mcp_server(id: String, spec: serde_json::Value) -> Result<bool, String> {
+    claude_mcp::upsert_mcp_server(&id, spec).map_err(|e| e.to_string())
+}
+
+/// 删除一个 MCP 服务器条目
+#[tauri::command]
+pub async fn delete_claude_mcp_server(id: String) -> Result<bool, String> {
+    claude_mcp::delete_mcp_server(&id).map_err(|e| e.to_string())
+}
+
+/// 校验命令是否在 PATH 中可用（不执行）
+#[tauri::command]
+pub async fn validate_mcp_command(cmd: String) -> Result<bool, String> {
+    claude_mcp::validate_command_in_path(&cmd).map_err(|e| e.to_string())
+}
+
+#[derive(Serialize)]
+pub struct McpConfigResponse {
+    pub config_path: String,
+    pub servers: HashMap<String, serde_json::Value>,
+}
+
+/// 获取 MCP 配置（来自 ~/.cc-switch/config.json）
+use std::str::FromStr;
+
+#[tauri::command]
+pub async fn get_mcp_config(
+    state: State<'_, AppState>,
+    app: String,
+) -> Result<McpConfigResponse, String> {
+    let config_path = crate::config::get_app_config_path()
+        .to_string_lossy()
+        .to_string();
+    let app_ty = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    let servers = McpService::get_servers(&state, app_ty).map_err(|e| e.to_string())?;
+    Ok(McpConfigResponse {
+        config_path,
+        servers,
+    })
+}
+
+/// 在 config.json 中新增或更新一个 MCP 服务器定义
+#[tauri::command]
+pub async fn upsert_mcp_server_in_config(
+    state: State<'_, AppState>,
+    app: String,
+    id: String,
+    spec: serde_json::Value,
+    sync_other_side: Option<bool>,
+) -> Result<bool, String> {
+    let app_ty = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    McpService::upsert_server(&state, app_ty, &id, spec, sync_other_side.unwrap_or(false))
+        .map_err(|e| e.to_string())
+}
+
+/// 在 config.json 中删除一个 MCP 服务器定义
+#[tauri::command]
+pub async fn delete_mcp_server_in_config(
+    state: State<'_, AppState>,
+    app: String,
+    id: String,
+) -> Result<bool, String> {
+    let app_ty = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    McpService::delete_server(&state, app_ty, &id).map_err(|e| e.to_string())
+}
+
+/// 设置启用状态并同步到客户端配置
+#[tauri::command]
+pub async fn set_mcp_enabled(
+    state: State<'_, AppState>,
+    app: String,
+    id: String,
+    enabled: bool,
+) -> Result<bool, String> {
+    let app_ty = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    McpService::set_enabled(&state, app_ty, &id, enabled).map_err(|e| e.to_string())
+}
+
+/// 手动同步：将启用的 MCP 投影到 ~/.claude.json
+#[tauri::command]
+pub async fn sync_enabled_mcp_to_claude(state: State<'_, AppState>) -> Result<bool, String> {
+    McpService::sync_enabled(&state, AppType::Claude)
+        .map(|_| true)
+        .map_err(|e| e.to_string())
+}
+
+/// 手动同步：将启用的 MCP 投影到 ~/.codex/config.toml
+#[tauri::command]
+pub async fn sync_enabled_mcp_to_codex(state: State<'_, AppState>) -> Result<bool, String> {
+    McpService::sync_enabled(&state, AppType::Codex)
+        .map(|_| true)
+        .map_err(|e| e.to_string())
+}
+
+/// 从 ~/.claude.json 导入 MCP 定义到 config.json
+#[tauri::command]
+pub async fn import_mcp_from_claude(state: State<'_, AppState>) -> Result<usize, String> {
+    McpService::import_from_claude(&state).map_err(|e| e.to_string())
+}
+
+/// 从 ~/.codex/config.toml 导入 MCP 定义到 config.json
+#[tauri::command]
+pub async fn import_mcp_from_codex(state: State<'_, AppState>) -> Result<usize, String> {
+    McpService::import_from_codex(&state).map_err(|e| e.to_string())
+}

src-tauri/src/commands/misc.rs

@@ -0,0 +1,45 @@
+#![allow(non_snake_case)]
+
+use tauri::AppHandle;
+use tauri_plugin_opener::OpenerExt;
+
+/// 打开外部链接
+#[tauri::command]
+pub async fn open_external(app: AppHandle, url: String) -> Result<bool, String> {
+    let url = if url.starts_with("http://") || url.starts_with("https://") {
+        url
+    } else {
+        format!("https://{}", url)
+    };
+
+    app.opener()
+        .open_url(&url, None::<String>)
+        .map_err(|e| format!("打开链接失败: {}", e))?;
+
+    Ok(true)
+}
+
+/// 检查更新
+#[tauri::command]
+pub async fn check_for_updates(handle: AppHandle) -> Result<bool, String> {
+    handle
+        .opener()
+        .open_url(
+            "https://github.com/farion1231/cc-switch/releases/latest",
+            None::<String>,
+        )
+        .map_err(|e| format!("打开更新页面失败: {}", e))?;
+
+    Ok(true)
+}
+
+/// 判断是否为便携版（绿色版）运行
+#[tauri::command]
+pub async fn is_portable_mode() -> Result<bool, String> {
+    let exe_path = std::env::current_exe().map_err(|e| format!("获取可执行路径失败: {}", e))?;
+    if let Some(dir) = exe_path.parent() {
+        Ok(dir.join("portable.ini").is_file())
+    } else {
+        Ok(false)
+    }
+}

src-tauri/src/commands/mod.rs

@@ -0,0 +1,17 @@
+#![allow(non_snake_case)]
+
+mod config;
+mod import_export;
+mod mcp;
+mod misc;
+mod plugin;
+mod provider;
+mod settings;
+
+pub use config::*;
+pub use import_export::*;
+pub use mcp::*;
+pub use misc::*;
+pub use plugin::*;
+pub use provider::*;
+pub use settings::*;

src-tauri/src/commands/plugin.rs

@@ -0,0 +1,36 @@
+#![allow(non_snake_case)]
+
+use crate::config::ConfigStatus;
+
+/// Claude 插件：获取 ~/.claude/config.json 状态
+#[tauri::command]
+pub async fn get_claude_plugin_status() -> Result<ConfigStatus, String> {
+    crate::claude_plugin::claude_config_status()
+        .map(|(exists, path)| ConfigStatus {
+            exists,
+            path: path.to_string_lossy().to_string(),
+        })
+        .map_err(|e| e.to_string())
+}
+
+/// Claude 插件：读取配置内容（若不存在返回 Ok(None)）
+#[tauri::command]
+pub async fn read_claude_plugin_config() -> Result<Option<String>, String> {
+    crate::claude_plugin::read_claude_config().map_err(|e| e.to_string())
+}
+
+/// Claude 插件：写入/清除固定配置
+#[tauri::command]
+pub async fn apply_claude_plugin_config(official: bool) -> Result<bool, String> {
+    if official {
+        crate::claude_plugin::clear_claude_config().map_err(|e| e.to_string())
+    } else {
+        crate::claude_plugin::write_claude_config().map_err(|e| e.to_string())
+    }
+}
+
+/// Claude 插件：检测是否已写入目标配置
+#[tauri::command]
+pub async fn is_claude_plugin_applied() -> Result<bool, String> {
+    crate::claude_plugin::is_claude_config_applied().map_err(|e| e.to_string())
+}

src-tauri/src/commands/provider.rs

@@ -0,0 +1,211 @@
+use std::collections::HashMap;
+use tauri::State;
+
+use crate::app_config::AppType;
+use crate::error::AppError;
+use crate::provider::Provider;
+use crate::services::{EndpointLatency, ProviderService, ProviderSortUpdate, SpeedtestService};
+use crate::store::AppState;
+
+fn missing_param(param: &str) -> String {
+    format!("缺少 {} 参数 (Missing {} parameter)", param, param)
+}
+
+use std::str::FromStr;
+
+/// 获取所有供应商
+#[tauri::command]
+pub fn get_providers(
+    state: State<'_, AppState>,
+    app: String,
+) -> Result<HashMap<String, Provider>, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::list(state.inner(), app_type).map_err(|e| e.to_string())
+}
+
+/// 获取当前供应商ID
+#[tauri::command]
+pub fn get_current_provider(state: State<'_, AppState>, app: String) -> Result<String, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::current(state.inner(), app_type).map_err(|e| e.to_string())
+}
+
+/// 添加供应商
+#[tauri::command]
+pub fn add_provider(
+    state: State<'_, AppState>,
+    app: String,
+    provider: Provider,
+) -> Result<bool, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::add(state.inner(), app_type, provider).map_err(|e| e.to_string())
+}
+
+/// 更新供应商
+#[tauri::command]
+pub fn update_provider(
+    state: State<'_, AppState>,
+    app: String,
+    provider: Provider,
+) -> Result<bool, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::update(state.inner(), app_type, provider).map_err(|e| e.to_string())
+}
+
+/// 删除供应商
+#[tauri::command]
+pub fn delete_provider(
+    state: State<'_, AppState>,
+    app: String,
+    id: String,
+) -> Result<bool, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::delete(state.inner(), app_type, &id)
+        .map(|_| true)
+        .map_err(|e| e.to_string())
+}
+
+/// 切换供应商
+fn switch_provider_internal(state: &AppState, app_type: AppType, id: &str) -> Result<(), AppError> {
+    ProviderService::switch(state, app_type, id)
+}
+
+#[cfg_attr(not(feature = "test-hooks"), doc(hidden))]
+pub fn switch_provider_test_hook(
+    state: &AppState,
+    app_type: AppType,
+    id: &str,
+) -> Result<(), AppError> {
+    switch_provider_internal(state, app_type, id)
+}
+
+#[tauri::command]
+pub fn switch_provider(
+    state: State<'_, AppState>,
+    app: String,
+    id: String,
+) -> Result<bool, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    switch_provider_internal(&state, app_type, &id)
+        .map(|_| true)
+        .map_err(|e| e.to_string())
+}
+
+fn import_default_config_internal(state: &AppState, app_type: AppType) -> Result<(), AppError> {
+    ProviderService::import_default_config(state, app_type)
+}
+
+#[cfg_attr(not(feature = "test-hooks"), doc(hidden))]
+pub fn import_default_config_test_hook(
+    state: &AppState,
+    app_type: AppType,
+) -> Result<(), AppError> {
+    import_default_config_internal(state, app_type)
+}
+
+/// 导入当前配置为默认供应商
+#[tauri::command]
+pub fn import_default_config(state: State<'_, AppState>, app: String) -> Result<bool, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    import_default_config_internal(&state, app_type)
+        .map(|_| true)
+        .map_err(Into::into)
+}
+
+/// 查询供应商用量
+#[tauri::command]
+pub async fn query_provider_usage(
+    state: State<'_, AppState>,
+    provider_id: Option<String>,
+    app: String,
+) -> Result<crate::provider::UsageResult, String> {
+    let provider_id = provider_id.ok_or_else(|| missing_param("providerId"))?;
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::query_usage(state.inner(), app_type, &provider_id)
+        .await
+        .map_err(|e| e.to_string())
+}
+
+/// 读取当前生效的配置内容
+#[tauri::command]
+pub fn read_live_provider_settings(app: String) -> Result<serde_json::Value, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::read_live_settings(app_type).map_err(|e| e.to_string())
+}
+
+/// 测试第三方/自定义供应商端点的网络延迟
+#[tauri::command]
+pub async fn test_api_endpoints(
+    urls: Vec<String>,
+    timeout_secs: Option<u64>,
+) -> Result<Vec<EndpointLatency>, String> {
+    SpeedtestService::test_endpoints(urls, timeout_secs)
+        .await
+        .map_err(|e| e.to_string())
+}
+
+/// 获取自定义端点列表
+#[tauri::command]
+pub fn get_custom_endpoints(
+    state: State<'_, AppState>,
+    app: String,
+    provider_id: Option<String>,
+) -> Result<Vec<crate::settings::CustomEndpoint>, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    let provider_id = provider_id.ok_or_else(|| missing_param("providerId"))?;
+    ProviderService::get_custom_endpoints(state.inner(), app_type, &provider_id)
+        .map_err(|e| e.to_string())
+}
+
+/// 添加自定义端点
+#[tauri::command]
+pub fn add_custom_endpoint(
+    state: State<'_, AppState>,
+    app: String,
+    provider_id: Option<String>,
+    url: String,
+) -> Result<(), String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    let provider_id = provider_id.ok_or_else(|| missing_param("providerId"))?;
+    ProviderService::add_custom_endpoint(state.inner(), app_type, &provider_id, url)
+        .map_err(|e| e.to_string())
+}
+
+/// 删除自定义端点
+#[tauri::command]
+pub fn remove_custom_endpoint(
+    state: State<'_, AppState>,
+    app: String,
+    provider_id: Option<String>,
+    url: String,
+) -> Result<(), String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    let provider_id = provider_id.ok_or_else(|| missing_param("providerId"))?;
+    ProviderService::remove_custom_endpoint(state.inner(), app_type, &provider_id, url)
+        .map_err(|e| e.to_string())
+}
+
+/// 更新端点最后使用时间
+#[tauri::command]
+pub fn update_endpoint_last_used(
+    state: State<'_, AppState>,
+    app: String,
+    provider_id: Option<String>,
+    url: String,
+) -> Result<(), String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    let provider_id = provider_id.ok_or_else(|| missing_param("providerId"))?;
+    ProviderService::update_endpoint_last_used(state.inner(), app_type, &provider_id, url)
+        .map_err(|e| e.to_string())
+}
+
+/// 更新多个供应商的排序
+#[tauri::command]
+pub fn update_providers_sort_order(
+    state: State<'_, AppState>,
+    app: String,
+    updates: Vec<ProviderSortUpdate>,
+) -> Result<bool, String> {
+    let app_type = AppType::from_str(&app).map_err(|e| e.to_string())?;
+    ProviderService::update_sort_order(state.inner(), app_type, updates).map_err(|e| e.to_string())
+}

src-tauri/src/commands/settings.rs

@@ -0,0 +1,39 @@
+#![allow(non_snake_case)]
+
+use tauri::AppHandle;
+
+/// 获取设置
+#[tauri::command]
+pub async fn get_settings() -> Result<crate::settings::AppSettings, String> {
+    Ok(crate::settings::get_settings())
+}
+
+/// 保存设置
+#[tauri::command]
+pub async fn save_settings(settings: crate::settings::AppSettings) -> Result<bool, String> {
+    crate::settings::update_settings(settings).map_err(|e| e.to_string())?;
+    Ok(true)
+}
+
+/// 重启应用程序（当 app_config_dir 变更后使用）
+#[tauri::command]
+pub async fn restart_app(app: AppHandle) -> Result<bool, String> {
+    app.restart();
+}
+
+/// 获取 app_config_dir 覆盖配置 (从 Store)
+#[tauri::command]
+pub async fn get_app_config_dir_override(app: AppHandle) -> Result<Option<String>, String> {
+    Ok(crate::app_store::refresh_app_config_dir_override(&app)
+        .map(|p| p.to_string_lossy().to_string()))
+}
+
+/// 设置 app_config_dir 覆盖配置 (到 Store)
+#[tauri::command]
+pub async fn set_app_config_dir_override(
+    app: AppHandle,
+    path: Option<String>,
+) -> Result<bool, String> {
+    crate::app_store::set_app_config_dir_to_store(&app, path.as_deref())?;
+    Ok(true)
+}

src-tauri/src/config.rs

@@ -0,0 +1,308 @@
+use serde::{Deserialize, Serialize};
+use std::fs;
+use std::io::Write;
+use std::path::{Path, PathBuf};
+
+use crate::error::AppError;
+
+/// 获取 Claude Code 配置目录路径
+pub fn get_claude_config_dir() -> PathBuf {
+    if let Some(custom) = crate::settings::get_claude_override_dir() {
+        return custom;
+    }
+
+    dirs::home_dir()
+        .expect("无法获取用户主目录")
+        .join(".claude")
+}
+
+/// 默认 Claude MCP 配置文件路径 (~/.claude.json)
+pub fn get_default_claude_mcp_path() -> PathBuf {
+    dirs::home_dir()
+        .expect("无法获取用户主目录")
+        .join(".claude.json")
+}
+
+fn derive_mcp_path_from_override(dir: &Path) -> Option<PathBuf> {
+    let file_name = dir
+        .file_name()
+        .map(|name| name.to_string_lossy().to_string())?
+        .trim()
+        .to_string();
+    if file_name.is_empty() {
+        return None;
+    }
+    let parent = dir.parent().unwrap_or_else(|| Path::new(""));
+    Some(parent.join(format!("{}.json", file_name)))
+}
+
+/// 获取 Claude MCP 配置文件路径，若设置了目录覆盖则与覆盖目录同级
+pub fn get_claude_mcp_path() -> PathBuf {
+    if let Some(custom_dir) = crate::settings::get_claude_override_dir() {
+        if let Some(path) = derive_mcp_path_from_override(&custom_dir) {
+            return path;
+        }
+    }
+    get_default_claude_mcp_path()
+}
+
+/// 获取 Claude Code 主配置文件路径
+pub fn get_claude_settings_path() -> PathBuf {
+    let dir = get_claude_config_dir();
+    let settings = dir.join("settings.json");
+    if settings.exists() {
+        return settings;
+    }
+    // 兼容旧版命名：若存在旧文件则继续使用
+    let legacy = dir.join("claude.json");
+    if legacy.exists() {
+        return legacy;
+    }
+    // 默认新建：回落到标准文件名 settings.json（不再生成 claude.json）
+    settings
+}
+
+/// 获取应用配置目录路径 (~/.cc-switch)
+pub fn get_app_config_dir() -> PathBuf {
+    if let Some(custom) = crate::app_store::get_app_config_dir_override() {
+        return custom;
+    }
+
+    dirs::home_dir()
+        .expect("无法获取用户主目录")
+        .join(".cc-switch")
+}
+
+/// 获取应用配置文件路径
+pub fn get_app_config_path() -> PathBuf {
+    get_app_config_dir().join("config.json")
+}
+
+/// 归档根目录 ~/.cc-switch/archive
+pub fn get_archive_root() -> PathBuf {
+    get_app_config_dir().join("archive")
+}
+
+fn ensure_unique_path(dest: PathBuf) -> PathBuf {
+    if !dest.exists() {
+        return dest;
+    }
+    let file_name = dest
+        .file_stem()
+        .map(|s| s.to_string_lossy().to_string())
+        .unwrap_or_else(|| "file".into());
+    let ext = dest
+        .extension()
+        .map(|s| format!(".{}", s.to_string_lossy()))
+        .unwrap_or_default();
+    let parent = dest.parent().map(|p| p.to_path_buf()).unwrap_or_default();
+    for i in 2..1000 {
+        let mut candidate = parent.clone();
+        candidate.push(format!("{}-{}{}", file_name, i, ext));
+        if !candidate.exists() {
+            return candidate;
+        }
+    }
+    dest
+}
+
+/// 将现有文件归档到 `~/.cc-switch/archive/<ts>/<category>/` 下，返回归档路径
+pub fn archive_file(ts: u64, category: &str, src: &Path) -> Result<Option<PathBuf>, AppError> {
+    if !src.exists() {
+        return Ok(None);
+    }
+    let mut dest_dir = get_archive_root();
+    dest_dir.push(ts.to_string());
+    dest_dir.push(category);
+    fs::create_dir_all(&dest_dir).map_err(|e| AppError::io(&dest_dir, e))?;
+
+    let file_name = src
+        .file_name()
+        .map(|s| s.to_string_lossy().to_string())
+        .unwrap_or_else(|| "file".into());
+    let mut dest = dest_dir.join(file_name);
+    dest = ensure_unique_path(dest);
+
+    copy_file(src, &dest)?;
+    Ok(Some(dest))
+}
+
+/// 清理供应商名称，确保文件名安全
+pub fn sanitize_provider_name(name: &str) -> String {
+    name.chars()
+        .map(|c| match c {
+            '<' | '>' | ':' | '"' | '/' | '\\' | '|' | '?' | '*' => '-',
+            _ => c,
+        })
+        .collect::<String>()
+        .to_lowercase()
+}
+
+/// 获取供应商配置文件路径
+pub fn get_provider_config_path(provider_id: &str, provider_name: Option<&str>) -> PathBuf {
+    let base_name = provider_name
+        .map(sanitize_provider_name)
+        .unwrap_or_else(|| sanitize_provider_name(provider_id));
+
+    get_claude_config_dir().join(format!("settings-{}.json", base_name))
+}
+
+/// 读取 JSON 配置文件
+pub fn read_json_file<T: for<'a> Deserialize<'a>>(path: &Path) -> Result<T, AppError> {
+    if !path.exists() {
+        return Err(AppError::Config(format!("文件不存在: {}", path.display())));
+    }
+
+    let content = fs::read_to_string(path).map_err(|e| AppError::io(path, e))?;
+
+    serde_json::from_str(&content).map_err(|e| AppError::json(path, e))
+}
+
+/// 写入 JSON 配置文件
+pub fn write_json_file<T: Serialize>(path: &Path, data: &T) -> Result<(), AppError> {
+    // 确保目录存在
+    if let Some(parent) = path.parent() {
+        fs::create_dir_all(parent).map_err(|e| AppError::io(parent, e))?;
+    }
+
+    let json =
+        serde_json::to_string_pretty(data).map_err(|e| AppError::JsonSerialize { source: e })?;
+
+    atomic_write(path, json.as_bytes())
+}
+
+/// 原子写入文本文件（用于 TOML/纯文本）
+pub fn write_text_file(path: &Path, data: &str) -> Result<(), AppError> {
+    if let Some(parent) = path.parent() {
+        fs::create_dir_all(parent).map_err(|e| AppError::io(parent, e))?;
+    }
+    atomic_write(path, data.as_bytes())
+}
+
+/// 原子写入：写入临时文件后 rename 替换，避免半写状态
+pub fn atomic_write(path: &Path, data: &[u8]) -> Result<(), AppError> {
+    if let Some(parent) = path.parent() {
+        fs::create_dir_all(parent).map_err(|e| AppError::io(parent, e))?;
+    }
+
+    let parent = path
+        .parent()
+        .ok_or_else(|| AppError::Config("无效的路径".to_string()))?;
+    let mut tmp = parent.to_path_buf();
+    let file_name = path
+        .file_name()
+        .ok_or_else(|| AppError::Config("无效的文件名".to_string()))?
+        .to_string_lossy()
+        .to_string();
+    let ts = std::time::SystemTime::now()
+        .duration_since(std::time::UNIX_EPOCH)
+        .unwrap_or_default()
+        .as_nanos();
+    tmp.push(format!("{}.tmp.{}", file_name, ts));
+
+    {
+        let mut f = fs::File::create(&tmp).map_err(|e| AppError::io(&tmp, e))?;
+        f.write_all(data).map_err(|e| AppError::io(&tmp, e))?;
+        f.flush().map_err(|e| AppError::io(&tmp, e))?;
+    }
+
+    #[cfg(unix)]
+    {
+        use std::os::unix::fs::PermissionsExt;
+        if let Ok(meta) = fs::metadata(path) {
+            let perm = meta.permissions().mode();
+            let _ = fs::set_permissions(&tmp, fs::Permissions::from_mode(perm));
+        }
+    }
+
+    #[cfg(windows)]
+    {
+        // Windows 上 rename 目标存在会失败，先移除再重命名（尽量接近原子性）
+        if path.exists() {
+            let _ = fs::remove_file(path);
+        }
+        fs::rename(&tmp, path).map_err(|e| AppError::IoContext {
+            context: format!("原子替换失败: {} -> {}", tmp.display(), path.display()),
+            source: e,
+        })?;
+    }
+
+    #[cfg(not(windows))]
+    {
+        fs::rename(&tmp, path).map_err(|e| AppError::IoContext {
+            context: format!("原子替换失败: {} -> {}", tmp.display(), path.display()),
+            source: e,
+        })?;
+    }
+    Ok(())
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn derive_mcp_path_from_override_preserves_folder_name() {
+        let override_dir = PathBuf::from("/tmp/profile/.claude");
+        let derived = derive_mcp_path_from_override(&override_dir)
+            .expect("should derive path for nested dir");
+        assert_eq!(derived, PathBuf::from("/tmp/profile/.claude.json"));
+    }
+
+    #[test]
+    fn derive_mcp_path_from_override_handles_non_hidden_folder() {
+        let override_dir = PathBuf::from("/data/claude-config");
+        let derived = derive_mcp_path_from_override(&override_dir)
+            .expect("should derive path for standard dir");
+        assert_eq!(derived, PathBuf::from("/data/claude-config.json"));
+    }
+
+    #[test]
+    fn derive_mcp_path_from_override_supports_relative_rootless_dir() {
+        let override_dir = PathBuf::from("claude");
+        let derived = derive_mcp_path_from_override(&override_dir)
+            .expect("should derive path for single segment");
+        assert_eq!(derived, PathBuf::from("claude.json"));
+    }
+
+    #[test]
+    fn derive_mcp_path_from_root_like_dir_returns_none() {
+        let override_dir = PathBuf::from("/");
+        assert!(derive_mcp_path_from_override(&override_dir).is_none());
+    }
+}
+
+/// 复制文件
+pub fn copy_file(from: &Path, to: &Path) -> Result<(), AppError> {
+    fs::copy(from, to).map_err(|e| AppError::IoContext {
+        context: format!("复制文件失败 ({} -> {})", from.display(), to.display()),
+        source: e,
+    })?;
+    Ok(())
+}
+
+/// 删除文件
+pub fn delete_file(path: &Path) -> Result<(), AppError> {
+    if path.exists() {
+        fs::remove_file(path).map_err(|e| AppError::io(path, e))?;
+    }
+    Ok(())
+}
+
+/// 检查 Claude Code 配置状态
+#[derive(Serialize, Deserialize)]
+pub struct ConfigStatus {
+    pub exists: bool,
+    pub path: String,
+}
+
+/// 获取 Claude Code 配置状态
+pub fn get_claude_config_status() -> ConfigStatus {
+    let path = get_claude_settings_path();
+    ConfigStatus {
+        exists: path.exists(),
+        path: path.to_string_lossy().to_string(),
+    }
+}
+
+//（移除未使用的备份/导入函数，避免 dead_code 告警）

src-tauri/src/error.rs

@@ -0,0 +1,98 @@
+use std::path::Path;
+use std::sync::PoisonError;
+
+use thiserror::Error;
+
+#[derive(Debug, Error)]
+pub enum AppError {
+    #[error("配置错误: {0}")]
+    Config(String),
+    #[error("无效输入: {0}")]
+    InvalidInput(String),
+    #[error("IO 错误: {path}: {source}")]
+    Io {
+        path: String,
+        #[source]
+        source: std::io::Error,
+    },
+    #[error("{context}: {source}")]
+    IoContext {
+        context: String,
+        #[source]
+        source: std::io::Error,
+    },
+    #[error("JSON 解析错误: {path}: {source}")]
+    Json {
+        path: String,
+        #[source]
+        source: serde_json::Error,
+    },
+    #[error("JSON 序列化失败: {source}")]
+    JsonSerialize {
+        #[source]
+        source: serde_json::Error,
+    },
+    #[error("TOML 解析错误: {path}: {source}")]
+    Toml {
+        path: String,
+        #[source]
+        source: toml::de::Error,
+    },
+    #[error("锁获取失败: {0}")]
+    Lock(String),
+    #[error("供应商不存在: {0}")]
+    ProviderNotFound(String),
+    #[error("MCP 校验失败: {0}")]
+    McpValidation(String),
+    #[error("{0}")]
+    Message(String),
+    #[error("{zh} ({en})")]
+    Localized {
+        key: &'static str,
+        zh: String,
+        en: String,
+    },
+}
+
+impl AppError {
+    pub fn io(path: impl AsRef<Path>, source: std::io::Error) -> Self {
+        Self::Io {
+            path: path.as_ref().display().to_string(),
+            source,
+        }
+    }
+
+    pub fn json(path: impl AsRef<Path>, source: serde_json::Error) -> Self {
+        Self::Json {
+            path: path.as_ref().display().to_string(),
+            source,
+        }
+    }
+
+    pub fn toml(path: impl AsRef<Path>, source: toml::de::Error) -> Self {
+        Self::Toml {
+            path: path.as_ref().display().to_string(),
+            source,
+        }
+    }
+
+    pub fn localized(key: &'static str, zh: impl Into<String>, en: impl Into<String>) -> Self {
+        Self::Localized {
+            key,
+            zh: zh.into(),
+            en: en.into(),
+        }
+    }
+}
+
+impl<T> From<PoisonError<T>> for AppError {
+    fn from(err: PoisonError<T>) -> Self {
+        Self::Lock(err.to_string())
+    }
+}
+
+impl From<AppError> for String {
+    fn from(err: AppError) -> Self {
+        err.to_string()
+    }
+}

src-tauri/src/lib.rs

@@ -0,0 +1,575 @@
+mod app_config;
+mod app_store;
+mod claude_mcp;
+mod claude_plugin;
+mod codex_config;
+mod commands;
+mod config;
+mod error;
+mod mcp;
+mod migration;
+mod provider;
+mod services;
+mod settings;
+mod store;
+mod usage_script;
+
+pub use app_config::{AppType, MultiAppConfig};
+pub use codex_config::{get_codex_auth_path, get_codex_config_path, write_codex_live_atomic};
+pub use commands::*;
+pub use config::{get_claude_mcp_path, get_claude_settings_path, read_json_file};
+pub use error::AppError;
+pub use mcp::{
+    import_from_claude, import_from_codex, sync_enabled_to_claude, sync_enabled_to_codex,
+};
+pub use provider::Provider;
+pub use services::{ConfigService, EndpointLatency, McpService, ProviderService, SpeedtestService};
+pub use settings::{update_settings, AppSettings};
+pub use store::AppState;
+
+use tauri::{
+    menu::{CheckMenuItem, Menu, MenuBuilder, MenuItem},
+    tray::{TrayIconBuilder, TrayIconEvent},
+};
+#[cfg(target_os = "macos")]
+use tauri::{ActivationPolicy, RunEvent};
+use tauri::{Emitter, Manager};
+
+#[derive(Clone, Copy)]
+struct TrayTexts {
+    show_main: &'static str,
+    no_provider_hint: &'static str,
+    quit: &'static str,
+}
+
+impl TrayTexts {
+    fn from_language(language: &str) -> Self {
+        match language {
+            "en" => Self {
+                show_main: "Open main window",
+                no_provider_hint: "  (No providers yet, please add them from the main window)",
+                quit: "Quit",
+            },
+            _ => Self {
+                show_main: "打开主界面",
+                no_provider_hint: "  (无供应商，请在主界面添加)",
+                quit: "退出",
+            },
+        }
+    }
+}
+
+/// 创建动态托盘菜单
+fn create_tray_menu(
+    app: &tauri::AppHandle,
+    app_state: &AppState,
+) -> Result<Menu<tauri::Wry>, AppError> {
+    let app_settings = crate::settings::get_settings();
+    let tray_texts = TrayTexts::from_language(app_settings.language.as_deref().unwrap_or("zh"));
+
+    let config = app_state.config.read().map_err(AppError::from)?;
+
+    let mut menu_builder = MenuBuilder::new(app);
+
+    // 顶部：打开主界面
+    let show_main_item =
+        MenuItem::with_id(app, "show_main", tray_texts.show_main, true, None::<&str>)
+            .map_err(|e| AppError::Message(format!("创建打开主界面菜单失败: {}", e)))?;
+    menu_builder = menu_builder.item(&show_main_item).separator();
+
+    // 直接添加所有供应商到主菜单（扁平化结构，更简单可靠）
+    if let Some(claude_manager) = config.get_manager(&crate::app_config::AppType::Claude) {
+        // 添加Claude标题（禁用状态，仅作为分组标识）
+        let claude_header =
+            MenuItem::with_id(app, "claude_header", "─── Claude ───", false, None::<&str>)
+                .map_err(|e| AppError::Message(format!("创建Claude标题失败: {}", e)))?;
+        menu_builder = menu_builder.item(&claude_header);
+
+        if !claude_manager.providers.is_empty() {
+            // Sort providers by sortIndex, then by createdAt, then by name
+            let mut sorted_providers: Vec<_> = claude_manager.providers.iter().collect();
+            sorted_providers.sort_by(|(_, a), (_, b)| {
+                // Priority 1: sortIndex
+                match (a.sort_index, b.sort_index) {
+                    (Some(idx_a), Some(idx_b)) => return idx_a.cmp(&idx_b),
+                    (Some(_), None) => return std::cmp::Ordering::Less,
+                    (None, Some(_)) => return std::cmp::Ordering::Greater,
+                    _ => {}
+                }
+                // Priority 2: createdAt
+                match (a.created_at, b.created_at) {
+                    (Some(time_a), Some(time_b)) => return time_a.cmp(&time_b),
+                    (Some(_), None) => return std::cmp::Ordering::Greater,
+                    (None, Some(_)) => return std::cmp::Ordering::Less,
+                    _ => {}
+                }
+                // Priority 3: name
+                a.name.cmp(&b.name)
+            });
+
+            for (id, provider) in sorted_providers {
+                let is_current = claude_manager.current == *id;
+                let item = CheckMenuItem::with_id(
+                    app,
+                    format!("claude_{}", id),
+                    &provider.name,
+                    true,
+                    is_current,
+                    None::<&str>,
+                )
+                .map_err(|e| AppError::Message(format!("创建菜单项失败: {}", e)))?;
+                menu_builder = menu_builder.item(&item);
+            }
+        } else {
+            // 没有供应商时显示提示
+            let empty_hint = MenuItem::with_id(
+                app,
+                "claude_empty",
+                tray_texts.no_provider_hint,
+                false,
+                None::<&str>,
+            )
+            .map_err(|e| AppError::Message(format!("创建Claude空提示失败: {}", e)))?;
+            menu_builder = menu_builder.item(&empty_hint);
+        }
+    }
+
+    if let Some(codex_manager) = config.get_manager(&crate::app_config::AppType::Codex) {
+        // 添加Codex标题（禁用状态，仅作为分组标识）
+        let codex_header =
+            MenuItem::with_id(app, "codex_header", "─── Codex ───", false, None::<&str>)
+                .map_err(|e| AppError::Message(format!("创建Codex标题失败: {}", e)))?;
+        menu_builder = menu_builder.item(&codex_header);
+
+        if !codex_manager.providers.is_empty() {
+            // Sort providers by sortIndex, then by createdAt, then by name
+            let mut sorted_providers: Vec<_> = codex_manager.providers.iter().collect();
+            sorted_providers.sort_by(|(_, a), (_, b)| {
+                // Priority 1: sortIndex
+                match (a.sort_index, b.sort_index) {
+                    (Some(idx_a), Some(idx_b)) => return idx_a.cmp(&idx_b),
+                    (Some(_), None) => return std::cmp::Ordering::Less,
+                    (None, Some(_)) => return std::cmp::Ordering::Greater,
+                    _ => {}
+                }
+                // Priority 2: createdAt
+                match (a.created_at, b.created_at) {
+                    (Some(time_a), Some(time_b)) => return time_a.cmp(&time_b),
+                    (Some(_), None) => return std::cmp::Ordering::Greater,
+                    (None, Some(_)) => return std::cmp::Ordering::Less,
+                    _ => {}
+                }
+                // Priority 3: name
+                a.name.cmp(&b.name)
+            });
+
+            for (id, provider) in sorted_providers {
+                let is_current = codex_manager.current == *id;
+                let item = CheckMenuItem::with_id(
+                    app,
+                    format!("codex_{}", id),
+                    &provider.name,
+                    true,
+                    is_current,
+                    None::<&str>,
+                )
+                .map_err(|e| AppError::Message(format!("创建菜单项失败: {}", e)))?;
+                menu_builder = menu_builder.item(&item);
+            }
+        } else {
+            // 没有供应商时显示提示
+            let empty_hint = MenuItem::with_id(
+                app,
+                "codex_empty",
+                tray_texts.no_provider_hint,
+                false,
+                None::<&str>,
+            )
+            .map_err(|e| AppError::Message(format!("创建Codex空提示失败: {}", e)))?;
+            menu_builder = menu_builder.item(&empty_hint);
+        }
+    }
+
+    // 分隔符和退出菜单
+    let quit_item = MenuItem::with_id(app, "quit", tray_texts.quit, true, None::<&str>)
+        .map_err(|e| AppError::Message(format!("创建退出菜单失败: {}", e)))?;
+
+    menu_builder = menu_builder.separator().item(&quit_item);
+
+    menu_builder
+        .build()
+        .map_err(|e| AppError::Message(format!("构建菜单失败: {}", e)))
+}
+
+#[cfg(target_os = "macos")]
+fn apply_tray_policy(app: &tauri::AppHandle, dock_visible: bool) {
+    let desired_policy = if dock_visible {
+        ActivationPolicy::Regular
+    } else {
+        ActivationPolicy::Accessory
+    };
+
+    if let Err(err) = app.set_dock_visibility(dock_visible) {
+        log::warn!("设置 Dock 显示状态失败: {}", err);
+    }
+
+    if let Err(err) = app.set_activation_policy(desired_policy) {
+        log::warn!("设置激活策略失败: {}", err);
+    }
+}
+
+/// 处理托盘菜单事件
+fn handle_tray_menu_event(app: &tauri::AppHandle, event_id: &str) {
+    log::info!("处理托盘菜单事件: {}", event_id);
+
+    match event_id {
+        "show_main" => {
+            if let Some(window) = app.get_webview_window("main") {
+                #[cfg(target_os = "windows")]
+                {
+                    let _ = window.set_skip_taskbar(false);
+                }
+                let _ = window.unminimize();
+                let _ = window.show();
+                let _ = window.set_focus();
+                #[cfg(target_os = "macos")]
+                {
+                    apply_tray_policy(app, true);
+                }
+            }
+        }
+        "quit" => {
+            log::info!("退出应用");
+            app.exit(0);
+        }
+        id if id.starts_with("claude_") => {
+            let provider_id = id.strip_prefix("claude_").unwrap();
+            log::info!("切换到Claude供应商: {}", provider_id);
+
+            // 执行切换
+            let app_handle = app.clone();
+            let provider_id = provider_id.to_string();
+            tauri::async_runtime::spawn_blocking(move || {
+                if let Err(e) = switch_provider_internal(
+                    &app_handle,
+                    crate::app_config::AppType::Claude,
+                    provider_id,
+                ) {
+                    log::error!("切换Claude供应商失败: {}", e);
+                }
+            });
+        }
+        id if id.starts_with("codex_") => {
+            let provider_id = id.strip_prefix("codex_").unwrap();
+            log::info!("切换到Codex供应商: {}", provider_id);
+
+            // 执行切换
+            let app_handle = app.clone();
+            let provider_id = provider_id.to_string();
+            tauri::async_runtime::spawn_blocking(move || {
+                if let Err(e) = switch_provider_internal(
+                    &app_handle,
+                    crate::app_config::AppType::Codex,
+                    provider_id,
+                ) {
+                    log::error!("切换Codex供应商失败: {}", e);
+                }
+            });
+        }
+        _ => {
+            log::warn!("未处理的菜单事件: {}", event_id);
+        }
+    }
+}
+
+//
+
+/// 内部切换供应商函数
+fn switch_provider_internal(
+    app: &tauri::AppHandle,
+    app_type: crate::app_config::AppType,
+    provider_id: String,
+) -> Result<(), AppError> {
+    if let Some(app_state) = app.try_state::<AppState>() {
+        // 在使用前先保存需要的值
+        let app_type_str = app_type.as_str().to_string();
+        let provider_id_clone = provider_id.clone();
+
+        crate::commands::switch_provider(app_state.clone(), app_type_str.clone(), provider_id)
+            .map_err(AppError::Message)?;
+
+        // 切换成功后重新创建托盘菜单
+        if let Ok(new_menu) = create_tray_menu(app, app_state.inner()) {
+            if let Some(tray) = app.tray_by_id("main") {
+                if let Err(e) = tray.set_menu(Some(new_menu)) {
+                    log::error!("更新托盘菜单失败: {}", e);
+                }
+            }
+        }
+
+        // 发射事件到前端，通知供应商已切换
+        let event_data = serde_json::json!({
+            "appType": app_type_str,
+            "providerId": provider_id_clone
+        });
+        if let Err(e) = app.emit("provider-switched", event_data) {
+            log::error!("发射供应商切换事件失败: {}", e);
+        }
+    }
+    Ok(())
+}
+
+/// 更新托盘菜单的Tauri命令
+#[tauri::command]
+async fn update_tray_menu(
+    app: tauri::AppHandle,
+    state: tauri::State<'_, AppState>,
+) -> Result<bool, String> {
+    match create_tray_menu(&app, state.inner()) {
+        Ok(new_menu) => {
+            if let Some(tray) = app.tray_by_id("main") {
+                tray.set_menu(Some(new_menu))
+                    .map_err(|e| format!("更新托盘菜单失败: {}", e))?;
+                return Ok(true);
+            }
+            Ok(false)
+        }
+        Err(err) => {
+            log::error!("创建托盘菜单失败: {}", err);
+            Ok(false)
+        }
+    }
+}
+
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    let mut builder = tauri::Builder::default();
+
+    #[cfg(any(target_os = "macos", target_os = "windows", target_os = "linux"))]
+    {
+        builder = builder.plugin(tauri_plugin_single_instance::init(|app, _args, _cwd| {
+            if let Some(window) = app.get_webview_window("main") {
+                let _ = window.unminimize();
+                let _ = window.show();
+                let _ = window.set_focus();
+            }
+        }));
+    }
+
+    let builder = builder
+        // 拦截窗口关闭：根据设置决定是否最小化到托盘
+        .on_window_event(|window, event| {
+            if let tauri::WindowEvent::CloseRequested { api, .. } = event {
+                let settings = crate::settings::get_settings();
+
+                if settings.minimize_to_tray_on_close {
+                    api.prevent_close();
+                    let _ = window.hide();
+                    #[cfg(target_os = "windows")]
+                    {
+                        let _ = window.set_skip_taskbar(true);
+                    }
+                    #[cfg(target_os = "macos")]
+                    {
+                        apply_tray_policy(window.app_handle(), false);
+                    }
+                } else {
+                    window.app_handle().exit(0);
+                }
+            }
+        })
+        .plugin(tauri_plugin_process::init())
+        .plugin(tauri_plugin_dialog::init())
+        .plugin(tauri_plugin_opener::init())
+        .plugin(tauri_plugin_store::Builder::new().build())
+        .setup(|app| {
+            // 注册 Updater 插件（桌面端）
+            #[cfg(desktop)]
+            {
+                if let Err(e) = app
+                    .handle()
+                    .plugin(tauri_plugin_updater::Builder::new().build())
+                {
+                    // 若配置不完整（如缺少 pubkey），跳过 Updater 而不中断应用
+                    log::warn!("初始化 Updater 插件失败，已跳过：{}", e);
+                }
+            }
+            #[cfg(target_os = "macos")]
+            {
+                // 设置 macOS 标题栏背景色为主界面蓝色
+                if let Some(window) = app.get_webview_window("main") {
+                    use objc2::rc::Retained;
+                    use objc2::runtime::AnyObject;
+                    use objc2_app_kit::NSColor;
+
+                    let ns_window_ptr = window.ns_window().unwrap();
+                    let ns_window: Retained<AnyObject> =
+                        unsafe { Retained::retain(ns_window_ptr as *mut AnyObject).unwrap() };
+
+                    // 使用与主界面 banner 相同的蓝色 #3498db
+                    // #3498db = RGB(52, 152, 219)
+                    let bg_color = unsafe {
+                        NSColor::colorWithRed_green_blue_alpha(
+                            52.0 / 255.0,  // R: 52
+                            152.0 / 255.0, // G: 152
+                            219.0 / 255.0, // B: 219
+                            1.0,           // Alpha: 1.0
+                        )
+                    };
+
+                    unsafe {
+                        use objc2::msg_send;
+                        let _: () = msg_send![&*ns_window, setBackgroundColor: &*bg_color];
+                    }
+                }
+            }
+
+            // 初始化日志
+            if cfg!(debug_assertions) {
+                app.handle().plugin(
+                    tauri_plugin_log::Builder::default()
+                        .level(log::LevelFilter::Info)
+                        .build(),
+                )?;
+            }
+
+            // 预先刷新 Store 覆盖配置，确保 AppState 初始化时可读取到最新路径
+            app_store::refresh_app_config_dir_override(app.handle());
+
+            // 初始化应用状态（仅创建一次，并在本函数末尾注入 manage）
+            let app_state = AppState::new();
+
+            // 迁移旧的 app_config_dir 配置到 Store
+            if let Err(e) = app_store::migrate_app_config_dir_from_settings(app.handle()) {
+                log::warn!("迁移 app_config_dir 失败: {}", e);
+            }
+
+            // 首次启动迁移：扫描副本文件，合并到 config.json，并归档副本；旧 config.json 先归档
+            {
+                let mut config_guard = app_state.config.write().unwrap();
+                let migrated = migration::migrate_copies_into_config(&mut config_guard)?;
+                if migrated {
+                    log::info!("已将副本文件导入到 config.json，并完成归档");
+                }
+                // 确保两个 App 条目存在
+                config_guard.ensure_app(&app_config::AppType::Claude);
+                config_guard.ensure_app(&app_config::AppType::Codex);
+            }
+
+            // 保存配置
+            let _ = app_state.save();
+
+            // 创建动态托盘菜单
+            let menu = create_tray_menu(app.handle(), &app_state)?;
+
+            // 构建托盘
+            let mut tray_builder = TrayIconBuilder::with_id("main")
+                .on_tray_icon_event(|_tray, event| match event {
+                    // 左键点击已通过 show_menu_on_left_click(true) 打开菜单，这里不再额外处理
+                    TrayIconEvent::Click { .. } => {}
+                    _ => log::debug!("unhandled event {event:?}"),
+                })
+                .menu(&menu)
+                .on_menu_event(|app, event| {
+                    handle_tray_menu_event(app, &event.id.0);
+                })
+                .show_menu_on_left_click(true);
+
+            // 统一使用应用默认图标；待托盘模板图标就绪后再启用
+            tray_builder = tray_builder.icon(app.default_window_icon().unwrap().clone());
+
+            let _tray = tray_builder.build(app)?;
+            // 将同一个实例注入到全局状态，避免重复创建导致的不一致
+            app.manage(app_state);
+            Ok(())
+        })
+        .invoke_handler(tauri::generate_handler![
+            commands::get_providers,
+            commands::get_current_provider,
+            commands::add_provider,
+            commands::update_provider,
+            commands::delete_provider,
+            commands::switch_provider,
+            commands::import_default_config,
+            commands::get_claude_config_status,
+            commands::get_config_status,
+            commands::get_claude_code_config_path,
+            commands::get_config_dir,
+            commands::open_config_folder,
+            commands::pick_directory,
+            commands::open_external,
+            commands::get_app_config_path,
+            commands::open_app_config_folder,
+            commands::read_live_provider_settings,
+            commands::get_settings,
+            commands::save_settings,
+            commands::restart_app,
+            commands::check_for_updates,
+            commands::is_portable_mode,
+            commands::get_claude_plugin_status,
+            commands::read_claude_plugin_config,
+            commands::apply_claude_plugin_config,
+            commands::is_claude_plugin_applied,
+            // Claude MCP management
+            commands::get_claude_mcp_status,
+            commands::read_claude_mcp_config,
+            commands::upsert_claude_mcp_server,
+            commands::delete_claude_mcp_server,
+            commands::validate_mcp_command,
+            // usage query
+            commands::query_provider_usage,
+            // New MCP via config.json (SSOT)
+            commands::get_mcp_config,
+            commands::upsert_mcp_server_in_config,
+            commands::delete_mcp_server_in_config,
+            commands::set_mcp_enabled,
+            commands::sync_enabled_mcp_to_claude,
+            commands::sync_enabled_mcp_to_codex,
+            commands::import_mcp_from_claude,
+            commands::import_mcp_from_codex,
+            // ours: endpoint speed test + custom endpoint management
+            commands::test_api_endpoints,
+            commands::get_custom_endpoints,
+            commands::add_custom_endpoint,
+            commands::remove_custom_endpoint,
+            commands::update_endpoint_last_used,
+            // app_config_dir override via Store
+            commands::get_app_config_dir_override,
+            commands::set_app_config_dir_override,
+            // provider sort order management
+            commands::update_providers_sort_order,
+            // theirs: config import/export and dialogs
+            commands::export_config_to_file,
+            commands::import_config_from_file,
+            commands::save_file_dialog,
+            commands::open_file_dialog,
+            commands::sync_current_providers_live,
+            update_tray_menu,
+        ]);
+
+    let app = builder
+        .build(tauri::generate_context!())
+        .expect("error while running tauri application");
+
+    app.run(|app_handle, event| {
+        #[cfg(target_os = "macos")]
+        // macOS 在 Dock 图标被点击并重新激活应用时会触发 Reopen 事件，这里手动恢复主窗口
+        if let RunEvent::Reopen { .. } = event {
+            if let Some(window) = app_handle.get_webview_window("main") {
+                #[cfg(target_os = "windows")]
+                {
+                    let _ = window.set_skip_taskbar(false);
+                }
+                let _ = window.unminimize();
+                let _ = window.show();
+                let _ = window.set_focus();
+                apply_tray_policy(app_handle, true);
+            }
+        }
+
+        #[cfg(not(target_os = "macos"))]
+        {
+            let _ = (app_handle, event);
+        }
+    });
+}

src-tauri/src/main.rs

@@ -0,0 +1,6 @@
+// Prevents additional console window on Windows in release, DO NOT REMOVE!!
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+fn main() {
+    cc_switch_lib::run();
+}

src-tauri/src/mcp.rs

@@ -0,0 +1,720 @@
+use serde_json::{json, Value};
+use std::collections::HashMap;
+
+use crate::app_config::{AppType, McpConfig, MultiAppConfig};
+use crate::error::AppError;
+
+/// 基础校验：允许 stdio/http；或省略 type（视为 stdio）。对应必填字段存在
+fn validate_server_spec(spec: &Value) -> Result<(), AppError> {
+    if !spec.is_object() {
+        return Err(AppError::McpValidation(
+            "MCP 服务器连接定义必须为 JSON 对象".into(),
+        ));
+    }
+    let t_opt = spec.get("type").and_then(|x| x.as_str());
+    // 支持两种：stdio/http；若缺省 type 则按 stdio 处理（与社区常见 .mcp.json 一致）
+    let is_stdio = t_opt.map(|t| t == "stdio").unwrap_or(true);
+    let is_http = t_opt.map(|t| t == "http").unwrap_or(false);
+
+    if !(is_stdio || is_http) {
+        return Err(AppError::McpValidation(
+            "MCP 服务器 type 必须是 'stdio' 或 'http'（或省略表示 stdio）".into(),
+        ));
+    }
+
+    if is_stdio {
+        let cmd = spec.get("command").and_then(|x| x.as_str()).unwrap_or("");
+        if cmd.trim().is_empty() {
+            return Err(AppError::McpValidation(
+                "stdio 类型的 MCP 服务器缺少 command 字段".into(),
+            ));
+        }
+    }
+    if is_http {
+        let url = spec.get("url").and_then(|x| x.as_str()).unwrap_or("");
+        if url.trim().is_empty() {
+            return Err(AppError::McpValidation(
+                "http 类型的 MCP 服务器缺少 url 字段".into(),
+            ));
+        }
+    }
+    Ok(())
+}
+
+fn validate_mcp_entry(entry: &Value) -> Result<(), AppError> {
+    let obj = entry
+        .as_object()
+        .ok_or_else(|| AppError::McpValidation("MCP 服务器条目必须为 JSON 对象".into()))?;
+
+    let server = obj
+        .get("server")
+        .ok_or_else(|| AppError::McpValidation("MCP 服务器条目缺少 server 字段".into()))?;
+    validate_server_spec(server)?;
+
+    for key in ["name", "description", "homepage", "docs"] {
+        if let Some(val) = obj.get(key) {
+            if !val.is_string() {
+                return Err(AppError::McpValidation(format!(
+                    "MCP 服务器 {} 必须为字符串",
+                    key
+                )));
+            }
+        }
+    }
+
+    if let Some(tags) = obj.get("tags") {
+        let arr = tags
+            .as_array()
+            .ok_or_else(|| AppError::McpValidation("MCP 服务器 tags 必须为字符串数组".into()))?;
+        if !arr.iter().all(|item| item.is_string()) {
+            return Err(AppError::McpValidation(
+                "MCP 服务器 tags 必须为字符串数组".into(),
+            ));
+        }
+    }
+
+    if let Some(enabled) = obj.get("enabled") {
+        if !enabled.is_boolean() {
+            return Err(AppError::McpValidation(
+                "MCP 服务器 enabled 必须为布尔值".into(),
+            ));
+        }
+    }
+
+    Ok(())
+}
+
+fn normalize_server_keys(map: &mut HashMap<String, Value>) -> usize {
+    let mut change_count = 0usize;
+    let mut renames: Vec<(String, String)> = Vec::new();
+
+    for (key_ref, value) in map.iter_mut() {
+        let key = key_ref.clone();
+        let Some(obj) = value.as_object_mut() else {
+            continue;
+        };
+
+        let id_value = obj.get("id").cloned();
+
+        let target_id: String;
+
+        match id_value {
+            Some(id_val) => match id_val.as_str() {
+                Some(id_str) => {
+                    let trimmed = id_str.trim();
+                    if trimmed.is_empty() {
+                        obj.insert("id".into(), json!(key.clone()));
+                        change_count += 1;
+                        target_id = key.clone();
+                    } else {
+                        if trimmed != id_str {
+                            obj.insert("id".into(), json!(trimmed));
+                            change_count += 1;
+                        }
+                        target_id = trimmed.to_string();
+                    }
+                }
+                None => {
+                    obj.insert("id".into(), json!(key.clone()));
+                    change_count += 1;
+                    target_id = key.clone();
+                }
+            },
+            None => {
+                obj.insert("id".into(), json!(key.clone()));
+                change_count += 1;
+                target_id = key.clone();
+            }
+        }
+
+        if target_id != key {
+            renames.push((key, target_id));
+        }
+    }
+
+    for (old_key, new_key) in renames {
+        if old_key == new_key {
+            continue;
+        }
+        if map.contains_key(&new_key) {
+            log::warn!(
+                "MCP 条目 '{}' 的内部 id '{}' 与现有键冲突，回退为原键",
+                old_key,
+                new_key
+            );
+            if let Some(value) = map.get_mut(&old_key) {
+                if let Some(obj) = value.as_object_mut() {
+                    if obj
+                        .get("id")
+                        .and_then(|v| v.as_str())
+                        .map(|s| s != old_key)
+                        .unwrap_or(true)
+                    {
+                        obj.insert("id".into(), json!(old_key.clone()));
+                        change_count += 1;
+                    }
+                }
+            }
+            continue;
+        }
+        if let Some(mut value) = map.remove(&old_key) {
+            if let Some(obj) = value.as_object_mut() {
+                obj.insert("id".into(), json!(new_key.clone()));
+            }
+            log::info!("MCP 条目键名已自动修复: '{}' -> '{}'", old_key, new_key);
+            map.insert(new_key, value);
+            change_count += 1;
+        }
+    }
+
+    change_count
+}
+
+pub fn normalize_servers_for(config: &mut MultiAppConfig, app: &AppType) -> usize {
+    let servers = &mut config.mcp_for_mut(app).servers;
+    normalize_server_keys(servers)
+}
+
+fn extract_server_spec(entry: &Value) -> Result<Value, AppError> {
+    let obj = entry
+        .as_object()
+        .ok_or_else(|| AppError::McpValidation("MCP 服务器条目必须为 JSON 对象".into()))?;
+    let server = obj
+        .get("server")
+        .ok_or_else(|| AppError::McpValidation("MCP 服务器条目缺少 server 字段".into()))?;
+
+    if !server.is_object() {
+        return Err(AppError::McpValidation(
+            "MCP 服务器 server 字段必须为 JSON 对象".into(),
+        ));
+    }
+
+    Ok(server.clone())
+}
+
+/// 返回已启用的 MCP 服务器（过滤 enabled==true）
+fn collect_enabled_servers(cfg: &McpConfig) -> HashMap<String, Value> {
+    let mut out = HashMap::new();
+    for (id, entry) in cfg.servers.iter() {
+        let enabled = entry
+            .get("enabled")
+            .and_then(|v| v.as_bool())
+            .unwrap_or(false);
+        if !enabled {
+            continue;
+        }
+        match extract_server_spec(entry) {
+            Ok(spec) => {
+                out.insert(id.clone(), spec);
+            }
+            Err(err) => {
+                log::warn!("跳过无效的 MCP 条目 '{}': {}", id, err);
+            }
+        }
+    }
+    out
+}
+
+pub fn get_servers_snapshot_for(
+    config: &mut MultiAppConfig,
+    app: &AppType,
+) -> (HashMap<String, Value>, usize) {
+    let normalized = normalize_servers_for(config, app);
+    let mut snapshot = config.mcp_for(app).servers.clone();
+    snapshot.retain(|id, value| {
+        let Some(obj) = value.as_object_mut() else {
+            log::warn!("跳过无效的 MCP 条目 '{}': 必须为 JSON 对象", id);
+            return false;
+        };
+
+        obj.entry(String::from("id")).or_insert(json!(id));
+
+        match validate_mcp_entry(value) {
+            Ok(()) => true,
+            Err(err) => {
+                log::error!("config.json 中存在无效的 MCP 条目 '{}': {}", id, err);
+                false
+            }
+        }
+    });
+    (snapshot, normalized)
+}
+
+pub fn upsert_in_config_for(
+    config: &mut MultiAppConfig,
+    app: &AppType,
+    id: &str,
+    spec: Value,
+) -> Result<bool, AppError> {
+    if id.trim().is_empty() {
+        return Err(AppError::InvalidInput("MCP 服务器 ID 不能为空".into()));
+    }
+    normalize_servers_for(config, app);
+    validate_mcp_entry(&spec)?;
+
+    let mut entry_obj = spec
+        .as_object()
+        .cloned()
+        .ok_or_else(|| AppError::McpValidation("MCP 服务器条目必须为 JSON 对象".into()))?;
+    if let Some(existing_id) = entry_obj.get("id") {
+        let Some(existing_id_str) = existing_id.as_str() else {
+            return Err(AppError::McpValidation("MCP 服务器 id 必须为字符串".into()));
+        };
+        if existing_id_str != id {
+            return Err(AppError::McpValidation(format!(
+                "MCP 服务器条目中的 id '{}' 与参数 id '{}' 不一致",
+                existing_id_str, id
+            )));
+        }
+    } else {
+        entry_obj.insert(String::from("id"), json!(id));
+    }
+
+    let value = Value::Object(entry_obj);
+
+    let servers = &mut config.mcp_for_mut(app).servers;
+    let before = servers.get(id).cloned();
+    servers.insert(id.to_string(), value);
+
+    Ok(before.is_none())
+}
+
+pub fn delete_in_config_for(
+    config: &mut MultiAppConfig,
+    app: &AppType,
+    id: &str,
+) -> Result<bool, AppError> {
+    if id.trim().is_empty() {
+        return Err(AppError::InvalidInput("MCP 服务器 ID 不能为空".into()));
+    }
+    normalize_servers_for(config, app);
+    let existed = config.mcp_for_mut(app).servers.remove(id).is_some();
+    Ok(existed)
+}
+
+/// 设置启用状态（不执行落盘或文件同步）
+pub fn set_enabled_flag_for(
+    config: &mut MultiAppConfig,
+    app: &AppType,
+    id: &str,
+    enabled: bool,
+) -> Result<bool, AppError> {
+    if id.trim().is_empty() {
+        return Err(AppError::InvalidInput("MCP 服务器 ID 不能为空".into()));
+    }
+    normalize_servers_for(config, app);
+    if let Some(spec) = config.mcp_for_mut(app).servers.get_mut(id) {
+        // 写入 enabled 字段
+        let mut obj = spec
+            .as_object()
+            .cloned()
+            .ok_or_else(|| AppError::McpValidation("MCP 服务器定义必须为 JSON 对象".into()))?;
+        obj.insert("enabled".into(), json!(enabled));
+        *spec = Value::Object(obj);
+    } else {
+        // 若不存在则直接返回 false
+        return Ok(false);
+    }
+
+    Ok(true)
+}
+
+/// 将 config.json 中 enabled==true 的项投影写入 ~/.claude.json
+pub fn sync_enabled_to_claude(config: &MultiAppConfig) -> Result<(), AppError> {
+    let enabled = collect_enabled_servers(&config.mcp.claude);
+    crate::claude_mcp::set_mcp_servers_map(&enabled)
+}
+
+/// 从 ~/.claude.json 导入 mcpServers 到 config.json（设为 enabled=true）。
+/// 已存在的项仅强制 enabled=true，不覆盖其他字段。
+pub fn import_from_claude(config: &mut MultiAppConfig) -> Result<usize, AppError> {
+    let text_opt = crate::claude_mcp::read_mcp_json()?;
+    let Some(text) = text_opt else { return Ok(0) };
+    let mut changed = normalize_servers_for(config, &AppType::Claude);
+    let v: Value = serde_json::from_str(&text)
+        .map_err(|e| AppError::McpValidation(format!("解析 ~/.claude.json 失败: {}", e)))?;
+    let Some(map) = v.get("mcpServers").and_then(|x| x.as_object()) else {
+        return Ok(changed);
+    };
+
+    for (id, spec) in map.iter() {
+        // 校验目标 spec
+        validate_server_spec(spec)?;
+
+        let entry = config
+            .mcp_for_mut(&AppType::Claude)
+            .servers
+            .entry(id.clone());
+        use std::collections::hash_map::Entry;
+        match entry {
+            Entry::Vacant(vac) => {
+                let mut obj = serde_json::Map::new();
+                obj.insert(String::from("id"), json!(id));
+                obj.insert(String::from("name"), json!(id));
+                obj.insert(String::from("server"), spec.clone());
+                obj.insert(String::from("enabled"), json!(true));
+                vac.insert(Value::Object(obj));
+                changed += 1;
+            }
+            Entry::Occupied(mut occ) => {
+                let value = occ.get_mut();
+                let Some(existing) = value.as_object_mut() else {
+                    log::warn!("MCP 条目 '{}' 不是 JSON 对象，覆盖为导入数据", id);
+                    let mut obj = serde_json::Map::new();
+                    obj.insert(String::from("id"), json!(id));
+                    obj.insert(String::from("name"), json!(id));
+                    obj.insert(String::from("server"), spec.clone());
+                    obj.insert(String::from("enabled"), json!(true));
+                    occ.insert(Value::Object(obj));
+                    changed += 1;
+                    continue;
+                };
+
+                let mut modified = false;
+                let prev_enabled = existing
+                    .get("enabled")
+                    .and_then(|b| b.as_bool())
+                    .unwrap_or(false);
+                if !prev_enabled {
+                    existing.insert(String::from("enabled"), json!(true));
+                    modified = true;
+                }
+                if existing.get("server").is_none() {
+                    log::warn!("MCP 条目 '{}' 缺少 server 字段，覆盖为导入数据", id);
+                    existing.insert(String::from("server"), spec.clone());
+                    modified = true;
+                }
+                if existing.get("id").is_none() {
+                    log::warn!("MCP 条目 '{}' 缺少 id 字段，自动填充", id);
+                    existing.insert(String::from("id"), json!(id));
+                    modified = true;
+                }
+                if modified {
+                    changed += 1;
+                }
+            }
+        }
+    }
+    Ok(changed)
+}
+
+/// 从 ~/.codex/config.toml 导入 MCP 到 config.json（Codex 作用域），并将导入项设为 enabled=true。
+/// 支持两种 schema：[mcp.servers.<id>] 与 [mcp_servers.<id>]。
+/// 已存在的项仅强制 enabled=true，不覆盖其他字段。
+pub fn import_from_codex(config: &mut MultiAppConfig) -> Result<usize, AppError> {
+    let text = crate::codex_config::read_and_validate_codex_config_text()?;
+    if text.trim().is_empty() {
+        return Ok(0);
+    }
+    let mut changed_total = normalize_servers_for(config, &AppType::Codex);
+
+    let root: toml::Table = toml::from_str(&text)
+        .map_err(|e| AppError::McpValidation(format!("解析 ~/.codex/config.toml 失败: {}", e)))?;
+
+    // helper：处理一组 servers 表
+    let mut import_servers_tbl = |servers_tbl: &toml::value::Table| {
+        let mut changed = 0usize;
+        for (id, entry_val) in servers_tbl.iter() {
+            let Some(entry_tbl) = entry_val.as_table() else {
+                continue;
+            };
+
+            // type 缺省为 stdio
+            let typ = entry_tbl
+                .get("type")
+                .and_then(|v| v.as_str())
+                .unwrap_or("stdio");
+
+            // 构建 JSON 规范
+            let mut spec = serde_json::Map::new();
+            spec.insert("type".into(), json!(typ));
+
+            match typ {
+                "stdio" => {
+                    if let Some(cmd) = entry_tbl.get("command").and_then(|v| v.as_str()) {
+                        spec.insert("command".into(), json!(cmd));
+                    }
+                    if let Some(args) = entry_tbl.get("args").and_then(|v| v.as_array()) {
+                        let arr = args
+                            .iter()
+                            .filter_map(|x| x.as_str())
+                            .map(|s| json!(s))
+                            .collect::<Vec<_>>();
+                        if !arr.is_empty() {
+                            spec.insert("args".into(), serde_json::Value::Array(arr));
+                        }
+                    }
+                    if let Some(cwd) = entry_tbl.get("cwd").and_then(|v| v.as_str()) {
+                        if !cwd.trim().is_empty() {
+                            spec.insert("cwd".into(), json!(cwd));
+                        }
+                    }
+                    if let Some(env_tbl) = entry_tbl.get("env").and_then(|v| v.as_table()) {
+                        let mut env_json = serde_json::Map::new();
+                        for (k, v) in env_tbl.iter() {
+                            if let Some(sv) = v.as_str() {
+                                env_json.insert(k.clone(), json!(sv));
+                            }
+                        }
+                        if !env_json.is_empty() {
+                            spec.insert("env".into(), serde_json::Value::Object(env_json));
+                        }
+                    }
+                }
+                "http" => {
+                    if let Some(url) = entry_tbl.get("url").and_then(|v| v.as_str()) {
+                        spec.insert("url".into(), json!(url));
+                    }
+                    if let Some(headers_tbl) = entry_tbl.get("headers").and_then(|v| v.as_table()) {
+                        let mut headers_json = serde_json::Map::new();
+                        for (k, v) in headers_tbl.iter() {
+                            if let Some(sv) = v.as_str() {
+                                headers_json.insert(k.clone(), json!(sv));
+                            }
+                        }
+                        if !headers_json.is_empty() {
+                            spec.insert("headers".into(), serde_json::Value::Object(headers_json));
+                        }
+                    }
+                }
+                _ => {}
+            }
+
+            let spec_v = serde_json::Value::Object(spec);
+
+            // 校验
+            if let Err(e) = validate_server_spec(&spec_v) {
+                log::warn!("跳过无效 Codex MCP 项 '{}': {}", id, e);
+                continue;
+            }
+
+            // 合并：仅强制 enabled=true
+            use std::collections::hash_map::Entry;
+            let entry = config
+                .mcp_for_mut(&AppType::Codex)
+                .servers
+                .entry(id.clone());
+            match entry {
+                Entry::Vacant(vac) => {
+                    let mut obj = serde_json::Map::new();
+                    obj.insert(String::from("id"), json!(id));
+                    obj.insert(String::from("name"), json!(id));
+                    obj.insert(String::from("server"), spec_v.clone());
+                    obj.insert(String::from("enabled"), json!(true));
+                    vac.insert(serde_json::Value::Object(obj));
+                    changed += 1;
+                }
+                Entry::Occupied(mut occ) => {
+                    let value = occ.get_mut();
+                    let Some(existing) = value.as_object_mut() else {
+                        log::warn!("MCP 条目 '{}' 不是 JSON 对象，覆盖为导入数据", id);
+                        let mut obj = serde_json::Map::new();
+                        obj.insert(String::from("id"), json!(id));
+                        obj.insert(String::from("name"), json!(id));
+                        obj.insert(String::from("server"), spec_v.clone());
+                        obj.insert(String::from("enabled"), json!(true));
+                        occ.insert(serde_json::Value::Object(obj));
+                        changed += 1;
+                        continue;
+                    };
+
+                    let mut modified = false;
+                    let prev = existing
+                        .get("enabled")
+                        .and_then(|b| b.as_bool())
+                        .unwrap_or(false);
+                    if !prev {
+                        existing.insert(String::from("enabled"), json!(true));
+                        modified = true;
+                    }
+                    if existing.get("server").is_none() {
+                        log::warn!("MCP 条目 '{}' 缺少 server 字段，覆盖为导入数据", id);
+                        existing.insert(String::from("server"), spec_v.clone());
+                        modified = true;
+                    }
+                    if existing.get("id").is_none() {
+                        log::warn!("MCP 条目 '{}' 缺少 id 字段，自动填充", id);
+                        existing.insert(String::from("id"), json!(id));
+                        modified = true;
+                    }
+                    if modified {
+                        changed += 1;
+                    }
+                }
+            }
+        }
+        changed
+    };
+
+    // 1) 处理 mcp.servers
+    if let Some(mcp_val) = root.get("mcp") {
+        if let Some(mcp_tbl) = mcp_val.as_table() {
+            if let Some(servers_val) = mcp_tbl.get("servers") {
+                if let Some(servers_tbl) = servers_val.as_table() {
+                    changed_total += import_servers_tbl(servers_tbl);
+                }
+            }
+        }
+    }
+
+    // 2) 处理 mcp_servers
+    if let Some(servers_val) = root.get("mcp_servers") {
+        if let Some(servers_tbl) = servers_val.as_table() {
+            changed_total += import_servers_tbl(servers_tbl);
+        }
+    }
+
+    Ok(changed_total)
+}
+
+/// 将 config.json 中 Codex 的 enabled==true 项以 TOML 形式写入 ~/.codex/config.toml 的 [mcp.servers]
+/// 策略：
+/// - 读取现有 config.toml；若语法无效则报错，不尝试覆盖
+/// - 仅更新 `mcp.servers` 或 `mcp_servers` 子表，保留 `mcp` 其它键
+/// - 仅写入启用项；无启用项时清理对应子表
+pub fn sync_enabled_to_codex(config: &MultiAppConfig) -> Result<(), AppError> {
+    use toml_edit::{DocumentMut, Item, Table};
+
+    // 1) 收集启用项（Codex 维度）
+    let enabled = collect_enabled_servers(&config.mcp.codex);
+
+    // 2) 读取现有 config.toml 文本；保持无效 TOML 的错误返回（不覆盖文件）
+    let base_text = crate::codex_config::read_and_validate_codex_config_text()?;
+
+    // 3) 使用 toml_edit 解析（允许空文件）
+    let mut doc: DocumentMut = if base_text.trim().is_empty() {
+        DocumentMut::default()
+    } else {
+        base_text
+            .parse::<DocumentMut>()
+            .map_err(|e| AppError::McpValidation(format!("解析 config.toml 失败: {}", e)))?
+    };
+
+    enum Target {
+        McpServers,    // 顶层 mcp_servers
+        McpDotServers, // mcp.servers
+    }
+
+    // 4) 选择目标风格：优先沿用既有子表；其次在 mcp 表下新建；最后退回顶层 mcp_servers
+    let has_mcp_dot_servers = doc
+        .get("mcp")
+        .and_then(|m| m.get("servers"))
+        .and_then(|s| s.as_table_like())
+        .is_some();
+    let has_mcp_servers = doc
+        .get("mcp_servers")
+        .and_then(|s| s.as_table_like())
+        .is_some();
+    let mcp_is_table = doc.get("mcp").and_then(|m| m.as_table_like()).is_some();
+
+    let target = if has_mcp_dot_servers {
+        Target::McpDotServers
+    } else if has_mcp_servers {
+        Target::McpServers
+    } else if mcp_is_table {
+        Target::McpDotServers
+    } else {
+        Target::McpServers
+    };
+
+    // 构造目标 servers 表（稳定的键顺序）
+    let build_servers_table = || -> Table {
+        let mut servers = Table::new();
+        let mut ids: Vec<_> = enabled.keys().cloned().collect();
+        ids.sort();
+        for id in ids {
+            let spec = enabled.get(&id).expect("spec must exist");
+            let mut t = Table::new();
+            let typ = spec.get("type").and_then(|v| v.as_str()).unwrap_or("stdio");
+            t["type"] = toml_edit::value(typ);
+            match typ {
+                "stdio" => {
+                    let cmd = spec.get("command").and_then(|v| v.as_str()).unwrap_or("");
+                    t["command"] = toml_edit::value(cmd);
+                    if let Some(args) = spec.get("args").and_then(|v| v.as_array()) {
+                        let mut arr_v = toml_edit::Array::default();
+                        for a in args.iter().filter_map(|x| x.as_str()) {
+                            arr_v.push(a);
+                        }
+                        if !arr_v.is_empty() {
+                            t["args"] = toml_edit::Item::Value(toml_edit::Value::Array(arr_v));
+                        }
+                    }
+                    if let Some(cwd) = spec.get("cwd").and_then(|v| v.as_str()) {
+                        if !cwd.trim().is_empty() {
+                            t["cwd"] = toml_edit::value(cwd);
+                        }
+                    }
+                    if let Some(env) = spec.get("env").and_then(|v| v.as_object()) {
+                        let mut env_tbl = Table::new();
+                        for (k, v) in env.iter() {
+                            if let Some(s) = v.as_str() {
+                                env_tbl[&k[..]] = toml_edit::value(s);
+                            }
+                        }
+                        if !env_tbl.is_empty() {
+                            t["env"] = Item::Table(env_tbl);
+                        }
+                    }
+                }
+                "http" => {
+                    let url = spec.get("url").and_then(|v| v.as_str()).unwrap_or("");
+                    t["url"] = toml_edit::value(url);
+                    if let Some(headers) = spec.get("headers").and_then(|v| v.as_object()) {
+                        let mut h_tbl = Table::new();
+                        for (k, v) in headers.iter() {
+                            if let Some(s) = v.as_str() {
+                                h_tbl[&k[..]] = toml_edit::value(s);
+                            }
+                        }
+                        if !h_tbl.is_empty() {
+                            t["headers"] = Item::Table(h_tbl);
+                        }
+                    }
+                }
+                _ => {}
+            }
+            servers[&id[..]] = Item::Table(t);
+        }
+        servers
+    };
+
+    // 5) 应用更新：仅就地更新目标子表；避免改动其它键/注释/空白
+    if enabled.is_empty() {
+        // 无启用项：移除两种 servers 表（如果存在），但保留 mcp 其它字段
+        if let Some(mcp_item) = doc.get_mut("mcp") {
+            if let Some(tbl) = mcp_item.as_table_like_mut() {
+                tbl.remove("servers");
+            }
+        }
+        doc.as_table_mut().remove("mcp_servers");
+    } else {
+        let servers_tbl = build_servers_table();
+        match target {
+            Target::McpDotServers => {
+                // 确保 mcp 为表
+                if doc.get("mcp").and_then(|m| m.as_table_like()).is_none() {
+                    doc["mcp"] = Item::Table(Table::new());
+                }
+                doc["mcp"]["servers"] = Item::Table(servers_tbl);
+                // 去重：若存在顶层 mcp_servers，则移除以避免重复定义
+                doc.as_table_mut().remove("mcp_servers");
+            }
+            Target::McpServers => {
+                doc["mcp_servers"] = Item::Table(servers_tbl);
+                // 去重：若存在 mcp.servers，则移除该子表，保留 mcp 其它键
+                if let Some(mcp_item) = doc.get_mut("mcp") {
+                    if let Some(tbl) = mcp_item.as_table_like_mut() {
+                        tbl.remove("servers");
+                    }
+                }
+            }
+        }
+    }
+
+    // 6) 写回（仅改 TOML，不触碰 auth.json）；toml_edit 会尽量保留未改区域的注释/空白/顺序
+    let new_text = doc.to_string();
+    let path = crate::codex_config::get_codex_config_path();
+    crate::config::write_text_file(&path, &new_text)?;
+    Ok(())
+}

src-tauri/src/migration.rs

@@ -0,0 +1,432 @@
+use crate::app_config::{AppType, MultiAppConfig};
+use crate::config::{
+    archive_file, delete_file, get_app_config_dir, get_app_config_path, get_claude_config_dir,
+};
+use crate::error::AppError;
+use serde_json::Value;
+use std::collections::{HashMap, HashSet};
+use std::fs;
+use std::path::PathBuf;
+
+fn now_ts() -> u64 {
+    std::time::SystemTime::now()
+        .duration_since(std::time::UNIX_EPOCH)
+        .unwrap_or_default()
+        .as_secs()
+}
+
+fn get_marker_path() -> PathBuf {
+    get_app_config_dir().join("migrated.copies.v1")
+}
+
+fn sanitized_id(base: &str) -> String {
+    crate::config::sanitize_provider_name(base)
+}
+
+fn next_unique_id(existing: &HashSet<String>, base: &str) -> String {
+    let base = sanitized_id(base);
+    if !existing.contains(&base) {
+        return base;
+    }
+    for i in 2..1000 {
+        let candidate = format!("{}-{}", base, i);
+        if !existing.contains(&candidate) {
+            return candidate;
+        }
+    }
+    format!("{}-dup", base)
+}
+
+fn extract_claude_api_key(value: &Value) -> Option<String> {
+    value
+        .get("env")
+        .and_then(|env| env.get("ANTHROPIC_AUTH_TOKEN"))
+        .and_then(|v| v.as_str())
+        .map(|s| s.to_string())
+}
+
+fn extract_codex_api_key(value: &Value) -> Option<String> {
+    value
+        .get("auth")
+        .and_then(|auth| {
+            auth.get("OPENAI_API_KEY")
+                .or_else(|| auth.get("openai_api_key"))
+        })
+        .and_then(|v| v.as_str())
+        .map(|s| s.to_string())
+}
+
+fn norm_name(s: &str) -> String {
+    s.trim().to_lowercase()
+}
+
+// 去重策略：name + 原始 key 直接比较（不做哈希）
+
+fn scan_claude_copies() -> Vec<(String, PathBuf, Value)> {
+    let mut items = Vec::new();
+    let dir = get_claude_config_dir();
+    if !dir.exists() {
+        return items;
+    }
+    if let Ok(rd) = fs::read_dir(&dir) {
+        for e in rd.flatten() {
+            let p = e.path();
+            let fname = match p.file_name().and_then(|s| s.to_str()) {
+                Some(s) => s,
+                None => continue,
+            };
+            if fname == "settings.json" || fname == "claude.json" {
+                continue;
+            }
+            if !fname.starts_with("settings-") || !fname.ends_with(".json") {
+                continue;
+            }
+            let name = fname
+                .trim_start_matches("settings-")
+                .trim_end_matches(".json");
+            if let Ok(val) = crate::config::read_json_file::<Value>(&p) {
+                items.push((name.to_string(), p, val));
+            }
+        }
+    }
+    items
+}
+
+fn scan_codex_copies() -> Vec<(String, Option<PathBuf>, Option<PathBuf>, Value)> {
+    let mut by_name: HashMap<String, (Option<PathBuf>, Option<PathBuf>)> = HashMap::new();
+    let dir = crate::codex_config::get_codex_config_dir();
+    if !dir.exists() {
+        return Vec::new();
+    }
+    if let Ok(rd) = fs::read_dir(&dir) {
+        for e in rd.flatten() {
+            let p = e.path();
+            let fname = match p.file_name().and_then(|s| s.to_str()) {
+                Some(s) => s,
+                None => continue,
+            };
+            if fname.starts_with("auth-") && fname.ends_with(".json") {
+                let name = fname.trim_start_matches("auth-").trim_end_matches(".json");
+                let entry = by_name.entry(name.to_string()).or_default();
+                entry.0 = Some(p);
+            } else if fname.starts_with("config-") && fname.ends_with(".toml") {
+                let name = fname
+                    .trim_start_matches("config-")
+                    .trim_end_matches(".toml");
+                let entry = by_name.entry(name.to_string()).or_default();
+                entry.1 = Some(p);
+            }
+        }
+    }
+
+    let mut items = Vec::new();
+    for (name, (auth_path, config_path)) in by_name {
+        if let Some(authp) = auth_path {
+            if let Ok(auth) = crate::config::read_json_file::<Value>(&authp) {
+                let config_str = if let Some(cfgp) = &config_path {
+                    match crate::codex_config::read_and_validate_config_from_path(cfgp) {
+                        Ok(s) => s,
+                        Err(e) => {
+                            log::warn!("跳过无效 Codex config-{}.toml: {}", name, e);
+                            String::new()
+                        }
+                    }
+                } else {
+                    String::new()
+                };
+                let settings = serde_json::json!({
+                    "auth": auth,
+                    "config": config_str,
+                });
+                items.push((name, Some(authp), config_path, settings));
+            }
+        }
+    }
+    items
+}
+
+pub fn migrate_copies_into_config(config: &mut MultiAppConfig) -> Result<bool, AppError> {
+    // 如果已迁移过则跳过；若目录不存在则先创建，避免新装用户写入标记时失败
+    let marker = get_marker_path();
+    if let Some(parent) = marker.parent() {
+        std::fs::create_dir_all(parent).map_err(|e| AppError::io(parent, e))?;
+    }
+    if marker.exists() {
+        return Ok(false);
+    }
+
+    let claude_items = scan_claude_copies();
+    let codex_items = scan_codex_copies();
+    if claude_items.is_empty() && codex_items.is_empty() {
+        // 即便没有可迁移项，也写入标记避免每次扫描
+        fs::write(&marker, b"no-copies").map_err(|e| AppError::io(&marker, e))?;
+        return Ok(false);
+    }
+
+    // 备份旧的 config.json
+    let ts = now_ts();
+    let app_cfg_path = get_app_config_path();
+    if app_cfg_path.exists() {
+        let _ = archive_file(ts, "cc-switch", &app_cfg_path);
+    }
+
+    // 读取 live：Claude（settings.json / claude.json）
+    let live_claude: Option<(String, Value)> = {
+        let settings_path = crate::config::get_claude_settings_path();
+        if settings_path.exists() {
+            match crate::config::read_json_file::<Value>(&settings_path) {
+                Ok(val) => Some(("default".to_string(), val)),
+                Err(e) => {
+                    log::warn!("读取 Claude live 配置失败: {}", e);
+                    None
+                }
+            }
+        } else {
+            None
+        }
+    };
+
+    // 合并：Claude（优先 live，然后副本） - 去重键: name + apiKey（直接比较）
+    config.ensure_app(&AppType::Claude);
+    let manager = config.get_manager_mut(&AppType::Claude).unwrap();
+    let mut ids: HashSet<String> = manager.providers.keys().cloned().collect();
+    let mut live_claude_id: Option<String> = None;
+
+    if let Some((name, value)) = &live_claude {
+        let cand_key = extract_claude_api_key(value);
+        let exist_id = manager.providers.iter().find_map(|(id, p)| {
+            let pk = extract_claude_api_key(&p.settings_config);
+            if norm_name(&p.name) == norm_name(name) && pk == cand_key {
+                Some(id.clone())
+            } else {
+                None
+            }
+        });
+        if let Some(exist_id) = exist_id {
+            if let Some(prov) = manager.providers.get_mut(&exist_id) {
+                log::info!("合并到已存在 Claude 供应商 '{}' (by name+key)", name);
+                prov.settings_config = value.clone();
+                live_claude_id = Some(exist_id);
+            }
+        } else {
+            let id = next_unique_id(&ids, name);
+            ids.insert(id.clone());
+            let provider =
+                crate::provider::Provider::with_id(id.clone(), name.clone(), value.clone(), None);
+            manager.providers.insert(provider.id.clone(), provider);
+            live_claude_id = Some(id);
+        }
+    }
+    for (name, path, value) in claude_items.iter() {
+        let cand_key = extract_claude_api_key(value);
+        let exist_id = manager.providers.iter().find_map(|(id, p)| {
+            let pk = extract_claude_api_key(&p.settings_config);
+            if norm_name(&p.name) == norm_name(name) && pk == cand_key {
+                Some(id.clone())
+            } else {
+                None
+            }
+        });
+        if let Some(exist_id) = exist_id {
+            if let Some(prov) = manager.providers.get_mut(&exist_id) {
+                log::info!(
+                    "覆盖 Claude 供应商 '{}' 来自 {} (by name+key)",
+                    name,
+                    path.display()
+                );
+                prov.settings_config = value.clone();
+            }
+        } else {
+            let id = next_unique_id(&ids, name);
+            ids.insert(id.clone());
+            let provider =
+                crate::provider::Provider::with_id(id.clone(), name.clone(), value.clone(), None);
+            manager.providers.insert(provider.id.clone(), provider);
+        }
+    }
+
+    // 读取 live：Codex（auth.json 必需，config.toml 可空）
+    let live_codex: Option<(String, Value)> = {
+        let auth_path = crate::codex_config::get_codex_auth_path();
+        if auth_path.exists() {
+            match crate::config::read_json_file::<Value>(&auth_path) {
+                Ok(auth) => {
+                    let cfg = match crate::codex_config::read_and_validate_codex_config_text() {
+                        Ok(s) => s,
+                        Err(e) => {
+                            log::warn!("读取/校验 Codex live config.toml 失败: {}", e);
+                            String::new()
+                        }
+                    };
+                    Some((
+                        "default".to_string(),
+                        serde_json::json!({"auth": auth, "config": cfg}),
+                    ))
+                }
+                Err(e) => {
+                    log::warn!("读取 Codex live auth.json 失败: {}", e);
+                    None
+                }
+            }
+        } else {
+            None
+        }
+    };
+
+    // 合并：Codex（优先 live，然后副本） - 去重键: name + OPENAI_API_KEY（直接比较）
+    config.ensure_app(&AppType::Codex);
+    let manager = config.get_manager_mut(&AppType::Codex).unwrap();
+    let mut ids: HashSet<String> = manager.providers.keys().cloned().collect();
+    let mut live_codex_id: Option<String> = None;
+
+    if let Some((name, value)) = &live_codex {
+        let cand_key = extract_codex_api_key(value);
+        let exist_id = manager.providers.iter().find_map(|(id, p)| {
+            let pk = extract_codex_api_key(&p.settings_config);
+            if norm_name(&p.name) == norm_name(name) && pk == cand_key {
+                Some(id.clone())
+            } else {
+                None
+            }
+        });
+        if let Some(exist_id) = exist_id {
+            if let Some(prov) = manager.providers.get_mut(&exist_id) {
+                log::info!("合并到已存在 Codex 供应商 '{}' (by name+key)", name);
+                prov.settings_config = value.clone();
+                live_codex_id = Some(exist_id);
+            }
+        } else {
+            let id = next_unique_id(&ids, name);
+            ids.insert(id.clone());
+            let provider =
+                crate::provider::Provider::with_id(id.clone(), name.clone(), value.clone(), None);
+            manager.providers.insert(provider.id.clone(), provider);
+            live_codex_id = Some(id);
+        }
+    }
+    for (name, authp, cfgp, value) in codex_items.iter() {
+        let cand_key = extract_codex_api_key(value);
+        let exist_id = manager.providers.iter().find_map(|(id, p)| {
+            let pk = extract_codex_api_key(&p.settings_config);
+            if norm_name(&p.name) == norm_name(name) && pk == cand_key {
+                Some(id.clone())
+            } else {
+                None
+            }
+        });
+        if let Some(exist_id) = exist_id {
+            if let Some(prov) = manager.providers.get_mut(&exist_id) {
+                log::info!(
+                    "覆盖 Codex 供应商 '{}' 来自 {:?}/{:?} (by name+key)",
+                    name,
+                    authp,
+                    cfgp
+                );
+                prov.settings_config = value.clone();
+            }
+        } else {
+            let id = next_unique_id(&ids, name);
+            ids.insert(id.clone());
+            let provider =
+                crate::provider::Provider::with_id(id.clone(), name.clone(), value.clone(), None);
+            manager.providers.insert(provider.id.clone(), provider);
+        }
+    }
+
+    // 若当前为空，将 live 导入项设为当前
+    {
+        let manager = config.get_manager_mut(&AppType::Claude).unwrap();
+        if manager.current.is_empty() {
+            if let Some(id) = live_claude_id {
+                manager.current = id;
+            }
+        }
+    }
+    {
+        let manager = config.get_manager_mut(&AppType::Codex).unwrap();
+        if manager.current.is_empty() {
+            if let Some(id) = live_codex_id {
+                manager.current = id;
+            }
+        }
+    }
+
+    // 归档副本文件
+    for (_, p, _) in claude_items.into_iter() {
+        match archive_file(ts, "claude", &p) {
+            Ok(Some(_)) => {
+                let _ = delete_file(&p);
+            }
+            _ => {
+                // 归档失败则不要删除原文件，保守处理
+            }
+        }
+    }
+    for (_, ap, cp, _) in codex_items.into_iter() {
+        if let Some(ap) = ap {
+            if let Ok(Some(_)) = archive_file(ts, "codex", &ap) {
+                let _ = delete_file(&ap);
+            }
+        }
+        if let Some(cp) = cp {
+            if let Ok(Some(_)) = archive_file(ts, "codex", &cp) {
+                let _ = delete_file(&cp);
+            }
+        }
+    }
+
+    // 标记完成
+    // 仅在迁移阶段执行一次全量去重（忽略大小写的名称 + API Key）
+    let removed = dedupe_config(config);
+    if removed > 0 {
+        log::info!("迁移阶段已去重重复供应商 {} 个", removed);
+    }
+
+    fs::write(&marker, b"done").map_err(|e| AppError::io(&marker, e))?;
+    Ok(true)
+}
+
+/// 启动时对现有配置做一次去重：按名称(忽略大小写)+API Key
+pub fn dedupe_config(config: &mut MultiAppConfig) -> usize {
+    use std::collections::HashMap as Map;
+
+    fn dedupe_one(
+        mgr: &mut crate::provider::ProviderManager,
+        extract_key: &dyn Fn(&Value) -> Option<String>,
+    ) -> usize {
+        let mut keep: Map<String, String> = Map::new(); // key -> id 保留
+        let mut remove: Vec<String> = Vec::new();
+        for (id, p) in mgr.providers.iter() {
+            let k = format!(
+                "{}|{}",
+                norm_name(&p.name),
+                extract_key(&p.settings_config).unwrap_or_default()
+            );
+            if let Some(exist_id) = keep.get(&k) {
+                // 若当前是正在使用的，则用当前替换之前的，反之丢弃当前
+                if *id == mgr.current {
+                    // 替换：把原先的标记为删除，改保留为当前
+                    remove.push(exist_id.clone());
+                    keep.insert(k, id.clone());
+                } else {
+                    remove.push(id.clone());
+                }
+            } else {
+                keep.insert(k, id.clone());
+            }
+        }
+        for id in remove.iter() {
+            mgr.providers.remove(id);
+        }
+        remove.len()
+    }
+
+    let mut removed = 0;
+    if let Some(mgr) = config.get_manager_mut(&crate::app_config::AppType::Claude) {
+        removed += dedupe_one(mgr, &extract_claude_api_key);
+    }
+    if let Some(mgr) = config.get_manager_mut(&crate::app_config::AppType::Codex) {
+        removed += dedupe_one(mgr, &extract_codex_api_key);
+    }
+    removed
+}

src-tauri/src/provider.rs

@@ -0,0 +1,118 @@
+use serde::{Deserialize, Serialize};
+use serde_json::Value;
+use std::collections::HashMap;
+
+// SSOT 模式：不再写供应商副本文件
+
+/// 供应商结构体
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Provider {
+    pub id: String,
+    pub name: String,
+    #[serde(rename = "settingsConfig")]
+    pub settings_config: Value,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[serde(rename = "websiteUrl")]
+    pub website_url: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub category: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[serde(rename = "createdAt")]
+    pub created_at: Option<i64>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[serde(rename = "sortIndex")]
+    pub sort_index: Option<usize>,
+    /// 供应商元数据（不写入 live 配置，仅存于 ~/.cc-switch/config.json）
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub meta: Option<ProviderMeta>,
+}
+
+impl Provider {
+    /// 从现有ID创建供应商
+    pub fn with_id(
+        id: String,
+        name: String,
+        settings_config: Value,
+        website_url: Option<String>,
+    ) -> Self {
+        Self {
+            id,
+            name,
+            settings_config,
+            website_url,
+            category: None,
+            created_at: None,
+            sort_index: None,
+            meta: None,
+        }
+    }
+}
+
+/// 供应商管理器
+#[derive(Debug, Clone, Serialize, Deserialize, Default)]
+pub struct ProviderManager {
+    pub providers: HashMap<String, Provider>,
+    pub current: String,
+}
+
+/// 用量查询脚本配置
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct UsageScript {
+    pub enabled: bool,
+    pub language: String,
+    pub code: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub timeout: Option<u64>,
+}
+
+/// 用量数据
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct UsageData {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[serde(rename = "planName")]
+    pub plan_name: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub extra: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[serde(rename = "isValid")]
+    pub is_valid: Option<bool>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[serde(rename = "invalidMessage")]
+    pub invalid_message: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub total: Option<f64>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub used: Option<f64>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub remaining: Option<f64>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub unit: Option<String>,
+}
+
+/// 用量查询结果（支持多套餐）
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct UsageResult {
+    pub success: bool,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub data: Option<Vec<UsageData>>, // 支持返回多个套餐
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub error: Option<String>,
+}
+
+/// 供应商元数据
+#[derive(Debug, Clone, Serialize, Deserialize, Default)]
+pub struct ProviderMeta {
+    /// 自定义端点列表（按 URL 去重存储）
+    #[serde(default, skip_serializing_if = "HashMap::is_empty")]
+    pub custom_endpoints: HashMap<String, crate::settings::CustomEndpoint>,
+    /// 用量查询脚本配置
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub usage_script: Option<UsageScript>,
+}
+
+impl ProviderManager {
+    /// 获取所有供应商
+    pub fn get_all_providers(&self) -> &HashMap<String, Provider> {
+        &self.providers
+    }
+}