coding-tool-x 3.8.4 → 3.8.6

package/src/commands/channels.js

@@ -3,89 +3,61 @@ const chalk = require('chalk');
 const inquirer = require('inquirer');
 const { loadConfig } = require('../config/loader');
 const { normalizePlatformKey } = require('../shared/platforms');
+const { getPlatformRegistry } = require('../platforms/runtime');
 
-/**
- * 获取当前类型的渠道服务
- */
-function getChannelServices(cliType) {
-  const normalizedCliType = normalizePlatformKey(cliType || 'claude');
-  if (normalizedCliType === 'claude') {
-    const {
-      getAllChannels,
-      createChannel,
-      updateChannel
-    } = require('../server/services/channels');
-    const { getProxyStatus } = require('../server/proxy-server');
-    return { getAllChannels, createChannel, updateChannel, getProxyStatus };
-  } else if (normalizedCliType === 'codex') {
-    const {
-      getChannels,
-      createChannel,
-      updateChannel
-    } = require('../server/services/codex-channels');
-    const { getCodexProxyStatus } = require('../server/codex-proxy-server');
-    return {
-      getAllChannels: () => {
-        const result = getChannels();
-        return Array.isArray(result?.channels) ? result.channels : [];
-      },
-      createChannel,
-      updateChannel,
-      getProxyStatus: getCodexProxyStatus
-    };
-  } else if (normalizedCliType === 'gemini') {
-    const {
-      getChannels,
-      createChannel,
-      updateChannel
-    } = require('../server/services/gemini-channels');
-    const { getGeminiProxyStatus } = require('../server/gemini-proxy-server');
-    return {
-      getAllChannels: () => {
-        const result = getChannels();
-        return Array.isArray(result?.channels) ? result.channels : [];
-      },
-      createChannel,
-      updateChannel,
-      getProxyStatus: getGeminiProxyStatus
-    };
-  } else if (normalizedCliType === 'opencode') {
-    const {
-      getChannels,
-      createChannel,
-      updateChannel
-    } = require('../server/services/opencode-channels');
-    const { getOpenCodeProxyStatus } = require('../server/opencode-proxy-server');
-    return {
-      getAllChannels: () => {
-        const result = getChannels();
-        return Array.isArray(result?.channels) ? result.channels : [];
-      },
-      createChannel,
-      updateChannel,
-      getProxyStatus: getOpenCodeProxyStatus
-    };
-  } else if (normalizedCliType === 'omp') {
-    const {
-      getChannels,
-      createChannel,
-      updateChannel
-    } = require('../server/services/omp-channels');
-    const { getOmpProxyStatus } = require('../server/omp-proxy-server');
-    return {
-      getAllChannels: () => {
-        const result = getChannels();
-        return Array.isArray(result?.channels) ? result.channels : [];
-      },
-      createChannel,
-      updateChannel,
-      getProxyStatus: getOmpProxyStatus,
-      supportsCliCreate: false,
-      managedProviderConfig: true
-    };
+function getPlatformRuntime() {
+  return require('../platforms/runtime').getPlatformRuntime();
+}
+
+function unwrapDriverResult(result) {
+  if (!result || typeof result !== 'object' || !result.status) {
+    return result;
+  }
+  if (result.status === 'ok') {
+    return result.data;
   }
+  throw result.cause instanceof Error
+    ? result.cause
+    : new Error(result.error || `Driver operation ${result.operation || 'unknown'} failed`);
+}
 
-  return null;
+function getChannelServices(cliType, runtime = getPlatformRuntime()) {
+  const platform = normalizePlatformKey(cliType || 'claude');
+  const channelsDriver = runtime?.getDriver?.(platform, 'channels');
+  const proxyDriver = runtime?.getDriver?.(platform, 'proxy');
+  if (!channelsDriver && !proxyDriver) {
+    return null;
+  }
+
+  const channelMetadata = channelsDriver?.getCliMetadata?.() || {};
+  const proxyMetadata = proxyDriver?.getCliMetadata?.() || {};
+  const metadata = { ...channelMetadata, ...proxyMetadata };
+  const unwrapChannels = (operation, ...args) => {
+    if (typeof channelsDriver?.[operation] !== 'function') return null;
+    return unwrapDriverResult(channelsDriver[operation](...args));
+  };
+
+  return {
+    ...metadata,
+    getAllChannels: () => {
+      const value = unwrapChannels('list');
+      return Array.isArray(value) ? value : (value?.channels || []);
+    },
+    createChannel: input => unwrapChannels('create', input),
+    updateChannel: (id, patch) => unwrapChannels('update', id, patch),
+    activateChannel: id => unwrapChannels('applyNativeConfig', id),
+    getBestChannelForRestore: () => unwrapChannels('getBestChannelForRestore'),
+    formatChannelDetails: channel => channelsDriver?.formatCliChannelDetails?.(channel) || [],
+    getProxyStatus: () => proxyDriver ? unwrapDriverResult(proxyDriver.status()) : null,
+    startProxyServer: options => proxyDriver
+      ? unwrapDriverResult(proxyDriver.start(options))
+      : null,
+    stopProxyServer: options => proxyDriver
+      ? unwrapDriverResult(proxyDriver.stop(options))
+      : null,
+    channelsDriver,
+    proxyDriver
+  };
 }
 
 /**
@@ -106,19 +78,17 @@ async function handleChannelManagement() {
     return;
   }
 
-  const channels = services.getAllChannels();
-
   if (channels.length === 0) {
     console.log(chalk.yellow('还没有添加任何渠道'));
-    if (cliType === 'omp') {
-      console.log(chalk.gray('提示: OMP 渠道请通过 Web UI 或 API 添加后，再在这里启停调度。\n'));
+    if (services.createUnavailableMessage) {
+      console.log(chalk.gray(`${services.createUnavailableMessage}\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([
+    await inquirer.prompt([
       {
         type: 'list',
         name: 'action',
@@ -156,11 +126,9 @@ async function handleAddChannel() {
   const services = getChannelServices(cliType);
 
   if (!services || services.supportsCliCreate === false || typeof services.createChannel !== 'function') {
-    if (cliType === 'omp') {
-      console.log(chalk.yellow('OMP 渠道创建/编辑需要使用 Web UI 或 API，以便配置 providerKey、providerApi、模型白名单等 OMP 字段。\n'));
-    } else {
-      console.log(chalk.red(`当前 CLI 类型 (${cliType}) 暂不支持添加渠道\n`));
-    }
+    console.log(chalk.red(
+      `${services?.createUnavailableMessage || `当前 CLI 类型 (${cliType}) 暂不支持添加渠道`}\n`
+    ));
     await inquirer.prompt([{ type: 'input', name: 'continue', message: '按回车返回...' }]);
     return;
   }
@@ -210,76 +178,30 @@ async function handleAddChannel() {
     },
   ]);
 
-  try {
-    let channel;
-
-    // Claude 类型的参数: (name, baseUrl, apiKey, websiteUrl, extraConfig)
-    if (cliType === 'claude') {
-      channel = services.createChannel(
-        answers.name.trim(),
-        answers.baseUrl.trim(),
-        answers.apiKey.trim(),
-        answers.websiteUrl.trim() || undefined
-      );
-    }
-    // Codex 类型的参数: (name, providerKey, baseUrl, apiKey, wireApi, extraConfig)
-    else if (cliType === 'codex') {
-      // Codex 需要额外的 providerKey 和 wireApi 参数
-      // 在这里简化为使用 name 作为 providerKey，wireApi 固定为 'responses'
-      channel = services.createChannel(
-        answers.name.trim(),
-        answers.name.trim().toLowerCase().replace(/\s+/g, '-'), // 生成 providerKey
-        answers.baseUrl.trim(),
-        answers.apiKey.trim(),
-        'responses', // wireApi 固定值
-        { websiteUrl: answers.websiteUrl.trim() || undefined }
-      );
-    }
-    // Gemini 类型的参数: (name, baseUrl, apiKey, model, extraConfig)
-    else if (cliType === 'gemini') {
-      // Gemini 需要 model 参数
-      const modelAnswer = await inquirer.prompt([
-        {
-          type: 'input',
-          name: 'model',
-          message: '模型名称 (默认: gemini-2.5-pro):',
-          default: 'gemini-2.5-pro'
-        }
-      ]);
-
-      channel = services.createChannel(
-        answers.name.trim(),
-        answers.baseUrl.trim(),
-        answers.apiKey.trim(),
-        modelAnswer.model.trim(),
-        { websiteUrl: answers.websiteUrl.trim() || undefined }
-      );
-    } else if (cliType === 'opencode') {
-      const extraAnswers = await inquirer.prompt([
-        {
-          type: 'input',
-          name: 'wireApi',
-          message: 'Wire API (默认: openai):',
-          default: 'openai'
-        },
-        {
-          type: 'input',
-          name: 'model',
-          message: '默认模型（可选，直接回车跳过）:'
-        }
-      ]);
-
-      channel = services.createChannel(
-        answers.name.trim(),
-        answers.baseUrl.trim(),
-        answers.apiKey.trim(),
-        {
-          wireApi: extraAnswers.wireApi.trim() || 'openai',
-          model: extraAnswers.model.trim() || null,
-          websiteUrl: answers.websiteUrl.trim() || undefined
-        }
-      );
+  const extraQuestions = services.createQuestions || [];
+  const extraAnswers = extraQuestions.length > 0
+    ? await inquirer.prompt(extraQuestions)
+    : {};
+
+  const websiteUrl = answers.websiteUrl.trim() || undefined;
+  const createInput = {
+    ...services.createDefaults,
+    ...answers,
+    ...extraAnswers,
+    name: answers.name.trim(),
+    baseUrl: answers.baseUrl.trim(),
+    apiKey: answers.apiKey.trim(),
+    websiteUrl,
+    providerKey: answers.name.trim().toLowerCase().replace(/\s+/g, '-'),
+    extra: {
+      ...services.createDefaults,
+      ...extraAnswers,
+      websiteUrl
     }
+  };
+
+  try {
+    const channel = services.createChannel(createInput);
 
     console.log(chalk.green(`\n[OK] 渠道添加成功: ${channel.name}\n`));
     console.log(chalk.gray('提示: 使用"渠道管理"功能来启用此渠道\n'));
@@ -356,7 +278,6 @@ module.exports = {
  * 统一的多渠道选择处理
  */
 async function handleChannelToggle(channels, services, cliType) {
-  const normalizedCliType = normalizePlatformKey(cliType || 'claude');
   const choices = channels.map(channel => {
     const enabled = channel.enabled !== false;
     const detailParts = [];
@@ -366,30 +287,7 @@ async function handleChannelToggle(channels, services, cliType) {
       detailParts.push(cleaned);
     }
 
-    if (normalizedCliType === 'codex' && channel.providerKey) {
-      detailParts.push(`provider ${channel.providerKey}`);
-    }
-
-    if (normalizedCliType === 'gemini' && channel.model) {
-      detailParts.push(`model ${channel.model}`);
-    }
-
-    if (normalizedCliType === 'omp') {
-      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}`);
-      }
-    }
+    detailParts.push(...services.formatChannelDetails(channel));
 
     if (channel.maxConcurrency) {
       detailParts.push(`并发 ${channel.maxConcurrency}`);
@@ -564,13 +462,12 @@ function broadcastSchedulerSnapshot(source = 'claude') {
 }
 
 function buildSchedulerSources() {
-  return [
-    { key: 'claude', label: 'Claude (Claude Code)' },
-    { key: 'codex', label: 'Codex (OpenAI)' },
-    { key: 'gemini', label: 'Gemini' },
-    { key: 'opencode', label: 'OpenCode' },
-    { key: 'omp', label: 'OMP' }
-  ];
+  return getPlatformRegistry()
+    .list({ enabledOnly: true })
+    .map(platform => ({
+      key: platform.key,
+      label: platform.label || platform.key
+    }));
 }
 
 async function handleLegacySwitch(channels, services) {

package/src/commands/cli-type.js

@@ -3,12 +3,17 @@ const chalk = require('chalk');
 const inquirer = require('inquirer');
 const { loadConfig, saveConfig } = require('../config/loader');
 
-const CLI_TYPES = {
-  claude: { name: 'Claude Code', color: 'cyan' },
-  codex: { name: 'Codex', color: 'green' },
-  gemini: { name: 'Gemini', color: 'magenta' },
-  opencode: { name: 'OpenCode', color: 'yellow' }
-};
+function getCliTypes(registry) {
+  const { createPlatformCommandRegistry } = require('./platform-command-registry');
+  return Object.fromEntries(
+    createPlatformCommandRegistry({ registry }).list()
+      .filter(platform => platform.cliSelectable !== false)
+      .map(platform => [platform.key, {
+        name: platform.label || platform.title || platform.key,
+        color: platform.terminalColor || 'cyan'
+      }])
+  );
+}
 
 /**
  * 切换CLI类型
@@ -20,13 +25,14 @@ async function handleSwitchCliType() {
   console.log(chalk.bold.cyan('╚=======================================╝\n'));
 
   const config = loadConfig();
+  const cliTypes = getCliTypes();
   const currentType = config.currentCliType || 'claude';
-  const currentTypeInfo = CLI_TYPES[currentType] || CLI_TYPES.claude;
+  const currentTypeInfo = cliTypes[currentType] || cliTypes.claude || { name: currentType, color: 'cyan' };
 
   console.log(chalk.gray(`当前类型: ${currentTypeInfo.name}\n`));
 
   // 构建类型选项
-  const choices = Object.entries(CLI_TYPES).map(([type, info]) => {
+  const choices = Object.entries(cliTypes).map(([type, info]) => {
     let name = '';
 
     // 如果是当前类型，添加[v]标记
@@ -37,7 +43,8 @@ async function handleSwitchCliType() {
     }
 
     // 类型名称
-    name += chalk[info.color](info.name);
+    const colorize = typeof chalk[info.color] === 'function' ? chalk[info.color] : chalk.cyan;
+    name += colorize(info.name);
 
     return {
       name,
@@ -81,7 +88,7 @@ async function handleSwitchCliType() {
   config.currentCliType = selectedType;
   saveConfig(config);
 
-  console.log(chalk.green(`\n[OK] 已切换到 ${CLI_TYPES[selectedType].name}\n`));
+  console.log(chalk.green(`\n[OK] 已切换到 ${cliTypes[selectedType].name}\n`));
   console.log(chalk.gray('下次启动时将使用新的类型\n'));
 
   await inquirer.prompt([
@@ -97,5 +104,6 @@ async function handleSwitchCliType() {
 }
 
 module.exports = {
-  handleSwitchCliType
+  handleSwitchCliType,
+  _test: { getCliTypes }
 };

package/src/commands/daemon.js

@@ -12,7 +12,7 @@ const {
   formatPortToolIssue
 } = require('../utils/port-helper');
 const { hasHostFlag } = require('../utils/cli-flags');
-
+const { getPlatformRegistry, getPlatformRuntime } = require('../platforms/runtime');
 const PM2_APP_NAME = 'cc-tool';
 const STARTUP_LOG_FILE = 'cc-tool-out.log';
 const CURRENT_PM2_FORK_PATH = resolveCurrentPm2ForkPath();
@@ -254,15 +254,76 @@ function shouldStopPM2Process(status) {
   return !['stopped', 'errored', 'stopping', 'launching'].includes(String(status || '').toLowerCase());
 }
 
-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,
-    config.ports?.ompProxy || 20092
-  ].filter((port, index, list) => Number.isInteger(port) && port > 0 && list.indexOf(port) === index);
+function listProxyPlatforms(registry = getPlatformRegistry()) {
+  if (!registry || typeof registry.list !== 'function') return [];
+  try {
+    return registry.list({ enabledOnly: true }).filter(platform => platform && platform.key);
+  } catch (_) {
+    return [];
+  }
+}
+
+function getPlatformPort(platform, config = {}) {
+  const configured = platform.portKey && config.ports?.[platform.portKey];
+  return configured || platform.defaultPort || null;
+}
+
+async function getProxyStatusEntries({ registry = getPlatformRegistry(), runtime = getPlatformRuntime(), config = loadConfig() } = {}) {
+  const entries = [];
+  for (const platform of listProxyPlatforms(registry)) {
+    const context = {
+      platform: platform.key,
+      capability: 'proxy',
+      operation: 'status'
+    };
+    try {
+      const driver = runtime && typeof runtime.getDriver === 'function'
+        ? runtime.getDriver(platform.key, 'proxy')
+        : null;
+      if (!driver || (typeof driver.status === 'string' && driver.status !== 'ok')) {
+        entries.push({ platform, state: { status: 'unsupported', ...context }, port: getPlatformPort(platform, config) });
+        continue;
+      }
+      if (typeof driver.status !== 'function') {
+        entries.push({ platform, state: { status: 'unsupported', ...context }, port: getPlatformPort(platform, config) });
+        continue;
+      }
+      const state = await Promise.resolve(driver.status());
+      if (state && typeof state.status === 'string' && state.status !== 'ok') {
+        entries.push({ platform, state: { ...state, ...context }, port: getPlatformPort(platform, config) });
+      } else {
+        entries.push({ platform, state: state || {}, port: getPlatformPort(platform, config) });
+      }
+    } catch (error) {
+      entries.push({
+        platform,
+        state: {
+          status: 'failed',
+          ...context,
+          error: error && error.message ? error.message : String(error)
+        },
+        port: getPlatformPort(platform, config)
+      });
+    }
+  }
+  return entries;
+}
+
+function getManagedPorts(config = loadConfig(), registry = getPlatformRegistry()) {
+  const configuredPorts = config.ports && typeof config.ports === 'object' ? config.ports : {};
+  const ports = [configuredPorts.webUI || 19999];
+  const configuredKeys = new Set(['webUI']);
+  for (const [key, port] of Object.entries(configuredPorts)) {
+    if (configuredKeys.has(key)) continue;
+    configuredKeys.add(key);
+    if (port) ports.push(port);
+  }
+  for (const platform of listProxyPlatforms(registry)) {
+    if (platform.portKey && configuredKeys.has(platform.portKey)) continue;
+    const port = getPlatformPort(platform, config);
+    if (port) ports.push(port);
+  }
+  return ports.filter((port, index, list) => Number.isInteger(port) && port > 0 && list.indexOf(port) === index);
 }
 
 async function cleanupManagedPorts(config = loadConfig(), options = {}) {
@@ -321,11 +382,18 @@ async function stopAllManagedInstances(existingProcess, config = loadConfig()) {
   }
 
   const cleanup = await cleanupManagedPorts(config, { timeoutMs: 3000 });
+  let lockCleanup = { removed: [], retained: [] };
+  try {
+    lockCleanup = require('../server/services/session-history-index').cleanupStaleInventoryLocks();
+  } catch (error) {
+    warnings.push(`清理 session-history 锁失败: ${error.message}`);
+  }
 
   return {
     hadPM2Process,
     pm2Status: status,
     cleanup,
+    lockCleanup,
     warnings
   };
 }
@@ -348,6 +416,9 @@ function printStopResult(result) {
     printPortToolIssue(cleanup.toolIssue);
     console.log(chalk.yellow('[TIP] 请检查是否有外部进程仍占用这些端口\n'));
   }
+  if (cleanup.lockCleanup?.removed?.length > 0) {
+    console.log(chalk.gray(`[CLEANUP] 已清理残留 session-history 锁: ${cleanup.lockCleanup.removed.length}`));
+  }
   warnings.forEach((warning) => {
     console.log(chalk.yellow(`[WARN]  ${warning}`));
   });
@@ -409,6 +480,7 @@ function buildStartOptions(port, enableHost, enableHttps) {
     script: path.join(__dirname, '../index.js'),
     args: pmArgs,
     interpreter: 'node',
+    windowsHide: true,
     autorestart: true,
     kill_timeout: 5000,
     max_memory_restart: '500M',
@@ -654,30 +726,28 @@ async function handleStatus() {
       console.log(chalk.gray('  [ERROR] 状态: 未运行'));
     }
 
-    // 代理服务状态（从运行时文件检测）
-    ensureStorageDirMigrated();
-    const claudeActive = fs.existsSync(PATHS.activeChannel.claude);
-    const codexActive = fs.existsSync(PATHS.activeChannel.codex);
-    const geminiActive = fs.existsSync(PATHS.activeChannel.gemini);
-    const opencodeActive = fs.existsSync(PATHS.activeChannel.opencode);
-    const ompActive = fs.existsSync(PATHS.activeChannel.omp);
+    // 代理服务状态由 Registry 中声明的 proxy driver 提供
+    const proxyStatuses = await getProxyStatusEntries({ config });
 
     console.log(chalk.bold('\n[PROXY] 代理服务:'));
-
-    console.log(chalk.gray('  Claude:  ') + (claudeActive ? chalk.green('[OK] 运行中') : chalk.gray('[STOP]  未启动')) +
-      chalk.gray(` (http://localhost:${config.ports?.proxy || 20088})`));
-
-    console.log(chalk.gray('  Codex:   ') + (codexActive ? chalk.green('[OK] 运行中') : chalk.gray('[STOP]  未启动')) +
-      chalk.gray(` (http://localhost:${config.ports?.codexProxy || 20089})`));
-
-    console.log(chalk.gray('  Gemini:  ') + (geminiActive ? chalk.green('[OK] 运行中') : chalk.gray('[STOP]  未启动')) +
-      chalk.gray(` (http://localhost:${config.ports?.geminiProxy || 20090})`));
-
-    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:     ') + (ompActive ? chalk.green('[OK] 运行中') : chalk.gray('[STOP]  未启动')) +
-      chalk.gray(` (http://localhost:${config.ports?.ompProxy || 20092})`));
+    for (const entry of proxyStatuses) {
+      const label = `${entry.platform.label || entry.platform.key}:`.padEnd(10);
+      const state = entry.state || {};
+      const port = state.port || entry.port || '-';
+      if (state.status === 'unsupported') {
+        console.log(chalk.gray(`  ${label}${chalk.gray('[N/A]  不支持')}`));
+        continue;
+      }
+      if (state.status === 'failed') {
+        console.log(chalk.red(`  ${label}${chalk.red('[ERROR] 查询失败')}`) +
+          chalk.gray(` (${state.error || 'unknown error'})`));
+        continue;
+      }
+      console.log(chalk.gray(`  ${label}`) + (state.running
+        ? chalk.green('[OK] 运行中')
+        : chalk.gray('[STOP]  未启动')) +
+        chalk.gray(` (http://localhost:${port})`));
+    }
 
     console.log(chalk.bold('\n[TIP] 提示:'));
     console.log(chalk.gray('  • 代理服务通过 Web UI 界面控制'));
@@ -733,6 +803,8 @@ module.exports = {
     buildStartOptions,
     shouldTreatPortOwnershipAsReady,
     getManagedPorts,
+    getProxyStatusEntries,
+    listProxyPlatforms,
     shouldStopPM2Process
   }
 };

package/src/commands/doctor.js

@@ -6,6 +6,8 @@ const { promisify } = require('util');
 const { loadConfig, getConfigFilePath } = require('../config/loader');
 const { PATHS, NATIVE_PATHS } = require('../config/paths');
 const { isPortInUse } = require('../utils/port-helper');
+const { getPlatformCatalog } = require('../server/services/platform-catalog');
+const { getPlatformContext } = require('../server/platform-context');
 
 const execAsync = promisify(exec);
 
@@ -176,21 +178,26 @@ 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?.ompProxy || 20092
-  };
+  const catalog = getPlatformCatalog();
+  return Object.fromEntries(catalog.ports().map(entry => [
+    entry.platform ? `${entry.platform === 'claude' ? 'Claude' : (catalog.get(entry.platform)?.label || entry.platform)} Proxy` : entry.label,
+    config.ports?.[entry.key] || entry.defaultPort
+  ]));
 }
 
 /**
  * 检查 Claude Code 配置
  */
 async function checkClaudeConfig() {
-  const settingsPath = NATIVE_PATHS.claude.settings;
+  let settingsPath = NATIVE_PATHS.claude.settings;
+  try {
+    const pathContext = getPlatformContext().registry.resolvePathContext('claude');
+    if (pathContext?.customized && pathContext.native?.settings) {
+      settingsPath = pathContext.native.settings;
+    }
+  } catch (_) {
+    // Keep the legacy path when the registry is unavailable during diagnostics.
+  }
   const exists = fs.existsSync(settingsPath);
 
   if (exists) {