coding-tool-x 3.5.1 → 3.5.3

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 该项目遵循 [Semantic Versioning](https://semver.org/)。
 
+## [3.5.3] - 2026-03-23
+
+### Fixed
+- **Windows 全局安装后 UI 启动失败** - 发布依赖中显式加入 `rxjs`，并移除无效的 `file:` 本地运行时依赖，修复 `ctx start` / `ctx ui --daemon` 在 Windows 上因 `inquirer` 缺少运行时依赖而启动失败的问题
+- **非交互启动链路解耦交互依赖** - CLI 与服务入口改为按需加载 `inquirer`，即使交互菜单依赖异常，后台启动命令仍可进入服务启动流程
+- **Codex PowerShell 环境同步降级处理** - Windows 上 `pwsh` 超时或缺失时，Codex 环境变量同步改为告警降级，不再直接中断代理恢复与服务启动
+- **残留端口清理体验修复** - `ctx stop` 现在会额外清理受管端口上的残留进程，并给出更明确的端口占用提示，减少二次启动时的误报
+
 ## [3.3.8] - 2026-03-12
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-tool-x",
-  "version": "3.5.1",
+  "version": "3.5.3",
   "description": "Vibe Coding 增强工作助手 - 智能会话管理、动态渠道切换、全局搜索、实时监控",
   "main": "src/index.js",
   "bin": {
@@ -58,7 +58,6 @@
     "@iarna/toml": "^2.2.5",
     "adm-zip": "^0.5.16",
     "ajv": "^8.17.1",
-    "cc-tool-web": "file:src/web",
     "chalk": "^4.1.2",
     "express": "^4.21.2",
     "http-proxy": "^1.18.1",
@@ -67,6 +66,7 @@
     "open": "^8.4.2",
     "ora": "^5.4.1",
     "pm2": "^6.0.14",
+    "rxjs": "^7.8.2",
     "semver": "^7.6.0",
     "toml": "^3.0.0",
     "ws": "^8.18.3"

package/src/commands/daemon.js

@@ -3,7 +3,13 @@ const path = require('path');
 const chalk = require('chalk');
 const { loadConfig } = require('../config/loader');
 const { PATHS, ensureStorageDirMigrated } = require('../config/paths');
-const { findProcessByPort, getPortToolIssue, formatPortToolIssue } = require('../utils/port-helper');
+const {
+  findProcessByPort,
+  killProcessByPort,
+  waitForPortRelease,
+  getPortToolIssue,
+  formatPortToolIssue
+} = require('../utils/port-helper');
 
 const PM2_APP_NAME = 'cc-tool';
 
@@ -83,6 +89,50 @@ function shouldTreatPortOwnershipAsReady(ownsPort) {
   return ownsPort === true || ownsPort === null;
 }
 
+function getManagedPorts(config = loadConfig()) {
+  return [
+    config.ports?.webUI || 19999,
+    config.ports?.proxy || 20088,
+    config.ports?.codexProxy || 20089,
+    config.ports?.geminiProxy || 20090,
+    config.ports?.opencodeProxy || 20091
+  ].filter((port, index, list) => Number.isInteger(port) && port > 0 && list.indexOf(port) === index);
+}
+
+async function cleanupManagedPorts(config = loadConfig(), options = {}) {
+  const timeoutMs = Number.isFinite(options.timeoutMs) ? options.timeoutMs : 3000;
+  const ports = getManagedPorts(config);
+  const released = [];
+  const forced = [];
+  const stillInUse = [];
+
+  for (const port of ports) {
+    if (await waitForPortRelease(port, timeoutMs)) {
+      released.push(port);
+      continue;
+    }
+
+    const killed = killProcessByPort(port);
+    if (killed) {
+      forced.push(port);
+      if (await waitForPortRelease(port, timeoutMs)) {
+        released.push(port);
+        continue;
+      }
+    }
+
+    stillInUse.push(port);
+  }
+
+  return {
+    ports,
+    released,
+    forced,
+    stillInUse,
+    toolIssue: getPortToolIssue()
+  };
+}
+
 async function waitForServiceReady(port, timeoutMs = 15000, intervalMs = 500) {
   const startAt = Date.now();
   let lastProcess = null;
@@ -232,10 +282,21 @@ async function handleStart() {
 async function handleStop() {
   try {
     await connectPM2();
+    const config = loadConfig();
 
     const existing = await getCCToolProcess();
     if (!existing) {
+      const cleanup = await cleanupManagedPorts(config, { timeoutMs: 3000 });
       console.log(chalk.yellow('\n[WARN]  服务未在运行\n'));
+
+      if (cleanup.forced.length > 0) {
+        console.log(chalk.yellow(`[WARN]  已额外清理残留端口: ${cleanup.forced.join(', ')}`));
+      }
+      if (cleanup.stillInUse.length > 0) {
+        console.log(chalk.red(`[ERROR] 以下端口仍被占用: ${cleanup.stillInUse.join(', ')}`));
+        printPortToolIssue(cleanup.toolIssue);
+        console.log(chalk.yellow('[TIP] 请检查是否有外部进程仍占用这些端口\n'));
+      }
       disconnectPM2();
       return;
     }
@@ -248,11 +309,21 @@ async function handleStop() {
       }
 
       // 删除进程
-      pm2.delete(PM2_APP_NAME, (err) => {
+      pm2.delete(PM2_APP_NAME, async (err) => {
         if (err) {
           console.error(chalk.red('删除进程失败:'), err.message);
         } else {
+          const cleanup = await cleanupManagedPorts(config, { timeoutMs: 3000 });
           console.log(chalk.green('\n[OK] Coding-Tool 服务已停止\n'));
+
+          if (cleanup.forced.length > 0) {
+            console.log(chalk.yellow(`[WARN]  已额外清理残留端口: ${cleanup.forced.join(', ')}`));
+          }
+          if (cleanup.stillInUse.length > 0) {
+            console.log(chalk.red(`[ERROR] 以下端口仍被占用: ${cleanup.stillInUse.join(', ')}`));
+            printPortToolIssue(cleanup.toolIssue);
+            console.log(chalk.yellow('[TIP] 请检查是否有外部进程仍占用这些端口\n'));
+          }
         }
 
         pm2.dump((err) => {
@@ -399,6 +470,7 @@ module.exports = {
   handleRestart,
   handleStatus,
   _test: {
-    shouldTreatPortOwnershipAsReady
+    shouldTreatPortOwnershipAsReady,
+    getManagedPorts
   }
 };

package/src/index.js

@@ -6,30 +6,24 @@
  */
 
 const { loadConfig } = require('./config/loader');
-const { showMainMenu } = require('./ui/menu');
-const { handleList } = require('./commands/list');
-const { handleSearch } = require('./commands/search');
-const { switchProject } = require('./commands/switch');
 const { resetConfig } = require('./reset-config');
-const { handleChannelManagement, handleAddChannel, handleChannelStatus } = require('./commands/channels');
-const { handleToggleProxy } = require('./commands/toggle-proxy');
-const { handlePortConfig } = require('./commands/port-config');
-const { handleSwitchCliType } = require('./commands/cli-type');
 const { handleStart, handleStop, handleRestart, handleStatus } = require('./commands/daemon');
 const { handleProxyStart: proxyStart, handleProxyStop: proxyStop, handleProxyRestart, handleProxyStatus: proxyStatus } = require('./commands/proxy-control');
 const { handleLogs } = require('./commands/logs');
 const { handleStats, handleStatsExport } = require('./commands/stats');
 const { handleDoctor } = require('./commands/doctor');
 const { handleUpdate } = require('./commands/update');
-const { workspaceMenu } = require('./commands/workspace');
 const { ensureStorageDirMigrated } = require('./config/paths');
 const PluginManager = require('./plugins/plugin-manager');
 const eventBus = require('./plugins/event-bus');
 const chalk = require('chalk');
-const inquirer = require('inquirer');
 const path = require('path');
 const fs = require('fs');
 
+function getInquirer() {
+  return require('inquirer');
+}
+
 // 读取版本号
 function getVersion() {
   const packagePath = path.join(__dirname, '../package.json');
@@ -338,6 +332,7 @@ async function main() {
 
   // port 命令 - 配置端口
   if (args[0] === 'port') {
+    const { handlePortConfig } = require('./commands/port-config');
     await handlePortConfig();
     return;
   }
@@ -400,6 +395,7 @@ async function main() {
 
   while (true) {
     // 显示主菜单
+    const { showMainMenu } = require('./ui/menu');
     const action = await showMainMenu(config);
 
     // 发送命令开始事件
@@ -409,7 +405,9 @@ async function main() {
 
     switch (action) {
       case 'list':
+        const { handleList } = require('./commands/list');
         await handleList(config, async () => {
+          const { switchProject } = require('./commands/switch');
           const switched = await switchProject(config);
           if (switched) {
             // 重新加载配置以获取最新的项目设置
@@ -420,7 +418,9 @@ async function main() {
         break;
 
       case 'search':
+        const { handleSearch } = require('./commands/search');
         await handleSearch(config, async () => {
+          const { switchProject } = require('./commands/switch');
           const switched = await switchProject(config);
           if (switched) {
             config = loadConfig();
@@ -430,11 +430,14 @@ async function main() {
         break;
 
       case 'switch':
+        const { switchProject } = require('./commands/switch');
         const switched = await switchProject(config);
         if (switched) {
           config = loadConfig();
           // 切换成功后自动进入会话列表
+          const { handleList } = require('./commands/list');
           await handleList(config, async () => {
+            const { switchProject } = require('./commands/switch');
             const switched = await switchProject(config);
             if (switched) {
               config = loadConfig();
@@ -445,26 +448,32 @@ async function main() {
         break;
 
       case 'workspace':
+        const { workspaceMenu } = require('./commands/workspace');
         await workspaceMenu();
         break;
 
       case 'switch-cli-type':
+        const { handleSwitchCliType } = require('./commands/cli-type');
         await handleSwitchCliType();
         config = loadConfig(); // 重新加载配置以获取新的类型
         break;
 
       case 'switch-channel':
+        const { handleChannelManagement } = require('./commands/channels');
         await handleChannelManagement();
         break;
       case 'channel-status':
+        const { handleChannelStatus } = require('./commands/channels');
         await handleChannelStatus();
         break;
 
       case 'toggle-proxy':
+        const { handleToggleProxy } = require('./commands/toggle-proxy');
         await handleToggleProxy();
         break;
 
       case 'add-channel':
+        const { handleAddChannel } = require('./commands/channels');
         await handleAddChannel();
         break;
 
@@ -475,6 +484,7 @@ async function main() {
       }
 
       case 'port-config':
+        const { handlePortConfig } = require('./commands/port-config');
         await handlePortConfig();
         break;
 
@@ -484,6 +494,7 @@ async function main() {
 
       case 'plugin-menu': {
         const { handlePluginCommand } = require('./commands/plugin');
+        const inquirer = getInquirer();
 
         // Show plugin management submenu
         const pluginAction = await inquirer.prompt([{

package/src/server/index.js

@@ -1,7 +1,6 @@
 const express = require('express');
 const path = require('path');
 const chalk = require('chalk');
-const inquirer = require('inquirer');
 const { loadConfig } = require('../config/loader');
 const { PATHS, ensureStorageDirMigrated } = require('../config/paths');
 const { startWebSocketServer: attachWebSocketServer } = require('./websocket-server');
@@ -25,6 +24,10 @@ const { startOpenCodeProxyServer, collectProxyModelList } = require('./opencode-
 const { createRemoteMutationGuard } = require('./services/network-access');
 const { createApiRequestLogger } = require('./services/request-logger');
 
+function getInquirer() {
+  return require('inquirer');
+}
+
 function isInteractivePortConflictMode(options = {}) {
   if (options.interactive === false) {
     return false;
@@ -73,6 +76,7 @@ async function startServer(port, host = '127.0.0.1', options = {}) {
       shouldKill = true;
     } else if (interactiveMode) {
       // 询问用户是否关闭占用端口的进程
+      const inquirer = getInquirer();
       const answer = await inquirer.prompt([
         {
           type: 'list',

package/src/server/services/codex-settings-manager.js

@@ -37,6 +37,33 @@ function hasBackup() {
   return fs.existsSync(getConfigBackupPath()) || fs.existsSync(getAuthBackupPath());
 }
 
+function isRecoverableEnvSyncError(err) {
+  const message = String(err?.message || '');
+  return err?.code === 'ETIMEDOUT' ||
+    /timed out|spawnSync (?:powershell|pwsh)|No PowerShell executable available/i.test(message);
+}
+
+function trySyncCodexUserEnvironment(envMap, options) {
+  try {
+    return {
+      success: true,
+      result: syncCodexUserEnvironment(envMap, options),
+      warning: null
+    };
+  } catch (err) {
+    if (!isRecoverableEnvSyncError(err)) {
+      throw err;
+    }
+
+    console.warn(`[Codex Settings] 跳过持久化环境变量同步: ${err.message}`);
+    return {
+      success: false,
+      result: null,
+      warning: err.message
+    };
+  }
+}
+
 
 // 读取 config.toml
 function readConfig() {
@@ -191,7 +218,7 @@ function restoreSettings() {
       fs.unlinkSync(getAuthBackupPath());
     }
 
-    syncCodexUserEnvironment({}, {
+    const envSync = trySyncCodexUserEnvironment({}, {
       replace: false,
       removeKeys: ['CC_PROXY_KEY']
     });
@@ -200,7 +227,11 @@ function restoreSettings() {
     delete process.env.CC_PROXY_KEY;
 
     console.log('Codex settings restored from backup');
-    return { success: true };
+    const result = { success: true };
+    if (envSync.warning) {
+      result.envSyncWarning = envSync.warning;
+    }
+    return result;
   } catch (err) {
     throw new Error('Failed to restore settings: ' + err.message);
   }
@@ -246,22 +277,27 @@ function setProxyConfig(proxyPort) {
     // 直接设置 process.env 确保从本进程派生的 Codex CLI 能读到 CC_PROXY_KEY
     process.env.CC_PROXY_KEY = 'PROXY_KEY';
 
-    const envResult = syncCodexUserEnvironment({
+    const envSync = trySyncCodexUserEnvironment({
       CC_PROXY_KEY: 'PROXY_KEY'
     }, {
       replace: false
     });
+    const envResult = envSync.result;
 
     console.log(`Codex settings updated to use proxy on port ${proxyPort}`);
-    return {
+    const result = {
       success: true,
       port: proxyPort,
-      envInjected: true,
-      isFirstTime: envResult.isFirstTime,
-      shellConfigPath: envResult.shellConfigPath,
-      sourceCommand: envResult.sourceCommand,
-      reloadRequired: envResult.reloadRequired
+      envInjected: envSync.success,
+      isFirstTime: envResult?.isFirstTime || false,
+      shellConfigPath: envResult?.shellConfigPath || null,
+      sourceCommand: envResult?.sourceCommand || null,
+      reloadRequired: envResult?.reloadRequired || false
     };
+    if (envSync.warning) {
+      result.envSyncWarning = envSync.warning;
+    }
+    return result;
   } catch (err) {
     throw new Error('Failed to set proxy config: ' + err.message);
   }
@@ -335,4 +371,7 @@ module.exports = {
   setProxyConfig,
   isProxyConfig,
   getCurrentProxyPort,
+  _test: {
+    isRecoverableEnvSyncError
+  }
 };