# CC Switch v3.7.1

> 稳定性增强与用户体验改进

**[English Version →](v3.7.1-en.md)**

---

## v3.7.1 更新内容

**发布日期**：2025-11-22
**代码变更**：17 个文件，+524 / -81 行

### Bug 修复

- **修复 Skills 第三方仓库安装失败** (#268)
  修复使用自定义子目录的 skills 仓库无法安装的问题，支持类似 `ComposioHQ/awesome-claude-skills` 这样带子目录的仓库

- **修复 Gemini 配置持久化问题**
  解决在 Gemini 表单中编辑 settings.json 后，切换供应商时修改丢失的问题

- **防止对话框意外关闭**
  添加点击遮罩时的保护，避免误操作导致表单数据丢失，影响所有 11 个对话框组件

### 新增功能

- **Gemini 配置目录支持** (#255)
  在设置中添加 Gemini 配置目录选项，支持自定义 `~/.gemini/` 路径

- **ArchLinux 安装支持** (#259)
  添加 AUR 安装方式：`paru -S cc-switch-bin`

### 改进

- **Skills 错误消息国际化增强**
  新增 28+ 条详细错误消息（中英文），提供具体的解决建议，下载超时从 15 秒延长到 60 秒

- **代码格式化**
  应用统一的 Rust 和 TypeScript 代码格式化标准

### 下载

访问 [Releases](https://github.com/farion1231/cc-switch/releases/latest) 下载最新版本

---

## v3.7.0 完整更新说明

> 从供应商切换器到 AI CLI 一体化管理平台

**发布日期**：2025-11-19
**提交数量**：从 v3.6.0 开始 85 个提交
**代码变更**：152 个文件，+18,104 / -3,732 行

---

## 新增功能

### Gemini CLI 集成

完整支持 Google Gemini CLI，成为第三个支持的应用（Claude Code、Codex、Gemini）。

**核心能力**：

- **双文件配置** - 同时支持 `.env` 和 `settings.json` 格式
- **自动检测** - 自动检测 `GOOGLE_GEMINI_BASE_URL`、`GEMINI_MODEL` 等环境变量
- **完整 MCP 支持** - 为 Gemini 提供完整的 MCP 服务器管理
- **深度链接集成** - 通过 `ccswitch://` 协议导入配置
- **系统托盘** - 从托盘菜单快速切换

**供应商预设**：

- **Google Official** - 支持 OAuth 认证
- **PackyCode** - 合作伙伴集成
- **自定义** - 完全自定义支持

**技术实现**：

- 新增后端模块：`gemini_config.rs`（20KB）、`gemini_mcp.rs`
- 表单与环境编辑器同步
- 双文件原子写入

---

### MCP v3.7.0 统一架构

MCP 管理系统完整重构，实现跨应用统一管理。

**架构改进**：

- **统一管理面板** - 单一界面管理 Claude/Codex/Gemini MCP 服务器
- **SSE 传输类型** - 新增 Server-Sent Events 支持
- **智能解析器** - 容错性 JSON 解析
- **格式修正** - 自动修复 Codex `[mcp_servers]` 格式
- **扩展字段** - 保留自定义 TOML 字段

**用户体验**：

- 表单中的默认应用选择
- JSON 格式化器用于验证
- 改进的视觉层次
- 更好的错误消息

**导入/导出**：

- 统一从三个应用导入
- 双向同步
- 状态保持

---

### Claude Skills 管理系统

**约 2,000 行代码** - 完整的技能生态平台。

**GitHub 集成**：

- 从 GitHub 仓库自动扫描技能
- 预配置仓库：
  - `ComposioHQ/awesome-claude-skills` - 精选集合
  - `anthropics/skills` - Anthropic 官方技能
  - `cexll/myclaude` - 社区贡献
- 添加自定义仓库
- 子目录扫描支持（`skillsPath`）

**生命周期管理**：

- **发现** - 自动检测 `SKILL.md` 文件
- **安装** - 一键安装到 `~/.claude/skills/`
- **卸载** - 安全移除并跟踪状态
- **更新** - 检查更新（基础设施已就绪）

**技术架构**：

- **后端**：`SkillService`（526 行）集成 GitHub API
- **前端**：SkillsPage、SkillCard、RepoManager
- **UI 组件**：Badge、Card、Table（shadcn/ui）
- **状态**：持久化存储在 `config.json`
- **国际化**：47+ 个翻译键

---

### Prompts 管理系统

**约 1,300 行代码** - 完整的系统提示词管理。

**多预设管理**：

- 创建无限数量的提示词预设
- 快速在预设间切换
- 同时只能激活一个提示词
- 活动提示词删除保护

**跨应用支持**：

- **Claude**：`~/.claude/CLAUDE.md`
- **Codex**：`~/.codex/AGENTS.md`
- **Gemini**：`~/.gemini/GEMINI.md`

**Markdown 编辑器**：

- 完整的 CodeMirror 6 集成
- 语法高亮
- 暗色主题（One Dark）
- 实时预览

**智能同步**：

- **自动写入** - 立即写入 live 文件
- **回填保护** - 切换前保存当前内容
- **自动导入** - 首次启动从 live 文件导入
- **修改保护** - 保留手动修改

**技术实现**：

- **后端**：`PromptService`（213 行）
- **前端**：PromptPanel（177）、PromptFormModal（160）、MarkdownEditor（159）
- **Hooks**：usePromptActions（152 行）
- **国际化**：41+ 个翻译键

---

### 深度链接协议（ccswitch://）

通过 URL 方案一键导入供应商配置。

**功能特性**：

- 所有平台的协议注册
- 从共享链接导入
- 生命周期集成
- 安全验证

---

### 环境变量冲突检测

智能检测和管理配置冲突。

**检测范围**：

- **Claude & Codex** - 跨应用冲突
- **Gemini** - 自动发现
- **MCP** - 服务器配置冲突

**管理功能**：

- 可视化冲突指示器
- 解决建议
- 覆盖警告
- 更改前备份

---

## 改进优化

### 供应商管理

**新增预设**：

- **DouBaoSeed** - 字节跳动的豆包
- **Kimi For Coding** - 月之暗面
- **BaiLing** - 百灵 AI
- **移除 AnyRouter** - 避免误导

**增强功能**：

- Codex 和 Gemini 的模型名称配置
- 供应商备注字段用于组织
- 增强的预设元数据

### 配置管理

- **通用配置迁移** - 从 localStorage 迁移到 `config.json`
- **统一持久化** - 跨所有应用共享
- **自动导入** - 首次启动配置导入
- **回填优先级** - 正确处理 live 文件

### UI/UX 改进

**设计系统**：

- **macOS 原生** - 与系统对齐的配色方案
- **窗口居中** - 默认居中位置
- **视觉优化** - 改进的间距和层次

**交互优化**：

- **密码输入** - 修复 Edge/IE 显示按钮
- **URL 溢出** - 修复卡片溢出
- **错误复制** - 可复制到剪贴板的错误
- **托盘同步** - 实时拖放同步

---

## Bug 修复

### 关键修复

- **用量脚本验证** - 边界检查
- **Gemini 验证** - 放宽约束
- **TOML 解析** - CJK 引号处理
- **MCP 字段** - 自定义字段保留
- **白屏** - FormLabel 崩溃修复

### 稳定性

- **托盘安全** - 模式匹配替代 unwrap
- **错误隔离** - 托盘失败不阻塞操作
- **导入分类** - 正确的类别分配

### UI 修复

- **模型占位符** - 移除误导性提示
- **Base URL** - 第三方供应商自动填充
- **拖拽排序** - 托盘菜单同步

---

## 技术改进

### 架构

**MCP v3.7.0**：

- 移除遗留代码（约 1,000 行）
- 统一初始化结构
- 保持向后兼容性
- 全面的代码格式化

**平台兼容性**：

- Windows winreg API 修复（v0.52）
- 安全模式匹配（无 `unwrap()`）
- 跨平台托盘处理

### 配置

**同步机制**：

- 跨所有应用的 MCP 同步
- Gemini 表单-编辑器同步
- 双文件读取（.env + settings.json）

**验证增强**：

- 输入边界检查
- TOML 引号规范化（CJK）
- 自定义字段保留
- 增强的错误消息

### 代码质量

**类型安全**：

- 完整的 TypeScript 覆盖
- Rust 类型改进
- API 契约验证

**测试**：

- 简化的断言
- 更好的测试覆盖
- 集成测试更新

**依赖项**：

- Tauri 2.8.x
- Rust：`anyhow`、`zip`、`serde_yaml`、`tempfile`
- 前端：CodeMirror 6 包
- winreg 0.52（Windows）

---

## 技术统计

```
总体变更：
- 提交数：85
- 文件数：152 个文件变更
- 新增：+18,104 行
- 删除：-3,732 行

新增模块：
- Skills 管理：2,034 行（21 个文件）
- Prompts 管理：1,302 行（20 个文件）
- Gemini 集成：约 1,000 行
- MCP 重构：约 3,000 行重构

代码分布：
- 后端（Rust）：约 4,500 行新增
- 前端（React）：约 3,000 行新增
- 配置：约 1,500 行重构
- 测试：约 500 行
```

---

## 战略定位

### 从工具到平台

v3.7.0 代表了 CC Switch 定位的转变：

| 方面     | v3.6           | v3.7.0                  |
| -------- | -------------- | ----------------------- |
| **身份** | 供应商切换器   | AI CLI 管理平台         |
| **范围** | 配置管理       | 生态系统管理            |
| **应用** | Claude + Codex | Claude + Codex + Gemini |
| **能力** | 切换配置       | 扩展能力（Skills）      |
| **定制** | 手动编辑       | 可视化管理（Prompts）   |
| **集成** | 孤立应用       | 统一管理（MCP）         |

### AI CLI 管理六大支柱

1. **配置管理** - 供应商切换和管理
2. **能力扩展** - Skills 安装和生命周期
3. **行为定制** - 系统提示词预设
4. **生态集成** - 深度链接和共享
5. **多 AI 支持** - Claude/Codex/Gemini
6. **智能检测** - 冲突预防

---

## 下载与安装

### 系统要求

- **Windows**：Windows 10+
- **macOS**：macOS 10.15（Catalina）+
- **Linux**：Ubuntu 22.04+ / Debian 11+ / Fedora 34+ / ArchLinux

### 下载链接

访问 [Releases](https://github.com/farion1231/cc-switch/releases/latest) 下载：

- **Windows**：`CC-Switch-Windows.msi` 或 `-Portable.zip`
- **macOS**：`CC-Switch-macOS.tar.gz` 或 `.zip`
- **Linux**：`CC-Switch-Linux.AppImage` 或 `.deb`
- **ArchLinux**：`paru -S cc-switch-bin`

### Homebrew（macOS）

```bash
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

更新：

```bash
brew upgrade --cask cc-switch
```

---

## 迁移说明

### 从 v3.6.x 升级

**自动迁移** - 无需任何操作，配置完全兼容

### 从 v3.1.x 或更早版本升级

**需要两步迁移**：

1. 首先升级到 v3.2.x（执行一次性迁移）
2. 然后升级到 v3.7.0

### 新功能

- **Skills**：无需迁移，全新开始
- **Prompts**：首次启动时从 live 文件自动导入
- **Gemini**：需要单独安装 Gemini CLI
- **MCP v3.7.0**：与之前的配置向后兼容

---

## 致谢

### 贡献者

感谢所有让这个版本成为可能的贡献者：

- [@YoVinchen](https://github.com/YoVinchen) - Skills & Prompts & Gemini 集成实现
- [@farion1231](https://github.com/farion1231) - 从开发沦为 issue 回复机
- 社区成员的测试和反馈

### 赞助商

**智谱AI** - GLM CODING PLAN 赞助商
[使用此链接购买可享九折优惠](https://www.bigmodel.cn/claude-code?ic=RRVJPB5SII)

**PackyCode** - API 中转服务合作伙伴
[使用 "cc-switch" 优惠码注册享 9 折优惠](https://www.packyapi.com/register?aff=cc-switch)

**闪电说** - 本地优先的 AI 语音输入法
[免费下载](https://shandianshuo.cn) Mac/Win 双平台

---

## 反馈与支持

- **问题反馈**：[GitHub Issues](https://github.com/farion1231/cc-switch/issues)
- **讨论**：[GitHub Discussions](https://github.com/farion1231/cc-switch/discussions)
- **文档**：[README](../README_ZH.md)
- **更新日志**：[CHANGELOG.md](../CHANGELOG.md)

---

## 未来展望

**v3.8.0 预览**（暂定）：

- 本地代理功能

敬请期待更多更新！

---

**Happy Coding!**
