ai-agent-router 0.2.0 → 0.2.2

package/dist/src/app/layout.js

@@ -1,14 +1,18 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.metadata = void 0;
 exports.default = RootLayout;
 const jsx_runtime_1 = require("react/jsx-runtime");
 require("./globals.css");
 const ToastProvider_1 = require("./components/ToastProvider");
+const Footer_1 = __importDefault(require("./components/Footer"));
 exports.metadata = {
     title: 'AAR - AI Agent Router',
     description: 'Unified API gateway for managing multiple AI model providers',
 };
 function RootLayout({ children, }) {
-    return ((0, jsx_runtime_1.jsx)("html", { lang: "zh-CN", suppressHydrationWarning: true, children: (0, jsx_runtime_1.jsx)("body", { children: (0, jsx_runtime_1.jsx)(ToastProvider_1.ToastProvider, { children: children }) }) }));
+    return ((0, jsx_runtime_1.jsx)("html", { lang: "zh-CN", suppressHydrationWarning: true, children: (0, jsx_runtime_1.jsxs)("body", { className: "pb-10", children: [(0, jsx_runtime_1.jsx)(ToastProvider_1.ToastProvider, { children: children }), (0, jsx_runtime_1.jsx)(Footer_1.default, {})] }) }));
 }

package/dist/src/app/logs/page.js

@@ -10,15 +10,17 @@ const react_1 = require("react");
 const Nav_1 = __importDefault(require("../components/Nav"));
 const ToastProvider_1 = require("../components/ToastProvider");
 const ConfirmDialog_1 = __importDefault(require("../components/ConfirmDialog"));
-/** 将服务端返回的 created_at 格式化为本地显示。无时区后缀时按 UTC 解析再转本地，避免差 8 小时。 */
+/** 将服务端返回的 created_at 格式化为本地显示。数据库存储的是本地时间，无需追加 Z 后缀。 */
 function formatCreatedAt(createdAt) {
     if (!createdAt || typeof createdAt !== 'string')
         return '';
     const s = createdAt.trim();
     if (!s)
         return '';
+    // 数据库使用 datetime('now','localtime') 存储的已经是本地时间，
+    // 不带时区后缀时直接按本地时间解析，不要追加 'Z'（否则会多偏移 8 小时）
     const hasTz = /[Z+-]\d{2}:?\d{2}$/.test(s);
-    const iso = hasTz ? s : s.replace(' ', 'T') + 'Z';
+    const iso = hasTz ? s : s.replace(' ', 'T');
     const date = new Date(iso);
     return Number.isNaN(date.getTime()) ? s : date.toLocaleString('zh-CN');
 }

package/dist/src/db/database.js

@@ -14,12 +14,39 @@ const schema_1 = require("./schema");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
+const crypto_1 = __importDefault(require("crypto"));
 const DB_PATH = process.env.DB_PATH || path_1.default.join(os_1.default.homedir(), '.aar', 'gateway.db');
+/**
+ * 生成随机的 API Key（用于网关密码默认值）
+ */
+function generateRandomApiKey() {
+    return `aar-${crypto_1.default.randomBytes(16).toString('hex')}`;
+}
+// Use hardcoded path for the built/distributed WASM file
+// Next.js copies sql-wasm.wasm to its chunks directory
+function findSqlJsWasmPath() {
+    // Try Next.js chunks directory first (works in dev and production)
+    const nextChunksPath = path_1.default.join(process.cwd(), '.next', 'dev', 'server', 'chunks', 'sql-wasm.wasm');
+    if (fs_1.default.existsSync(nextChunksPath)) {
+        return nextChunksPath;
+    }
+    // Try production .next directory
+    const prodChunksPath = path_1.default.join(process.cwd(), '.next', 'server', 'chunks', 'sql-wasm.wasm');
+    if (fs_1.default.existsSync(prodChunksPath)) {
+        return prodChunksPath;
+    }
+    // Try node_modules as fallback
+    const nodeModulesPath = path_1.default.join(process.cwd(), 'node_modules', 'sql.js', 'dist', 'sql-wasm.wasm');
+    if (fs_1.default.existsSync(nodeModulesPath)) {
+        return nodeModulesPath;
+    }
+    // Use the most likely location as default
+    return nodeModulesPath;
+}
+const SQLJS_WASM_PATH = findSqlJsWasmPath();
 let dbInstance = null;
 let sqlJsInstance = null;
