coding-tool-x 3.8.4 → 3.8.5

package/src/config/paths.js

@@ -24,6 +24,19 @@ const RUNTIME_DIR = path.join(STORAGE_DIR, 'runtime');
 const CACHE_DIR = path.join(STORAGE_DIR, 'cache');
 const CACHE_SKILLS_DIR = path.join(CACHE_DIR, 'skills');
 const CACHE_PLUGINS_DIR = path.join(CACHE_DIR, 'plugins');
+const OMP_PATH_CACHE_VERSION = 1;
+const OMP_PATH_CACHE_FILE = path.join(CONFIG_DIR, 'omp-path.json');
+const OMP_PATH_ENV_KEYS = [
+  'HOME',
+  'USERPROFILE',
+  'APPDATA',
+  'PATH',
+  'OMP_COMMAND',
+  'OMP_CONFIG_DIR',
+  'OMP_PROFILE',
+  'PI_CODING_AGENT_DIR',
+  'OMP_CODING_AGENT_DIR'
+];
 const REPOS_DIR = path.join(STORAGE_DIR, 'repos');
 const REPOS_SKILLS_DIR = path.join(REPOS_DIR, 'skills');
 const REPOS_PLUGINS_DIR = path.join(REPOS_DIR, 'plugins');
@@ -37,6 +50,9 @@ const LEGACY_CONFLICTS_DIR = path.join(LEGACY_DIR, 'root-conflicts');
 const LEGACY_ROOT_BACKUPS_DIR = path.join(LEGACY_DIR, 'root-backups');
 const LEGACY_IMPORT_STATE_FILE = path.join(LEGACY_DIR, 'import-state.json');
 const LEGACY_STATS_DIR = path.join(LEGACY_DIR, 'stats');
