aihezu 1.7.1 → 1.8.0

package/INSTALL_USAGE.md

@@ -0,0 +1,152 @@
+# aihezu install 使用说明
+
+## 功能概述
+
+`npx aihezu install` 命令现在是完全交互式的，支持配置 Claude 和 Codex 服务。
+
+## 使用方式
+
+### 1. 基本用法（无参数）
+
+```bash
+npx aihezu install
+```
+
+交互流程：
+1. 选择服务类型（Claude / Codex）
+2. 输入 API 地址（显示系统默认值，可直接回车使用）
+3. 选择模型（仅 Codex）
+4. 输入 API Key
+5. 查看配置摘要并确认
+6. 自动备份现有配置
+7. 自动清理缓存
+8. 写入新配置
+
+**示例输出：**
+```
+🔧 Claude / Codex API 配置工具
+🌐 Powered by https://aihezu.dev
+
+请选择服务类型 [1] Claude (默认) / [2] Codex: 1
+
+✅ 已选择服务: Claude
+
+💡 Claude 默认 API 地址: https://cc.aihezu.dev/api
+请输入 API 地址（直接回车使用默认地址）:
+✅ API 地址: https://cc.aihezu.dev/api
+...
+```
+
+### 2. 带参数用法（推荐）
+
+#### Claude 企业域名
+
+```bash
+npx aihezu install --api hk.aihezu.dev
+```
+
+**交互提示：**
+```
+✅ 已选择服务: Claude
+
+💡 检测到命令行参数，默认 API 地址: https://hk.aihezu.dev/api
+请输入 API 地址（直接回车使用默认地址）:
+```
+
+此时用户可以：
+- **直接回车**：使用命令行参数 `https://hk.aihezu.dev/api`
+- **输入其他值**：覆盖命令行参数
+
+#### Codex 企业域名
+
+```bash
+npx aihezu install --provider codex --api hk.aihezu.dev
+```
+
+**交互提示：**
+```
+✅ 已选择服务: Codex
+
+💡 检测到命令行参数，默认 API 地址: https://hk.aihezu.dev/openai
+请输入 API 地址（直接回车使用默认地址）:
+
+请选择模型:
+  [1] gpt-5-codex (默认)
+  [2] claude-sonnet-4.5
+  [3] 自定义模型名称
+请选择 [1/2/3]:
+```
+
+## 参数优先级
+
+对于 API 地址配置：
+
+1. **用户交互输入** > 命令行参数 > 系统默认值
+2. 如果带了 `--api` 参数，会将参数值作为默认值显示给用户
+3. 用户可以直接回车使用这个默认值，也可以输入新值覆盖
+
+## 配置摘要示例
+
+```
+=== 配置摘要 ===
+服务类型: Claude
+API 地址: https://hk.aihezu.dev/api
+API Key: sk-ant-123...xyz
+
+⚠️  即将执行以下操作:
+  1. 备份现有配置文件
+  2. 清理缓存数据
+  3. 写入新的配置
+  4. 修改 hosts 文件
+
+是否继续？(y/n):
+```
+
+## 自动备份
+
+无论是否首次使用，每次运行都会：
+- 自动备份现有配置文件（如果存在）
+- 备份文件命名格式：`原文件名.backup-时间戳`
+- 示例：`settings.json.backup-2024-12-10T08-30-45-123Z`
+
+## 模型选择（Codex）
+
+Codex 用户可以选择：
+1. `gpt-5-codex`（默认）
+2. `claude-sonnet-4.5`
+3. 自定义模型名称
+
+## 完整示例
+
+### 场景 1：企业用户首次配置 Claude
+
+```bash
+npx aihezu install --api company.aihezu.dev
+```
+
+只需要：
+1. 直接回车确认企业域名
+2. 输入 API Key
+3. 确认配置摘要
+4. 等待完成
+
+### 场景 2：切换到 Codex 服务
+
+```bash
+npx aihezu install --provider codex
+```
+
+1. 系统识别 Codex 服务
+2. 显示默认地址 `https://cc.aihezu.dev/openai`
+3. 选择模型
+4. 输入 API Key
+5. 自动备份 Claude 配置
+6. 完成切换
+
+### 场景 3：完全自定义配置
+
+```bash
+npx aihezu install
+```
+
+交互式输入所有选项，完全自定义。

