aicodeswitch 5.2.9 → 5.2.11

package/README.md

@@ -35,50 +35,26 @@ AI Code Switch 是帮助你在本地管理 AI 编程工具接入大模型的工
 * 数据完全本地，自主可控
 * 特殊语法：在发送的提示词最前面添加`[!]`来直接切换为高智商模型服务（`[x]`关闭），简单快捷
 
+![](public/aicodeswitch-flow.svg)
+
 ## 桌面客户端
 
 [进入下载](https://github.com/tangshuang/aicodeswitch/releases)
 
 ## 命令行工具
 
-### 安装
-
 ```
+# 安装
 npm install -g aicodeswitch
-```
-
-### 使用方法
-
-**启动服务**
-
-```
+# 启动服务
 aicos start
-```
-
-或者直接运行
-
-```
+# http://127.0.0.1:4567
+# 启动服务并打开管理界面
 aicos ui
-```
-
-**停止服务**
-
-```
+# 停止服务
 aicos stop
 ```
 
-**进入管理界面**
-
-```
-# 自动启动服务和打开界面
-aicos ui
-```
-
-```
-# 手动在浏览器打开管理界面
-http://127.0.0.1:4567
-```
-
 ## 管理界面
 
 **配置供应商**
@@ -257,6 +233,7 @@ PORT=4567
 ## 关联资源
 
 * [Claude Code 深度教程](https://claudecode.tangshuang.net): 100%免费的Claude Code入门到精通教程
+* [AICodingBus](https://aicodingbus.24x7.to): AI Tokens 交换平台
 
 ## 支持我
 

package/bin/cli.js

@@ -7,6 +7,7 @@ const commands = {
   start: require('./start'),
   stop: require('./stop'),
   restart: require('./restart'),
+  status: require('./status'),
   upgrade: require('./upgrade'),
   restore: require('./restore'),
   version: require('./version'),
@@ -21,6 +22,7 @@ Commands:
   start      Start the AI Code Switch server
   stop       Stop the AI Code Switch server
   restart    Restart the AI Code Switch server
+  status     Show server status, running address and port
   ui         Open the web UI in browser (starts server if needed)
   upgrade    Upgrade to the latest version and restart
   restore    Restore original configuration files
@@ -30,6 +32,7 @@ Example:
   aicos start
   aicos stop
   aicos restart
+  aicos status
   aicos ui
   aicos upgrade
   aicos restore

package/bin/status.js

@@ -0,0 +1,84 @@
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+const chalk = require('chalk');
+const boxen = require('boxen');
+const { isServerRunning, getServerInfo } = require('./utils/get-server');
+const { findPidByPort, getProcessInfo } = require('./utils/port-utils');
+
+const PID_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.pid');
+const LOG_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.log');
+
+const status = async () => {
+  console.log('\n');
+
+  // 读取配置的 host/port
+  const { host, port } = getServerInfo();
+  const url = `http://${host}:${port}`;
+
+  // 优先通过 PID 文件判断
+  let pidFromFile = null;
+  if (fs.existsSync(PID_FILE)) {
+    try {
+      pidFromFile = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+    } catch (err) {
+      pidFromFile = null;
+    }
+  }
+
+  const runningByPidFile = isServerRunning();
+  // 通过端口检测（兜底：PID 文件丢失但服务仍在监听的情况）
+  const pidByPort = await findPidByPort(port);
+  const isRunning = runningByPidFile || !!pidByPort;
+
+  if (isRunning) {
+    // PID 优先使用 PID 文件记录的，其次使用端口检测到的
+    const pid = runningByPidFile ? pidFromFile : pidByPort;
+    const processInfo = await getProcessInfo(pid);
+
+    console.log(boxen(
+      chalk.green.bold('🟢 AI Code Switch Server\n\n') +
+      chalk.white('Status:  ') + chalk.green.bold('● Running\n') +
+      chalk.white('Host:    ') + chalk.cyan(host) + '\n' +
+      chalk.white('Port:    ') + chalk.cyan.bold(port) + '\n' +
+      chalk.white('URL:     ') + chalk.cyan.bold(url) + '\n' +
+      chalk.white('PID:     ') + chalk.yellow(pid) + '\n' +
+      chalk.white('Process: ') + chalk.gray(processInfo) + '\n' +
+      chalk.white('Logs:    ') + chalk.gray(LOG_FILE) + '\n\n' +
+      chalk.gray('Open the URL in your browser to access the dashboard'),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'double',
+        borderColor: 'green'
+      }
+    ));
+
+    console.log(chalk.cyan('💡 Tips:\n'));
+    console.log(chalk.white('  • Open browser: ') + chalk.cyan(url));
+    console.log(chalk.white('  • View logs:    ') + chalk.gray(`tail -f ${LOG_FILE}`));
+    console.log(chalk.white('  • Stop server:  ') + chalk.yellow('aicos stop'));
+    console.log(chalk.white('  • Restart:      ') + chalk.yellow('aicos restart'));
+    console.log('\n');
+  } else {
+    console.log(boxen(
+      chalk.gray('AI Code Switch Server\n\n') +
+      chalk.white('Status: ') + chalk.red('● Stopped\n\n') +
+      chalk.white('Host:   ') + chalk.gray(host) + '\n' +
+      chalk.white('Port:   ') + chalk.gray(port) + '\n' +
+      chalk.white('URL:    ') + chalk.gray(url) + ' ' + chalk.gray('(not listening)'),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'gray'
+      }
+    ));
+
+    console.log(chalk.white('Use ') + chalk.cyan('aicos start') + chalk.white(' to start the server.\n'));
+  }
+
+  process.exit(0);
+};
+
+module.exports = status;

package/bin/utils/managed-fields.js

@@ -45,6 +45,8 @@ const CODEX_CONFIG_MANAGED_FIELDS = [
   'enableRouteSelection',
   'model_providers.aicodeswitch',
   'mcp_servers',
+  'features',
+  'memories',
 ];
 
 /**

package/dist/server/config-managed-fields.js

@@ -41,6 +41,8 @@ exports.CODEX_CONFIG_MANAGED_FIELDS = [
     { path: ['enableRouteSelection'] },
     { path: ['model_providers', 'aicodeswitch'], isSection: true },
     { path: ['mcp_servers'], isSection: true, optional: true },
+    { path: ['features'], isSection: true, optional: true },
+    { path: ['memories'], isSection: true, optional: true },
 ];
 /**
  * Codex auth.json 管理字段定义

package/dist/server/conversions/pairs/responses-claude/response.js

@@ -9,6 +9,7 @@ exports.claudeToResponsesResponse = claudeToResponsesResponse;
 const id_js_1 = require("../../utils/id.js");
 const stop_reasons_js_1 = require("../../utils/stop-reasons.js");
 const mapper_js_1 = require("../../thinking/mapper.js");
+const usage_js_1 = require("../../utils/usage.js");
 /**
  * Convert a Claude Messages response to an OpenAI Responses API response.
  */
@@ -45,26 +46,9 @@ function claudeToResponsesResponse(response) {
         }
     }
     const { status, incomplete_details } = (0, stop_reasons_js_1.claudeToResponsesStatus)(response.stop_reason);
-    const usage = claudeToResponsesUsage(response.usage);
+    // 上游无 usage 时省略 usage 字段（不伪造 0）
+    const usage = (0, usage_js_1.toResponsesUsage)(response.usage);
     const responseId = response.id || (0, id_js_1.generateResponseId)();
-    return Object.assign(Object.assign({ id: responseId, object: 'response', status,
-        output, model: response.model || '', created_at: Math.floor(Date.now() / 1000), usage }, (incomplete_details ? { incomplete_details } : {})), { metadata: {} });
-}
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Map Claude usage to Responses API usage.
- */
-function claudeToResponsesUsage(usage) {
-    var _a, _b;
-    if (!usage)
-        return { input_tokens: 0, output_tokens: 0, total_tokens: 0 };
-    const input = (_a = usage.input_tokens) !== null && _a !== void 0 ? _a : 0;
-    const output = (_b = usage.output_tokens) !== null && _b !== void 0 ? _b : 0;
-    return {
-        input_tokens: input,
-        output_tokens: output,
-        total_tokens: input + output,
-    };
+    return Object.assign(Object.assign(Object.assign({ id: responseId, object: 'response', status,
+        output, model: response.model || '', created_at: Math.floor(Date.now() / 1000) }, (usage ? { usage } : {})), (incomplete_details ? { incomplete_details } : {})), { metadata: {} });
 }

