claude-coder 1.8.4 → 1.9.1

package/src/commands/setup-modules/helpers.js

@@ -1,99 +1,100 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-const { log, COLOR, updateEnvVar } = require('../../common/config');
-const { ensureGitignore: ensureGitignoreBase } = require('../../common/utils');
-const { assets } = require('../../common/assets');
-
-function createInterface() {
-  return readline.createInterface({ input: process.stdin, output: process.stdout });
-}
-
-function ask(rl, question) {
-  return new Promise(resolve => rl.question(question, resolve));
-}
-
-function askChoice(rl, prompt, min, max, defaultVal) {
-  return new Promise(async (resolve) => {
-    while (true) {
-      const raw = await ask(rl, prompt);
-      const val = raw.trim() || String(defaultVal ?? '');
-      const num = parseInt(val, 10);
-      if (num >= min && num <= max) return resolve(num);
-      console.log(`请输入 ${min}-${max}`);
-    }
-  });
-}
-
-async function askApiKey(rl, platform, apiUrl, existingKey) {
-  if (existingKey) {
-    console.log('回车保留当前 API Key，输入新 Key 更新，输入 q 返回上层菜单:');
-  } else {
-    console.log(`请输入 ${platform} 的 API Key:`);
-  }
-  if (apiUrl) {
-    console.log(`  ${COLOR.blue}获取入口: ${apiUrl}${COLOR.reset}`);
-    console.log('');
-  }
-  const key = await ask(rl, '  API Key: ');
-  const trimmed = key.trim();
-  if (trimmed.toLowerCase() === 'q') {
-    return null;
-  }
-  if (!trimmed) {
-    if (existingKey) return existingKey;
-    console.error('API Key 不能为空');
-    process.exit(1);
-  }
-  return trimmed;
-}
-
-function writeConfig(filePath, lines) {
-  const dir = path.dirname(filePath);
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-
-  if (fs.existsSync(filePath)) {
-    const ts = new Date().toISOString().replace(/[:\-T]/g, '').slice(0, 14);
-    const backup = `${filePath}.bak.${ts}`;
-    fs.copyFileSync(filePath, backup);
-    log('info', `已备份旧配置到: ${backup}`);
-  }
-
-  fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf8');
-}
-
-function ensureGitignore() {
-  if (ensureGitignoreBase(assets.projectRoot)) {
-    log('info', '已更新 .gitignore');
-  }
-}
-
-function showCurrentConfig(existing) {
-  console.log('');
-  console.log(`${COLOR.blue}当前配置:${COLOR.reset}`);
-  console.log(`  提供商:     ${existing.MODEL_PROVIDER || '未配置'}`);
-  console.log(`  BASE_URL:   ${existing.ANTHROPIC_BASE_URL || '默认'}`);
-  console.log(`  模型:       ${existing.ANTHROPIC_MODEL || '默认'}`);
-  console.log(`  MCP:        ${existing.MCP_PLAYWRIGHT === 'true' ? `已启用 (${existing.MCP_PLAYWRIGHT_MODE || 'persistent'})` : '未启用'}`);
-  const compTimeout = existing.SESSION_COMPLETION_TIMEOUT || '300';
-  const turns = existing.SESSION_MAX_TURNS || '0';
-  console.log(`  停顿超时:   ${existing.SESSION_STALL_TIMEOUT || '600'} 秒`);
-  console.log(`  完成检测:   ${compTimeout} 秒`);
-  console.log(`  工具轮次:   ${turns === '0' ? '无限制' : turns}`);
-  const simplifyInterval = existing.SIMPLIFY_INTERVAL ?? '5';
-  const simplifyCommits = existing.SIMPLIFY_COMMITS ?? '5';
-  console.log(`  自动审查:   ${simplifyInterval === '0' ? '禁用' : `每 ${simplifyInterval} 个 session`}${simplifyInterval !== '0' ? `，审查 ${simplifyCommits} 个 commit` : ''}`);
-  console.log('');
-}
-
-module.exports = {
-  createInterface,
-  ask,
-  askChoice,
-  askApiKey,
-  writeConfig,
-  ensureGitignore,
-  showCurrentConfig,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { log, COLOR, updateEnvVar } = require('../../common/config');
+const { ensureGitignore: ensureGitignoreBase } = require('../../common/utils');
+const { assets } = require('../../common/assets');
+
+function createInterface() {
+  return readline.createInterface({ input: process.stdin, output: process.stdout });
+}
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+function askChoice(rl, prompt, min, max, defaultVal) {
+  return new Promise(async (resolve) => {
+    while (true) {
+      const raw = await ask(rl, prompt);
+      const val = raw.trim() || String(defaultVal ?? '');
+      const num = parseInt(val, 10);
+      if (num >= min && num <= max) return resolve(num);
+      console.log(`请输入 ${min}-${max}`);
+    }
+  });
+}
+
+async function askApiKey(rl, platform, apiUrl, existingKey) {
+  if (existingKey) {
+    console.log('回车保留当前 API Key，输入新 Key 更新，输入 q 返回上层菜单:');
+  } else {
+    console.log(`请输入 ${platform} 的 API Key:`);
+  }
+  if (apiUrl) {
+    console.log(`  ${COLOR.blue}获取入口: ${apiUrl}${COLOR.reset}`);
+    console.log('');
+  }
+  const key = await ask(rl, '  API Key: ');
+  const trimmed = key.trim();
+  if (trimmed.toLowerCase() === 'q') {
+    return null;
+  }
+  if (!trimmed) {
+    if (existingKey) return existingKey;
+    console.error('API Key 不能为空');
+    process.exit(1);
+  }
+  return trimmed;
+}
+
+function writeConfig(filePath, lines) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  if (fs.existsSync(filePath)) {
+    const ts = new Date().toISOString().replace(/[:\-T]/g, '').slice(0, 14);
+    const backup = `${filePath}.bak.${ts}`;
+    fs.copyFileSync(filePath, backup);
+    log('info', `已备份旧配置到: ${backup}`);
+  }
+
+  fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf8');
+}
+
+function ensureGitignore() {
+  if (ensureGitignoreBase(assets.projectRoot)) {
+    log('info', '已更新 .gitignore');
+  }
+}
+
+function showCurrentConfig(existing) {
+  console.log('');
+  console.log(`${COLOR.blue}当前配置:${COLOR.reset}`);
+  console.log(`  提供商:     ${existing.MODEL_PROVIDER || '未配置'}`);
+  console.log(`  BASE_URL:   ${existing.ANTHROPIC_BASE_URL || '默认'}`);
+  console.log(`  模型:       ${existing.ANTHROPIC_MODEL || '默认'}`);
+  const webTool = existing.WEB_TEST_TOOL;
+  const webMode = existing.WEB_TEST_MODE;
+  console.log(`  浏览器工具: ${webTool ? `${webTool}${webMode ? ` (${webMode})` : ''}` : '未启用'}`);
+  const turns = existing.SESSION_MAX_TURNS || '0';
+  console.log(`  停顿超时:   ${existing.SESSION_STALL_TIMEOUT || '600'} 秒`);
+  console.log(`  完成检测:   Stop hook（SDK 原生）`);
+  console.log(`  工具轮次:   ${turns === '0' ? '无限制' : turns}`);
+  const simplifyInterval = existing.SIMPLIFY_INTERVAL ?? '5';
+  const simplifyCommits = existing.SIMPLIFY_COMMITS ?? '5';
+  console.log(`  自动审查:   ${simplifyInterval === '0' ? '禁用' : `每 ${simplifyInterval} 个 session`}${simplifyInterval !== '0' ? `，审查 ${simplifyCommits} 个 commit` : ''}`);
+  console.log('');
+}
+
+module.exports = {
+  createInterface,
+  ask,
+  askChoice,
+  askApiKey,
+  writeConfig,
+  ensureGitignore,
+  showCurrentConfig,
+};