+const CONTROL_MANIFEST_PATH = path.join(CONFIG_DIR, 'effective-control.json');
+const SKILL_ARTIFACTS_DIR = path.join(STORAGE_DIR, 'skill-artifacts');
+const SKILL_REFRESH_TASKS_PATH = path.join(RUNTIME_DIR, 'skill-refresh-tasks.json');
 
 // 旧目录（升级时自动合并到 ~/.cc-tool）
 const LEGACY_BASE_DIRS = [
@@ -378,7 +394,9 @@ const PATHS = {
 
   // 全局配置
   configFile: path.join(CONFIG_DIR, 'config.json'),
+  ompPathCache: OMP_PATH_CACHE_FILE,
   uiConfig: path.join(CONFIG_DIR, 'ui-config.json'),
+  platforms: path.join(CONFIG_DIR, 'platforms.json'),
   prompts: path.join(CONFIG_DIR, 'prompts.json'),
   mcpConfig: path.join(CONFIG_DIR, 'mcp-servers.json'),
   mcpServers: path.join(CONFIG_DIR, 'mcp-servers.json'),
@@ -395,6 +413,9 @@ const PATHS = {
   opencodeSessionOrder: path.join(CONFIG_DIR, 'opencode-session-order.json'),
   ompProjectOrder: path.join(CONFIG_DIR, 'omp-project-order.json'),
   ompSessionOrder: path.join(CONFIG_DIR, 'omp-session-order.json'),
+  effectiveControlManifest: CONTROL_MANIFEST_PATH,
+  skillArtifacts: SKILL_ARTIFACTS_DIR,
+  skillRefreshTasks: SKILL_REFRESH_TASKS_PATH,
 
   // 渠道配置
   channelsDir: CHANNELS_DIR,
@@ -435,8 +456,6 @@ const PATHS = {
   // 运行时、缓存、备份
   cache: CACHE_DIR,
   snapshotCache: path.join(CACHE_DIR, 'snapshots'),
-  sessionCache: path.join(CACHE_DIR, 'session-cache.json'),
-  sessionHasCache: path.join(CACHE_DIR, 'session-has-cache.json'),
   channelModels: path.join(CACHE_DIR, 'channel-models.json'),
   channelBalanceStrategies: path.join(CACHE_DIR, 'channel-balance-strategies.json'),
   sessionHistoryIndex: path.join(CACHE_DIR, 'session-history.sqlite'),
@@ -519,6 +538,65 @@ const PATHS = {
   }
 };
 
+const PLATFORM_STATE_KEY_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
+
+function normalizePlatformStateKey(platformKey) {
+  const key = String(platformKey || '').trim().toLowerCase();
+  return PLATFORM_STATE_KEY_PATTERN.test(key) ? key : '';
+}
+
+function getPlatformStatePath(category, platformKey, { basePaths = PATHS } = {}) {
+  const key = normalizePlatformStateKey(platformKey);
+  if (!key) return undefined;
+
+  const categoryPaths = basePaths && basePaths[category];
+  if (categoryPaths && typeof categoryPaths === 'object' && !Array.isArray(categoryPaths)) {
+    if (typeof categoryPaths[key] === 'string') return categoryPaths[key];
+  }
+
+  switch (category) {
+    case 'channels':
+      return path.join(basePaths.channelsDir, `${key}.json`);
+    case 'activeChannel':
+      return path.join(basePaths.activeChannelDir, `${key}.json`);
+    case 'proxyRuntime':
+      return path.join(path.dirname(basePaths.proxyRuntime.claude), `${key}-proxy.json`);
+    case 'requestSnapshots':
+      return path.join(path.dirname(basePaths.requestSnapshots.claude), `${key}.jsonl`);
+    case 'localSkills':
+      return path.join(path.dirname(basePaths.localSkills.claude), key);
+    case 'skillRepos':
+      return path.join(path.dirname(basePaths.skillRepos.claude), `${key}.json`);
+    case 'skillCaches':
+      return path.join(path.dirname(basePaths.skillCaches.claude), `${key}.json`);
+    case 'pluginRepos':
+      return path.join(path.dirname(basePaths.pluginRepos.claude), `${key}.json`);
+    case 'pluginMarketCache':
+      return path.join(path.dirname(basePaths.pluginMarketCache.claude), `${key}-market.json`);
+    case 'gatewaySecret':
+      return path.join(path.dirname(basePaths.ompGatewaySecret), `${key}-gateway-secret`);
+    default:
+      return undefined;
+  }
+}
+
+function getPlatformStatePaths(platformKey, options = {}) {
+  const key = normalizePlatformStateKey(platformKey);
+  if (!key) return {};
+  return {
+    channels: getPlatformStatePath('channels', key, options),
+    activeChannel: getPlatformStatePath('activeChannel', key, options),
+    proxyRuntime: getPlatformStatePath('proxyRuntime', key, options),
+    requestSnapshots: getPlatformStatePath('requestSnapshots', key, options),
+    localSkills: getPlatformStatePath('localSkills', key, options),
+    skillRepos: getPlatformStatePath('skillRepos', key, options),
+    skillCaches: getPlatformStatePath('skillCaches', key, options),
+    pluginRepos: getPlatformStatePath('pluginRepos', key, options),
+    pluginMarketCache: getPlatformStatePath('pluginMarketCache', key, options),
+    gatewaySecret: getPlatformStatePath('gatewaySecret', key, options)
+  };
+}
+
 const LEGACY_STORAGE_RELOCATIONS = [
   // 全局配置文件
   { source: rootEntry('config.json'), target: PATHS.configFile },
@@ -565,8 +643,6 @@ const LEGACY_STORAGE_RELOCATIONS = [
   { source: rootEntry('opencode-daily-stats'), target: PATHS.statistics.legacy.opencodeDaily },
 
   // 缓存、运行时、脚本
-  { source: rootEntry('session-cache.json'), target: PATHS.sessionCache },
-  { source: rootEntry('session-has-cache.json'), target: PATHS.sessionHasCache },
   { source: rootEntry('channel-models.json'), target: PATHS.channelModels },
   { source: rootEntry('proxy-runtime.json'), target: PATHS.proxyRuntime.claude },
   { source: rootEntry('claude-proxy-runtime.json'), target: PATHS.proxyRuntime.claude },
@@ -807,7 +883,66 @@ function normalizeOmpProfileName(profile = '') {
   return value && value !== 'default' ? value : '';
 }
 
+function getOmpPathFingerprint(env = process.env) {
+  return {
+    homeDir: HOME_DIR,
+    ...Object.fromEntries(OMP_PATH_ENV_KEYS.map(key => [key, String(env[key] || '')]))
+  };
+}
+
+function fingerprintsMatch(left, right) {
+  if (!left || !right) return false;
+  return Object.keys(getOmpPathFingerprint()).every(key => left[key] === right[key]);
+}
+
+function readPersistedOmpAgentDir(env = process.env, options = {}) {
+  if (options.resolveRuntime === false) return '';
+  const cacheFile = options.cacheFile || OMP_PATH_CACHE_FILE;
+  try {
+    const cached = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+    if (cached.version !== OMP_PATH_CACHE_VERSION
+      || !fingerprintsMatch(cached.fingerprint, getOmpPathFingerprint(env))) {
+      return '';
+    }
+    const rawAgentDir = String(cached.agentDir || '').trim();
+    if (!rawAgentDir) return '';
+    const agentDir = path.resolve(expandHomePath(rawAgentDir));
+    if (!fs.statSync(agentDir).isDirectory()) return '';
+    return agentDir;
+  } catch {
+    return '';
+  }
+}
+
+function canReuseInProcessOmpPath(options = {}) {
+  return !options.commandRunner || options.commandRunner === execFileSync;
+}
+
+let lastOmpPathResolution = null;
+
+function rememberOmpPathResolution(agentDir, source, env) {
+  lastOmpPathResolution = {
+    agentDir,
+    source,
+    fingerprint: getOmpPathFingerprint(env)
+  };
+}
+
 function getOmpAgentDir(env = process.env, options = {}) {
+  const persistedAgentDir = readPersistedOmpAgentDir(env, options);
+  if (persistedAgentDir) {
+    rememberOmpPathResolution(persistedAgentDir, 'cache', env);
+    return persistedAgentDir;
+  }
+
+  if (canReuseInProcessOmpPath(options)
+    && lastOmpPathResolution
+    && lastOmpPathResolution.source !== 'fallback'
+    && fingerprintsMatch(lastOmpPathResolution.fingerprint, getOmpPathFingerprint(env))
+    && fs.existsSync(lastOmpPathResolution.agentDir)) {
+    return lastOmpPathResolution.agentDir;
+  }
+
   if (options.resolveRuntime !== false) {
     const command = String(env.OMP_COMMAND || 'omp').trim() || 'omp';
     const commandRunner = options.commandRunner || execFileSync;
@@ -821,7 +956,12 @@ function getOmpAgentDir(env = process.env, options = {}) {
       });
       const configuredByCli = String(output || '').trim().split(/\r?\n/).find(Boolean);
       if (configuredByCli) {
-        return path.resolve(expandHomePath(configuredByCli));
+        const agentDir = path.resolve(expandHomePath(configuredByCli));
+        rememberOmpPathResolution(agentDir, 'cli', env);
+        if (canReuseInProcessOmpPath(options)) {
+          persistOmpAgentPath(agentDir, { ...options, env });
+        }
+        return agentDir;
       }
     } catch {
       // Fall through to environment/profile compatibility paths.
@@ -835,7 +975,9 @@ function getOmpAgentDir(env = process.env, options = {}) {
     env.PI_CODING_AGENT_DIR || env.OMP_CODING_AGENT_DIR
   );
   if (configuredDir) {
-    return path.resolve(expandHomePath(configuredDir));
+    const resolvedConfiguredDir = path.resolve(expandHomePath(configuredDir));
+    rememberOmpPathResolution(resolvedConfiguredDir, 'fallback', env);
+    return resolvedConfiguredDir;
   }
   const profile = normalizeOmpProfileName(env.OMP_PROFILE);
   const configRoot = expandHomePath(
@@ -844,7 +986,34 @@ function getOmpAgentDir(env = process.env, options = {}) {
   const agentDir = profile
     ? path.join(configRoot, 'profiles', profile, 'agent')
     : path.join(configRoot, 'agent');
-  return path.resolve(agentDir);
+  const resolvedAgentDir = path.resolve(agentDir);
+  rememberOmpPathResolution(resolvedAgentDir, 'fallback', env);
+  return resolvedAgentDir;
+}
+
+function persistOmpAgentPath(agentDir = lastOmpPathResolution?.agentDir, options = {}) {
+  const resolution = lastOmpPathResolution;
+  const env = options.env || process.env;
+  const normalizedAgentDir = agentDir ? path.resolve(agentDir) : '';
+  if (!resolution
+    || resolution.source !== 'cli'
+    || !normalizedAgentDir
+    || normalizedAgentDir !== resolution.agentDir
+    || !fingerprintsMatch(resolution.fingerprint, getOmpPathFingerprint(env))) {
+    return false;
+  }
+
+  try {
+    writeJsonFile(options.cacheFile || OMP_PATH_CACHE_FILE, {
+      version: OMP_PATH_CACHE_VERSION,
+      agentDir: normalizedAgentDir,
+      fingerprint: resolution.fingerprint,
+      savedAt: new Date().toISOString()
+    });
+    return true;
+  } catch {
+    return false;
+  }
 }
 
 const OMP_AGENT_DIR = getOmpAgentDir();
@@ -939,5 +1108,9 @@ module.exports = {
   getGeminiDir,
   getOpenCodeDataDir,
   getOpenCodeConfigDir,
-  getOmpAgentDir
+  getOmpAgentDir,
+  persistOmpAgentPath,
+  getPlatformStatePath,
+  getPlatformStatePaths,
+  normalizePlatformStateKey
 };

package/src/index.js

@@ -5,23 +5,57 @@
  * 主入口文件
  */
 
-const { loadConfig } = require('./config/loader');
-const { resetConfig } = require('./reset-config');
-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 { ensureStorageDirMigrated } = require('./config/paths');
-const { normalizePlatformKey } = require('./shared/platforms');
-const PluginManager = require('./plugins/plugin-manager');
-const eventBus = require('./plugins/event-bus');
-const { hasHostFlag } = require('./utils/cli-flags');
 const chalk = require('chalk');
 const path = require('path');
 const fs = require('fs');
 
+function lazyExport(modulePath, exportName) {
+  return (...args) => require(modulePath)[exportName](...args);
+}
+
+const loadConfig = lazyExport('./config/loader', 'loadConfig');
+const resetConfig = lazyExport('./reset-config', 'resetConfig');
+const handleStart = lazyExport('./commands/daemon', 'handleStart');
+const handleStop = lazyExport('./commands/daemon', 'handleStop');
+const handleRestart = lazyExport('./commands/daemon', 'handleRestart');
+const handleStatus = lazyExport('./commands/daemon', 'handleStatus');
+const proxyStart = lazyExport('./commands/proxy-control', 'handleProxyStart');
+const proxyStop = lazyExport('./commands/proxy-control', 'handleProxyStop');
+const handleProxyRestart = lazyExport('./commands/proxy-control', 'handleProxyRestart');
+const proxyStatus = lazyExport('./commands/proxy-control', 'handleProxyStatus');
+const handleLogs = lazyExport('./commands/logs', 'handleLogs');
+const handleStats = lazyExport('./commands/stats', 'handleStats');
+const handleStatsExport = lazyExport('./commands/stats', 'handleStatsExport');
+const handleDoctor = lazyExport('./commands/doctor', 'handleDoctor');
+const handleUpdate = lazyExport('./commands/update', 'handleUpdate');
+const ensureStorageDirMigrated = lazyExport('./config/paths', 'ensureStorageDirMigrated');
+const createPlatformCommandRegistry = lazyExport('./commands/platform-command-registry', 'createPlatformCommandRegistry');
+
+const eventBus = {
+  emitSync(...args) {
+    return require('./plugins/event-bus').emitSync(...args);
+  }
+};
+
+const PluginManager = {
+  initializePlugins(...args) {
+    return require('./plugins/plugin-manager').initializePlugins(...args);
+  },
+  isPluginCommand(...args) {
+    return require('./plugins/plugin-manager').isPluginCommand(...args);
+  },
+  executePluginCommand(...args) {
+    return require('./plugins/plugin-manager').executePluginCommand(...args);
+  },
+  shutdownPlugins(...args) {
+    return require('./plugins/plugin-manager').shutdownPlugins(...args);
+  }
+};
+
+function hasHostFlag(argv = process.argv) {
+  return Array.isArray(argv) && (argv.includes('--host') || argv.includes('--hosts'));
+}
+
 function getInquirer() {
   return require('inquirer');
 }
@@ -52,26 +86,25 @@ function showHelp() {
   console.log(chalk.yellow('[UI] UI 管理:'));
   console.log('  ctx ui                  前台启动 Web UI（仅本地访问）');
   console.log('  ctx ui --https          前台启动 Web UI（本地 HTTPS）');
-  console.log('  ctx ui --host           前台启动 Web UI（允许 LAN 访问，默认允许远程写操作）');
+  console.log('  ctx ui --host           前台启动 Web UI（允许 LAN 访问，远程写默认关闭）');
   console.log('  ctx ui --hosts          前台启动 Web UI（同 --host）');
   console.log('  ctx --hosts             前台启动 Web UI（同 ctx ui --host）');
   console.log('  ctx ui start            后台启动 Web UI');
   console.log('  ctx ui start --https    后台启动 Web UI（本地 HTTPS）');
-  console.log('  ctx ui start --host     后台启动 Web UI（允许 LAN 访问，默认允许远程写操作）');
+  console.log('  ctx ui start --host     后台启动 Web UI（允许 LAN 访问，远程写默认关闭）');
   console.log('  ctx ui start --hosts    后台启动 Web UI（同 --host）');
   console.log('  ctx ui stop             停止 Web UI');
   console.log('  ctx ui restart          重启 Web UI\n');
-  console.log(chalk.gray('  提示: 如需禁止 LAN 远程写操作，可设置 CC_TOOL_ALLOW_REMOTE_WRITE=false\n'));
-
+  console.log(chalk.gray('  提示: 只有显式设置 CC_TOOL_ALLOW_REMOTE_WRITE=true 才允许 LAN 远程写操作\n'));
   console.log(chalk.yellow('[PROXY] 代理管理:'));
-  console.log('  ctx claude start        启动 Claude 代理');
-  console.log('  ctx claude stop         停止 Claude 代理');
-  console.log('  ctx claude status       查看 Claude 代理状态');
-  console.log('  ctx codex start         启动 Codex 代理');
-  console.log('  ctx gemini start        启动 Gemini 代理');
-  console.log('  ctx opencode start      启动 OpenCode 代理');
-  console.log('  ctx omp start           启动 OMP 动态切换');
-  console.log(chalk.gray('  (codex/gemini/opencode/omp 命令与 claude 类似)\n'));
+  const platformEntries = createPlatformCommandRegistry().helpEntries();
+  platformEntries.filter(entry => entry.proxy).forEach((entry) => {
+    const proxyLabel = entry.proxyLabel || '代理';
+    console.log(`  ctx ${entry.command} start        启动 ${entry.label} ${proxyLabel}`);
+    console.log(`  ctx ${entry.command} stop         停止 ${entry.label} ${proxyLabel}`);
+    console.log(`  ctx ${entry.command} status       查看 ${entry.label} ${proxyLabel}状态`);
+  });
+  console.log(chalk.gray('  (平台命令由 Registry 配置派生)\n'));
 
   console.log(chalk.yellow('[LOG] 日志管理:'));
   console.log('  ctx logs                查看所有日志');
@@ -126,6 +159,30 @@ function showHelp() {
   console.log(chalk.gray('  问题: https://github.com/ZeaoZhang/coding-tool/issues\n'));
 }
 
+async function dispatchPlatformCommand(platform, args = [], dependencies = {}) {
+  const action = args[0] || 'status';
+  const channel = platform.key;
+  const options = dependencies.registry ? { registry: dependencies.registry } : {};
+
+  switch (action) {
+    case 'start':
+      await proxyStart(channel, options);
+      return;
+    case 'stop':
+      await proxyStop(channel, options);
+      return;
+    case 'restart':
+      await handleProxyRestart(channel, options);
+      return;
+    case 'status':
+      await proxyStatus(channel, options);
+      return;
+    default:
+      console.log(chalk.red(`\n[ERROR] 未知操作: ${action}\n`));
+      console.log(chalk.gray('支持的操作: start, stop, restart, status\n'));
+  }
+}
+
 let processShutdownPromise = null;
 
 async function stopOwnedOmpGatewayBeforeExit() {
@@ -133,7 +190,7 @@ async function stopOwnedOmpGatewayBeforeExit() {
     const {
       getOmpProxyStatus,
       stopOmpProxyServer
-    } = require('./server/omp-proxy-server');
+    } = require('./platforms/drivers/omp/proxy-implementation');
     if (getOmpProxyStatus().running) {
       const preserveManagedMode = process.argv.includes('--daemon');
       await stopOmpProxyServer({ forceAfterMs: 1500, preserveManagedMode });
@@ -146,9 +203,30 @@ async function stopOwnedOmpGatewayBeforeExit() {
 function shutdownProcess(code = 0, error = null) {
   if (processShutdownPromise) return processShutdownPromise;
   processShutdownPromise = (async () => {
+    try {
+      require('./server/services/native-log-observer').shutdownNativeCliLogObserver();
+    } catch (observerError) {
+      console.error(chalk.yellow(`[WARN] CLI 原生会话日志退出清理失败: ${observerError.message}`));
+    }
     await stopOwnedOmpGatewayBeforeExit();
     eventBus.emitSync('cli:shutdown', {});
     PluginManager.shutdownPlugins();
+    try {
+      await require('./server/websocket-server').flushPendingLogs();
+    } catch (flushError) {
+      console.error(`[WARN] Log persistence flush failed during shutdown: ${flushError.message}`);
+    }
+    try {
+      await require('./server/services/statistics-service').shutdownStatistics();
+    } catch (flushError) {
+      console.error(`[WARN] Statistics flush failed during shutdown: ${flushError.message}`);
+    }
+    try {
+      require('./server/services/session-history-index').closeSessionHistoryIndex();
+      require('./server/services/sqlite-connection').closeAllDatabases();
+    } catch (databaseError) {
+      console.error(chalk.yellow(`[WARN] SQLite 退出清理失败: ${databaseError.message}`));
+    }
     if (error) {
       console.error(error);
     }
@@ -175,19 +253,10 @@ process.on('SIGTERM', () => {
 /**
  * 主函数
  */
-async function main() {
-  ensureStorageDirMigrated();
-
+async function main({ menuDependencies } = {}) {
   // 处理命令行参数
   const args = process.argv.slice(2);
 
-  // LAN 快捷入口，等同于 ctx ui --host/--hosts
-  if (hasHostFlag(process.argv) && !args.some((arg) => arg && !arg.startsWith('-'))) {
-    const { handleUI } = require('./commands/ui');
-    await handleUI();
-    return;
-  }
-
   // --version 或 -v - 显示版本号
   if (args[0] === '--version' || args[0] === '-v') {
     console.log(getVersion());
@@ -200,6 +269,15 @@ async function main() {
     return;
   }
 
+  ensureStorageDirMigrated();
+
+  // LAN 快捷入口，等同于 ctx ui --host/--hosts
+  if (hasHostFlag(process.argv) && !args.some((arg) => arg && !arg.startsWith('-'))) {
+    const { handleUI } = require('./commands/ui');
+    await handleUI();
+    return;
+  }
+
   // daemon 命令兼容（保持与 README 中旧命令一致）
   if (args[0] === 'daemon') {
     const subCommand = args[1] || 'status';
@@ -304,30 +382,17 @@ async function main() {
     return;
   }
 
-  // claude/codex/gemini/opencode/omp 代理管理命令
-  const channels = ['claude', 'codex', 'gemini', 'opencode', 'omp'];
-  const normalizedChannel = normalizePlatformKey(args[0]);
-  if (channels.includes(normalizedChannel)) {
-    const channel = String(args[0] || '').trim().toLowerCase();
-    const action = args[1] || 'status';
-
-    switch (action) {
-      case 'start':
-        await proxyStart(channel);
-        break;
-      case 'stop':
-        await proxyStop(channel);
-        break;
-      case 'restart':
-        await handleProxyRestart(channel);
-        break;
-      case 'status':
-        await proxyStatus(channel);
-        break;
-      default:
-        console.log(chalk.red(`\n[ERROR] 未知操作: ${action}\n`));
-        console.log(chalk.gray('支持的操作: start, stop, restart, status\n'));
-    }
+  // plugin 命令 - 插件管理
+  if (args[0] === 'plugin') {
+    const { handlePluginCommand } = require('./commands/plugin');
+    await handlePluginCommand(args.slice(1));
+    return;
+  }
+  // Registry-derived platform proxy commands
+  const commandRegistry = createPlatformCommandRegistry();
+  const platform = commandRegistry.resolve(args[0]);
+  if (platform) {
+    await dispatchPlatformCommand(platform, args.slice(1), { registry: commandRegistry });
     return;
   }
 
@@ -418,12 +483,6 @@ async function main() {
     }
   }
 
-  // plugin 命令 - 插件管理
-  if (args[0] === 'plugin') {
-    const { handlePluginCommand } = require('./commands/plugin');
-    await handlePluginCommand(args.slice(1));
-    return;
-  }
 
   // 加载配置
   let config = loadConfig();
@@ -452,7 +511,9 @@ async function main() {
   while (true) {
     // 显示主菜单
     const { showMainMenu } = require('./ui/menu');
-    const action = await showMainMenu(config);
+    const action = menuDependencies
+      ? await showMainMenu(config, menuDependencies)
+      : await showMainMenu(config);
 
     // 发送命令开始事件
     eventBus.emitSync('cli:command:before', { command: action, args: [], config });
@@ -470,7 +531,7 @@ async function main() {
             config = loadConfig();
           }
           return switched;
-        }, true); // crossProject = true，跨项目显示最近会话
+        }, true, { platform: config.currentCliType || '' }); // crossProject = true，跨项目显示最近会话
         break;
 
       case 'search':
@@ -482,7 +543,7 @@ async function main() {
             config = loadConfig();
           }
           return switched;
-        });
+        }, { platform: config.currentCliType || '' });
         break;
 
       case 'switch':
@@ -499,13 +560,13 @@ async function main() {
               config = loadConfig();
             }
             return switched;
-          });
+          }, false, { platform: config.currentCliType || '' });
         }
         break;
 
       case 'workspace':
         const { workspaceMenu } = require('./commands/workspace');
-        await workspaceMenu();
+        await workspaceMenu({ platform: config.currentCliType || '' });
         break;
 
       case 'switch-cli-type':
@@ -745,6 +806,8 @@ main().catch((error) => {
 
 module.exports = {
   _test: {
+    dispatchPlatformCommand,
+    showHelp,
     stopOwnedOmpGatewayBeforeExit
   }
 };