coding-tool-x 3.7.6 → 3.7.7

package/src/config/loader.js

@@ -3,7 +3,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const DEFAULT_CONFIG = require('./default');
-const { PATHS, ensureStorageDirMigrated } = require('./paths');
+const { PATHS, NATIVE_PATHS, ensureStorageDirMigrated } = require('./paths');
 const { resolvePreferredHomeDir } = require('../utils/home-dir');
 const eventBus = require('../plugins/event-bus');
 
@@ -23,12 +23,79 @@ function getConfigFilePath() {
  * 展开 ~ 为用户主目录
  */
 function expandHome(filepath) {
+  if (typeof filepath !== 'string') {
+    return filepath;
+  }
   if (filepath.startsWith('~')) {
     return path.join(HOME_DIR, filepath.slice(1));
   }
   return filepath;
 }
 
+function collapseHome(filepath) {
+  if (typeof filepath !== 'string') {
+    return filepath;
+  }
+  if (filepath === HOME_DIR) {
+    return '~';
+  }
+  const prefix = `${HOME_DIR}${path.sep}`;
+  if (filepath.startsWith(prefix)) {
+    return path.join('~', filepath.slice(prefix.length));
+  }
+  return filepath;
+}
+
+function getNativeClaudeProjectsDir() {
+  return NATIVE_PATHS?.claude?.projects || path.join(HOME_DIR, '.claude', 'projects');
+}
+
+function hasExplicitProjectsDir(config = {}) {
+  return Object.prototype.hasOwnProperty.call(config, 'projectsDir') &&
+    typeof config.projectsDir === 'string' &&
+    config.projectsDir.trim() !== '';
+}
+
+function resolveClaudeProjectsDir(config = {}) {
+  if (!hasExplicitProjectsDir(config) || isDefaultProjectsDir(config.projectsDir)) {
+    return getNativeClaudeProjectsDir();
+  }
+  return expandHome(config.projectsDir);
+}
+
+function normalizeComparablePath(filepath) {
+  if (typeof filepath !== 'string' || !filepath.trim()) {
+    return '';
+  }
+  return path.normalize(expandHome(filepath.trim()));
+}
+
+function isDefaultProjectsDir(projectsDir) {
+  const normalized = normalizeComparablePath(projectsDir);
+  if (!normalized) {
+    return true;
+  }
+  const nativeDefault = normalizeComparablePath(getNativeClaudeProjectsDir());
+  const legacyHomeDefault = normalizeComparablePath(path.join(HOME_DIR, '.claude', 'projects'));
+  if (normalized === nativeDefault || normalized === legacyHomeDefault) {
+    return true;
+  }
+  const normalizedParts = normalized.replace(/\\/g, '/').split('/').filter(Boolean);
+  const last = normalizedParts[normalizedParts.length - 1];
+  const previous = normalizedParts[normalizedParts.length - 2];
+  return previous === '.claude' && last === 'projects' && !fs.existsSync(normalized);
+}
+
+function normalizeConfigForSave(config = {}) {
+  const normalized = { ...config };
+  if (isDefaultProjectsDir(normalized.projectsDir)) {
+    delete normalized.projectsDir;
+  } else if (typeof normalized.projectsDir === 'string') {
+    normalized.projectsDir = collapseHome(normalized.projectsDir);
+  }
+  return normalized;
+}
+
 function mergePricing(defaultPricing, overrides = {}) {
   const merged = {};
   Object.keys(defaultPricing).forEach((key) => {
@@ -96,7 +163,7 @@ function loadConfig() {
     if (fs.existsSync(configFilePath)) {
       const userConfig = readJsonFile(configFilePath);
       const config = { ...DEFAULT_CONFIG, ...userConfig };
-      config.projectsDir = expandHome(config.projectsDir || DEFAULT_CONFIG.projectsDir);
+      config.projectsDir = resolveClaudeProjectsDir(userConfig);
 
       // 合并 ports 配置
       config.ports = { ...DEFAULT_CONFIG.ports, ...userConfig.ports };
@@ -120,7 +187,7 @@ function loadConfig() {
   }
   const defaultConfig = {
     ...DEFAULT_CONFIG,
-    projectsDir: expandHome(DEFAULT_CONFIG.projectsDir),
+    projectsDir: resolveClaudeProjectsDir(),
     currentProject: DEFAULT_CONFIG.defaultProject
   };
   eventBus.emitSync('config:loaded', { config: defaultConfig });
@@ -137,8 +204,9 @@ function saveConfig(config) {
     if (!fs.existsSync(dir)) {
       fs.mkdirSync(dir, { recursive: true });
     }
-    fs.writeFileSync(configFilePath, JSON.stringify(config, null, 2), 'utf8');
-    eventBus.emitSync('config:saved', { config });
+    const normalizedConfig = normalizeConfigForSave(config);
+    fs.writeFileSync(configFilePath, JSON.stringify(normalizedConfig, null, 2), 'utf8');
+    eventBus.emitSync('config:saved', { config: normalizedConfig });
   } catch (error) {
     console.error(`保存配置失败 (${configFilePath}):`, error.message);
   }
@@ -148,5 +216,8 @@ module.exports = {
   loadConfig,
   saveConfig,
   expandHome,
+  resolveClaudeProjectsDir,
+  normalizeConfigForSave,
+  isDefaultProjectsDir,
   getConfigFilePath
 };

package/src/index.js

@@ -17,6 +17,7 @@ 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');
@@ -54,9 +55,12 @@ function showHelp() {
   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 --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 --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'));
@@ -149,6 +153,13 @@ async function main() {
   // 处理命令行参数
   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());

package/src/server/api/config.js

@@ -330,7 +330,6 @@ router.post('/default-models', (req, res) => {
     // Save config
     const newConfig = {
       ...config,
-      projectsDir: config.projectsDir.replace(require('os').homedir(), '~'),
       defaultModels: newDefaultModels
     };
 
@@ -378,7 +377,6 @@ router.post('/default-models/reset', (req, res) => {
     // Save config
     const newConfig = {
       ...config,
-      projectsDir: config.projectsDir.replace(require('os').homedir(), '~'),
       defaultModels: newDefaultModels
     };
 
@@ -490,7 +488,6 @@ router.post('/advanced', (req, res) => {
     // 更新配置
     const newConfig = {
       ...config,
-      projectsDir: config.projectsDir.replace(require('os').homedir(), '~'),
       ports: normalizedPorts,
       maxLogs: maxLogs !== undefined ? parseInt(maxLogs) : config.maxLogs,
       statsInterval: statsInterval !== undefined ? parseInt(statsInterval) : config.statsInterval,

package/src/server/api/settings.js

@@ -90,7 +90,6 @@ function handleSaveModelSettings(req, res) {
     const config = loadConfig();
     const newConfig = {
       ...config,
-      projectsDir: config.projectsDir.replace(require('os').homedir(), '~'),
       modelMetadataOverrides: overrides && typeof overrides === 'object'
         ? overrides
         : (config.modelMetadataOverrides || {})
@@ -124,7 +123,6 @@ function handleDeleteModelOverride(req, res) {
 
     const newConfig = {
       ...config,
-      projectsDir: config.projectsDir.replace(require('os').homedir(), '~'),
       modelMetadataOverrides: overrides
     };
     saveConfig(newConfig);

package/src/server/api/workspaces.js

@@ -33,6 +33,24 @@ function validateBranchName(branchName) {
   }
 }
 
+function normalizeBranchMode(branchMode) {
+  if (typeof branchMode !== 'string' || !branchMode.trim()) {
+    return '';
+  }
+  return branchMode.trim();
+}
+
+function validateBranchMode(branchMode) {
+  const normalized = normalizeBranchMode(branchMode);
+  if (!normalized) {
+    return { valid: true, normalized: '' };
+  }
+  if (normalized !== 'existing' && normalized !== 'new') {
+    return { valid: false, normalized, message: `分支模式不合法: ${normalized}` };
+  }
+  return { valid: true, normalized };
+}
+
 /**
  * GET /api/workspaces
  * 获取所有工作区列表
@@ -226,6 +244,17 @@ router.post('/', (req, res) => {
         });
       }
 
+      const branchModeValidation = validateBranchMode(proj.branchMode);
+      if (!branchModeValidation.valid) {
+        return res.status(400).json({
+          success: false,
+          message: branchModeValidation.message
+        });
+      }
+      if (branchModeValidation.normalized) {
+        proj.branchMode = branchModeValidation.normalized;
+      }
+
       const normalizedBranch = normalizeBranchName(proj.branch);
       if (normalizedBranch) {
         const branchValidation = validateBranchName(normalizedBranch);
@@ -329,9 +358,10 @@ router.put('/:id/last-used', (req, res) => {
 router.post('/:id/projects', (req, res) => {
   try {
     const { id } = req.params;
-    const { sourcePath, name, createWorktree, branch, baseBranch } = req.body;
+    const { sourcePath, name, createWorktree, branch, baseBranch, branchMode } = req.body;
     const normalizedBranch = normalizeBranchName(branch);
     const normalizedBaseBranch = normalizeBranchName(baseBranch);
+    const branchModeValidation = validateBranchMode(branchMode);
 
     if (!sourcePath || !sourcePath.trim()) {
       return res.status(400).json({
@@ -340,6 +370,13 @@ router.post('/:id/projects', (req, res) => {
       });
     }
 
+    if (!branchModeValidation.valid) {
+      return res.status(400).json({
+        success: false,
+        message: branchModeValidation.message
+      });
+    }
+
     if (normalizedBranch) {
       const branchValidation = validateBranchName(normalizedBranch);
       if (!branchValidation.valid) {
@@ -364,6 +401,7 @@ router.post('/:id/projects', (req, res) => {
       sourcePath,
       name,
       createWorktree,
+      branchMode: branchModeValidation.normalized || branchMode,
       branch: normalizedBranch || branch,
       baseBranch: normalizedBaseBranch || baseBranch
     });

package/src/server/services/dashboard-snapshot-worker.js

@@ -130,6 +130,7 @@ function runDashboardSnapshotWorker(kind, source, config = {}, options = {}) {
   return new Promise((resolve, reject) => {
     const child = fork(__filename, [], {
       stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
+      windowsHide: true,
       env: {
         ...process.env,
         CC_TOOL_DASHBOARD_SNAPSHOT_WORKER: '1'

package/src/server/services/https-cert.js

@@ -42,7 +42,7 @@ function resolveOpenSslCommand() {
 
   for (const command of commands) {
     try {
-      execFileSync(command, ['version'], { stdio: 'ignore' });
+      execFileSync(command, ['version'], { stdio: 'ignore', windowsHide: true });
       return command;
     } catch {
       // Try next candidate.
@@ -96,7 +96,8 @@ function generatePemCertificateWithOpenSsl(command) {
     '-config',
     configPath
   ], {
-    stdio: 'ignore'
+    stdio: 'ignore',
+    windowsHide: true
   });
 
   writeMeta({

package/src/server/services/omp-auth-providers.js

@@ -351,6 +351,7 @@ function warmOmpAuthProviderSnapshot(options = {}) {
   try {
     const child = fork(workerPath, [], {
       stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+      windowsHide: true,
       env: {
         ...process.env,
         CC_TOOL_OMP_AUTH_PROVIDER_WORKER: '1'

package/src/server/services/session-snapshots.js

@@ -46,6 +46,7 @@ function runSessionSnapshotWorker(source, projectName, config = {}, options = {}
     const workerPath = path.join(__dirname, 'session-snapshot-worker.js');
     const child = fork(workerPath, [], {
       stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
+      windowsHide: true,
       env: {
         ...process.env,
         CC_TOOL_SESSION_SNAPSHOT_WORKER: '1'

package/src/server/services/sessions.js

@@ -17,6 +17,17 @@ const CLAUDE_PROJECTS_DIR = NATIVE_PATHS.claude.projects;
 const CODEX_PROJECTS_DIR = path.join(path.dirname(NATIVE_PATHS.codex.config), 'projects');
 const GEMINI_PROJECTS_DIR = path.join(path.dirname(NATIVE_PATHS.gemini.env), 'projects');
 
+function resolveProjectsDir(config = {}) {
+  return config.projectsDir || CLAUDE_PROJECTS_DIR;
+}
+
+function withResolvedProjectsDir(config = {}) {
+  return {
+    ...config,
+    projectsDir: resolveProjectsDir(config)
+  };
+}
+
 // Base directory for cc-tool data
 function getCcToolDir() {
   return PATHS.base;
@@ -182,7 +193,7 @@ function sliceClaudeSessionContentByUserMessage(content, afterUserMessageNumber)
 
 // Get all projects with stats (async version)
 async function getProjects(config) {
-  const projectsDir = config.projectsDir;
+  const projectsDir = resolveProjectsDir(config);
 
   if (!fs.existsSync(projectsDir)) {
     return [];
@@ -383,16 +394,17 @@ function extractCwdFromSessionHeader(sessionFile) {
 
 // Get projects with detailed stats (with caching) - async version
 async function getProjectsWithStats(config, options = {}) {
+  const resolvedConfig = withResolvedProjectsDir(config);
   if (!options.force) {
     // Check enhanced cache first
-    const cacheKey = `${CacheKeys.PROJECTS}${config.projectsDir}`;
+    const cacheKey = `${CacheKeys.PROJECTS}${resolvedConfig.projectsDir}`;
     const enhancedCached = globalCache.get(cacheKey);
     if (enhancedCached) {
       return enhancedCached;
     }
 
     // Check old cache
-    const cached = getCachedProjects(config);
+    const cached = getCachedProjects(resolvedConfig);
     if (cached) {
       globalCache.set(cacheKey, cached, 300000); // 5分钟
       return cached;
@@ -400,22 +412,22 @@ async function getProjectsWithStats(config, options = {}) {
   }
 
   try {
-    const data = await buildProjectsWithStats(config);
+    const data = await buildProjectsWithStats(resolvedConfig);
     if (!Array.isArray(data)) {
-      console.warn(`[getProjectsWithStats] Unexpected non-array result for ${config.projectsDir}, returning empty array.`);
+      console.warn(`[getProjectsWithStats] Unexpected non-array result for ${resolvedConfig.projectsDir}, returning empty array.`);
       return [];
     }
-    setCachedProjects(config, data);
-    globalCache.set(`${CacheKeys.PROJECTS}${config.projectsDir}`, data, 300000);
+    setCachedProjects(resolvedConfig, data);
+    globalCache.set(`${CacheKeys.PROJECTS}${resolvedConfig.projectsDir}`, data, 300000);
     return data;
   } catch (err) {
-    console.error(`[getProjectsWithStats] Failed to build projects for ${config.projectsDir}:`, err);
+    console.error(`[getProjectsWithStats] Failed to build projects for ${resolvedConfig.projectsDir}:`, err);
     return [];
   }
 }
 
 async function buildProjectsWithStats(config) {
-  const projectsDir = config.projectsDir;
+  const projectsDir = resolveProjectsDir(config);
 
   if (!fs.existsSync(projectsDir)) {
     return [];
@@ -482,7 +494,7 @@ async function buildProjectsWithStats(config) {
 
 // 获取 Claude 项目/会话数量（轻量统计）
 function getProjectAndSessionCounts(config) {
-  const projectsDir = config.projectsDir;
+  const projectsDir = resolveProjectsDir(config);
   if (!fs.existsSync(projectsDir)) {
     return { projectCount: 0, sessionCount: 0 };
   }
@@ -672,7 +684,8 @@ async function getSessionsForProject(config, projectName, options = {}) {
 
 // Delete a session
 function deleteSession(config, projectName, sessionId) {
-  const projectDir = path.join(config.projectsDir, projectName);
+  const resolvedConfig = withResolvedProjectsDir(config);
+  const projectDir = path.join(resolvedConfig.projectsDir, projectName);
   const sessionFile = path.join(projectDir, sessionId + '.jsonl');
 
   if (!fs.existsSync(sessionFile)) {
@@ -680,14 +693,15 @@ function deleteSession(config, projectName, sessionId) {
   }
 
   fs.unlinkSync(sessionFile);
-  invalidateProjectsCache(config);
+  invalidateProjectsCache(resolvedConfig);
   invalidateSessionResultCache(projectName);
   return { success: true };
 }
 
 // Fork a session
 function forkSession(config, projectName, sessionId, options = {}) {
-  const projectDir = path.join(config.projectsDir, projectName);
+  const resolvedConfig = withResolvedProjectsDir(config);
+  const projectDir = path.join(resolvedConfig.projectsDir, projectName);
   const sessionFile = path.join(projectDir, sessionId + '.jsonl');
 
   if (!fs.existsSync(sessionFile)) {
@@ -716,7 +730,7 @@ function forkSession(config, projectName, sessionId, options = {}) {
     const { setAlias } = require('./alias');
     setAlias(newSessionId, options.alias);
   }
-  invalidateProjectsCache(config);
+  invalidateProjectsCache(resolvedConfig);
   invalidateSessionResultCache(projectName);
 
   return {
@@ -768,7 +782,8 @@ function saveSessionOrder(projectName, order) {
 
 // Delete a project (remove the entire project directory)
 function deleteProject(config, projectName) {
-  const projectDir = path.join(config.projectsDir, projectName);
+  const resolvedConfig = withResolvedProjectsDir(config);
+  const projectDir = path.join(resolvedConfig.projectsDir, projectName);
 
   if (!fs.existsSync(projectDir)) {
     throw new Error('Project not found');
@@ -778,19 +793,20 @@ function deleteProject(config, projectName) {
   fs.rmSync(projectDir, { recursive: true, force: true });
 
   // Remove from order file if exists
-  const order = getProjectOrder(config);
+  const order = getProjectOrder(resolvedConfig);
   const newOrder = order.filter(name => name !== projectName);
   if (newOrder.length !== order.length) {
-    saveProjectOrder(config, newOrder);
+    saveProjectOrder(resolvedConfig, newOrder);
   }
 
-  invalidateProjectsCache(config);
+  invalidateProjectsCache(resolvedConfig);
   return { success: true };
 }
 
 // Search sessions for keyword
 function searchSessions(config, projectName, keyword, contextLength = 15) {
-  const projectDir = path.join(config.projectsDir, projectName);
+  const resolvedConfig = withResolvedProjectsDir(config);
+  const projectDir = path.join(resolvedConfig.projectsDir, projectName);
 
   if (!fs.existsSync(projectDir)) {
     return [];

package/src/server/services/web-build.js

@@ -101,7 +101,8 @@ function runWebBuild(options = {}) {
     const child = spawn(npmCommand, ['run', 'build'], {
       cwd: sourceRoot,
       env,
-      stdio
+      stdio,
+      windowsHide: true
     });
 
     child.once('error', (error) => {