mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-23 01:14:51 +08:00
0fcb1b01e2
* docs: add user manual documentation Add comprehensive user manual covering getting started, provider management, extensions (MCP/prompts/skills), proxy configuration, and FAQ sections. Includes screenshots and a README index. * fix(docs): align user manual with v3.10.3 codebase - Add OpenCode as 4th supported app throughout all docs - Fix proxy default port 15762 → 15721 - Update Claude presets (9 → 26), Codex (3 → 10), Gemini (3 → 7) - Add OpenCode presets (25 entries) - Fix timeout defaults and ranges (stream first byte 60s/90s, etc.) - Fix circuit breaker defaults with per-app values (Claude vs general) - Fix Skills support: all 4 apps, not just Claude/Codex - Remove non-existent Gemini authMode field - Fix prompt deletion behavior: enabled prompts cannot be deleted - Remove non-existent Legacy deeplink protocol, use V1 only - Fix DB table names (usage_logs → proxy_request_logs) and add missing tables - Fix migration version v3.8.0 → v3.7.0 - Add missing V1 deeplink parameters (config, configFormat, etc.) - Update doc version v3.9.1 → v3.10.3 - Add claude-opus-4-1 to pricing table - Fix recovery wait time range 10-300 → 0-300 --------- Co-authored-by: Jason <farion1231@gmail.com>
65 lines
2.2 KiB
Markdown
65 lines
2.2 KiB
Markdown
# 1.1 软件介绍
|
||
|
||
## 什么是 CC Switch
|
||
|
||
CC Switch 是一款跨平台桌面应用，专为使用 AI 编程工具的开发者设计。它帮助你统一管理 **Claude Code**、**Codex**、**Gemini CLI**、**OpenCode** 四大 AI 编程工具的配置。
|
||
|
||
## 解决什么问题
|
||
|
||
在日常开发中，你可能会遇到这些痛点：
|
||
|
||
- **多供应商切换麻烦**：使用不同的 API 供应商（官方、中转服务商），需要手动修改配置文件
|
||
- **配置分散难管理**：Claude、Codex、Gemini、OpenCode 各有独立的配置文件，格式不同
|
||
- **无法监控用量**：不知道 API 调用了多少次，花了多少钱
|
||
- **服务不稳定**：单一供应商出问题时，整个工作流中断
|
||
|
||
CC Switch 通过统一的界面解决这些问题。
|
||
|
||
## 核心功能
|
||
|
||
### 供应商管理
|
||
- 一键切换多个 API 供应商配置
|
||
- 支持预设模板，快速添加常用供应商
|
||
- 统一供应商功能，跨应用共享配置
|
||
- 用量查询与余额显示
|
||
- 端点速度测试
|
||
|
||
### 扩展功能
|
||
- **MCP 服务器**：管理 Model Context Protocol 服务器，扩展 AI 能力
|
||
- **Prompts**：管理系统提示词预设，快速切换不同场景
|
||
- **Skills**：安装和管理技能扩展
|
||
|
||
### 代理与高可用
|
||
- 本地代理服务，记录请求日志和用量统计
|
||
- 自动故障转移，主供应商失败时自动切换备用
|
||
- 熔断器机制，防止频繁重试失败的供应商
|
||
- 详细的 Token 用量追踪与成本估算
|
||
|
||
## 支持的应用
|
||
|
||
| 应用 | 说明 |
|
||
|------|------|
|
||
| **Claude Code** | Anthropic 官方的 AI 编程助手 |
|
||
| **Codex** | OpenAI 的代码生成工具 |
|
||
| **Gemini CLI** | Google 的 AI 命令行工具 |
|
||
| **OpenCode** | 开源 AI 编程终端工具 |
|
||
|
||
## 支持的平台
|
||
|
||
- **Windows** 10 及以上
|
||
- **macOS** 10.15 (Catalina) 及以上
|
||
- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+
|
||
|
||
## 技术架构
|
||
|
||
CC Switch 使用现代化的技术栈构建：
|
||
|
||
- **前端**：React 18 + TypeScript + Tailwind CSS
|
||
- **后端**：Tauri 2 + Rust
|
||
- **数据存储**：SQLite（供应商、MCP、Prompts）+ JSON（设备设置）
|
||
|
||
这种架构确保了：
|
||
- 跨平台一致的体验
|
||
- 原生级别的性能
|
||
- 安全的本地数据存储
|