-/** 上次从磁盘加载 DB 的时间（用于多进程时发现磁盘被其他进程更新则重新加载） */
 let lastLoadMtimeMs = 0;
-/** 若磁盘上的 DB 被其他进程更新则重新加载，以便读到最新数据 */
 function reloadFromFileIfNewer() {
     if (!dbInstance || !fs_1.default.existsSync(DB_PATH))
         return;
@@ -43,7 +70,7 @@ async function initSqlJsEngine() {
         sqlJsInstance = await (0, sql_js_1.default)({
             locateFile: (file) => {
                 if (file.endsWith('.wasm')) {
-                    return path_1.default.join(process.cwd(), 'node_modules', 'sql.js', 'dist', file);
+                    return SQLJS_WASM_PATH;
                 }
                 return `https://sql.js.org/dist/${file}`;
             }
@@ -84,6 +111,7 @@ async function getDatabase() {
     if (!dbInstance) {
         const engine = await initSqlJsEngine();
         const loaded = loadDatabase();
+        let isNewDatabase = false;
         if (loaded) {
             dbInstance = loaded;
             if (fs_1.default.existsSync(DB_PATH))
@@ -92,7 +120,9 @@ async function getDatabase() {
         else {
             dbInstance = new engine.Database();
             lastLoadMtimeMs = 0;
+            isNewDatabase = true; // 标记为新数据库
         }
+        let migrationPerformed = false;
         try {
             dbInstance.run(schema_1.CREATE_TABLES_SQL);
             // Migration: Allow NULL model_id in request_logs table
@@ -124,7 +154,7 @@ async function getDatabase() {
                             dbInstance.run(`INSERT INTO request_logs_new SELECT * FROM request_logs;`);
                             dbInstance.run(`DROP TABLE request_logs;`);
                             dbInstance.run(`ALTER TABLE request_logs_new RENAME TO request_logs;`);
-                            saveDatabase(dbInstance);
+                            migrationPerformed = true;
                             console.log('[Database] Migration completed successfully');
                         }
                     }
@@ -137,7 +167,16 @@ async function getDatabase() {
                     console.warn('[Database] Migration warning (non-critical):', migrationError.message);
                 }
             }
-            saveDatabase(dbInstance);
+            // 只在新数据库创建或执行了 migration 时才保存，避免覆盖现有数据
+            if (isNewDatabase || migrationPerformed) {
+                // 为新数据库初始化默认的 api_key
+                if (isNewDatabase) {
+                    const defaultApiKey = generateRandomApiKey();
+                    dbInstance.run(`INSERT OR IGNORE INTO config (key, value, updated_at) VALUES ('api_key', ?, datetime('now'))`, [defaultApiKey]);
+                    console.log('[Database] Generated default API key for new database');
+                }
+                saveDatabase(dbInstance);
+            }
         }
         catch (schemaError) {
             if (!schemaError.message.includes('already exists') &&
@@ -159,7 +198,6 @@ async function closeDatabase() {
 function getDbPath() {
     return DB_PATH;
 }
-// Helper to run a query and get single result
 async function queryOne(sql, params = []) {
     const db = await getDatabase();
     const stmt = db.prepare(sql);
@@ -172,7 +210,6 @@ async function queryOne(sql, params = []) {
     stmt.free();
     return null;
 }
-// Helper to run a query and get all results
 async function queryAll(sql, params = []) {
     const db = await getDatabase();
     const results = [];
@@ -184,7 +221,6 @@ async function queryAll(sql, params = []) {
     stmt.free();
     return results;
 }
-// Helper to run INSERT/UPDATE/DELETE
 async function run(sql, params = []) {
     const db = await getDatabase();
     db.run(sql, params);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-agent-router",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A unified API gateway for managing multiple AI model providers (Anthropic, OpenAI, Gemini, etc.)",
   "main": "dist/src/cli/index.js",
   "bin": {

package/src/app/api/config/route.ts

@@ -1,10 +1,18 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { getDatabase } from '@/db/database';
 import { getConfig, setConfig, getAllConfig } from '@/db/queries';
+import crypto from 'crypto';
 
 // Ensure Node.js runtime (required for SQLite)
 export const runtime = 'nodejs';
 
+/**
+ * 生成随机的 API Key（用于网关密码默认值）
+ */
+function generateRandomApiKey(): string {
+  return `aar-${crypto.randomBytes(16).toString('hex')}`;
+}
+
 export async function GET(request: NextRequest) {
   try {
     // Initialize database on request (safer than module load)
@@ -25,6 +33,15 @@ export async function GET(request: NextRequest) {
     }
 
     const configs = await getAllConfig();
+    
+    // 如果 api_key 为空，生成一个随机默认值
+    if (!configs.api_key) {
+      const defaultApiKey = generateRandomApiKey();
+      await setConfig('api_key', defaultApiKey);
+      configs.api_key = defaultApiKey;
+      console.log('[Config API] Generated default API key');
+    }
+    
     return NextResponse.json(configs);
   } catch (error: any) {
     console.error('Config API error:', error);

package/src/app/api/ide/claude/apply/route.ts

@@ -10,6 +10,12 @@ const CLAUDE_DIR = join(homedir(), '.claude');
 const SETTINGS_FILE = join(CLAUDE_DIR, 'settings.json');
 const BACKUP_FILE = join(CLAUDE_DIR, 'settings.json.aar.bak');
 
+// Claude 登录配置文件（用于 hasCompletedOnboarding）
+const CLAUDE_JSON_FILE = join(homedir(), '.claude.json');
+
+// AAR 备份目录
+const AAR_BACKUP_DIR = join(homedir(), '.aar', 'backups');
+
 // 默认模型映射
 const DEFAULT_MODEL_MAPPING = {
   haiku: 'GLM-4.5-air',
@@ -38,11 +44,20 @@ export async function POST(request: NextRequest) {
     const gatewayAddress = await getGatewayAddress();
     const gatewayApiKey = await getGatewayApiKey();
 
-    // 生成配置对象
     const modelMapping = { haiku, sonnet, opus, default: defaultModel, reasoning: reasoningModel };
-    const config = generateClaudeConfig(gatewayAddress, gatewayApiKey, modelMapping);
+    const aarEnv = buildAarEnv(gatewayAddress, gatewayApiKey, modelMapping);
+
+    // 在修改配置前，先备份到 ~/.aar/backups 目录
+    const settingsBackup = backupToAar(SETTINGS_FILE, 'settings');
+    const claudeJsonBackup = backupToAar(CLAUDE_JSON_FILE, 'claude');
+    
+    if (!settingsBackup.success) {
+      console.warn('[Claude Apply] Settings backup warning:', settingsBackup.error);
+    }
+    if (!claudeJsonBackup.success) {
+      console.warn('[Claude Apply] Claude.json backup warning:', claudeJsonBackup.error);
+    }
 
-    // 备份原有配置
     const backupResult = backupOriginalConfig();
     if (!backupResult.success) {
       return NextResponse.json(
@@ -51,13 +66,27 @@ export async function POST(request: NextRequest) {
       );
     }
 
-    // 确保目录存在
     if (!existsSync(CLAUDE_DIR)) {
       mkdirSync(CLAUDE_DIR, { recursive: true });
     }
 
-    // 验证并写入新配置
-    const validationResult = validateAndWriteConfig(config);
+    let configToWrite: any;
+    if (existsSync(SETTINGS_FILE)) {
+      try {
+        const existing = JSON.parse(readFileSync(SETTINGS_FILE, 'utf-8'));
+        configToWrite = {
+          ...existing,
+          env: { ...(existing.env || {}), ...aarEnv },
+          router_provider: 'aar',
+        };
+      } catch {
+        configToWrite = generateClaudeConfig(gatewayAddress, gatewayApiKey, modelMapping);
+      }
+    } else {
+      configToWrite = generateClaudeConfig(gatewayAddress, gatewayApiKey, modelMapping);
+    }
+
+    const validationResult = validateAndWriteConfig(configToWrite);
     if (!validationResult.success) {
       return NextResponse.json(
         { error: validationResult.error },
@@ -65,12 +94,23 @@ export async function POST(request: NextRequest) {
       );
     }
 
+    // 处理 ~/.claude.json，确保包含 hasCompletedOnboarding: true
+    const onboardingResult = ensureClaudeOnboarding();
+    if (!onboardingResult.success) {
+      console.warn('[Claude Apply] Onboarding update warning:', onboardingResult.error);
+    }
+
     return NextResponse.json({
       success: true,
       message: 'Configuration applied successfully',
-      config,
+      config: configToWrite,
       backup: backupResult.existed ? 'Created backup' : 'No existing config to backup',
       previousWasFromAar: backupResult.existed && backupResult.isFromAar,
+      onboarding: onboardingResult.created ? 'Created ~/.claude.json' : 'Updated ~/.claude.json',
+      aarBackups: {
+        settings: settingsBackup.backupPath,
+        claudeJson: claudeJsonBackup.backupPath,
+      },
     });
   } catch (error: any) {
     console.error('IDE Apply API error:', error);
@@ -101,57 +141,60 @@ async function getGatewayApiKey(): Promise<string> {
   return apiKeyConfig?.value || 'your-gateway-api-key';
 }
 
-/**
- * 生成 Claude 配置
- */
+/** 仅生成 AAR 相关的 env 字段，用于合并到现有配置 */
+function buildAarEnv(
+  gatewayAddress: string,
+  gatewayApiKey: string,
+  modelMapping: { haiku: string; sonnet: string; opus: string; default: string; reasoning: string }
+): Record<string, unknown> {
+  return {
+    ANTHROPIC_AUTH_TOKEN: gatewayApiKey,
+    ANTHROPIC_BASE_URL: gatewayAddress,
+    ANTHROPIC_DEFAULT_HAIKU_MODEL: modelMapping.haiku,
+    ANTHROPIC_DEFAULT_OPUS_MODEL: modelMapping.opus,
+    ANTHROPIC_DEFAULT_SONNET_MODEL: modelMapping.sonnet,
+    ANTHROPIC_MODEL: modelMapping.default,
+    ANTHROPIC_REASONING_MODEL: modelMapping.reasoning,
+    API_TIMEOUT_MS: '3000000',
+    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1,
+    hasCompletedOnboarding: true,
+  };
+}
+
+/** 生成完整 Claude 配置（仅在无现有文件时使用） */
 function generateClaudeConfig(
   gatewayAddress: string,
   gatewayApiKey: string,
   modelMapping: { haiku: string; sonnet: string; opus: string; default: string; reasoning: string }
 ): any {
   return {
-    // 路由提供者标识，标识配置来自当前工具 aar
     router_provider: 'aar',
-    env: {
-      ANTHROPIC_AUTH_TOKEN: gatewayApiKey,
-      ANTHROPIC_BASE_URL: gatewayAddress,
-      ANTHROPIC_DEFAULT_HAIKU_MODEL: modelMapping.haiku,
-      ANTHROPIC_DEFAULT_OPUS_MODEL: modelMapping.opus,
-      ANTHROPIC_DEFAULT_SONNET_MODEL: modelMapping.sonnet,
-      ANTHROPIC_MODEL: modelMapping.default,
-      ANTHROPIC_REASONING_MODEL: modelMapping.reasoning,
-      API_TIMEOUT_MS: '3000000',
-      CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1,
-      hasCompletedOnboarding: true,
-    },
+    env: buildAarEnv(gatewayAddress, gatewayApiKey, modelMapping),
   };
 }
 
 /**
  * 备份原有配置
- * 返回原有配置是否来自当前工具（router_provider === 'aar'）
+ * 仅在当前配置不是 AAR 时写入备份，这样「还原」才能恢复到应用 AAR 前的状态
  */
 function backupOriginalConfig(): { success: boolean; existed: boolean; isFromAar: boolean; error?: string } {
   try {
-    // 检查原有配置是否存在
     const existing = existsSync(SETTINGS_FILE);
 
     if (existing) {
-      // 读取原有配置
       const originalConfig = readFileSync(SETTINGS_FILE, 'utf-8');
 
-      // 解析配置检查 router_provider
       let isFromAar = false;
       try {
         const parsedConfig = JSON.parse(originalConfig);
         isFromAar = parsedConfig.router_provider === 'aar';
-      } catch (error) {
-        // 解析失败，不影响备份操作
+      } catch {
         isFromAar = false;
       }
 
-      // 写入备份文件
-      writeFileSync(BACKUP_FILE, originalConfig, 'utf-8');
+      if (!isFromAar) {
+        writeFileSync(BACKUP_FILE, originalConfig, 'utf-8');
+      }
 
       return { success: true, existed: true, isFromAar };
     }
@@ -189,3 +232,69 @@ function validateAndWriteConfig(config: any): { success: boolean; error?: string
     };
   }
 }
+
+/**
+ * 备份文件到 ~/.aar/backups 目录
+ */
+function backupToAar(filePath: string, backupName: string): { success: boolean; backupPath?: string; error?: string } {
+  try {
+    if (!existsSync(filePath)) {
+      return { success: true }; // 文件不存在，无需备份
+    }
+    
+    if (!existsSync(AAR_BACKUP_DIR)) {
+      mkdirSync(AAR_BACKUP_DIR, { recursive: true });
+    }
+    
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = join(AAR_BACKUP_DIR, `${backupName}-${timestamp}.json`);
+    copyFileSync(filePath, backupPath);
+    
+    return { success: true, backupPath };
+  } catch (error: any) {
+    return {
+      success: false,
+      error: `Backup to AAR failed: ${error.message}`,
+    };
+  }
+}
+
+/**
+ * 确保 ~/.claude.json 文件中包含 hasCompletedOnboarding: true
+ * 这允许用户跳过 Claude 登录使用自定义模型
+ */
+function ensureClaudeOnboarding(): { success: boolean; created: boolean; error?: string } {
+  try {
+    let config: any = {};
+    let created = false;
+    
+    if (existsSync(CLAUDE_JSON_FILE)) {
+      try {
+        const content = readFileSync(CLAUDE_JSON_FILE, 'utf-8');
+        config = JSON.parse(content);
+      } catch {
+        // 文件存在但解析失败，使用空对象
+        config = {};
+      }
+    } else {
+      created = true;
+    }
+    
+    // 检查是否已经有 hasCompletedOnboarding
+    if (config.hasCompletedOnboarding === true) {
+      return { success: true, created: false };
+    }
+    
+    // 添加 hasCompletedOnboarding
+    config.hasCompletedOnboarding = true;
+    writeFileSync(CLAUDE_JSON_FILE, JSON.stringify(config, null, 2), 'utf-8');
+    
+    return { success: true, created };
+  } catch (error: any) {
+    return {
+      success: false,
+      created: false,
+      error: `Failed to update claude.json: ${error.message}`,
+    };
+  }
+}

package/src/app/api/ide/claude/restore/route.ts

@@ -1,5 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
-import { existsSync, readFileSync, copyFileSync, unlinkSync } from 'fs';
+import { existsSync, readFileSync, copyFileSync, unlinkSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 
@@ -8,6 +8,9 @@ const CLAUDE_DIR = join(homedir(), '.claude');
 const SETTINGS_FILE = join(CLAUDE_DIR, 'settings.json');
 const BACKUP_FILE = join(CLAUDE_DIR, 'settings.json.aar.bak');
 
+// AAR 备份目录
+const AAR_BACKUP_DIR = join(homedir(), '.aar', 'backups');
+
 /**
  * 还原 Claude IDE 配置
  */
@@ -34,6 +37,12 @@ export async function POST(request: NextRequest) {
       );
     }
 
+    // 在还原前，先备份当前配置到 ~/.aar/backups 目录
+    const currentBackup = backupToAar(SETTINGS_FILE, 'settings-before-restore');
+    if (!currentBackup.success) {
+      console.warn('[IDE Restore] Current config backup warning:', currentBackup.error);
+    }
+
     // 将备份内容复制到原配置文件
     copyFileSync(BACKUP_FILE, SETTINGS_FILE);
 
@@ -93,3 +102,29 @@ export async function DELETE(request: NextRequest) {
     );
   }
 }
+
+/**
+ * 备份文件到 ~/.aar/backups 目录
+ */
+function backupToAar(filePath: string, backupName: string): { success: boolean; backupPath?: string; error?: string } {
+  try {
+    if (!existsSync(filePath)) {
+      return { success: true }; // 文件不存在，无需备份
+    }
+    
+    if (!existsSync(AAR_BACKUP_DIR)) {
+      mkdirSync(AAR_BACKUP_DIR, { recursive: true });
+    }
+    
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = join(AAR_BACKUP_DIR, `${backupName}-${timestamp}.json`);
+    copyFileSync(filePath, backupPath);
+    
+    return { success: true, backupPath };
+  } catch (error: any) {
+    return {
+      success: false,
+      error: `Backup to AAR failed: ${error.message}`,
+    };
+  }
+}

package/src/app/api/ide/claude/save/route.ts

@@ -1,5 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import { getDatabase } from '@/db/database';
@@ -9,10 +9,16 @@ import { getConfig } from '@/db/queries';
 const CLAUDE_DIR = join(homedir(), '.claude');
 const SETTINGS_FILE = join(CLAUDE_DIR, 'settings.json');
 
+// Claude 登录配置文件（用于 hasCompletedOnboarding）
+const CLAUDE_JSON_FILE = join(homedir(), '.claude.json');
+
 // AAR 临时配置目录和文件
 const AAR_DIR = join(homedir(), '.aar');
 const TEMP_SETTINGS_FILE = join(AAR_DIR, 'settings.tmp.json');
 
+// AAR 备份目录
+const AAR_BACKUP_DIR = join(AAR_DIR, 'backups');
+
 type SaveRequest = {
   haiku?: string;
   sonnet?: string;
@@ -64,6 +70,18 @@ export async function POST(request: NextRequest) {
       // 已应用当前网关配置，更新 settings.json
       savePath = SETTINGS_FILE;
       saveType = 'applied';
+      
+      // 备份到 ~/.aar/backups 目录
+      const settingsBackup = backupToAar(SETTINGS_FILE, 'settings');
+      const claudeJsonBackup = backupToAar(CLAUDE_JSON_FILE, 'claude');
+      
+      if (!settingsBackup.success) {
+        console.warn('[IDE Save] Settings backup warning:', settingsBackup.error);
+      }
+      if (!claudeJsonBackup.success) {
+        console.warn('[IDE Save] Claude.json backup warning:', claudeJsonBackup.error);
+      }
+      
       mergedConfig = generateClaudeConfig(gatewayAddress, gatewayApiKey, {
         haiku: haiku,
         sonnet: sonnet,
@@ -71,6 +89,12 @@ export async function POST(request: NextRequest) {
         default: defaultModel,
         reasoning: reasoningModel
       });
+      
+      // 确保 ~/.claude.json 包含 hasCompletedOnboarding: true
+      const onboardingResult = ensureClaudeOnboarding();
+      if (!onboardingResult.success) {
+        console.warn('[IDE Save] Onboarding update warning:', onboardingResult.error);
+      }
     } else {
       // 未应用网络关配置，保存到临时文件 ~/.aar/settings.tmp.json
       savePath = TEMP_SETTINGS_FILE;
@@ -179,3 +203,69 @@ function generateClaudeConfig(
     },
   };
 }
+
+/**
+ * 备份文件到 ~/.aar/backups 目录
+ */
+function backupToAar(filePath: string, backupName: string): { success: boolean; backupPath?: string; error?: string } {
+  try {
+    if (!existsSync(filePath)) {
+      return { success: true }; // 文件不存在，无需备份
+    }
+    
+    if (!existsSync(AAR_BACKUP_DIR)) {
+      mkdirSync(AAR_BACKUP_DIR, { recursive: true });
+    }
+    
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = join(AAR_BACKUP_DIR, `${backupName}-${timestamp}.json`);
+    copyFileSync(filePath, backupPath);
+    
+    return { success: true, backupPath };
+  } catch (error: any) {
+    return {
+      success: false,
+      error: `Backup to AAR failed: ${error.message}`,
+    };
+  }
+}
+
+/**
+ * 确保 ~/.claude.json 文件中包含 hasCompletedOnboarding: true
+ * 这允许用户跳过 Claude 登录使用自定义模型
+ */
+function ensureClaudeOnboarding(): { success: boolean; created: boolean; error?: string } {
+  try {
+    let config: any = {};
+    let created = false;
+    
+    if (existsSync(CLAUDE_JSON_FILE)) {
+      try {
+        const content = readFileSync(CLAUDE_JSON_FILE, 'utf-8');
+        config = JSON.parse(content);
+      } catch {
+        // 文件存在但解析失败，使用空对象
+        config = {};
+      }
+    } else {
+      created = true;
+    }
+    
+    // 检查是否已经有 hasCompletedOnboarding
+    if (config.hasCompletedOnboarding === true) {
+      return { success: true, created: false };
+    }
+    
+    // 添加 hasCompletedOnboarding
+    config.hasCompletedOnboarding = true;
+    writeFileSync(CLAUDE_JSON_FILE, JSON.stringify(config, null, 2), 'utf-8');
+    
+    return { success: true, created };
+  } catch (error: any) {
+    return {
+      success: false,
+      created: false,
+      error: `Failed to update claude.json: ${error.message}`,
+    };
+  }
+}

package/src/app/api/ide/claude/status/route.ts

@@ -29,9 +29,14 @@ type ConfigStatus = {
   apiKey?: string;
   lastUpdated?: string | null;
   backupExists: boolean;
-  matchCurrentGateway?: boolean; // 是否匹配当前网关配置
+  matchCurrentGateway?: boolean; // 是否匹配当前网关配置（仅当 routerProvider === 'aar' 时有效）
   routerProvider?: string; // 路由提供者标识，'aar' 表示配置来自当前工具
   tempMapping?: { haiku?: string; sonnet?: string; opus?: string; default?: string; reasoning?: string }; // 临时配置模型映射
+  config?: Record<string, unknown>; // 当前配置文件完整内容，用于「生效中」展示
+  /** 当前网关地址（来自数据库），用于预览 */
+  currentGatewayAddress?: string;
+  /** 当前网关 API Key（来自数据库，脱敏），用于预览 */
+  currentGatewayApiKey?: string;
 };
 
 /**
@@ -60,6 +65,8 @@ export async function GET(request: NextRequest) {
         lastUpdated: undefined,
         matchCurrentGateway: false,
         routerProvider: undefined,
+        currentGatewayAddress: gatewayAddress,
+        currentGatewayApiKey: gatewayApiKey,
       });
     }
 
@@ -98,7 +105,7 @@ export async function GET(request: NextRequest) {
       }
     }
 
-    // 提取配置状态
+    // 提取配置状态；返回完整 config 供前端在非 AAR 时展示原有配置文件
     const status: ConfigStatus = {
       applied: true,
       modelMapping: extractModelMapping(config),
@@ -109,6 +116,9 @@ export async function GET(request: NextRequest) {
       matchCurrentGateway,
       routerProvider: config.router_provider,
       tempMapping,
+      config,
+      currentGatewayAddress: gatewayAddress,
+      currentGatewayApiKey: gatewayApiKey,
     };
 
     return NextResponse.json(status);