新增首次自动配置保存备份配置文件，优化续写逻辑。

Author: sdfggds

README.md

@@ -1,19 +1,45 @@
 # 88code Desktop
 
-88code Claude Code 和 Codex 自动配置工具
+88code Claude Code 和 Codex 配置工具
 
 ## 功能特性
 
-### 1. Claude Code 自动配置
-- 用户输入 Base URL 和 API 密钥
+### 1. Claude Code 配置
+- **自动配置模式**: 快速配置 Base URL 和 API 密钥
+- **高级配置模式**: 自定义完整 JSON 配置内容
 - 自动配置 `~/.claude/settings.json` 文件
+- 支持配置续写，保留现有配置字段
 - 跨平台支持（Windows/macOS/Linux）
 
-### 2. Codex 自动配置
-- 用户输入 API 密钥
+### 2. Code 终端配置
+- 配置环境变量 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN`
+- Windows: 永久设置系统环境变量
+- Linux/macOS: 写入 shell 配置文件（.zshrc/.bashrc）
+- 支持清空配置功能
+
+### 3. Codex 配置
+- **自动配置模式**: 快速配置 API 密钥和 Base URL
+- **高级配置模式**: 自定义 auth.json 和 config.toml 内容
 - 自动配置 `~/.codex/auth.json` 和 `config.toml`
+- 支持配置续写，保留现有配置字段
 - **永久设置环境变量 key88**
 
+### 4. VSCode 扩展配置
+- **Claude 扩展**: 配置 `~/.claude/config.json`
+- **Codex (ChatGPT) 扩展**: 配置 VSCode settings.json
+- 自动检测 VSCode 安装路径（支持 Stable/Insiders/VSCodium）
+
+### 🆕 5. 配置备份功能 (v1.1.0)
+- **首次配置自动备份**: 在修改配置前自动创建 .bak 备份文件
+- **智能备份保护**: 仅首次创建备份，已存在的 .bak 文件不会被覆盖
+- **全面覆盖**: 所有配置文件（Claude/Codex/VSCode/终端）均支持备份
+- **备份位置**:
+  - `~/.claude/settings.json.bak`
+  - `~/.claude/config.json.bak`
+  - `~/.codex/auth.json.bak`
+  - `~/.codex/config.toml.bak`
+  - `[VSCode配置目录]/settings.json.bak`
+
 ## 技术栈
 
 - **前端**: Vue 3.5.13 (Composition API) + Tailwind CSS 4
@@ -84,44 +110,94 @@ Codex 配置会自动设置环境变量 `key88=<您的API密钥>`
 ## 注意事项
 
 1. 首次配置会自动创建配置目录和文件
-2. 如果配置文件已存在，会合并现有配置（Claude Code）或覆盖（Codex）
-3. 配置使用原子写入机制，确保配置文件完整性
-4. API 密钥以密码形式输入，配置成功后会自动清空输入框
+2. **自动备份**: 首次配置前会自动创建 .bak 备份文件，保护原始配置
+3. **配置续写**: 配置文件已存在时，会智能合并现有配置，不会丢失其他字段
+4. 配置使用原子写入机制，确保配置文件完整性
+5. API 密钥以密码形式输入，配置成功后会自动清空输入框
+6. 高级配置支持 JSON/TOML 格式验证，确保配置正确性
 
 ## 项目结构
 
 ```
 88code-desktop/