package/src/commands/setup-modules/index.js

@@ -1,26 +1,26 @@
-'use strict';
-
-// ── setup 子模块统一入口 ──
-
-const helpers = require('./helpers');
-const provider = require('./provider');
-const mcp = require('./mcp');
-const safety = require('./safety');
-const simplify = require('./simplify');
-
-module.exports = {
-  createInterface: helpers.createInterface,
-  ask: helpers.ask,
-  askChoice: helpers.askChoice,
-  askApiKey: helpers.askApiKey,
-  writeConfig: helpers.writeConfig,
-  ensureGitignore: helpers.ensureGitignore,
-  showCurrentConfig: helpers.showCurrentConfig,
-  selectProvider: provider.selectProvider,
-  updateApiKeyOnly: provider.updateApiKeyOnly,
-  configureMCP: mcp.configureMCP,
-  appendMcpConfig: mcp.appendMcpConfig,
-  updateMCPOnly: mcp.updateMCPOnly,
-  updateSafetyLimits: safety.updateSafetyLimits,
-  updateSimplifyConfig: simplify.updateSimplifyConfig,
+'use strict';
+
+// ── setup 子模块统一入口 ──
+
+const helpers = require('./helpers');
+const provider = require('./provider');
+const mcp = require('./mcp');
+const safety = require('./safety');
+const simplify = require('./simplify');
+
+module.exports = {
+  createInterface: helpers.createInterface,
+  ask: helpers.ask,
+  askChoice: helpers.askChoice,
+  askApiKey: helpers.askApiKey,
+  writeConfig: helpers.writeConfig,
+  ensureGitignore: helpers.ensureGitignore,
+  showCurrentConfig: helpers.showCurrentConfig,
+  selectProvider: provider.selectProvider,
+  updateApiKeyOnly: provider.updateApiKeyOnly,
+  configureMCP: mcp.configureMCP,
+  appendMcpConfig: mcp.appendMcpConfig,
+  updateMCPOnly: mcp.updateMCPOnly,
+  updateSafetyLimits: safety.updateSafetyLimits,
+  updateSimplifyConfig: simplify.updateSimplifyConfig,
 };

package/src/commands/setup-modules/mcp.js

@@ -1,95 +1,115 @@
-'use strict';
-
-const { ask, askChoice } = require('./helpers');
-const { log, COLOR, updateEnvVar } = require('../../common/config');
-const { assets } = require('../../common/assets');
-
-// ── MCP 配置 ──
-
-async function configureMCP(rl) {
-  console.log('');
-  console.log('是否启用 Playwright MCP（浏览器自动化测试）？');
-  console.log('');
-  console.log('  Playwright MCP 由微软官方维护 (github.com/microsoft/playwright-mcp)');
-  console.log('  提供 browser_click、browser_snapshot 等 25+ 浏览器自动化工具');
-  console.log('  适用于有 Web 前端的项目，Agent 可用它做端到端测试');
-  console.log('');
-  console.log('  1) 是 - 启用 Playwright MCP（项目有 Web 前端）');
-  console.log('  2) 否 - 跳过（纯后端 / CLI 项目）');
-  console.log('');
-
-  const mcpChoice = await askChoice(rl, '选择 [1-2]: ', 1, 2);
-
-  const mcpConfig = { enabled: false, mode: null };
-
-  if (mcpChoice === 1) {
-    mcpConfig.enabled = true;
-    console.log('');
-    console.log('请选择 Playwright MCP 浏览器模式:');
-    console.log('');
-    console.log('  1) persistent - 懒人模式（默认，推荐）');
-    console.log('     登录一次永久生效，适合 Google SSO、企业内网 API 拉取等日常开发');
-    console.log('');
-    console.log('  2) isolated - 开发模式');
-    console.log('     每次会话从快照加载，适合验证登录流程的自动化测试');
-    console.log('');
-    console.log('  3) extension - 连接真实浏览器（实验性）');
-    console.log('     通过 Chrome 扩展复用已有登录态和插件');
-    console.log('     需要安装 "Playwright MCP Bridge" 扩展');
-    console.log('');
-
-    const modeChoice = await askChoice(rl, '选择 [1-3，默认 1]: ', 1, 3, 1);
-    const modeMap = { 1: 'persistent', 2: 'isolated', 3: 'extension' };
-    mcpConfig.mode = modeMap[modeChoice];
-
-    console.log('');
-    if (mcpConfig.mode === 'extension') {
-      console.log(`  ${COLOR.yellow}⚠ 前置条件：安装 Playwright MCP Bridge 浏览器扩展${COLOR.reset}`);
-      console.log(`  ${COLOR.blue}  https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm${COLOR.reset}`);
-      console.log('');
-      console.log('  安装扩展后，运行 claude-coder auth 生成 .mcp.json 配置');
-    } else if (mcpConfig.mode === 'persistent') {
-      console.log('  使用 claude-coder auth <URL> 打开浏览器完成首次登录');
-      console.log('  登录状态将持久保存，后续 MCP 会话自动复用');
-      console.log('');
-      console.log('  请确保已安装 Playwright:');
-      console.log(`  ${COLOR.blue}npx playwright install chromium${COLOR.reset}`);
-    } else {
-      console.log('  使用 claude-coder auth <URL> 录制登录状态到 playwright-auth.json');
-      console.log('  MCP 每次会话从此文件加载初始 cookies/localStorage');
-    }
-  }
-
-  return mcpConfig;
-}
-
-// ── MCP 配置追加到 lines ──
-
-function appendMcpConfig(lines, mcpConfig) {
-  lines.push('', '# MCP 工具配置');
-  if (mcpConfig.enabled) {
-    lines.push('MCP_PLAYWRIGHT=true');
-    if (mcpConfig.mode) lines.push(`MCP_PLAYWRIGHT_MODE=${mcpConfig.mode}`);
-  } else {
-    lines.push('MCP_PLAYWRIGHT=false');
-  }
-}
-
-// ── 仅更新 MCP 配置 ──
-
-async function updateMCPOnly(rl) {
-  const mcpConfig = await configureMCP(rl);
-  updateEnvVar('MCP_PLAYWRIGHT', mcpConfig.enabled ? 'true' : 'false');
-  if (mcpConfig.enabled && mcpConfig.mode) {
-    updateEnvVar('MCP_PLAYWRIGHT_MODE', mcpConfig.mode);
-    const { updateMcpConfig } = require('../auth');
-    updateMcpConfig(assets.path('mcpConfig'), mcpConfig.mode);
-  }
-  log('ok', 'MCP 配置已更新');
-}
-
-module.exports = {
-  configureMCP,
-  appendMcpConfig,
-  updateMCPOnly,
-};
+'use strict';
+
+const { askChoice } = require('./helpers');
+const { log, COLOR, updateEnvVar } = require('../../common/config');
+const { assets } = require('../../common/assets');
+
+// ── MCP 配置 ──
+
+async function configureMCP(rl) {
+  console.log('');
+  console.log('是否启用浏览器测试工具？');
+  console.log('');
+  console.log('  1) Playwright MCP — 微软官方，25+ 浏览器自动化工具，支持多实例并行');
+  console.log('  2) Chrome DevTools MCP — Google 官方，连接已打开的 Chrome，调试能力更强');
+  console.log('     （单实例限制，多开请配置 Playwright MCP）');
+  console.log('  3) 跳过（纯后端 / CLI 项目）');
+  console.log('');
+
+  const toolChoice = await askChoice(rl, '选择 [1-3]: ', 1, 3);
+
+  const mcpConfig = { tool: '', mode: '' };
+
+  if (toolChoice === 1) {
+    mcpConfig.tool = 'playwright';
+    console.log('');
+    console.log('请选择 Playwright MCP 浏览器模式:');
+    console.log('');
+    console.log('  1) persistent - 懒人模式（默认，推荐）');
+    console.log('     登录一次永久生效，适合 Google SSO、企业内网等日常开发');
+    console.log('');
+    console.log('  2) isolated - 开发模式');
+    console.log('     每次会话从快照加载，适合验证登录流程的自动化测试');
+    console.log('');
+    console.log('  3) extension - 连接真实浏览器（实验性）');
+    console.log('     通过 Chrome 扩展复用已有登录态和插件');
+    console.log('');
+
+    const modeChoice = await askChoice(rl, '选择 [1-3，默认 1]: ', 1, 3, 1);
+    const modeMap = { 1: 'persistent', 2: 'isolated', 3: 'extension' };
+    mcpConfig.mode = modeMap[modeChoice];
+
+    console.log('');
+    if (mcpConfig.mode === 'extension') {
+      console.log(`  ${COLOR.yellow}⚠ 前置条件：安装 Playwright MCP Bridge 浏览器扩展${COLOR.reset}`);
+      console.log(`  ${COLOR.blue}  https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm${COLOR.reset}`);
+      console.log('');
+      console.log('  安装扩展后，运行 claude-coder auth 生成 .mcp.json 配置');
+    } else if (mcpConfig.mode === 'persistent') {
+      console.log('  使用 claude-coder auth <URL> 打开浏览器完成首次登录');
+      console.log('  登录状态将持久保存，后续 MCP 会话自动复用');
+      console.log('');
+      console.log('  请确保已安装 Playwright:');
+      console.log(`  ${COLOR.blue}npx playwright install chromium${COLOR.reset}`);
+    } else {
+      console.log('  使用 claude-coder auth <URL> 录制登录状态到 playwright-auth.json');
+      console.log('  MCP 每次会话从此文件加载初始 cookies/localStorage');
+    }
+  } else if (toolChoice === 2) {
+    mcpConfig.tool = 'chrome-devtools';
+
+    const [major, minor] = process.versions.node.split('.').map(Number);
+    if (major < 20 || (major === 20 && minor < 19)) {
+      console.log('');
+      console.log(`  ${COLOR.yellow}⚠ 当前 Node.js v${process.versions.node}，Chrome DevTools MCP 要求 v20.19+${COLOR.reset}`);
+      console.log(`  ${COLOR.blue}  nvm 用户: nvm alias default 22 && nvm use 22${COLOR.reset}`);
+    }
+
+    console.log('');
+    console.log('  Chrome DevTools MCP 将连接已打开的 Chrome 浏览器。');
+    console.log('');
+    console.log('  前置条件:');
+    console.log('  1. Node.js v20.19+（npx 自动下载 chrome-devtools-mcp 包）');
+    console.log('  2. Chrome 144+');
+    console.log('  3. 打开 chrome://inspect/#remote-debugging 启用远程调试');
+    console.log('');
+    console.log('  运行 claude-coder auth 自动配置 .mcp.json');
+  }
+
+  return mcpConfig;
+}
+
+// ── MCP 配置追加到 lines ──
+
+function appendMcpConfig(lines, mcpConfig) {
+  lines.push('', '# 浏览器测试工具配置');
+  if (mcpConfig.tool) {
+    lines.push(`WEB_TEST_TOOL=${mcpConfig.tool}`);
+    if (mcpConfig.mode) lines.push(`WEB_TEST_MODE=${mcpConfig.mode}`);
+  } else {
+    lines.push('WEB_TEST_TOOL=');
+  }
+}
+
+// ── 仅更新 MCP 配置 ──
+
+async function updateMCPOnly(rl) {
+  const mcpConfig = await configureMCP(rl);
+  updateEnvVar('WEB_TEST_TOOL', mcpConfig.tool);
+  if (mcpConfig.tool === 'playwright' && mcpConfig.mode) {
+    updateEnvVar('WEB_TEST_MODE', mcpConfig.mode);
+    const { updateMcpConfig } = require('../auth');
+    updateMcpConfig(assets.path('mcpConfig'), 'playwright', mcpConfig.mode);
+  } else if (mcpConfig.tool === 'chrome-devtools') {
+    updateEnvVar('WEB_TEST_MODE', '');
+    const { updateMcpConfig } = require('../auth');
+    updateMcpConfig(assets.path('mcpConfig'), 'chrome-devtools');
+  }
+  log('ok', 'MCP 配置已更新');
+}
+
+module.exports = {
+  configureMCP,
+  appendMcpConfig,
+  updateMCPOnly,
+};