coding-tool-x 3.5.6 → 3.5.8

package/src/index.js

@@ -19,6 +19,7 @@ const eventBus = require('./plugins/event-bus');
 const chalk = require('chalk');
 const path = require('path');
 const fs = require('fs');
+let processHandlersRegistered = false;
 
 function getInquirer() {
   return require('inquirer');
@@ -36,35 +37,66 @@ function showHelp() {
   const version = getVersion();
   console.log(chalk.cyan.bold(`\nCODING-TOOL v${version}`));
   console.log(chalk.gray('Vibe Coding 增强工作助手 - 智能会话管理、动态渠道切换、全局搜索、实时监控\n'));
+  console.log(chalk.gray('用法: ctx [command] [options]'));
+  console.log(chalk.gray('不带参数时进入交互菜单；输入未知命令时会直接报错。\n'));
 
   console.log(chalk.yellow('[START] 服务管理:'));
   console.log('  ctx start               启动所有服务（后台运行）');
   console.log('  ctx start --host        启动所有服务（后台运行，允许 LAN 访问）');
+  console.log('  ctx start --https       启动所有服务（后台运行，原生 HTTPS）');
   console.log('  ctx stop                停止所有服务');
   console.log('  ctx restart             重启所有服务');
   console.log('  ctx status              查看服务状态\n');
 
   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 start            后台启动 Web UI');
+  console.log('  ctx ui start            后台启动 Web UI（等同于 ctx start）');
+  console.log('  ctx ui start --https    后台启动 Web UI（原生 HTTPS）');
   console.log('  ctx ui start --host     后台启动 Web UI（允许 LAN 访问）');
   console.log('  ctx ui stop             停止 Web UI');
   console.log('  ctx ui restart          重启 Web UI\n');
 
-  console.log(chalk.yellow('[PROXY] 代理管理:'));
+  console.log(chalk.yellow('[CHANNEL] 渠道代理管理:'));
   console.log('  ctx claude start        启动 Claude 代理');
   console.log('  ctx claude stop         停止 Claude 代理');
+  console.log('  ctx claude restart      重启 Claude 代理');
   console.log('  ctx claude status       查看 Claude 代理状态');
   console.log('  ctx codex start         启动 Codex 代理');
+  console.log('  ctx codex stop          停止 Codex 代理');
+  console.log('  ctx codex restart       重启 Codex 代理');
+  console.log('  ctx codex status        查看 Codex 代理状态');
   console.log('  ctx gemini start        启动 Gemini 代理');
+  console.log('  ctx gemini stop         停止 Gemini 代理');
+  console.log('  ctx gemini restart      重启 Gemini 代理');
+  console.log('  ctx gemini status       查看 Gemini 代理状态');
   console.log('  ctx opencode start      启动 OpenCode 代理');
-  console.log(chalk.gray('  (codex/gemini/opencode 命令与 claude 类似)\n'));
+  console.log('  ctx opencode stop       停止 OpenCode 代理');
+  console.log('  ctx opencode restart    重启 OpenCode 代理');
+  console.log('  ctx opencode status     查看 OpenCode 代理状态\n');
+
+  console.log(chalk.yellow('[PROXY] 旧版代理命令:'));
+  console.log('  ctx proxy               启动旧版 Claude 代理');
+  console.log('  ctx proxy start         启动旧版 Claude 代理');
+  console.log('  ctx proxy stop          停止旧版 Claude 代理并恢复配置');
+  console.log('  ctx proxy status        查看旧版 Claude 代理状态\n');
+
+  console.log(chalk.yellow('[COMPAT] 兼容命令:'));
+  console.log('  ctx daemon start        等同于 ctx start');
+  console.log('  ctx daemon stop         等同于 ctx stop');
+  console.log('  ctx daemon restart      等同于 ctx restart');
+  console.log('  ctx daemon status       等同于 ctx status');
+  console.log('  ctx daemon logs         查看 UI 日志');
+  console.log('  ctx daemon logs --follow  实时跟踪 UI 日志\n');
 
   console.log(chalk.yellow('[LOG] 日志管理:'));
   console.log('  ctx logs                查看所有日志');
   console.log('  ctx logs ui             查看 UI 日志');
   console.log('  ctx logs claude         查看 Claude 日志');
+  console.log('  ctx logs codex          查看 Codex 日志');
+  console.log('  ctx logs gemini         查看 Gemini 日志');
+  console.log('  ctx logs opencode       查看 OpenCode 日志');
   console.log('  ctx logs --lines 100    查看最近 100 行');
   console.log('  ctx logs --follow       实时跟踪日志');
   console.log('  ctx logs --clear        清空日志\n');
@@ -73,18 +105,24 @@ function showHelp() {
   console.log('  ctx stats               查看总体统计');
   console.log('  ctx stats claude        查看 Claude 统计');
   console.log('  ctx stats --today       查看今日统计');
+  console.log('  ctx stats --week        查看最近 7 天统计');
+  console.log('  ctx stats --month       查看最近 30 天统计');
   console.log('  ctx stats export        导出统计数据\n');
 
   console.log(chalk.yellow('[TOOL]  其他命令:'));
   console.log('  ctx update              检查并更新到最新版本');
+  console.log('  ctx update --check      仅检查更新，不执行安装');
   console.log('  ctx doctor              系统诊断');
   console.log('  ctx port                配置端口');
   console.log('  ctx reset               重置配置');
   console.log('  ctx security reset      关闭访问密码');
+  console.log('  ctx security disable    关闭访问密码（别名）');
+  console.log('  ctx security off        关闭访问密码（别名）');
+  console.log('  ctx help                显示帮助');
   console.log('  ctx --version, -v       显示版本');
   console.log('  ctx --help, -h          显示帮助\n');
 
-  console.log(chalk.yellow('[PROXY] 插件管理:'));
+  console.log(chalk.yellow('[PLUGIN] 插件管理:'));
   console.log('  ctx plugin list         列出已安装插件');
   console.log('  ctx plugin install <url>  从 Git 安装插件');
   console.log('  ctx plugin remove <name>  卸载插件');
@@ -112,21 +150,44 @@ function showHelp() {
   console.log(chalk.gray('  问题: https://github.com/ZeaoZhang/coding-tool/issues\n'));
 }
 
-// 全局错误处理
-process.on('uncaughtException', (err) => {
-  // 忽略终端相关的错误（通常在 Ctrl+C 时发生）
-  if (err.code === 'EIO' || err.code === 'ENOTTY' || err.code === 'EPIPE') {
-    process.exit(0);
+function registerProcessHandlers() {
+  if (processHandlersRegistered) {
+    return;
   }
-  throw err;
-});
 
-// 处理 SIGINT 信号（Ctrl+C）
-process.on('SIGINT', async () => {
-  eventBus.emitSync('cli:shutdown', {});
-  PluginManager.shutdownPlugins();
-  process.exit(0);
-});
+  processHandlersRegistered = true;
+
+  process.on('uncaughtException', (err) => {
+    // 忽略终端相关的错误（通常在 Ctrl+C 时发生）
+    if (err.code === 'EIO' || err.code === 'ENOTTY' || err.code === 'EPIPE') {
+      process.exit(0);
+    }
+    throw err;
+  });
+
+  process.on('SIGINT', async () => {
+    eventBus.emitSync('cli:shutdown', {});
+    PluginManager.shutdownPlugins();
+    process.exit(0);
+  });
+}
+
+function exitWithError(code = 1) {
+  process.exit(code);
+}
+
+function showUnknownCommand(command) {
+  console.error(chalk.red(`\n[ERROR] 未知命令: ${command}\n`));
+  console.log(chalk.gray('使用 ctx --help 查看完整帮助\n'));
+}
+
+function showUnknownSubcommand(command, subCommand, supportedText) {
+  console.error(chalk.red(`\n[ERROR] 未知 ${command} 子命令: ${subCommand}\n`));
+  if (supportedText) {
+    console.log(chalk.gray(`${supportedText}\n`));
+  }
+  console.log(chalk.gray('使用 ctx --help 查看完整帮助\n'));
+}
 
 /**
  * 主函数
@@ -144,7 +205,7 @@ async function main() {
   }
 
   // --help 或 -h - 显示帮助信息
-  if (args[0] === '--help' || args[0] === '-h') {
+  if (args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
     showHelp();
     return;
   }
@@ -185,8 +246,8 @@ async function main() {
       return;
     }
 
-    console.log(chalk.red(`\n[ERROR] 未知 daemon 子命令: ${subCommand}\n`));
-    console.log(chalk.gray('支持的命令: start, stop, restart, status, logs\n'));
+    showUnknownSubcommand('daemon', subCommand, '支持的命令: start, stop, restart, status, logs');
+    exitWithError(1);
     return;
   }
 
@@ -236,16 +297,18 @@ async function main() {
   // ui 命令 - Web UI 管理
   if (args[0] === 'ui') {
     const subCommand = args[1];
-    if (subCommand === 'start') {
+    if (!subCommand || subCommand.startsWith('--')) {
+      const { handleUI } = require('./commands/ui');
+      await handleUI();
+    } else if (subCommand === 'start') {
       await handleStart();  // UI start 实际上就是启动整个服务
     } else if (subCommand === 'stop') {
       await handleStop();
     } else if (subCommand === 'restart') {
       await handleRestart();
     } else {
-      // 默认前台运行
-      const { handleUI } = require('./commands/ui');
-      await handleUI();
+      showUnknownSubcommand('ui', subCommand, '支持的命令: start, stop, restart，或直接使用 ctx ui [--host] [--https]');
+      exitWithError(1);
     }
     return;
   }
@@ -272,6 +335,7 @@ async function main() {
       default:
         console.log(chalk.red(`\n[ERROR] 未知操作: ${action}\n`));
         console.log(chalk.gray('支持的操作: start, stop, restart, status\n'));
+        exitWithError(1);
     }
     return;
   }
@@ -357,8 +421,8 @@ async function main() {
         return;
 
       default:
-        // 默认执行 start
-        await handleProxyStart();
+        showUnknownSubcommand('proxy', subCommand, '支持的命令: start, stop, status');
+        exitWithError(1);
         return;
     }
   }
@@ -375,15 +439,17 @@ async function main() {
 
   // 初始化插件系统
   const pluginResult = PluginManager.initializePlugins({ config, args });
-  if (pluginResult.loaded > 0) {
+  const isPluginCommand = args[0] && PluginManager.isPluginCommand(args[0]);
+  const shouldShowPluginInitSummary = !args[0] || isPluginCommand;
+  if (shouldShowPluginInitSummary && pluginResult.loaded > 0) {
     console.log(chalk.gray(`[Plugin] 已加载 ${pluginResult.loaded} 个插件`));
   }
-  if (pluginResult.failed.length > 0) {
+  if (shouldShowPluginInitSummary && pluginResult.failed.length > 0) {
     console.log(chalk.yellow(`[Plugin] ${pluginResult.failed.length} 个插件加载失败`));
   }
 
   // 检查是否为插件注册的命令
-  if (args[0] && PluginManager.isPluginCommand(args[0])) {
+  if (isPluginCommand) {
     eventBus.emitSync('cli:command:before', { command: args[0], args: args.slice(1), config });
     const result = await PluginManager.executePluginCommand(args[0], args.slice(1));
     eventBus.emitSync('cli:command:after', { command: args[0], args: args.slice(1), result });
@@ -394,6 +460,12 @@ async function main() {
     return;
   }
 
+  if (args[0]) {
+    showUnknownCommand(args[0]);
+    exitWithError(1);
+    return;
+  }
+
   while (true) {
     // 显示主菜单
     const { showMainMenu } = require('./ui/menu');
@@ -685,8 +757,26 @@ async function main() {
   }
 }
 
-// 启动应用
-main().catch((error) => {
-  console.error('程序出错:', error);
-  process.exit(1);
-});
+async function runCli() {
+  registerProcessHandlers();
+  await main();
+}
+
+if (require.main === module) {
+  runCli().catch((error) => {
+    console.error('程序出错:', error);
+    process.exit(1);
+  });
+}
+
+module.exports = {
+  main,
+  runCli,
+  showHelp,
+  getVersion,
+  _test: {
+    showUnknownCommand,
+    showUnknownSubcommand,
+    registerProcessHandlers
+  }
+};

package/src/server/api/agents.js

@@ -228,7 +228,7 @@ router.use((req, res, next) => {
 router.get('/', (req, res) => {
   try {
     const { platform, service } = getAgentsService(req);
-    const { projectPath } = req.query;
+    const { projectPath, refresh } = req.query;
     const normalizedProjectPath = normalizeOptionalProjectPath(projectPath);
     if (normalizedProjectPath.error) {
       return res.status(400).json({
@@ -236,7 +236,10 @@ router.get('/', (req, res) => {
         message: normalizedProjectPath.error
       });
     }
-    const result = service.listAgents(normalizedProjectPath.projectPath);
+    const forceRefresh = refresh === '1';
+    const result = service.listAgents(normalizedProjectPath.projectPath, {
+      syncManagedLocalAgents: forceRefresh
+    });
 
     res.json({
       success: true,
@@ -775,6 +778,53 @@ router.post('/install', async (req, res) => {
   }
 });
 
+/**
+ * 安装本地托管代理
+ * POST /api/agents/install-local
+ * Body: { fileName }
+ */
+router.post('/install-local', (req, res) => {
+  try {
+    const { platform, service } = getAgentsService(req);
+    if (isCodexRepoOperationUnsupported(platform)) {
+      return res.status(400).json({
+        success: false,
+        message: 'Codex 平台暂不支持本地托管代理安装'
+      });
+    }
+
+    const { fileName } = req.body;
+    if (!fileName) {
+      return res.status(400).json({
+        success: false,
+        message: 'Missing fileName'
+      });
+    }
+
+    const fileNameError = validateAgentFileName(fileName);
+    if (fileNameError) {
+      return res.status(400).json({
+        success: false,
+        message: fileNameError
+      });
+    }
+
+    const result = service.installLocalAgent(fileName);
+
+    res.json({
+      success: true,
+      platform,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Agents API] Install local agent error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
 /**
  * 卸载代理
  * POST /api/agents/uninstall

package/src/server/api/commands.js

@@ -35,8 +35,11 @@ function getCommandsService(req) {
 router.get('/', (req, res) => {
   try {
     const { platform, service } = getCommandsService(req);
-    const { projectPath } = req.query;
-    const result = service.listCommands(projectPath || null);
+    const { projectPath, refresh } = req.query;
+    const forceRefresh = refresh === '1';
+    const result = service.listCommands(projectPath || null, {
+      syncManagedLocalCommands: forceRefresh
+    });
 
     res.json({
       success: true,
@@ -446,6 +449,39 @@ router.post('/install', async (req, res) => {
   }
 });
 
+/**
+ * 安装本地托管命令
+ * POST /api/commands/install-local
+ * Body: { path }
+ */
+router.post('/install-local', (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const { path } = req.body;
+
+    if (!path) {
+      return res.status(400).json({
+        success: false,
+        message: 'Missing path'
+      });
+    }
+
+    const result = service.installLocalCommand(path);
+
+    res.json({
+      success: true,
+      platform,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Commands API] Install local command error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
 /**
  * 卸载命令
  * POST /api/commands/uninstall

package/src/server/api/plugins.js

@@ -88,7 +88,10 @@ function sanitizeRepos(service, repos = []) {
 router.get('/', (req, res) => {
   try {
     const { platform, service } = getPluginsService(req);
-    const result = service.listPlugins();
+    const forceRefresh = req.query.refresh === '1';
+    const result = service.listPlugins({
+      syncManagedLocalPlugins: forceRefresh
+    });
 
     res.json({
       success: true,
@@ -189,6 +192,46 @@ router.post('/install', async (req, res) => {
   }
 });
 
+/**
+ * 安装本地托管插件
+ * POST /api/plugins/install-local
+ * Body: { name }
+ */
+router.post('/install-local', (req, res) => {
+  try {
+    const { platform, service } = getPluginsService(req);
+    const { name } = req.body;
+
+    if (!name) {
+      return res.status(400).json({
+        success: false,
+        message: 'name is required'
+      });
+    }
+
+    const result = service.installLocalPlugin(name);
+    if (!result.success) {
+      return res.status(400).json({
+        success: false,
+        message: result.error || result.message || 'Install failed'
+      });
+    }
+
+    res.json({
+      success: true,
+      platform,
+      plugin: result.plugin,
+      message: result.message || `Plugin "${result.plugin?.name || name}" installed successfully`
+    });
+  } catch (err) {
+    console.error('[Plugins API] Install local plugin error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
 // ==================== 仓库管理 API ====================
 
 /**
@@ -440,6 +483,66 @@ router.post('/sync', async (req, res) => {
   }
 });
 
+/**
+ * 获取插件文件列表
+ * GET /api/plugins/:name/files
+ */
+router.get('/:name/files', async (req, res) => {
+  try {
+    const { platform, service } = getPluginsService(req);
+    const { name } = req.params;
+    const pluginInfo = extractPluginQueryInfo(name, req.query);
+    const result = await service.getPluginFiles(pluginInfo);
+
+    res.json({
+      success: true,
+      platform,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Plugins API] Get plugin files error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message,
+      files: []
+    });
+  }
+});
+
+/**
+ * 获取插件单个文件内容
+ * GET /api/plugins/:name/file/*
+ */
+router.get('/:name/file/*', async (req, res) => {
+  try {
+    const { platform, service } = getPluginsService(req);
+    const { name } = req.params;
+    const filePath = req.params[0];
+
+    if (!filePath) {
+      return res.status(400).json({
+        success: false,
+        message: '请指定文件路径'
+      });
+    }
+
+    const pluginInfo = extractPluginQueryInfo(name, req.query);
+    const result = await service.getPluginFileContent(pluginInfo, filePath);
+
+    res.json({
+      success: true,
+      platform,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Plugins API] Get plugin file content error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
 /**
  * 获取插件 README
  * GET /api/plugins/:name/readme

package/src/server/api/sessions.js

@@ -7,7 +7,7 @@ const { getSessionsForProject, deleteSession, forkSession, saveSessionOrder, par
 const { loadAliases } = require('../services/alias');
 const { broadcastLog } = require('../websocket-server');
 const { buildLaunchCommand } = require('../services/session-launch-command');
-const { NATIVE_PATHS } = require('../../config/paths');
+const { NATIVE_PATHS, joinNativeBasePath } = require('../../config/paths');
 const CLAUDE_PROJECTS_DIR = NATIVE_PATHS.claude.projects;
 
 module.exports = (config) => {
@@ -171,13 +171,13 @@ module.exports = (config) => {
         const year = now.getFullYear();
         const month = String(now.getMonth() + 1).padStart(2, '0');
         const day = String(now.getDate()).padStart(2, '0');
-        sessionDir = path.join(NATIVE_PATHS.codex.sessions, String(year), month, day);
-        sessionFile = path.join(sessionDir, `${newSessionId}.jsonl`);
+        sessionDir = joinNativeBasePath(NATIVE_PATHS.codex.sessions, String(year), month, day);
+        sessionFile = joinNativeBasePath(sessionDir, `${newSessionId}.jsonl`);
       } else if (toolType === 'gemini') {
         // Gemini: ~/.gemini/tmp/{hash}/chats/{sessionId}.json
         const pathHash = crypto.createHash('sha256').update(fullPath).digest('hex');
-        sessionDir = path.join(NATIVE_PATHS.gemini.tmp, pathHash, 'chats');
-        sessionFile = path.join(sessionDir, `${newSessionId}.json`);
+        sessionDir = joinNativeBasePath(NATIVE_PATHS.gemini.tmp, pathHash, 'chats');
+        sessionFile = joinNativeBasePath(sessionDir, `${newSessionId}.json`);
       } else {
         return res.status(400).json({ error: 'Invalid toolType. Must be claude, codex, or gemini' });
       }

package/src/server/index.js

@@ -1,4 +1,5 @@
 const express = require('express');
+const https = require('https');
 const path = require('path');
 const chalk = require('chalk');
 const { loadConfig } = require('../config/loader');
@@ -23,6 +24,8 @@ const { startGeminiProxyServer } = require('./gemini-proxy-server');
 const { startOpenCodeProxyServer, collectProxyModelList } = require('./opencode-proxy-server');
 const { createRemoteMutationGuard, isRemoteMutationAllowed } = require('./services/network-access');
 const { createApiRequestLogger } = require('./services/request-logger');
+const { getLocalHttpsCredentials } = require('./services/https-cert');
+const { getWebUiProtocol, isHttpsEnabled, getWebUiBaseUrl, getWebSocketBaseUrl } = require('./services/web-ui-runtime');
 
 function getInquirer() {
   return require('inquirer');
@@ -59,6 +62,8 @@ function printPortToolIssue(issue = getPortToolIssue()) {
 async function startServer(port, host = '127.0.0.1', options = {}) {
   ensureStorageDirMigrated();
   const config = loadConfig();
+  const webUiProtocol = getWebUiProtocol({ https: options.https });
+  const httpsEnabled = isHttpsEnabled({ protocol: webUiProtocol });
   // 使用配置的端口，如果没有传入参数
   if (!port) {
     port = config.ports?.webUI || 19999;
@@ -247,7 +252,18 @@ async function startServer(port, host = '127.0.0.1', options = {}) {
   }
 
   // Start server（确保监听成功后才返回，避免命令误报“已启动”）
-  const server = app.listen(port, host);
+  let httpsCertificate = null;
+  const server = httpsEnabled
+    ? (() => {
+      httpsCertificate = getLocalHttpsCredentials();
+      const httpsServer = https.createServer({
+        key: httpsCertificate.key,
+        cert: httpsCertificate.cert
+      }, app);
+      httpsServer.listen(port, host);
+      return httpsServer;
+    })()
+    : app.listen(port, host);
   await new Promise((resolve) => {
     const onListening = () => {
       server.off('error', onError);
@@ -274,15 +290,19 @@ async function startServer(port, host = '127.0.0.1', options = {}) {
   console.log(`\n[START] Coding-Tool Web UI running at:`);
   if (host === '0.0.0.0') {
     console.log(chalk.yellow(`   [WARN]  警告: 服务正在监听所有网络接口 (LAN 可访问)`));
-    console.log(`   http://localhost:${port}`);
-    console.log(chalk.gray(`   http://<your-ip>:${port} (LAN 访问)`));
+    console.log(`   ${getWebUiBaseUrl(port, { protocol: webUiProtocol })}`);
+    console.log(chalk.gray(`   ${webUiProtocol}://<your-ip>:${port} (LAN 访问)`));
   } else {
-    console.log(`   http://localhost:${port}`);
+    console.log(`   ${getWebUiBaseUrl(port, { protocol: webUiProtocol })}`);
   }
 
   // 附加 WebSocket 服务器到同一个端口
   attachWebSocketServer(server, { host });
-  console.log(`   ws://localhost:${port}/ws\n`);
+  console.log(`   ${getWebSocketBaseUrl(port, { protocol: webUiProtocol })}/ws\n`);
+
+  if (httpsEnabled && httpsCertificate?.generated) {
+    console.log(chalk.gray(`   [LOCK] 已生成本地 HTTPS 证书: ${httpsCertificate.certPath}`));
+  }
 
   if (host === '0.0.0.0' && !allowRemoteMutation) {
     console.log(chalk.yellow('   [LOCK] 已禁用 LAN 远程写操作 (CC_TOOL_ALLOW_REMOTE_WRITE=false)'));