package/bin/ccinstall.js

@@ -147,11 +147,6 @@ function writeClaudeSettings(apiKey, apiBaseUrl) {
       settings = JSON.parse(content);
     } catch (e) {
       console.log('⚠️  现有配置文件格式错误，将创建新的配置');
-      // 备份错误的配置文件
-      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-      const backupPath = `${claudeSettingsPath}.backup-${timestamp}`;
-      fs.writeFileSync(backupPath, content);
-      console.log(`📦 已备份原配置文件到: ${path.basename(backupPath)}`);
     }
   }
 
@@ -172,32 +167,87 @@ function writeClaudeSettings(apiKey, apiBaseUrl) {
   console.log('  ANTHROPIC_BASE_URL:', apiBaseUrl);
 }
 
-function writeCodexConfig(apiKey, codexBaseUrl) {
+function writeCodexConfig(apiKey, codexBaseUrl, modelName = 'gpt-5-codex') {
   if (!fs.existsSync(codexDir)) {
     console.log('📁 创建 ~/.codex 目录...');
     fs.mkdirSync(codexDir, { recursive: true });
   }
 
-  const configBackup = backupFile(codexConfigPath);
-  if (configBackup) {
-    console.log(`📦 已备份原配置文件到: ${path.basename(configBackup)}`);
-  }
+  let configContent = '';
+  let existingConfig = '';
+  let providerName = 'aihezu';  // 默认 provider 名称
+
+  // 读取现有配置
+  if (fs.existsSync(codexConfigPath)) {
+    console.log('📖 读取现有 Codex 配置文件...');
+    existingConfig = fs.readFileSync(codexConfigPath, 'utf8');
+
+    // 提取现有的 provider 名称
+    const providerMatch = existingConfig.match(/model_provider\s*=\s*"([^"]+)"/);
+    if (providerMatch) {
+      providerName = providerMatch[1];
+      console.log(`ℹ️  检测到现有 provider: ${providerName}`);
+    }
+
+    // 更新 model
+    const modelPattern = /^model\s*=\s*"[^"]*"/m;
+    if (modelPattern.test(existingConfig)) {
+      existingConfig = existingConfig.replace(modelPattern, `model = "${modelName}"`);
+      console.log('✏️  已更新模型配置');
+    }
 
-  const configContent = [
-    'model_provider = "aihezu"',
-    'model = "gpt-5-codex"',
-    'model_reasoning_effort = "high"',
-    'disable_response_storage = true',
-    'preferred_auth_method = "apikey"',
-    '',
-    '[model_providers.aihezu]',
-    'name = "aihezu"',
-    `base_url = "${codexBaseUrl}"`,
-    'wire_api = "responses"',
-    'requires_openai_auth = true',
-    'env_key = "AIHEZU_OAI_KEY"',
-    ''
-  ].join('\n');
+    // 更新 base_url
+    const baseUrlPattern = new RegExp(
+      `(\\[model_providers\\.${providerName}\\][\\s\\S]*?base_url\\s*=\\s*)"[^"]*"`,
+      'm'
+    );
+
+    if (baseUrlPattern.test(existingConfig)) {
+      // 如果找到了 base_url，就替换它
+      configContent = existingConfig.replace(baseUrlPattern, `$1"${codexBaseUrl}"`);
+      console.log('✏️  已更新现有配置中的 base_url');
+    } else {
+      // 如果没有找到完整的 provider 配置，尝试添加或创建
+      const providerSectionPattern = new RegExp(`\\[model_providers\\.${providerName}\\]`, 'm');
+
+      if (providerSectionPattern.test(existingConfig)) {
+        // provider section 存在但没有 base_url，添加 base_url
+        configContent = existingConfig.replace(
+          providerSectionPattern,
+          `[model_providers.${providerName}]\nbase_url = "${codexBaseUrl}"`
+        );
+        console.log('✏️  已在现有 provider 配置中添加 base_url');
+      } else {
+        // 完全没有这个 provider，保留现有配置并追加新的
+        configContent = existingConfig.trim() + '\n\n' +
+          `[model_providers.${providerName}]\n` +
+          `name = "${providerName}"\n` +
+          `base_url = "${codexBaseUrl}"\n` +
+          `wire_api = "responses"\n` +
+          `requires_openai_auth = true\n` +
+          `env_key = "AIHEZU_OAI_KEY"\n`;
+        console.log('✏️  已追加新的 provider 配置');
+      }
+    }
+  } else {
+    // 文件不存在，创建新配置
+    console.log('📝 创建新的 Codex 配置文件...');
+    configContent = [
+      'model_provider = "aihezu"',
+      `model = "${modelName}"`,
+      'model_reasoning_effort = "high"',
+      'disable_response_storage = true',
+      'preferred_auth_method = "apikey"',
+      '',
+      '[model_providers.aihezu]',
+      'name = "aihezu"',
+      `base_url = "${codexBaseUrl}"`,
+      'wire_api = "responses"',
+      'requires_openai_auth = true',
+      'env_key = "AIHEZU_OAI_KEY"',
+      ''
+    ].join('\n');
+  }
 
   fs.writeFileSync(codexConfigPath, configContent, 'utf8');
 