package/dist/server/conversions/pairs/responses-claude/streaming.js

@@ -10,6 +10,7 @@ exports.ClaudeToResponsesConverter = void 0;
 const id_js_1 = require("../../utils/id.js");
 const stop_reasons_js_1 = require("../../utils/stop-reasons.js");
 const streaming_helpers_js_1 = require("../../utils/streaming-helpers.js");
+const usage_js_1 = require("../../utils/usage.js");
 /**
  * ClaudeToResponsesConverter: Claude Messages SSE → Responses API SSE
  */
@@ -49,7 +50,7 @@ class ClaudeToResponsesConverter {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: { input_tokens: 0, output_tokens: 0 }
+            value: null
         });
         Object.defineProperty(this, "output", {
             enumerable: true,
@@ -89,7 +90,7 @@ class ClaudeToResponsesConverter {
         });
     }
     convertEvent(event) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
         if (!event.data)
             return [];
         const events = [];
@@ -99,6 +100,14 @@ class ClaudeToResponsesConverter {
                 case 'message_start': {
                     this.model = ((_a = data.message) === null || _a === void 0 ? void 0 : _a.model) || '';
                     this.responseId = ((_b = data.message) === null || _b === void 0 ? void 0 : _b.id) || this.responseId;
+                    // Claude 的 prompt token 数在 message_start 的 message.usage.input_tokens
+                    const startUsage = (_c = data.message) === null || _c === void 0 ? void 0 : _c.usage;
+                    if (startUsage) {
+                        this.usage = {
+                            input_tokens: (_d = startUsage.input_tokens) !== null && _d !== void 0 ? _d : 0,
+                            output_tokens: (_e = startUsage.output_tokens) !== null && _e !== void 0 ? _e : 0,
+                        };
+                    }
                     events.push(this.makeSSE('response.created', {
                         id: this.responseId,
                         object: 'response',
@@ -236,11 +245,11 @@ class ClaudeToResponsesConverter {
                     break;
                 }
                 case 'message_delta': {
-                    this.pendingStopReason = ((_c = data.delta) === null || _c === void 0 ? void 0 : _c.stop_reason) || null;
+                    this.pendingStopReason = ((_f = data.delta) === null || _f === void 0 ? void 0 : _f.stop_reason) || null;
                     if (data.usage) {
                         this.usage = {
-                            input_tokens: this.usage.input_tokens,
-                            output_tokens: (_e = (_d = data.usage.output_tokens) !== null && _d !== void 0 ? _d : data.usage.tokens) !== null && _e !== void 0 ? _e : 0,
+                            input_tokens: (_j = (_g = data.usage.input_tokens) !== null && _g !== void 0 ? _g : (_h = this.usage) === null || _h === void 0 ? void 0 : _h.input_tokens) !== null && _j !== void 0 ? _j : 0,
+                            output_tokens: (_o = (_l = (_k = data.usage.output_tokens) !== null && _k !== void 0 ? _k : data.usage.tokens) !== null && _l !== void 0 ? _l : (_m = this.usage) === null || _m === void 0 ? void 0 : _m.output_tokens) !== null && _o !== void 0 ? _o : 0,
                         };
                     }
                     break;
@@ -253,7 +262,7 @@ class ClaudeToResponsesConverter {
                     break;
             }
         }
-        catch (_f) {
+        catch (_p) {
             // Ignore parse errors
         }
         return events;
@@ -315,20 +324,9 @@ class ClaudeToResponsesConverter {
         this.closeText(events);
         this.closeThinking(events);
         const { status, incomplete_details } = (0, stop_reasons_js_1.claudeToResponsesStatus)(this.pendingStopReason);
-        const responseObj = {
-            id: this.responseId,
-            object: 'response',
-            status,
-            output: this.output,
-            model: this.model,
-            created_at: Math.floor(Date.now() / 1000),
-            usage: {
-                input_tokens: this.usage.input_tokens,
-                output_tokens: this.usage.output_tokens,
-                total_tokens: this.usage.input_tokens + this.usage.output_tokens,
-            },
-            metadata: {},
-        };
+        // 上游无 usage 时省略 usage 字段（不伪造 0，避免 Codex missing field input_tokens）
+        const responsesUsage = (0, usage_js_1.toResponsesUsage)(this.usage);
+        const responseObj = Object.assign({ id: this.responseId, object: 'response', status, output: this.output, model: this.model, created_at: Math.floor(Date.now() / 1000), metadata: {} }, (responsesUsage ? { usage: responsesUsage } : {}));
         if (incomplete_details) {
             responseObj.incomplete_details = incomplete_details;
         }

package/dist/server/conversions/pairs/responses-completions/response.js

@@ -80,15 +80,8 @@ function completionsToResponsesResponse(response) {
     const finishReason = (0, stop_reasons_js_1.completionsToResponsesFinishReason)(choice.finish_reason);
     const status = finishReason === 'incomplete' ? 'incomplete' : 'completed';
     const usage = (0, usage_js_1.completionsToResponsesUsage)(response.usage);
-    const result = {
-        id: ((_m = response.id) === null || _m === void 0 ? void 0 : _m.startsWith('resp_')) ? response.id : (0, id_js_1.generateResponseId)(),
-        object: 'response',
-        status,
-        output,
-        model: response.model,
-        usage,
-        created_at: response.created || Math.floor(Date.now() / 1000),
-    };
+    const result = Object.assign({ id: ((_m = response.id) === null || _m === void 0 ? void 0 : _m.startsWith('resp_')) ? response.id : (0, id_js_1.generateResponseId)(), object: 'response', status,
+        output, model: response.model, created_at: response.created || Math.floor(Date.now() / 1000) }, (usage ? { usage } : {}));
     if (status === 'incomplete') {
         result.incomplete_details = { reason: 'max_output_tokens' };
     }

package/dist/server/conversions/pairs/responses-completions/streaming.js

@@ -320,16 +320,9 @@ class CompletionsToResponsesConverter {
         }
         // Build full response object
         const status = this.finishReason === 'length' ? 'incomplete' : 'completed';
-        const responseObj = {
-            id: this.responseId,
-            object: 'response',
-            status,
-            output: this.output,
-            model: this.model,
-            usage: this.usage ? (0, usage_js_1.completionsToResponsesUsage)(this.usage) : {},
-            created_at: Math.floor(Date.now() / 1000),
-            metadata: {},
-        };
+        // 上游无 usage 时省略 usage 字段（不伪造 0，避免 Codex missing field input_tokens）
+        const responsesUsage = (0, usage_js_1.completionsToResponsesUsage)(this.usage);
+        const responseObj = Object.assign({ id: this.responseId, object: 'response', status, output: this.output, model: this.model, created_at: Math.floor(Date.now() / 1000), metadata: {} }, (responsesUsage ? { usage: responsesUsage } : {}));
         if (status === 'incomplete') {
             responseObj.incomplete_details = { reason: 'max_output_tokens' };
         }

package/dist/server/conversions/utils/usage.js

@@ -8,6 +8,7 @@ exports.claudeToCompletionsUsage = claudeToCompletionsUsage;
 exports.geminiToClaudeUsage = geminiToClaudeUsage;
 exports.claudeToGeminiUsage = claudeToGeminiUsage;
 exports.responsesToClaudeUsage = responsesToClaudeUsage;
+exports.toResponsesUsage = toResponsesUsage;
 exports.completionsToResponsesUsage = completionsToResponsesUsage;
 /** Map OpenAI Chat usage to Claude usage */
 function completionsToClaudeUsage(usage) {
@@ -69,14 +70,33 @@ function responsesToClaudeUsage(usage) {
         cache_creation_input_tokens: usage.cache_creation_input_tokens,
     };
 }
-/** Map OpenAI Chat usage to Responses API usage */
-function completionsToResponsesUsage(usage) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-    if (!usage)
-        return {};
+/**
+ * 构造标准 Responses API usage 对象（转换层兼容入口）。
+ *
+ * 真实值优先：input_tokens ?? prompt_tokens、output_tokens ?? completion_tokens、total_tokens。
+ * 覆盖上游 chat completions / claude / gemini 三种格式的字段命名归一。
+ *
+ * 仅当上游确实提供了任意 token 字段时返回归一化对象；否则返回 null（调用方应省略 usage 字段，
+ * 不伪造 0）。这是避免 Codex `ResponseCompleted: missing field input_tokens` 的关键——
+ * 既不吐空 `{}`，也不吐伪造的 `{0,0,0}`。
+ */
+function toResponsesUsage(usage) {
+    var _a, _b;
+    if (!usage || typeof usage !== 'object')
+        return null;
+    const input_tokens = (_a = usage.input_tokens) !== null && _a !== void 0 ? _a : usage.prompt_tokens;
+    const output_tokens = (_b = usage.output_tokens) !== null && _b !== void 0 ? _b : usage.completion_tokens;
+    const total_tokens = usage.total_tokens;
+    // 上游没返回任何 token 字段 → 不伪造，返回 null
+    if (input_tokens == null && output_tokens == null && total_tokens == null)
+        return null;
     return {
-        input_tokens: (_b = (_a = usage.input_tokens) !== null && _a !== void 0 ? _a : usage.prompt_tokens) !== null && _b !== void 0 ? _b : 0,
-        output_tokens: (_d = (_c = usage.output_tokens) !== null && _c !== void 0 ? _c : usage.completion_tokens) !== null && _d !== void 0 ? _d : 0,
-        total_tokens: (_e = usage.total_tokens) !== null && _e !== void 0 ? _e : (((_g = (_f = usage.input_tokens) !== null && _f !== void 0 ? _f : usage.prompt_tokens) !== null && _g !== void 0 ? _g : 0) + ((_j = (_h = usage.output_tokens) !== null && _h !== void 0 ? _h : usage.completion_tokens) !== null && _j !== void 0 ? _j : 0)),
+        input_tokens: input_tokens !== null && input_tokens !== void 0 ? input_tokens : 0,
+        output_tokens: output_tokens !== null && output_tokens !== void 0 ? output_tokens : 0,
+        total_tokens: total_tokens !== null && total_tokens !== void 0 ? total_tokens : ((input_tokens !== null && input_tokens !== void 0 ? input_tokens : 0) + (output_tokens !== null && output_tokens !== void 0 ? output_tokens : 0)),
     };
 }
+/** Map OpenAI Chat usage to Responses API usage（薄封装，保持现有调用方不变） */
+function completionsToResponsesUsage(usage) {
+    return toResponsesUsage(usage);
+}

package/dist/server/main.js

@@ -383,7 +383,7 @@ const DEFAULT_CODEX_REASONING_EFFORT = 'high';
 const isCodexReasoningEffort = (value) => {
     return typeof value === 'string' && VALID_CODEX_REASONING_EFFORTS.includes(value);
 };
-const writeCodexConfig = (_dbManager_1, ...args_1) => __awaiter(void 0, [_dbManager_1, ...args_1], void 0, function* (_dbManager, modelReasoningEffort = DEFAULT_CODEX_REASONING_EFFORT, codexDefaultModel, options = {}) {
+const writeCodexConfig = (_dbManager_1, ...args_1) => __awaiter(void 0, [_dbManager_1, ...args_1], void 0, function* (_dbManager, modelReasoningEffort = DEFAULT_CODEX_REASONING_EFFORT, codexDefaultModel, enableMemories, options = {}) {
     var _a;
     try {
         const homeDir = os_1.default.homedir();
@@ -450,6 +450,17 @@ const writeCodexConfig = (_dbManager_1, ...args_1) => __awaiter(void 0, [_dbMana
                 }
             }
         };
+        // 记忆功能配置
+        if (enableMemories) {
+            proxyConfig.features = {
+                memories: true,
+            };
+            proxyConfig.memories = {
+                generate_memories: true,
+                use_memories: true,
+                disable_on_external_context: true,
+            };
+        }
         // 使用智能合并
         const mergedConfig = (0, config_merge_1.mergeTomlConfig)(proxyConfig, currentConfig, config_managed_fields_1.CODEX_CONFIG_MANAGED_FIELDS);
         // 原子性写入合并后的配置
@@ -681,7 +692,7 @@ const syncConfigsOnServerStartup = (dbManager) => __awaiter(void 0, void 0, void
     const modelReasoningEffort = isCodexReasoningEffort(config.codexModelReasoningEffort)
         ? config.codexModelReasoningEffort
         : DEFAULT_CODEX_REASONING_EFFORT;
-    const codexWritten = yield writeCodexConfig(dbManager, modelReasoningEffort, config.codexDefaultModel);
+    const codexWritten = yield writeCodexConfig(dbManager, modelReasoningEffort, config.codexDefaultModel, config.codexEnableMemories);
     console.log(`[Startup Config Sync] Codex config ${codexWritten ? 'written' : 'skipped'}`);
 });
 const syncConfigsOnGlobalConfigUpdate = (dbManager) => __awaiter(void 0, void 0, void 0, function* () {
@@ -694,7 +705,7 @@ const syncConfigsOnGlobalConfigUpdate = (dbManager) => __awaiter(void 0, void 0,
     const modelReasoningEffort = isCodexReasoningEffort(config.codexModelReasoningEffort)
         ? config.codexModelReasoningEffort
         : DEFAULT_CODEX_REASONING_EFFORT;
-    const codexUpdated = yield writeCodexConfig(dbManager, modelReasoningEffort, config.codexDefaultModel, { allowOverwriteRefresh: true });
+    const codexUpdated = yield writeCodexConfig(dbManager, modelReasoningEffort, config.codexDefaultModel, config.codexEnableMemories, { allowOverwriteRefresh: true });
     console.log(`[Config Update Sync] Codex config ${codexUpdated ? 'written' : 'skipped'}`);
 });
 const getCentralSkillsDir = () => {
@@ -2038,7 +2049,11 @@ ${instruction}
             : isCodexReasoningEffort(appConfig.codexModelReasoningEffort)
                 ? appConfig.codexModelReasoningEffort
                 : DEFAULT_CODEX_REASONING_EFFORT;
-        const result = yield writeCodexConfig(dbManager, modelReasoningEffort, appConfig.codexDefaultModel);
+        const requestedEnableMemories = req.body.enableMemories;
+        const enableMemories = requestedEnableMemories !== undefined
+            ? !!requestedEnableMemories
+            : !!appConfig.codexEnableMemories;
+        const result = yield writeCodexConfig(dbManager, modelReasoningEffort, appConfig.codexDefaultModel, enableMemories);
         applyWriteLocalRecords(proxyServer);
         res.json(result);
     })));
@@ -3288,21 +3303,23 @@ ${instruction}
         }
     }
 });
+// listen 就绪标志：区分"启动阶段"与"运行阶段"，启动期致命异常应让进程退出
+let listenReady = false;
 const start = () => __awaiter(void 0, void 0, void 0, function* () {
     fs_1.default.mkdirSync(dataDir, { recursive: true });
     // 自动检测数据库类型并执行迁移（如果需要）
-    console.log('[Server] Initializing database...');
+    console.time('[Server] step "database-init"');
     const dbManager = yield database_factory_1.DatabaseFactory.createAuto(dataDir, legacyDataDir);
-    console.log('[Server] Database initialized successfully');
+    console.timeEnd('[Server] step "database-init"');
     // 服务启动时自动同步配置文件（适用于 CLI 和 dev:server）
-    console.log('[Server] Syncing tool configs with global settings...');
+    console.time('[Server] step "sync-configs"');
     try {
         yield syncConfigsOnServerStartup(dbManager);
-        console.log('[Server] Tool config sync completed');
     }
     catch (error) {
         console.error('[Server] Tool config sync failed:', error);
     }
+    console.timeEnd('[Server] step "sync-configs"');
     // 清理旧的迁移临时文件
     try {
         (0, session_launcher_1.cleanupOldTempFiles)();
@@ -3328,8 +3345,10 @@ const start = () => __awaiter(void 0, void 0, void 0, function* () {
     // Initialize proxy server and register proxy routes last
     proxyServer.initialize();
     // Register admin routes first
+    console.time('[Server] step "register-routes"');
     yield registerRoutes(dbManager, proxyServer);
     yield proxyServer.registerProxyRoutes();
+    console.timeEnd('[Server] step "register-routes"');
     app.use(express_1.default.static(path_1.default.resolve(__dirname, '../ui')));
     // 404 处理程序 - 确保返回 JSON 而不是 HTML（放在所有路由和静态文件之后）
     app.use((_req, res) => {
@@ -3347,14 +3366,28 @@ const start = () => __awaiter(void 0, void 0, void 0, function* () {
         console.error(`端口 ${port} 已被占用，无法启动服务。请执行 aicos stop 后重启。`);
         process.exit(1);
     }
+    console.time('[Server] step "listen"');
     const server = app.listen(port, host, () => {
+        listenReady = true;
         console.log(`Admin server running on http://${host}:${port}`);
+        console.timeEnd('[Server] step "listen"');
         // 启动后异步执行延迟维护任务（分片校验/修复、日志清理、会话索引构建）
         // 不阻塞服务启动，后台静默执行
         dbManager.deferredMaintenance().catch(err => {
             console.error('[Server] Deferred maintenance error:', err);
         });
     });
+    // 显式处理 listen 错误（EADDRINUSE/权限不足等），打印明确日志并退出，
+    // 避免被全局 uncaughtException 静默吞掉导致"进程在但不 listen"
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            console.error(`[Server] 端口 ${port} 已被占用（EADDRINUSE）。请执行 aicos stop 后重启，或更换端口（PORT 环境变量）。`);
+        }
+        else {
+            console.error('[Server] 监听失败:', err);
+        }
+        setImmediate(() => process.exit(1));
+    });
     // 创建 WebSocket 服务器用于工具安装
     const toolInstallWss = (0, websocket_service_1.createToolInstallationWSServer)();
     // 设置黑名单检查函数，用于在规则状态同步时检查黑名单是否已过期
@@ -3435,11 +3468,19 @@ const start = () => __awaiter(void 0, void 0, void 0, function* () {
 process.on('uncaughtException', (error) => {
     console.error('[Uncaught Exception] 服务遇到未捕获的异常:', error);
     console.error('[Uncaught Exception] 堆栈信息:', error.stack);
-    // 不退出进程，继续运行
+    // 启动阶段（listen 之前）的异常通常是致命的（依赖加载失败、初始化崩溃等），
+    // 静默吞掉会导致"进程在但不 listen"，Tauri 只能干等超时；此时退出让上层重新探测/诊断。
+    if (!listenReady) {
+        console.error('[Uncaught Exception] 发生在服务监听之前，退出进程');
+        process.exit(1);
+    }
 });
 process.on('unhandledRejection', (reason) => {
     console.error('[Unhandled Rejection] 服务遇到未处理的 Promise 拒绝:', reason);
-    // 不退出进程，继续运行
+    if (!listenReady) {
+        console.error('[Unhandled Rejection] 发生在服务监听之前，退出进程');
+        process.exit(1);
+    }
 });
 start().catch((error) => {
     console.error('Failed to start server:', error);

package/dist/server/session-launcher.js

@@ -22,7 +22,7 @@ const os_1 = require("os");
 function which(cmd) {
     try {
         const command = process.platform === 'win32' ? `where ${cmd}` : `which ${cmd}`;
-        (0, child_process_1.execSync)(command, { stdio: 'ignore' });
+        (0, child_process_1.execSync)(command, { stdio: 'ignore', windowsHide: true }); // 隐藏 Windows 命令行窗口，避免检测时闪窗
         return true;
     }
     catch (_a) {

package/dist/server/tools-service.js

@@ -29,6 +29,7 @@ function checkToolInstalled(toolName) {
             const child = (0, child_process_1.spawn)(command, ['--version'], {
                 shell: true,
                 stdio: ['ignore', 'pipe', 'pipe'],
+                windowsHide: true, // 隐藏 Windows 命令行窗口，避免检测时闪窗
             });
             let stdout = '';
             let stderr = '';

package/dist/server/utils.js

@@ -9,13 +9,27 @@ Object.defineProperty(exports, "isLastMessageCompact", { enumerable: true, get:
 Object.defineProperty(exports, "isCodexCompactRequest", { enumerable: true, get: function () { return compact_1.isCodexCompactRequest; } });
 function checkPortUsable(port) {
     return new Promise((resolve) => {
+        let settled = false;
         const server = net.createConnection({ port });
-        server.on('connect', () => {
-            server.end();
-            resolve(false);
-        });
-        server.on('error', () => {
-            resolve(true);
+        const finish = (val) => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                server.destroy();
+            }
+            catch ( /* ignore */_a) { /* ignore */ }
+            resolve(val);
+        };
+        // 正常：连得上 = 端口被占；连不上(ECONNREFUSED) = 端口可用
+        server.on('connect', () => finish(false));
+        server.on('error', () => finish(true));
+        // 兜底：网络栈异常（防火墙/杀软 hook）时 connect/error 可能都不触发，
+        // 1.5s 后强制按可用处理，避免 start() 永久卡死。误判由 app.listen 的 EADDRINUSE 兜底。
+        server.setTimeout(1500);
+        server.once('timeout', () => {
+            console.warn(`[checkPortUsable] 探测端口 ${port} 超时(1.5s)，按可用处理`);
+            finish(true);
         });
     });
 }