-├── src/                          # Vue 3 前端代码
-│   ├── components/               # Vue 组件
-│   │   ├── Sidebar.vue          # 侧边栏导航
-│   │   ├── ClaudeConfigPanel.vue # Claude 配置面板
-│   │   ├── CodexConfigPanel.vue  # Codex 配置面板
-│   │   └── Notification.vue      # 通知组件
-│   ├── App.vue                   # 主应用
-│   ├── main.js                   # 入口文件
-│   ├── types.ts                  # TypeScript 类型定义
-│   └── index.css                 # 全局样式
-├── src-tauri/                    # Rust 后端代码
-│   └── src/
-│       ├── config.rs             # 配置路径管理和原子写入
-│       ├── claude_config.rs      # Claude 配置逻辑
-│       ├── codex_config.rs       # Codex 配置逻辑
-│       ├── env_manager.rs        # 环境变量管理
-│       ├── commands.rs           # Tauri 命令
-│       └── lib.rs                # 主模块
-├── package.json                  # 前端依赖
-├── Cargo.toml                    # Rust 依赖
-└── README.md                     # 项目说明
+├── src/                                 # Vue 3 前端代码
+│   ├── components/                      # Vue 组件
+│   │   ├── icons/                       # 图标组件
+│   │   │   ├── ClaudeIcon.vue           # Claude 图标
+│   │   │   ├── CodexIcon.vue            # Codex 图标
+│   │   │   ├── VSCodeIcon.vue           # VSCode 图标
+│   │   │   ├── JetBrainsIcon.vue        # JetBrains 图标
+│   │   │   └── TerminalIcon.vue         # 终端图标
+│   │   ├── Sidebar.vue                  # 侧边栏导航
+│   │   ├── TabButton.vue                # 标签按钮组件
+│   │   ├── ClaudeConfigPanel.vue        # Claude Code 配置面板
+│   │   ├── CodexConfigPanel.vue         # Codex 配置面板
+│   │   ├── AdvancedConfigModal.vue      # 高级配置模态框
+│   │   └── Notification.vue             # 通知组件
+│   ├── assets/                          # 静态资源
+│   │   └── vue.svg                      # Vue logo
+│   ├── App.vue                          # 主应用组件
+│   ├── main.js                          # Vue 应用入口
+│   ├── types.ts                         # TypeScript 类型定义
+│   └── index.css                        # Tailwind CSS 全局样式
+├── src-tauri/                           # Rust 后端代码
+│   ├── src/
+│   │   ├── config.rs                    # 配置路径管理、原子写入、备份功能
+│   │   ├── claude_config.rs             # Claude Code 配置逻辑
+│   │   ├── codex_config.rs              # Codex 配置逻辑
+│   │   ├── vscode.rs                    # VSCode 扩展配置逻辑
+│   │   ├── env_manager.rs               # 环境变量管理（终端配置）
+│   │   ├── commands.rs                  # Tauri 命令定义
+│   │   ├── lib.rs                       # 库主模块
+│   │   └── main.rs                      # 应用入口
+│   ├── icons/                           # 应用图标资源
+│   ├── capabilities/                    # Tauri 权限配置
+│   ├── Cargo.toml                       # Rust 依赖配置
+│   └── tauri.conf.json                  # Tauri 应用配置
+├── public/                              # 静态资源
+│   ├── tauri.svg
+│   └── vite.svg
+├── package.json                         # Node.js 依赖配置
+├── vite.config.js                       # Vite 构建配置
+├── tailwind.config.js                   # Tailwind CSS 配置
+├── index.html                           # HTML 入口
+└── README.md                            # 项目文档
 ```
 
 ## 许可证
 
 MIT
 
-## 版本
+## 版本历史
+
+### v1.1.0 (2025-10-05)
+
+
+- 🆕 新增配置备份功能，首次配置自动创建 .bak 备份文件
+
+- ✨ 智能备份保护，已存在的备份不会被覆盖
+
+- 📦 全面支持所有配置文件的备份（Claude/Codex/VSCode/终端）
+
+- 🔧 优化配置续写逻辑，确保不破坏原有配置
+
+### v1.0.0 (2025-10-04)
+
+- ✅ Claude Code 自动配置
+- ✅ Codex 自动配置
+- ✅ Code 终端环境变量配置
+- ✅ VSCode 扩展配置
+- ✅ 高级配置模式
+- ✅ 官方图标
+- ✅ 跨平台支持（Windows/macOS/Linux）
+
+### v0.1.0 (2025-10-01)
 
-1.0.0
+- ✅ Claude Code 自动配置
+- ✅ Codex 自动配置
+- ✅ Code 终端环境变量配置
+- ✅ VSCode 扩展配置
+- ✅ 跨平台支持（Windows/macOS/Linux）
 
 ---
 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "88code-desktop",
   "private": true,
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "description": "88code Claude Code & Codex 配置工具",
   "scripts": {

src-tauri/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "code-desktop"
-version = "1.0.0"
+version = "1.1.0"
 description = "88code Claude Code & Codex 配置工具"
 authors = ["88code"]
 edition = "2021"

src-tauri/Cargo.toml

@@ -36,6 +36,9 @@ impl Default for ClaudeSettings {
 pub fn configure_claude_code(base_url: String, api_key: String) -> Result<(), String> {
     let settings_path = get_claude_settings_path();
 
+    // 首次配置前创建备份
+    crate::config::create_backup_if_not_exists(&settings_path)?;
+
     // 读取现有配置JSON并提取未知字段（使用Vec保持顺序）
     let mut extra_env = Vec::new();
     let mut extra_root = Vec::new();
@@ -135,6 +138,9 @@ pub fn get_claude_config() -> Result<ClaudeSettings, String> {
 pub fn configure_claude_advanced(config_content: String) -> Result<(), String> {
     let settings_path = get_claude_settings_path();
 
+    // 首次配置前创建备份
+    crate::config::create_backup_if_not_exists(&settings_path)?;
+
     // 验证JSON格式
     let new_config: Value = serde_json::from_str(&config_content)
         .map_err(|e| format!("配置内容格式错误: {}", e))?;

src-tauri/src/claude_config.rs

@@ -1,4 +1,4 @@
-use crate::config::{get_codex_auth_path, get_codex_config_path, write_json_file};
+use crate::config::{get_codex_auth_path, get_codex_config_path};
 use serde::{Deserialize, Serialize};
 use serde_json::Value;
 use std::collections::HashMap;
@@ -41,6 +41,10 @@ pub fn configure_codex(base_url: String, api_key: String) -> Result<(), String>
     let auth_path = get_codex_auth_path();
     let config_path = get_codex_config_path();
 
+    // 首次配置前创建备份
+    crate::config::create_backup_if_not_exists(&auth_path)?;
+    crate::config::create_backup_if_not_exists(&config_path)?;
+
     // 读取现有 auth.json，提取所有字段（使用Vec保持顺序）
     let mut extra_fields = Vec::new();
 
@@ -216,6 +220,10 @@ pub fn configure_codex_advanced(
     let auth_path = get_codex_auth_path();
     let config_path = get_codex_config_path();
 
+    // 首次配置前创建备份
+    crate::config::create_backup_if_not_exists(&auth_path)?;
+    crate::config::create_backup_if_not_exists(&config_path)?;
+
     // 验证并解析 auth.json
     let new_auth_value: Value = serde_json::from_str(&auth_json)
         .map_err(|e| format!("auth.json 格式错误: {}", e))?;

src-tauri/src/codex_config.rs

@@ -142,3 +142,33 @@ pub fn get_config_paths_info() -> ConfigPaths {
         codex_config: get_codex_config_path().to_string_lossy().to_string(),
     }
 }
+
+/// 创建备份文件(仅在.bak文件不存在时创建)
+/// 返回 Ok(true) 表示创建了备份, Ok(false) 表示备份已存在
+pub fn create_backup_if_not_exists(file_path: &Path) -> Result<bool, String> {
+    // 如果原文件不存在,无需备份
+    if !file_path.exists() {
+        return Ok(false);
+    }
+
+    // 生成备份文件路径
+    let backup_path = file_path.with_extension(
+        format!("{}.bak", file_path.extension()
+            .and_then(|s| s.to_str())
+            .unwrap_or("")
+        ).trim_start_matches('.')
+    );
+
+    // 如果备份文件已存在,不再覆盖
+    if backup_path.exists() {
+        log::info!("备份文件已存在,跳过: {:?}", backup_path);
+        return Ok(false);
+    }
+
+    // 创建备份
+    fs::copy(file_path, &backup_path)
+        .map_err(|e| format!("创建备份文件失败: {}", e))?;
+
+    log::info!("首次备份成功: {:?} -> {:?}", file_path, backup_path);
+    Ok(true)
+}

src-tauri/src/config.rs

@@ -226,6 +226,9 @@ pub fn configure_vscode_claude(api_key: String, _base_url: String) -> Result<Str
     let config_dir = get_claude_config_dir();
     let config_path = config_dir.join("config.json");
 
+    // 首次配置前创建备份
+    crate::config::create_backup_if_not_exists(&config_path)?;
+
     // 3. 创建配置内容
     let config_content = json!({
         "primaryApiKey": api_key
@@ -245,6 +248,8 @@ pub fn configure_vscode_claude(api_key: String, _base_url: String) -> Result<Str
 pub fn configure_vscode_codex(base_url: String, api_key: String) -> Result<String, String> {
     // 查找或创建 settings.json 路径
     let settings_path = if let Some(path) = find_existing_settings() {
+        // 首次配置前创建备份
+        crate::config::create_backup_if_not_exists(&path)?;
         path
     } else {
         // 如果找不到现有配置，使用第一个候选路径（通常是 Code Stable）

src-tauri/src/vscode.rs

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "code-desktop",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "identifier": "com.88code.desktop",
   "build": {
     "beforeDevCommand": "pnpm dev",