docs/release-notes/v3.8.0-zh.md
持久化架构升级，为云同步奠定基础
CC Switch v3.8.0 是一次重大的架构升级版本，重构了数据持久化层和用户界面，为未来的云同步和本地代理功能奠定基础。
发布日期：2025-11-28 提交数量：从 v3.7.1 开始 51 个提交 代码变更：207 个文件，+17,297 / -6,870 行
从单一 JSON 文件存储迁移到 SQLite + JSON 双层架构，实现数据分层管理。
架构变更：
v3.7.x (旧) v3.8.0 (新)
┌─────────────────┐ ┌─────────────────────────────────┐
│ config.json │ │ SQLite (可同步数据) │
│ ┌───────────┐ │ │ ├─ providers 供应商配置 │
│ │ providers │ │ │ ├─ mcp_servers MCP 服务器 │
│ │ mcp │ │ ──> │ ├─ prompts 提示词 │
│ │ prompts │ │ │ ├─ skills 技能 │
│ │ settings │ │ │ └─ settings 通用设置 │
│ └───────────┘ │ ├─────────────────────────────────┤
└─────────────────┘ │ JSON (设备级数据) │
│ └─ settings.json 本地设置 │
│ ├─ 窗口位置 │
│ ├─ 路径覆盖 │
│ └─ 当前选中供应商 ID │
└─────────────────────────────────┘
双层结构设计：
| 层级 | 存储方式 | 数据类型 | 同步策略 |
|---|---|---|---|
| 云同步层 | SQLite | 供应商、MCP、Prompts、Skills | 未来可同步 |
| 设备层 | JSON | 窗口状态、本地路径、当前选择 | 保持本地 |
技术实现：
backup.rs 支持 SQL dump，便于云端存储config.json 迁移数据模块化重构：
database/
├── mod.rs 核心 Database 结构体和初始化
├── schema.rs 表结构定义、Schema 版本迁移
├── backup.rs SQL 导入导出、二进制快照备份
├── migration.rs JSON → SQLite 数据迁移引擎
└── dao/ 数据访问对象层
├── providers.rs 供应商 CRUD
├── mcp.rs MCP 服务器 CRUD
├── prompts.rs 提示词 CRUD
├── skills.rs Skills CRUD
└── settings.rs 键值对设置存储
完整重构的 UI 设计，提供更现代化的视觉体验。
视觉改进：
交互优化：
兼容性调整：
新增日语（日本語）界面支持，国际化语言扩展到三种。
支持语言：
Skills 管理系统支持递归扫描仓库目录，自动发现嵌套的技能文件。
改进内容：
SKILL.md 文件供应商预设支持自定义图标配置。
功能特性：
供应商表单新增必填字段验证，提供更友好的错误提示。
改进内容：
新增开机自动启动功能，支持 Windows、macOS 和 Linux 三个平台。
功能特性：
自定义端点丢失问题
修复更新供应商时自定义请求地址意外丢失的问题。
INSERT OR REPLACE 在 SQLite 底层执行 DELETE + INSERT，触发外键级联删除UPDATE 语句更新已存在的供应商Gemini 配置问题
.env 文件供应商验证问题
Linux
.desktop 文件自定义供应商服务模块化：
services/provider/
├── mod.rs 核心服务 - add/update/delete/switch/validate
├── live.rs Live 配置文件操作
├── gemini_auth.rs Gemini 认证类型检测
├── endpoints.rs 自定义端点管理
└── usage.rs 用量脚本执行
深链接模块化：
deeplink/
├── mod.rs 模块导出
├── parser.rs URL 解析
├── provider.rs 供应商导入逻辑
├── mcp.rs MCP 导入逻辑
├── prompt.rs 提示词导入
├── skill.rs Skills 导入
└── utils.rs 工具函数
清理工作：
测试更新：
总体变更：
- 提交数：51
- 文件数：207 个文件变更
- 新增：+17,297 行
- 删除：-6,870 行
- 净增：+10,427 行
提交类型分布：
- fix：25 个（Bug 修复）
- refactor：11 个（代码重构）
- feat：9 个（新功能）
- test：1 个（测试）
- 其他：5 个
改动区域分布：
- 前端源码：112 个文件
- Rust 后端：63 个文件
- 测试文件：20 个文件
- 国际化文件：3 个文件
自动迁移 - 首次启动时自动执行：
config.json 是否存在settings.json数据安全：
config.json 文件保留不删除config.json访问 Releases 下载：
CC-Switch-v3.8.0-Windows.msi 或 -Portable.zipCC-Switch-v3.8.0-macOS.tar.gz 或 .zipCC-Switch-v3.8.0-Linux.AppImage 或 .debbrew tap farion1231/ccswitch
brew install --cask cc-switch
更新：
brew upgrade --cask cc-switch
感谢所有让这个版本成为可能的贡献者：
智谱AI - GLM CODING PLAN 赞助商 使用此链接购买可享九折优惠
PackyCode - API 中转服务合作伙伴 使用 "cc-switch" 优惠码注册享 9 折优惠
闪电说 - 本地优先的 AI 语音输入法 免费下载 Mac/Win 双平台
MiniMax - MiniMax M2 CODING PLAN 赞助商 黑五优惠进行中，套餐9.9元起
v3.9.0 预览（暂定）：
敬请期待更多更新！
Happy Coding!