@@ -207,13 +257,12 @@ function writeCodexConfig(apiKey, codexBaseUrl) {
       const content = fs.readFileSync(codexAuthPath, 'utf8');
       authData = JSON.parse(content);
     } catch (e) {
-      const backupPath = backupFile(codexAuthPath);
-      console.log('⚠️  现有 auth.json 解析失败，已备份旧文件:', backupPath ? path.basename(backupPath) : '未备份');
+      console.log('⚠️  现有 auth.json 解析失败，将创建新文件');
       authData = {};
     }
   }
 
-  authData.OPENAI_API_KEY = null;
+  // 只设置 AIHEZU_OAI_KEY，不修改其他环境变量
   authData.AIHEZU_OAI_KEY = apiKey;
 
   fs.writeFileSync(codexAuthPath, JSON.stringify(authData, null, 2), 'utf8');
@@ -224,10 +273,13 @@ function writeCodexConfig(apiKey, codexBaseUrl) {
   console.log('  -', codexConfigPath);
   console.log('  -', codexAuthPath);
   console.log('\n配置内容:');
-  console.log('  AIHEZU_OAI_KEY:', apiKey);
-  console.log('  base_url:', codexBaseUrl);
-  console.log('\n💡 已在 auth.json 中写入密钥，并在 config.toml 中指定 env_key = "AIHEZU_OAI_KEY"');
-  console.log('   如需在 shell 中直接使用，可运行: export AIHEZU_OAI_KEY="<你的密钥>"');
+  console.log('  环境变量名: AIHEZU_OAI_KEY');
+  console.log('  API 密钥:', apiKey);
+  console.log('  API 地址:', codexBaseUrl);
+  console.log('\n💡 Codex 会自动从 auth.json 中读取 AIHEZU_OAI_KEY');
+  console.log('   如果遇到认证问题，请确保:');
+  console.log('   1. auth.json 文件存在且格式正确');
+  console.log('   2. 或者在终端中手动设置: export AIHEZU_OAI_KEY="' + apiKey + '"');
 }
 
 async function main() {
@@ -240,6 +292,7 @@ async function main() {
   });
 
   try {
+    // 1. 选择服务类型
     const cliProviderInput = parseProviderArg(cliArgs);
     let provider = resolveProvider(cliProviderInput);
 
@@ -248,76 +301,161 @@ async function main() {
       provider = resolveProvider(providerAnswer);
     }
 
-    const apiBaseInput = provider === PROVIDERS.CLAUDE ? parseApiBaseInput(cliArgs) : '';
-    const codexBaseInput = provider === PROVIDERS.CODEX ? parseApiBaseInput(cliArgs) : '';
+    console.log(`\n✅ 已选择服务: ${provider === PROVIDERS.CLAUDE ? 'Claude' : 'Codex'}\n`);
 
+    // 2. 交互式询问 API 地址
     let apiBaseUrl = DEFAULT_CLAUDE_API_BASE;
     let codexBaseUrl = DEFAULT_CODEX_BASE_URL;
+
     if (provider === PROVIDERS.CLAUDE) {
+      // 先检查命令行参数
+      const cliApiInput = parseApiBaseInput(cliArgs);
+      let defaultApiBase = DEFAULT_CLAUDE_API_BASE;
+      let promptMessage = '';
+
+      if (cliApiInput) {
+        // 如果用户传了参数，将参数作为默认值
+        try {
+          defaultApiBase = normalizeClaudeApiBaseUrl(cliApiInput);
+          promptMessage = `💡 检测到命令行参数，默认 API 地址: ${defaultApiBase}`;
+        } catch (error) {
+          console.error(`❌ 命令行参数错误: ${error.message}`);
+          process.exit(1);
+        }
+      } else {
+        promptMessage = `💡 Claude 默认 API 地址: ${defaultApiBase}`;
+      }
+
+      console.log(promptMessage);
+      const apiBaseInput = await askQuestion(rl, '请输入 API 地址（直接回车使用默认地址）: ');
+
       try {
-        apiBaseUrl = normalizeClaudeApiBaseUrl(apiBaseInput);
+        apiBaseUrl = normalizeClaudeApiBaseUrl(apiBaseInput || defaultApiBase);
+        console.log(`✅ API 地址: ${apiBaseUrl}\n`);
       } catch (error) {
         console.error(`❌ ${error.message}`);
         process.exit(1);
       }
     } else {
+      // 先检查命令行参数
+      const cliCodexInput = parseApiBaseInput(cliArgs);
+      let defaultCodexBase = DEFAULT_CODEX_BASE_URL;
+      let promptMessage = '';
+
+      if (cliCodexInput) {
+        // 如果用户传了参数，将参数作为默认值
+        try {
+          defaultCodexBase = normalizeCodexBaseUrl(cliCodexInput);
+          promptMessage = `💡 检测到命令行参数，默认 API 地址: ${defaultCodexBase}`;
+        } catch (error) {
+          console.error(`❌ 命令行参数错误: ${error.message}`);
+          process.exit(1);
+        }
+      } else {
+        promptMessage = `💡 Codex 默认 API 地址: ${defaultCodexBase}`;
+      }
+
+      console.log(promptMessage);
+      const codexBaseInput = await askQuestion(rl, '请输入 API 地址（直接回车使用默认地址）: ');
+
       try {
-        codexBaseUrl = normalizeCodexBaseUrl(codexBaseInput);
+        codexBaseUrl = normalizeCodexBaseUrl(codexBaseInput || defaultCodexBase);
+        console.log(`✅ API 地址: ${codexBaseUrl}\n`);
       } catch (error) {
         console.error(`❌ ${error.message}`);
         process.exit(1);
       }
     }
 
-    const usingCustomDomain = provider === PROVIDERS.CLAUDE && !!apiBaseInput;
-    const usingCustomCodexDomain = provider === PROVIDERS.CODEX && !!codexBaseInput;
-
-    if (provider === PROVIDERS.CLAUDE) {
-      if (usingCustomDomain) {
-        console.log(`🏢 已启用企业独立域名: ${apiBaseUrl}\n`);
+    // 3. 交互式询问模型（Codex 专用）
+    let selectedModel = '';
+    if (provider === PROVIDERS.CODEX) {
+      console.log('请选择模型:');
+      console.log('  [1] gpt-5-codex (默认)');
+      console.log('  [2] claude-sonnet-4.5');
+      console.log('  [3] 自定义模型名称');
+      const modelChoice = await askQuestion(rl, '请选择 [1/2/3]: ');
+
+      if (modelChoice === '2') {
+        selectedModel = 'claude-sonnet-4.5';
+      } else if (modelChoice === '3') {
+        const customModel = await askQuestion(rl, '请输入自定义模型名称: ');
+        selectedModel = customModel.trim() || 'gpt-5-codex';
       } else {
-        console.log(`ℹ️  未指定域名，将使用默认地址: ${DEFAULT_CLAUDE_API_BASE}`);
-        console.log('    企业用户可使用 --api 或 --api-url 指定独立域名，例如:');
-        console.log('    sudo npx aihezu install --api your-org.aihezu.dev\n');
-      }
-    } else {
-      if (usingCustomCodexDomain) {
-        console.log(`🏢 Codex 已使用企业域名: ${codexBaseUrl}\n`);
-      } else {
-        console.log(`🤖 已选择 Codex，默认网关: ${DEFAULT_CODEX_BASE_URL}`);
-        console.log('    企业用户可用 --api 或 --api-url 指定独立域名，例如:');
-        console.log('    npx aihezu install --provider codex --api your-org.aihezu.dev\n');
-      }
-    }
-
-    const needCleanAnswer = await askQuestion(
-      rl,
-      '您是从其他服务切换过来的吗？(y/n，如果是首次使用请输入 n): '
-    );
-    const needClean = ['y', 'yes'].includes(needCleanAnswer.toLowerCase());
-
-    if (needClean) {
-      try {
-        console.log('\n=== 清理旧缓存 ===');
-        const count = cleanCache({ showHeader: false });
-        console.log(`\n✅ 缓存清理完成！（共处理 ${count} 项）`);
-        console.log('💡 配置文件已保留，即将配置新的 API Key\n');
-      } catch (error) {
-        console.error('⚠️  清理缓存时出错:', error.message);
-        console.log('继续配置流程...\n');
+        selectedModel = 'gpt-5-codex';
       }
+      console.log(`✅ 已选择模型: ${selectedModel}\n`);
     }
 
+    // 4. 询问 API Key
     const apiKey = await askQuestion(rl, '请输入您的 API Key: ');
     if (!apiKey) {
       console.error('❌ API Key 不能为空');
       process.exit(1);
     }
 
+    // 5. 显示配置摘要并确认
+    console.log('\n=== 配置摘要 ===');
+    console.log(`服务类型: ${provider === PROVIDERS.CLAUDE ? 'Claude' : 'Codex'}`);
+    if (provider === PROVIDERS.CLAUDE) {
+      console.log(`API 地址: ${apiBaseUrl}`);
+    } else {
+      console.log(`API 地址: ${codexBaseUrl}`);
+      console.log(`模型: ${selectedModel}`);
+    }
+    console.log(`API Key: ${apiKey.substring(0, 10)}...${apiKey.substring(apiKey.length - 4)}`);
+    console.log('\n⚠️  即将执行以下操作:');
+    console.log('  1. 备份现有配置文件');
+    console.log('  2. 清理缓存数据');
+    console.log('  3. 写入新的配置');
+    if (provider === PROVIDERS.CLAUDE) {
+      console.log('  4. 修改 hosts 文件');
+    }
+
+    const confirmAnswer = await askQuestion(rl, '\n是否继续？(y/n): ');
+    if (!['y', 'yes'].includes(confirmAnswer.toLowerCase())) {
+      console.log('❌ 已取消配置');
+      process.exit(0);
+    }
+
+    // 6. 默认执行备份和清理缓存
+    try {
+      console.log('\n=== 备份与清理 ===');
+
+      // 备份现有配置文件
+      if (provider === PROVIDERS.CLAUDE && fs.existsSync(claudeSettingsPath)) {
+        const backup = backupFile(claudeSettingsPath);
+        if (backup) {
+          console.log(`📦 已备份 Claude 配置: ${path.basename(backup)}`);
+        }
+      } else if (provider === PROVIDERS.CODEX) {
+        if (fs.existsSync(codexConfigPath)) {
+          const backup = backupFile(codexConfigPath);
+          if (backup) {
+            console.log(`📦 已备份 Codex config.toml: ${path.basename(backup)}`);
+          }
+        }
+        if (fs.existsSync(codexAuthPath)) {
+          const backup = backupFile(codexAuthPath);
+          if (backup) {
+            console.log(`📦 已备份 Codex auth.json: ${path.basename(backup)}`);
+          }
+        }
+      }
+
+      // 清理缓存
+      const count = cleanCache({ showHeader: false });
+      console.log(`✅ 缓存清理完成！（共处理 ${count} 项）\n`);
+    } catch (error) {
+      console.error('⚠️  备份或清理时出错:', error.message);
+      console.log('继续配置流程...\n');
+    }
+
+    // 7. 写入配置
     if (provider === PROVIDERS.CLAUDE) {
       writeClaudeSettings(apiKey.trim(), apiBaseUrl);
     } else {
-      writeCodexConfig(apiKey.trim(), codexBaseUrl);
+      writeCodexConfig(apiKey.trim(), codexBaseUrl, selectedModel);
     }
 
     if (provider === PROVIDERS.CLAUDE) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aihezu",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "description": "Claude Code CLI 清理工具 - 快速备份和清理 Claude Code 的本地配置和缓存，同时修改 hosts 文件实现本地代理",
   "main": "bin/ccclear.js",
   "bin": {