d65513ae7d
Add release notes for v3.7.1 maintenance release, with v3.7.1 updates at top and complete v3.7.0 documentation below. **v3.7.1 Updates**: - Bug Fixes: Skills installation, Gemini config persistence, dialog overlay protection - New Features: Gemini config directory support, ArchLinux installation - Improvements: Skills error i18n enhancement (28+ keys), code formatting **v3.7.0 Complete Documentation**: - Six major features (Gemini CLI, MCP v3.7.0, Skills, Prompts, Deep Link, Conflict Detection) - Technical statistics (152 files, +18,104 / -3,732 lines) - Strategic positioning shift: Provider Switcher → AI CLI Management Platform Files: - docs/release-note-v3.7.1-zh.md (Chinese) - docs/release-note-v3.7.1-en.md (English)
482 lines
11 KiB
Markdown
482 lines
11 KiB
Markdown
# CC Switch v3.7.1
|
||
|
||
> 稳定性增强与用户体验改进
|
||
|
||
**[English Version →](release-note-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!**
|