本仓库 Fork 自 farion1231/cc-switch（原版 v3.10.3），在原版基础上进行了以下增强：

原版仅支持本地 SQL 文件的导入/导出，本 Fork 新增了完整的 WebDAV 云同步能力，实现真正的跨设备配置同步。

功能概述：

• WebDAV 服务器关联 — 配置 WebDAV 服务器地址、用户名、密码、远程路径，支持一键测试连接
• 上传备份 — 将当前数据库导出为带时间戳的 SQL 文件并上传到 WebDAV 服务器
• 同步备份 — 从 WebDAV 服务器下载最新备份并同步到本地，支持 4 种同步模式：

技术实现：

• 后端：通过 reqwest 实现 WebDAV 协议（PROPFIND / PUT / GET / MKCOL），支持代理配置
• 配置存储：复用 SQLite settings 表，密码 Base64 编码存储
• 合并逻辑：独立的 webdav_sync 模块，支持 providers、mcp_servers、prompts、skills 四张表的智能合并
• 前端：useWebDav Hook + WebDavSection 组件，完整的状态管理和错误处理
• 国际化：中文 / 英文 / 日文三语支持

新增/修改文件：

新增:
  src-tauri/src/commands/webdav.rs       # WebDAV Tauri 命令（615 行）
  src-tauri/src/database/webdav_sync.rs  # 合并同步逻辑
  src/lib/api/webdav.ts                  # 前端 API 层
  src/hooks/useWebDav.ts                 # 状态管理 Hook
  src/components/settings/WebDavSection.tsx  # UI 组件

修改:
  src-tauri/src/commands/mod.rs          # 注册 webdav 模块
  src-tauri/src/database/mod.rs          # 注册 webdav_sync 模块
  src-tauri/src/lib.rs                   # 注册 6 个 Tauri 命令
  src/components/settings/SettingsPage.tsx  # 集成 WebDavSection
  src/i18n/locales/{zh,en,ja}.json       # 36 个翻译 key

1. 打开 设置 → 高级设置 → 数据管理
2. 在 "SQL 导入导出" 下方找到 WebDAV 云同步 区域
3. 填写 WebDAV 服务器信息（支持坚果云、Nextcloud、群晖等任何 WebDAV 服务）
4. 点击 测试连接 验证配置
5. 点击 保存配置 保存到本地
6. 使用 上传备份 / 同步备份 进行跨设备同步

以下为原版 farion1231/cc-switch 的功能说明。

Main Interface	Add Provider

Core Capabilities

• Provider Management: One-click switching between Claude Code, Codex, and Gemini API configurations
• MCP Server Management: Unified MCP server panel for Claude / Codex / Gemini
• Skills Management: Auto-scan and install Claude skills from GitHub repositories
• Prompts Management: Multi-preset system prompt management with Markdown editor
• Speed Testing: Measure API endpoint latency with visual quality indicators
• Import/Export: Backup and restore configs (SQL) with auto-rotation
• i18n Support: Chinese / English / Japanese localization
• Deep Link Protocol: ccswitch:// one-click import provider configs

System Features

• System tray with quick switching
• Single instance daemon
• Built-in auto-updater
• Atomic writes with rollback protection
• Auto launch on startup

• Windows: Windows 10+
• macOS: macOS 10.15 (Catalina)+
• Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+

Download the latest .msi installer or portable .zip from the Releases page.

# Homebrew (upstream)
brew tap farion1231/ccswitch
brew install --cask cc-switch

Or download CC-Switch-v{version}-macOS.zip from Releases.

Note: You may see an "unidentified developer" warning. Go to "System Settings" → "Privacy & Security" → "Open Anyway".

Download from Releases:

• .deb (Debian/Ubuntu)
• .rpm (Fedora/RHEL/openSUSE)
• .AppImage (Universal)

1. Add Provider: Click "Add Provider" → Choose preset or create custom configuration
2. Switch Provider: Select provider → Click "Enable" (or use system tray)
3. Takes Effect: Restart your terminal or AI CLI client
4. Back to Official: Select the "Official Login" preset, restart client, follow login flow

Claude Code: ~/.claude/settings.json · MCP: ~/.claude.json Codex: ~/.codex/auth.json + config.toml · MCP: ~/.codex/config.toml Gemini: ~/.gemini/.env + settings.json · MCP: ~/.gemini/settings.json CC Switch: ~/.cc-switch/cc-switch.db (SQLite) + ~/.cc-switch/settings.json

┌─────────────────────────────────────────────────────────────┐
│                    Frontend (React + TS)                    │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │ Components  │  │    Hooks     │  │  TanStack Query  │    │
│  │   (UI)      │──│ (Bus. Logic) │──│   (Cache/Sync)   │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└────────────────────────┬────────────────────────────────────┘
                         │ Tauri IPC
┌────────────────────────▼────────────────────────────────────┐
│                  Backend (Tauri + Rust)                     │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐    │
│  │  Commands   │  │   Services   │  │  Models/Config   │    │
│  │ (API Layer) │──│ (Bus. Layer) │──│     (Data)       │    │
│  └─────────────┘  └──────────────┘  └──────────────────┘    │
└─────────────────────────────────────────────────────────────┘

Frontend: React 18 · TypeScript · Vite · TailwindCSS · TanStack Query v5 · react-i18next · shadcn/ui · @dnd-kit

Backend: Tauri 2.8 · Rust · serde · tokio · reqwest · thiserror

Testing: vitest · MSW · @testing-library/react

# Install dependencies
pnpm install

# Dev mode (hot reload)
pnpm dev

# Type check
pnpm typecheck

# Run frontend tests
pnpm test:unit

# Build application
pnpm build

├── src/                      # Frontend (React + TypeScript)
│   ├── components/           # UI components
│   ├── hooks/                # Custom hooks (business logic)
│   ├── lib/api/              # Tauri API wrappers
│   ├── i18n/locales/         # Translations (zh/en/ja)
│   └── config/               # Presets (providers/mcp)
├── src-tauri/                # Backend (Rust)
│   └── src/
│       ├── commands/         # Tauri commands (incl. webdav.rs)
│       ├── services/         # Business logic
│       ├── database/         # DAO + webdav_sync.rs
│       └── lib.rs            # App entry
└── tests/                    # Frontend tests

Issues and PRs are welcome! Before submitting:

pnpm typecheck      # Type check
pnpm format:check   # Format check
pnpm test:unit      # Unit tests

• Original project: farion1231/cc-switch
• All upstream contributors

MIT © Jason Young (original) · Fork maintained by ShadowHunt-yi