coding-tool-x 3.6.12 → 3.7.0

package/dist/web/index.html

@@ -5,14 +5,14 @@
     <link rel="icon" href="/favicon.ico">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>coding-tool-x · AI 编程工作台</title>
-    <script type="module" crossorigin src="/assets/index-y-eEayxR.js"></script>
+    <script type="module" crossorigin src="/assets/index-EQq56pRa.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/markdown-BNJfEgCA.js">
     <link rel="modulepreload" crossorigin href="/assets/vue-vendor-B5RqjEjQ.js">
-    <link rel="modulepreload" crossorigin href="/assets/naive-ui-kcWDeJwl.js">
-    <link rel="modulepreload" crossorigin href="/assets/icons-QFXzEgqM.js">
+    <link rel="modulepreload" crossorigin href="/assets/naive-ui-CVyvdmg1.js">
+    <link rel="modulepreload" crossorigin href="/assets/icons-Dop5j7Bf.js">
     <link rel="modulepreload" crossorigin href="/assets/vendors-DQA4Hw9v.js">
     <link rel="stylesheet" crossorigin href="/assets/markdown-BfC0goYb.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-Dsh4Q5Cg.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-CM26UrnJ.css">
   </head>
   <body>
     <div id="app"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-tool-x",
-  "version": "3.6.12",
+  "version": "3.7.0",
   "description": "Vibe Coding 增强工作助手 - 智能会话管理、动态渠道切换、全局搜索、实时监控",
   "main": "src/index.js",
   "bin": {
@@ -64,6 +64,7 @@
     "http-proxy": "^1.18.1",
     "https-proxy-agent": "^7.0.6",
     "inquirer": "^8.2.7",
+    "js-yaml": "^4.1.1",
     "open": "^8.4.2",
     "ora": "^5.4.1",
     "pm2": "^6.0.14",

package/src/commands/channels.js

@@ -2,12 +2,14 @@
 const chalk = require('chalk');
 const inquirer = require('inquirer');
 const { loadConfig } = require('../config/loader');
+const { normalizePlatformKey } = require('../shared/platforms');
 
 /**
  * 获取当前类型的渠道服务
  */
 function getChannelServices(cliType) {
-  if (cliType === 'claude') {
+  const normalizedCliType = normalizePlatformKey(cliType || 'claude');
+  if (normalizedCliType === 'claude') {
     const {
       getAllChannels,
       createChannel,
@@ -15,7 +17,7 @@ function getChannelServices(cliType) {
     } = require('../server/services/channels');
     const { getProxyStatus } = require('../server/proxy-server');
     return { getAllChannels, createChannel, updateChannel, getProxyStatus };
-  } else if (cliType === 'codex') {
+  } else if (normalizedCliType === 'codex') {
     const {
       getChannels,
       createChannel,
@@ -31,7 +33,7 @@ function getChannelServices(cliType) {
       updateChannel,
       getProxyStatus: getCodexProxyStatus
     };
-  } else if (cliType === 'gemini') {
+  } else if (normalizedCliType === 'gemini') {
     const {
       getChannels,
       createChannel,
@@ -47,7 +49,7 @@ function getChannelServices(cliType) {
       updateChannel,
       getProxyStatus: getGeminiProxyStatus
     };
-  } else if (cliType === 'opencode') {
+  } else if (normalizedCliType === 'opencode') {
     const {
       getChannels,
       createChannel,
@@ -63,7 +65,27 @@ function getChannelServices(cliType) {
       updateChannel,
       getProxyStatus: getOpenCodeProxyStatus
     };
+  } else if (normalizedCliType === 'pi') {
+    const {
+      getChannels,
+      createChannel,
+      updateChannel
+    } = require('../server/services/pi-channels');
+    const { getPiProxyStatus } = require('../server/pi-proxy-server');
+    return {
+      getAllChannels: () => {
+        const result = getChannels();
+        return Array.isArray(result?.channels) ? result.channels : [];
+      },
+      createChannel,
+      updateChannel,
+      getProxyStatus: getPiProxyStatus,
+      supportsCliCreate: false,
+      managedProviderConfig: true
+    };
   }
+
+  return null;
 }
 
 /**
@@ -76,13 +98,8 @@ async function handleChannelManagement() {
   console.log(chalk.bold.cyan('╚=======================================╝\n'));
 
   const config = loadConfig();
-  const cliType = config.currentCliType || 'claude';
+  const cliType = normalizePlatformKey(config.currentCliType || 'claude');
   const services = getChannelServices(cliType);
-  if (!services || typeof services.createChannel !== 'function') {
-    console.log(chalk.red(`当前 CLI 类型 (${cliType}) 暂不支持添加渠道`));
-    await inquirer.prompt([{ type: 'input', name: 'continue', message: '按回车返回...' }]);
-    return;
-  }
   if (!services || typeof services.getAllChannels !== 'function') {
     console.log(chalk.red(`当前 CLI 类型 (${cliType}) 暂不支持渠道管理`));
     await inquirer.prompt([{ type: 'input', name: 'continue', message: '按回车返回...' }]);
@@ -93,7 +110,13 @@ async function handleChannelManagement() {
 
   if (channels.length === 0) {
     console.log(chalk.yellow('还没有添加任何渠道'));
-    console.log(chalk.gray('提示: 使用主菜单的"添加渠道"功能来添加新渠道\n'));
+    if (cliType === 'pi') {
+      console.log(chalk.gray('提示: OMP 渠道请通过 Web UI 或 API 添加后，再在这里启停调度。\n'));
+    } else if (services.supportsCliCreate === false || typeof services.createChannel !== 'function') {
+      console.log(chalk.gray('提示: 当前平台不支持在 CLI 中添加渠道，请通过 Web UI 添加。\n'));
+    } else {
+      console.log(chalk.gray('提示: 使用主菜单的"添加渠道"功能来添加新渠道\n'));
+    }
 
     const { action } = await inquirer.prompt([
       {
@@ -129,9 +152,19 @@ async function handleAddChannel() {
   console.log(chalk.bold.cyan('╚=======================================╝\n'));
 
   const config = loadConfig();
-  const cliType = config.currentCliType || 'claude';
+  const cliType = normalizePlatformKey(config.currentCliType || 'claude');
   const services = getChannelServices(cliType);
 
+  if (!services || services.supportsCliCreate === false || typeof services.createChannel !== 'function') {
+    if (cliType === 'pi') {
+      console.log(chalk.yellow('OMP 渠道创建/编辑需要使用 Web UI 或 API，以便配置 providerKey、providerApi、模型白名单等 OMP 字段。\n'));
+    } else {
+      console.log(chalk.red(`当前 CLI 类型 (${cliType}) 暂不支持添加渠道\n`));
+    }
+    await inquirer.prompt([{ type: 'input', name: 'continue', message: '按回车返回...' }]);
+    return;
+  }
+
   const answers = await inquirer.prompt([
     {
       type: 'input',
@@ -280,12 +313,7 @@ async function handleChannelStatus() {
 
   try {
     const { getSchedulerState } = require('../server/services/channel-scheduler');
-    const sources = [
-      { key: 'claude', label: 'Claude (Claude Code)' },
-      { key: 'codex', label: 'Codex (OpenAI)' },
-      { key: 'gemini', label: 'Gemini' },
-      { key: 'opencode', label: 'OpenCode' }
-    ];
+    const sources = buildSchedulerSources();
 
     sources.forEach((source) => {
       const state = getSchedulerState(source.key);
@@ -317,13 +345,18 @@ async function handleChannelStatus() {
 module.exports = {
   handleChannelManagement,
   handleAddChannel,
-  handleChannelStatus
+  handleChannelStatus,
+  _test: {
+    buildSchedulerSources,
+    getChannelServices
+  }
 };
 
 /**
  * 统一的多渠道选择处理
  */
 async function handleChannelToggle(channels, services, cliType) {
+  const normalizedCliType = normalizePlatformKey(cliType || 'claude');
   const choices = channels.map(channel => {
     const enabled = channel.enabled !== false;
     const detailParts = [];
@@ -333,14 +366,31 @@ async function handleChannelToggle(channels, services, cliType) {
       detailParts.push(cleaned);
     }
 
-    if (cliType === 'codex' && channel.providerKey) {
+    if (normalizedCliType === 'codex' && channel.providerKey) {
       detailParts.push(`provider ${channel.providerKey}`);
     }
 
-    if (cliType === 'gemini' && channel.model) {
+    if (normalizedCliType === 'gemini' && channel.model) {
       detailParts.push(`model ${channel.model}`);
     }
 
+    if (normalizedCliType === 'pi') {
+      if (channel.providerKey) {
+        detailParts.push(`provider ${channel.providerKey}`);
+      }
+      if (channel.model) {
+        detailParts.push(`model ${channel.model}`);
+      }
+      const allowedModels = Array.isArray(channel.allowedModels) && channel.allowedModels.length > 0
+        ? channel.allowedModels
+        : channel.models;
+      if (Array.isArray(allowedModels) && allowedModels.length > 0) {
+        const preview = allowedModels.slice(0, 3).join(', ');
+        const suffix = allowedModels.length > 3 ? ` +${allowedModels.length - 3}` : '';
+        detailParts.push(`models ${preview}${suffix}`);
+      }
+    }
+
     if (channel.maxConcurrency) {
       detailParts.push(`并发 ${channel.maxConcurrency}`);
     }
@@ -389,10 +439,10 @@ async function handleChannelToggle(channels, services, cliType) {
   }
 
   if (hasChanged) {
-    broadcastSchedulerSnapshot(cliType);
+    broadcastSchedulerSnapshot(normalizedCliType);
   }
 
-  await handleAdvancedConfig(services, cliType);
+  await handleAdvancedConfig(services, normalizedCliType);
 
   console.log(
     chalk.cyan(
@@ -503,15 +553,26 @@ async function handleAdvancedConfig(services, cliType) {
 }
 
 function broadcastSchedulerSnapshot(source = 'claude') {
+  const normalizedSource = normalizePlatformKey(source || 'claude');
   try {
     const { getSchedulerState } = require('../server/services/channel-scheduler');
     const { broadcastSchedulerState } = require('../server/websocket-server');
-    broadcastSchedulerState(source, getSchedulerState(source));
+    broadcastSchedulerState(normalizedSource, getSchedulerState(normalizedSource));
   } catch (err) {
     // ignore when scheduler not available
   }
 }
 
+function buildSchedulerSources() {
+  return [
+    { key: 'claude', label: 'Claude (Claude Code)' },
+    { key: 'codex', label: 'Codex (OpenAI)' },
+    { key: 'gemini', label: 'Gemini' },
+    { key: 'opencode', label: 'OpenCode' },
+    { key: 'pi', label: 'OMP' }
+  ];
+}
+
 async function handleLegacySwitch(channels, services) {
   const choices = channels.map(channel => {
     let name = channel.enabled !== false ? chalk.green('● ') : '  ';

package/src/commands/daemon.js

@@ -11,7 +11,6 @@ const {
   getPortToolIssue,
   formatPortToolIssue
 } = require('../utils/port-helper');
-const { hasHostFlag } = require('../utils/cli-flags');
 
 const PM2_APP_NAME = 'cc-tool';
 const STARTUP_LOG_FILE = 'cc-tool-out.log';
@@ -260,7 +259,8 @@ function getManagedPorts(config = loadConfig()) {
     config.ports?.proxy || 20088,
     config.ports?.codexProxy || 20089,
     config.ports?.geminiProxy || 20090,
-    config.ports?.opencodeProxy || 20091
+    config.ports?.opencodeProxy || 20091,
+    config.ports?.piProxy || 20092
   ].filter((port, index, list) => Number.isInteger(port) && port > 0 && list.indexOf(port) === index);
 }
 
@@ -500,7 +500,7 @@ async function handleStart() {
   try {
     const config = loadConfig();
     const port = config.ports?.webUI || 19999;
-    const enableHost = hasHostFlag();
+    const enableHost = process.argv.includes('--host');
     const enableHttps = process.argv.includes('--https');
     fs.mkdirSync(PATHS.logs, { recursive: true });
 
@@ -668,6 +668,7 @@ async function handleStatus() {
     const codexActive = fs.existsSync(PATHS.activeChannel.codex);
     const geminiActive = fs.existsSync(PATHS.activeChannel.gemini);
     const opencodeActive = fs.existsSync(PATHS.activeChannel.opencode);
+    const piActive = fs.existsSync(PATHS.activeChannel.pi);
 
     console.log(chalk.bold('\n[PROXY] 代理服务:'));
 
@@ -683,6 +684,9 @@ async function handleStatus() {
     console.log(chalk.gray('  OpenCode:') + (opencodeActive ? chalk.green('[OK] 运行中') : chalk.gray('[STOP]  未启动')) +
       chalk.gray(` (http://localhost:${config.ports?.opencodeProxy || 20091})`));
 
+    console.log(chalk.gray('  OMP:     ') + (piActive ? chalk.green('[OK] 运行中') : chalk.gray('[STOP]  未启动')) +
+      chalk.gray(` (http://localhost:${config.ports?.piProxy || 20092})`));
+
     console.log(chalk.bold('\n[TIP] 提示:'));
     console.log(chalk.gray('  • 代理服务通过 Web UI 界面控制'));
     console.log(chalk.gray('  • 使用 ') + chalk.cyan('ctx logs [type]') + chalk.gray(' 查看日志'));
@@ -734,7 +738,6 @@ module.exports = {
   _test: {
     detectStalePm2RuntimeIssue,
     extractMissingPm2ForkScriptPath,
-    buildStartOptions,
     shouldTreatPortOwnershipAsReady,
     getManagedPorts,
     shouldStopPM2Process

package/src/commands/doctor.js

@@ -148,13 +148,7 @@ async function checkConfigFiles() {
  */
 async function checkPorts() {
   const config = loadConfig();
-  const ports = {
-    'Web UI': config.ports?.webUI || 19999,
-    'Claude Proxy': config.ports?.proxy || 20088,
-    'Codex Proxy': config.ports?.codexProxy || 20089,
-    'Gemini Proxy': config.ports?.geminiProxy || 20090,
-    'OpenCode Proxy': config.ports?.opencodeProxy || 20091
-  };
+  const ports = buildPortCheckMap(config);
 
   const conflicts = [];
 
@@ -181,6 +175,17 @@ async function checkPorts() {
   }
 }
 
+function buildPortCheckMap(config = {}) {
+  return {
+    'Web UI': config.ports?.webUI || 19999,
+    'Claude Proxy': config.ports?.proxy || 20088,
+    'Codex Proxy': config.ports?.codexProxy || 20089,
+    'Gemini Proxy': config.ports?.geminiProxy || 20090,
+    'OpenCode Proxy': config.ports?.opencodeProxy || 20091,
+    'OMP Proxy': config.ports?.piProxy || 20092
+  };
+}
+
 /**
  * 检查 Claude Code 配置
  */
@@ -329,5 +334,9 @@ async function checkDiskSpace() {
 }
 
 module.exports = {
-  handleDoctor
+  handleDoctor,
+  _test: {
+    buildPortCheckMap,
+    checkPorts
+  }
 };

package/src/commands/logs.js

@@ -3,6 +3,7 @@ const fs = require('fs');
 const path = require('path');
 const { spawn } = require('child_process');
 const { PATHS } = require('../config/paths');
+const { normalizePlatformKey } = require('../shared/platforms');
 
 const LOGS_DIR = PATHS.logs;
 
@@ -13,6 +14,34 @@ const LOG_FILES = {
   gemini: 'gemini-proxy.log',
   opencode: 'opencode-proxy.log'
 };
+const LOG_ALIASES = {
+  pi: 'ui',
+  omp: 'ui'
+};
+const LOG_ALIAS_NOTES = {
+  pi: 'OMP 受管 provider 配置没有独立请求代理日志，相关活动记录在 UI/server 日志中。',
+  omp: 'OMP 受管 provider 配置没有独立请求代理日志，相关活动记录在 UI/server 日志中。'
+};
+
+function getSupportedLogTypes() {
+  return [...Object.keys(LOG_FILES), 'pi', 'omp'];
+}
+
+function resolveLogType(type) {
+  const normalized = normalizePlatformKey(type);
+  if (!normalized) {
+    return { requestedType: type, type: null, file: null, note: null };
+  }
+  const aliasTarget = LOG_ALIASES[normalized];
+  const resolvedType = aliasTarget || normalized;
+  return {
+    requestedType: type,
+    normalizedType: normalized,
+    type: resolvedType,
+    file: LOG_FILES[resolvedType] || null,
+    note: LOG_ALIAS_NOTES[normalized] || null
+  };
+}
 
 /**
  * 确保日志目录存在
@@ -44,12 +73,16 @@ async function handleLogs(type = null, options = {}) {
   }
 
   // 显示特定类型的日志
-  const logFile = LOG_FILES[type];
+  const resolved = resolveLogType(type);
+  const logFile = resolved.file;
   if (!logFile) {
     console.error(chalk.red(`\n[ERROR] 无效的日志类型: ${type}\n`));
-    console.log(chalk.gray('支持的类型: ui, claude, codex, gemini, opencode\n'));
+    console.log(chalk.gray(`支持的类型: ${getSupportedLogTypes().join(', ')}\n`));
     process.exit(1);
   }
+  if (resolved.note) {
+    console.log(chalk.yellow(`\n[INFO] ${resolved.note}\n`));
+  }
 
   const logPath = path.join(LOGS_DIR, logFile);
 
@@ -60,7 +93,7 @@ async function handleLogs(type = null, options = {}) {
     return;
   }
 
-  console.log(chalk.cyan(`\n[LOG] ${type.toUpperCase()} 日志 ${follow ? '(实时)' : `(最近 ${lines} 行)`}\n`));
+  console.log(chalk.cyan(`\n[LOG] ${String(type).toUpperCase()} 日志 ${follow ? '(实时)' : `(最近 ${lines} 行)`}\n`));
   console.log(chalk.gray(`=`.repeat(60)) + '\n');
 
   if (follow) {
@@ -116,7 +149,7 @@ function showAllLogs(lines, follow) {
   });
 
   console.log(chalk.gray(`\n=`.repeat(60)));
-  console.log(chalk.gray(`\n[TIP] 使用 `) + chalk.cyan(`ctx logs ${Object.keys(LOG_FILES).join('|')}`) + chalk.gray(` 查看特定类型日志\n`));
+  console.log(chalk.gray(`\n[TIP] 使用 `) + chalk.cyan(`ctx logs ${getSupportedLogTypes().join('|')}`) + chalk.gray(` 查看特定类型日志\n`));
 }
 
 /**
@@ -226,11 +259,18 @@ function clearLogs(type) {
     console.log(chalk.green(`\n[OK] 共清空 ${cleared} 个日志文件\n`));
   } else {
     // 清空特定类型日志
-    const logFile = LOG_FILES[type];
+    const resolved = resolveLogType(type);
+    const logFile = resolved.file;
     if (!logFile) {
       console.error(chalk.red(`\n[ERROR] 无效的日志类型: ${type}\n`));
+      console.log(chalk.gray(`支持的类型: ${getSupportedLogTypes().join(', ')}\n`));
       process.exit(1);
     }
+    if (resolved.note) {
+      console.log(chalk.yellow(`\n[INFO] ${resolved.note}`));
+      console.log(chalk.gray('如需清空该日志，请使用 ctx logs ui --clear。\n'));
+      return;
+    }
 
     const logPath = path.join(LOGS_DIR, logFile);
     if (fs.existsSync(logPath)) {
@@ -289,6 +329,8 @@ function getTypeColor(type) {
 module.exports = {
   handleLogs,
   _test: {
-    buildFollowProcessSpec
+    buildFollowProcessSpec,
+    getSupportedLogTypes,
+    resolveLogType
   }
 };

package/src/commands/port-config.js

@@ -4,110 +4,111 @@ const inquirer = require('inquirer');
 const { loadConfig, saveConfig } = require('../config/loader');
 const { HOME_DIR } = require('../config/paths');
 
-/**
- * 配置端口
- */
-async function handlePortConfig() {
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    console.log(chalk.yellow('\n当前环境不支持交互式端口配置，请在本地终端中运行 `ctx port`。\n'));
-    return;
-  }
-
-  console.clear();
-  console.log(chalk.bold.cyan('\n╔=======================================╗'));
-  console.log(chalk.bold.cyan('║          端口配置          ║'));
-  console.log(chalk.bold.cyan('╚=======================================╝\n'));
-
-  const config = loadConfig();
-
-  console.log(chalk.cyan('当前端口配置:'));
-  console.log(chalk.gray(`• Web UI 页面端口:     ${config.ports.webUI} (同时用于 WebSocket)`));
-  console.log(chalk.gray(`• Claude 代理端口:     ${config.ports.proxy}`));
-  console.log(chalk.gray(`• Codex 代理端口:      ${config.ports.codexProxy || 20089}`));
-  console.log(chalk.gray(`• Gemini 代理端口:     ${config.ports.geminiProxy || 20090}`));
-  console.log(chalk.gray(`• OpenCode 代理端口:   ${config.ports.opencodeProxy || 20091}\n`));
+function normalizePort(value) {
+  return parseInt(value, 10);
+}
 
-  console.log(chalk.yellow('说明:'));
-  console.log(chalk.gray('• 端口范围: 1024-65535'));
-  console.log(chalk.gray('• 修改后需要重启相关服务才能生效'));
-  console.log(chalk.gray('• 如果端口被占用，请修改为其他端口\n'));
+function validatePort(input) {
+  const port = normalizePort(input);
+  if (isNaN(port) || port < 1024 || port > 65535) {
+    return '端口必须是 1024-65535 之间的数字';
+  }
+  return true;
+}
 
-  const answers = await inquirer.prompt([
+function buildPortQuestions(config = {}) {
+  const ports = config.ports || {};
+  return [
     {
       type: 'input',
       name: 'webUI',
       message: 'Web UI 页面端口 (同时用于 WebSocket):',
-      default: config.ports.webUI,
-      validate: (input) => {
-        const port = parseInt(input);
-        if (isNaN(port) || port < 1024 || port > 65535) {
-          return '端口必须是 1024-65535 之间的数字';
-        }
-        return true;
-      },
+      default: ports.webUI || 19999,
+      validate: validatePort,
     },
     {
       type: 'input',
       name: 'proxy',
       message: 'Claude 代理服务端口:',
-      default: config.ports.proxy,
-      validate: (input) => {
-        const port = parseInt(input);
-        if (isNaN(port) || port < 1024 || port > 65535) {
-          return '端口必须是 1024-65535 之间的数字';
-        }
-        return true;
-      },
+      default: ports.proxy || 20088,
+      validate: validatePort,
     },
     {
       type: 'input',
       name: 'codexProxy',
       message: 'Codex 代理服务端口:',
-      default: config.ports.codexProxy || 20089,
-      validate: (input) => {
-        const port = parseInt(input);
-        if (isNaN(port) || port < 1024 || port > 65535) {
-          return '端口必须是 1024-65535 之间的数字';
-        }
-        return true;
-      },
+      default: ports.codexProxy || 20089,
+      validate: validatePort,
     },
     {
       type: 'input',
       name: 'geminiProxy',
       message: 'Gemini 代理服务端口:',
-      default: config.ports.geminiProxy || 20090,
-      validate: (input) => {
-        const port = parseInt(input);
-        if (isNaN(port) || port < 1024 || port > 65535) {
-          return '端口必须是 1024-65535 之间的数字';
-        }
-        return true;
-      },
+      default: ports.geminiProxy || 20090,
+      validate: validatePort,
     },
     {
       type: 'input',
       name: 'opencodeProxy',
       message: 'OpenCode 代理服务端口:',
-      default: config.ports.opencodeProxy || 20091,
-      validate: (input) => {
-        const port = parseInt(input);
-        if (isNaN(port) || port < 1024 || port > 65535) {
-          return '端口必须是 1024-65535 之间的数字';
-        }
-        return true;
-      },
+      default: ports.opencodeProxy || 20091,
+      validate: validatePort,
     },
-  ]);
+    {
+      type: 'input',
+      name: 'piProxy',
+      message: 'OMP 代理服务端口:',
+      default: ports.piProxy || 20092,
+      validate: validatePort,
+    },
+  ];
+}
 
-  // 更新配置
-  config.ports = {
-    webUI: parseInt(answers.webUI),
-    proxy: parseInt(answers.proxy),
-    codexProxy: parseInt(answers.codexProxy),
-    geminiProxy: parseInt(answers.geminiProxy),
-    opencodeProxy: parseInt(answers.opencodeProxy),
+function buildPortsConfig(answers = {}) {
+  return {
+    webUI: normalizePort(answers.webUI),
+    proxy: normalizePort(answers.proxy),
+    codexProxy: normalizePort(answers.codexProxy),
+    geminiProxy: normalizePort(answers.geminiProxy),
+    opencodeProxy: normalizePort(answers.opencodeProxy),
+    piProxy: normalizePort(answers.piProxy),
   };
+}
+
+/**
+ * 配置端口
+ */
+async function handlePortConfig() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    console.log(chalk.yellow('\n当前环境不支持交互式端口配置，请在本地终端中运行 `ctx port`。\n'));
+    return;
+  }
+
+  console.clear();
+  console.log(chalk.bold.cyan('\n╔=======================================╗'));
+  console.log(chalk.bold.cyan('║          端口配置          ║'));
+  console.log(chalk.bold.cyan('╚=======================================╝\n'));
+
+  const config = loadConfig();
+  const ports = config.ports || {};
+
+  console.log(chalk.cyan('当前端口配置:'));
+  console.log(chalk.gray(`• Web UI 页面端口:     ${ports.webUI || 19999} (同时用于 WebSocket)`));
+  console.log(chalk.gray(`• Claude 代理端口:     ${ports.proxy || 20088}`));
+  console.log(chalk.gray(`• Codex 代理端口:      ${ports.codexProxy || 20089}`));
+  console.log(chalk.gray(`• Gemini 代理端口:     ${ports.geminiProxy || 20090}`));
+  console.log(chalk.gray(`• OpenCode 代理端口:   ${ports.opencodeProxy || 20091}`));
+  console.log(chalk.gray(`• OMP 代理端口:        ${ports.piProxy || 20092}\n`));
+
+  console.log(chalk.yellow('说明:'));
+  console.log(chalk.gray('• 端口范围: 1024-65535'));
+  console.log(chalk.gray('• 修改后需要重启相关服务才能生效'));
+  console.log(chalk.gray('• 如果端口被占用，请修改为其他端口\n'));
+
+  const answers = await inquirer.prompt(buildPortQuestions(config));
+
+  // 更新配置
+  config.ports = buildPortsConfig(answers);
 
   // 保存配置（保留其余字段）
   saveConfig({
@@ -132,4 +133,9 @@ async function handlePortConfig() {
 
 module.exports = {
   handlePortConfig,
+  _test: {
+    buildPortQuestions,
+    buildPortsConfig,
+    validatePort
+  }
 };