claude-coder 1.8.3 → 1.9.0

package/recipes/console/components/tree.md

@@ -0,0 +1,15 @@
+# 树形结构
+
+## 任务分解指导
+树形通常与列表替换使用，作为独立 frontend 任务。
+
+## 实现要点
+- 树形数据格式：id + parentId 或嵌套 children
+- 展开/折叠：默认展开第一级
+- 懒加载：大数据量时按需加载子节点
+- 操作：点击节点 → 右侧显示详情或触发其他交互
+- 搜索/过滤：树节点过滤 + 高亮匹配节点
+
+## 验证策略
+- snapshot 验证树形结构渲染
+- 点击展开 → 验证子节点显示

package/recipes/console/components/upload.md

@@ -0,0 +1,15 @@
+# 文件上传
+
+## 任务分解指导
+文件上传通常嵌入弹窗表单中，不单独拆任务。如上传逻辑较复杂（多文件、进度条、预览），可拆为独立 frontend 任务。
+
+## 实现要点
+- 文件类型限制：accept 属性 + 前端校验
+- 文件大小限制：前端校验 + 后端校验
+- 上传进度：progress bar（XMLHttpRequest 或 fetch + ReadableStream）
+- 上传成功后：显示文件名/预览图 + 返回 fileId
+- 多文件上传：列表展示已上传文件，支持删除
+
+## 验证策略
+- 选择超限文件 → 验证拒绝提示
+- 上传正确文件 → 验证成功提示 + 预览显示

package/recipes/console/manifest.json

@@ -0,0 +1,24 @@
+{
+  "id": "console",
+  "name": "管理后台",
+  "description": "企业级管理后台页面开发（搜索、列表、分页、弹窗等 CRUD 场景）",
+  "base": "base.md",
+  "components": [
+    { "id": "search",     "label": "搜索框",     "description": "关键词搜索、筛选条件、防抖",         "file": "components/search.md",     "default": true },
+    { "id": "table",      "label": "数据表格",   "description": "列定义、排序、行选择、批量操作",     "file": "components/table-list.md",  "default": true },
+    { "id": "pagination", "label": "分页",       "description": "分页导航、每页条数、总数显示",       "file": "components/pagination.md",  "default": true },
+    { "id": "modal",      "label": "弹窗/表单",  "description": "新建/编辑弹窗、表单校验、提交回填",   "file": "components/modal-form.md",  "default": true },
+    { "id": "upload",     "label": "文件上传",   "description": "文件类型限制、大小限制、上传进度",   "file": "components/upload.md",      "default": false },
+    { "id": "tree",       "label": "树形结构",   "description": "树形数据展示、懒加载、展开折叠",     "file": "components/tree.md",        "default": false },
+    { "id": "tabs",       "label": "标签页",     "description": "多标签切换、路由联动、懒加载",       "file": "components/tabs.md",        "default": false }
+  ],
+  "test": {
+    "file": "test/crud-e2e.md",
+    "defaultEnabled": true
+  },
+  "defaults": {
+    "components": ["search", "table", "pagination", "modal"],
+    "role": "developer",
+    "test": true
+  }
+}

package/recipes/console/test/crud-e2e.md

@@ -0,0 +1,47 @@
+# Console CRUD E2E 测试步骤模板
+
+## 任务分解指导
+E2E 测试作为独立 test 类任务。steps 用优先级标签标记。
+
+## 标准测试用例
+
+### 【P0】列表加载
+1. 导航到列表页
+2. Playwright snapshot 验证表格存在
+3. 验证至少有 1 行数据（或空状态文案）
+
+### 【P0】搜索功能
+1. 在搜索框输入已知关键词
+2. 等待列表更新（waitForLoadState）
+3. snapshot 验证结果数量变化
+
+### 【P1】分页
+1. 点击第 2 页
+2. 验证页码高亮变化
+3. 验证数据不同于第 1 页
+
+### 【P0】新建
+1. 点击新建按钮
+2. snapshot 验证弹窗打开
+3. 填写表单各字段
+4. 提交
+5. 验证弹窗关闭 + 列表出现新数据
+
+### 【P1】编辑
+1. 点击某行编辑按钮
+2. 验证弹窗打开且回填数据正确
+3. 修改某字段，提交
+4. 验证列表数据更新
+
+### 【P1】删除
+1. 点击删除按钮
+2. 验证确认弹窗出现
+3. 确认删除
+4. 验证列表数据减少
+
+### 【P2】表单校验
+1. 打开新建弹窗
+2. 不填必填项直接提交
+3. 验证校验提示出现
+4. 填入格式错误的数据（如邮箱格式）
+5. 验证格式校验提示

package/recipes/h5/base.md

@@ -0,0 +1,26 @@
+# H5 活动页 — 基础食谱
+
+## 任务分解模式
+
+H5 活动页按以下标准拆分：
+
+1. **infra**: 项目脚手架（如未有移动端模板，需要初始化）
+   - steps：脚手架搭建、移动端适配（viewport + rem/vw）、基础样式
+   - 验证：页面在移动端视口正常显示
+
+2. **frontend**: 页面主体（布局 + 核心交互组件）
+   - steps：页面结构、组件集成、数据对接
+   - 验证：Playwright 移动端 viewport snapshot
+
+3. **frontend**: 分享/营销功能（如需要）
+   - steps：分享配置、海报生成、统计埋点
+   - 验证：分享链接正确、海报生成成功
+
+4. **test**: 多端兼容测试
+   - steps：iOS Safari、Android Chrome、微信内置浏览器
+
+## 通用规则
+
+- H5 页面通常较轻量，2-3 个任务即可
+- 优先保证移动端适配（viewport meta + 响应式）
+- 注意性能：图片懒加载、动画性能、首屏加载速度

package/recipes/h5/components/animation.md

@@ -0,0 +1,11 @@
+# 动画效果
+
+## 实现要点
+- 入场动画：元素进入视口时触发（Intersection Observer）
+- 滚动动画：视差滚动、进度条等
+- 交互动效：点击反馈、状态切换过渡
+- 性能：使用 transform/opacity 动画，避免触发 layout
+
+## 验证策略
+- snapshot 验证动画元素存在
+- 滚动页面 → 验证动画触发

package/recipes/h5/components/countdown.md

@@ -0,0 +1,11 @@
+# 倒计时组件
+
+## 实现要点
+- 服务端时间同步（避免客户端时间篡改）
+- 天/时/分/秒 格式化显示
+- 倒计时结束回调（如切换页面状态）
+- requestAnimationFrame 或 setInterval 驱动
+
+## 验证策略
+- snapshot 验证倒计时数字显示
+- 等待数秒 → 验证数字递减

package/recipes/h5/components/share.md

@@ -0,0 +1,11 @@
+# 分享功能
+
+## 实现要点
+- 微信 JS-SDK 分享配置（标题、描述、图片、链接）
+- 浏览器原生 Web Share API 兜底
+- 分享海报生成（html2canvas / canvas 绘制）
+- 分享统计埋点
+
+## 验证策略
+- 验证分享按钮可点击
+- 验证海报生成成功（如适用）

package/recipes/h5/components/swiper.md

@@ -0,0 +1,11 @@
+# 轮播组件
+
+## 实现要点
+- 图片/卡片横向轮播，支持触摸滑动
+- 自动播放 + 手动暂停
+- 指示器（圆点或数字）
+- 图片懒加载，优化首屏性能
+
+## 验证策略
+- snapshot 验证轮播容器和指示器存在
+- 滑动/点击 → 验证切换到下一张

package/recipes/h5/manifest.json

@@ -0,0 +1,21 @@
+{
+  "id": "h5",
+  "name": "H5 活动页",
+  "description": "移动端 H5 活动页面开发（轮播、倒计时、分享、动画等营销场景）",
+  "base": "base.md",
+  "components": [
+    { "id": "swiper",    "label": "轮播",     "description": "图片/卡片轮播、自动播放、指示器", "file": "components/swiper.md",    "default": true },
+    { "id": "countdown", "label": "倒计时",   "description": "活动倒计时、服务端时间同步",     "file": "components/countdown.md", "default": false },
+    { "id": "share",     "label": "分享",     "description": "微信/浏览器分享、海报生成",      "file": "components/share.md",     "default": true },
+    { "id": "animation", "label": "动画效果", "description": "入场动画、滚动动画、交互动效",   "file": "components/animation.md", "default": false }
+  ],
+  "test": {
+    "file": "test/h5-e2e.md",
+    "defaultEnabled": true
+  },
+  "defaults": {
+    "components": ["swiper", "share"],
+    "role": "developer",
+    "test": true
+  }
+}

package/recipes/h5/test/h5-e2e.md

@@ -0,0 +1,20 @@
+# H5 活动页 E2E 测试步骤模板
+
+## 标准测试用例
+
+### 【P0】页面加载
+1. 使用移动端 viewport 导航到页面
+2. snapshot 验证页面主体内容渲染
+3. 验证无 JS 报错（console.error）
+
+### 【P0】核心交互
+1. 操作页面核心功能（如轮播滑动、按钮点击）
+2. 验证交互响应正确
+
+### 【P1】分享功能
+1. 点击分享按钮
+2. 验证分享面板/海报出现
+
+### 【P1】适配验证
+1. 切换不同 viewport（iPhone SE / iPhone 14 / Android）
+2. 验证布局无溢出、元素无遮挡

package/src/commands/auth.js

@@ -41,7 +41,11 @@ function updateGitignore(entry) {
   }
 }
 
-function updateMcpConfig(mcpPath, mode) {
+// ─────────────────────────────────────────────────────────────
+// .mcp.json 配置（Playwright / Chrome DevTools 共用）
+// ─────────────────────────────────────────────────────────────
+
+function updateMcpConfig(mcpPath, tool, mode) {
   let mcpConfig = {};
   if (fs.existsSync(mcpPath)) {
     try { mcpConfig = JSON.parse(fs.readFileSync(mcpPath, 'utf8')); } catch {}
@@ -49,6 +53,19 @@ function updateMcpConfig(mcpPath, mode) {
 
   if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
 
+  if (tool === 'chrome-devtools') {
+    delete mcpConfig.mcpServers.playwright;
+    mcpConfig.mcpServers['chrome-devtools'] = {
+      command: 'npx',
+      args: ['-y', 'chrome-devtools-mcp@latest', '--autoConnect'],
+    };
+    fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n', 'utf8');
+    log('ok', '.mcp.json 已配置 Chrome DevTools MCP (autoConnect)');
+    return;
+  }
+
+  // Playwright MCP
+  delete mcpConfig.mcpServers['chrome-devtools'];
   const args = ['@playwright/mcp@latest'];
   const projectRoot = assets.projectRoot;
 
@@ -75,23 +92,23 @@ function updateMcpConfig(mcpPath, mode) {
   log('ok', `.mcp.json 已配置 Playwright MCP (${mode} 模式)`);
 }
 
-function enableMcpPlaywrightEnv() {
+function enableWebTestEnv(tool) {
   const envPath = assets.path('env');
   if (!envPath || !fs.existsSync(envPath)) return;
 
   let content = fs.readFileSync(envPath, 'utf8');
-  if (/^MCP_PLAYWRIGHT=/m.test(content)) {
-    content = content.replace(/^MCP_PLAYWRIGHT=.*/m, 'MCP_PLAYWRIGHT=true');
+  if (/^WEB_TEST_TOOL=/m.test(content)) {
+    content = content.replace(/^WEB_TEST_TOOL=.*/m, `WEB_TEST_TOOL=${tool}`);
   } else {
     const suffix = content.endsWith('\n') ? '' : '\n';
-    content += `${suffix}MCP_PLAYWRIGHT=true\n`;
+    content += `${suffix}WEB_TEST_TOOL=${tool}\n`;
   }
   fs.writeFileSync(envPath, content, 'utf8');
-  log('ok', '.claude-coder/.env 已设置 MCP_PLAYWRIGHT=true');
+  log('ok', `.claude-coder/.env 已设置 WEB_TEST_TOOL=${tool}`);
 }
 
 // ─────────────────────────────────────────────────────────────
-// 浏览器脚本（session cookie 自动持久化）
+// 浏览器脚本（Playwright persistent 模式用）
 // ─────────────────────────────────────────────────────────────
 
 function buildBrowserScript(playwrightDir, profileDir, url) {
@@ -185,9 +202,9 @@ async function authPersistent(url) {
 
   const mcpPath = assets.path('mcpConfig');
   log('ok', '登录状态已保存到持久化配置');
-  updateMcpConfig(mcpPath, 'persistent');
+  updateMcpConfig(mcpPath, 'playwright', 'persistent');
   updateGitignore('.claude-coder/.runtime/browser-profile');
-  enableMcpPlaywrightEnv();
+  enableWebTestEnv('playwright');
 
   console.log('');
   log('ok', '配置完成！');
@@ -227,9 +244,9 @@ async function authIsolated(url) {
 
   const mcpPath = assets.path('mcpConfig');
   log('ok', '登录状态已保存到 playwright-auth.json');
-  updateMcpConfig(mcpPath, 'isolated');
+  updateMcpConfig(mcpPath, 'playwright', 'isolated');
   updateGitignore('.claude-coder/playwright-auth.json');
-  enableMcpPlaywrightEnv();
+  enableWebTestEnv('playwright');
 
   console.log('');
   log('ok', '配置完成！');
@@ -251,8 +268,8 @@ function authExtension() {
   console.log('');
 
   const mcpPath = assets.path('mcpConfig');
-  updateMcpConfig(mcpPath, 'extension');
-  enableMcpPlaywrightEnv();
+  updateMcpConfig(mcpPath, 'playwright', 'extension');
+  enableWebTestEnv('playwright');
 
   console.log('');
   log('ok', '配置完成！');
@@ -260,13 +277,68 @@ function authExtension() {
   log('info', '确保 Chrome/Edge 已运行且 Playwright MCP Bridge 扩展已启用');
 }
 
+function authChromeDevTools() {
+  console.log('Chrome DevTools MCP 配置:');
+  console.log('');
+  console.log('  此模式通过 Chrome DevTools Protocol 连接到已打开的 Chrome 浏览器。');
+  console.log('  直接复用浏览器中已有的登录态、扩展和 DevTools 调试能力。');
+  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('  4. 允许传入调试连接');
+  console.log('');
+  console.log('  功能:');
+  console.log('  - 输入自动化: 点击、输入、表单填写');
+  console.log('  - 页面导航: 多页面管理、截图');
+  console.log('  - 性能分析: Trace 录制、Core Web Vitals、Lighthouse 审计');
+  console.log('  - 调试工具: Console 消息、网络请求检查、内存快照');
+  console.log('');
+  console.log(`  注意: 单实例限制，同一时间只能连接一个 Chrome 调试会话。`);
+  console.log(`  如需多实例并行，请配置 Playwright MCP（claude-coder setup）。`);
+  console.log('');
+
+  const mcpPath = assets.path('mcpConfig');
+  updateMcpConfig(mcpPath, 'chrome-devtools');
+  enableWebTestEnv('chrome-devtools');
+
+  console.log('');
+  log('ok', '配置完成！');
+  log('info', 'Chrome DevTools MCP 使用 autoConnect 模式');
+  log('info', '确保 Chrome 已启动且已在 chrome://inspect 中启用远程调试');
+}
+
 async function auth(url) {
   assets.ensureDirs();
   const config = loadConfig();
-  const mode = config.playwrightMode;
+  const tool = config.webTestTool;
+
+  if (!tool) {
+    log('error', '未配置浏览器测试工具');
+    log('info', '请先运行 claude-coder setup 选择 Playwright MCP 或 Chrome DevTools MCP');
+    return;
+  }
+
+  if (tool === 'chrome-devtools') {
+    const [major, minor] = process.versions.node.split('.').map(Number);
+    if (major < 20 || (major === 20 && minor < 19)) {
+      log('warn', `当前 Node.js 版本 v${process.versions.node}，Chrome DevTools MCP 要求 v20.19+`);
+      log('info', 'nvm 用户请执行: nvm alias default 22 && nvm use 22');
+      log('info', '升级后重新运行此命令');
+      return;
+    }
+    log('info', '浏览器工具: Chrome DevTools MCP');
+    console.log('');
+    authChromeDevTools();
+    return;
+  }
+
+  // Playwright MCP
+  const mode = config.webTestMode;
   const targetUrl = normalizeUrl(url) || 'http://localhost:3000';
 
-  log('info', `Playwright 模式: ${mode}`);
+  log('info', `浏览器工具: Playwright MCP (${mode} 模式)`);
   log('info', `目标 URL: ${targetUrl}`);
   console.log('');
 

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

@@ -76,11 +76,12 @@ function showCurrentConfig(existing) {
   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 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(`  完成检测:   ${compTimeout} 秒`);
+  console.log(`  完成检测:   Stop hook（SDK 原生）`);
   console.log(`  工具轮次:   ${turns === '0' ? '无限制' : turns}`);
   const simplifyInterval = existing.SIMPLIFY_INTERVAL ?? '5';
   const simplifyCommits = existing.SIMPLIFY_COMMITS ?? '5';

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

@@ -1,6 +1,6 @@
 'use strict';
 
-const { ask, askChoice } = require('./helpers');
+const { askChoice } = require('./helpers');
 const { log, COLOR, updateEnvVar } = require('../../common/config');
 const { assets } = require('../../common/assets');
 
@@ -8,34 +8,31 @@ const { assets } = require('../../common/assets');
 
 async function configureMCP(rl) {
   console.log('');
-  console.log('是否启用 Playwright MCP（浏览器自动化测试）？');
+  console.log('是否启用浏览器测试工具？');
   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('  1) Playwright MCP — 微软官方，25+ 浏览器自动化工具，支持多实例并行');
+  console.log('  2) Chrome DevTools MCP — Google 官方，连接已打开的 Chrome，调试能力更强');
+  console.log('     （单实例限制，多开请配置 Playwright MCP）');
+  console.log('  3) 跳过（纯后端 / CLI 项目）');
   console.log('');
 
-  const mcpChoice = await askChoice(rl, '选择 [1-2]: ', 1, 2);
+  const toolChoice = await askChoice(rl, '选择 [1-3]: ', 1, 3);
 
-  const mcpConfig = { enabled: false, mode: null };
+  const mcpConfig = { tool: '', mode: '' };
 
-  if (mcpChoice === 1) {
-    mcpConfig.enabled = true;
+  if (toolChoice === 1) {
+    mcpConfig.tool = 'playwright';
     console.log('');
     console.log('请选择 Playwright MCP 浏览器模式:');
     console.log('');
     console.log('  1) persistent - 懒人模式（默认，推荐）');
-    console.log('     登录一次永久生效，适合 Google SSO、企业内网 API 拉取等日常开发');
+    console.log('     登录一次永久生效，适合 Google SSO、企业内网等日常开发');
     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);
@@ -58,6 +55,25 @@ async function configureMCP(rl) {
       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;
@@ -66,12 +82,12 @@ async function configureMCP(rl) {
 // ── 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}`);
+  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('MCP_PLAYWRIGHT=false');
+    lines.push('WEB_TEST_TOOL=');
   }
 }
 
@@ -79,11 +95,15 @@ function appendMcpConfig(lines, mcpConfig) {
 
 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);
+  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'), mcpConfig.mode);
+    updateMcpConfig(assets.path('mcpConfig'), 'chrome-devtools');
   }
   log('ok', 'MCP 配置已更新');
 }
@@ -92,4 +112,4 @@ module.exports = {
   configureMCP,
   appendMcpConfig,
   updateMCPOnly,
-};
+};

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

@@ -7,16 +7,14 @@ const { log, COLOR, updateEnvVar } = require('../../common/config');
 
 async function updateSafetyLimits(rl, existing) {
   const currentStall = existing.SESSION_STALL_TIMEOUT || '600';
-  const currentCompletion = existing.SESSION_COMPLETION_TIMEOUT || '300';
   const currentTurns = existing.SESSION_MAX_TURNS || '0';
 
   console.log(`${COLOR.blue}当前安全限制:${COLOR.reset}`);
   console.log(`  停顿超时:     ${currentStall} 秒 (${Math.floor(parseInt(currentStall) / 60)} 分钟)`);
-  console.log(`  完成检测超时: ${currentCompletion} 秒 (${Math.ceil(parseInt(currentCompletion) / 60)} 分钟)`);
   console.log(`  最大工具轮次: ${currentTurns === '0' ? '无限制' : currentTurns}`);
   console.log('');
   console.log(`${COLOR.yellow}说明:${COLOR.reset}`);
-  console.log('  完成检测 — 模型写入 session_result.json 后缩短等待，解决"完成但不退出"');
+  console.log('  完成检测 — 通过 SDK Stop hook 感知模型结束，无需额外超时');
   console.log('  停顿超时 — 长时间无工具调用时自动中断（通用兜底）');
   console.log('  最大轮次 — 限制总轮次，仅 CI 推荐（默认 0 = 无限制）');
   console.log('');
@@ -32,18 +30,6 @@ async function updateSafetyLimits(rl, existing) {
     }
   }
 
-  console.log('');
-  const compInput = await ask(rl, `完成检测超时秒数（回车保留 ${currentCompletion}）: `);
-  if (compInput.trim()) {
-    const seconds = parseInt(compInput.trim(), 10);
-    if (isNaN(seconds) || seconds < 30) {
-      log('warn', '完成检测超时需 >= 30 秒，跳过');
-    } else {
-      updateEnvVar('SESSION_COMPLETION_TIMEOUT', String(seconds));
-      log('ok', `完成检测超时已设置为 ${seconds} 秒`);
-    }
-  }
-
   console.log('');
   const turnsInput = await ask(rl, `最大工具轮次（回车保留 ${currentTurns === '0' ? '无限制' : currentTurns}，输入 0 = 无限制）: `);
   if (turnsInput.trim()) {

package/src/commands/setup.js

@@ -20,7 +20,7 @@ const {
 } = require('./setup-modules');
 
 const PRESERVED_KEYS = [
-  'SESSION_STALL_TIMEOUT', 'SESSION_COMPLETION_TIMEOUT',
+  'SESSION_STALL_TIMEOUT',
   'SESSION_MAX_TURNS', 'SIMPLIFY_INTERVAL', 'SIMPLIFY_COMMITS',
 ];
 
@@ -61,10 +61,10 @@ async function setup() {
     writeConfig(envPath, configResult.lines);
     ensureGitignore();
 
-    if (mcpConfig.enabled && mcpConfig.mode) {
+    if (mcpConfig.tool) {
       const { updateMcpConfig } = require('./auth');
       const mcpPath = assets.path('mcpConfig');
-      updateMcpConfig(mcpPath, mcpConfig.mode);
+      updateMcpConfig(mcpPath, mcpConfig.tool, mcpConfig.mode);
     }
 
     console.log('');
@@ -98,7 +98,7 @@ async function setup() {
     console.log('');
     console.log('  1) 切换模型提供商');
     console.log('  2) 更新 API Key');
-    console.log('  3) 配置 MCP');
+    console.log('  3) 配置浏览器测试工具');
     console.log('  4) 配置安全限制');
     console.log('  5) 配置自动审查');
     console.log('  6) 完全重新配置');
@@ -119,8 +119,8 @@ async function setup() {
         const configResult = await selectProvider(rl, existing);
         preserveSafetyConfig(configResult.lines, existing);
         appendMcpConfig(configResult.lines, {
-          enabled: existing.MCP_PLAYWRIGHT === 'true',
-          mode: existing.MCP_PLAYWRIGHT_MODE || null,
+          tool: existing.WEB_TEST_TOOL || '',
+          mode: existing.WEB_TEST_MODE || '',
         });
         writeConfig(envPath, configResult.lines);
         log('ok', `已切换到: ${configResult.summary}`);
@@ -150,10 +150,10 @@ async function setup() {
         appendMcpConfig(configResult.lines, mcpConfig);
         writeConfig(envPath, configResult.lines);
 
-        if (mcpConfig.enabled && mcpConfig.mode) {
+        if (mcpConfig.tool) {
           const { updateMcpConfig } = require('./auth');
           const mcpPath = assets.path('mcpConfig');
-          updateMcpConfig(mcpPath, mcpConfig.mode);
+          updateMcpConfig(mcpPath, mcpConfig.tool, mcpConfig.mode);
         }
 
         log('ok', '配置已更新');

package/src/common/assets.js

@@ -26,7 +26,7 @@ const REGISTRY = new Map([
   // Other Templates
   ['testRule',       { file: 'test_rule.md',               kind: 'template' }],
   ['guidance',       { file: 'guidance.json',              kind: 'template' }],
-  ['playwright',     { file: 'playwright.md',              kind: 'template' }],
+  ['webTesting',     { file: 'web-testing.md',              kind: 'template' }],
   ['bashProcess',    { file: 'bash-process.md',            kind: 'template' }],
   ['requirements',   { file: 'requirements.example.md',    kind: 'template' }],
 
@@ -226,6 +226,15 @@ class AssetManager {
     return deployed;
   }
 
+  recipesDir() {
+    this._ensureInit();
+    const projectRecipes = path.join(this.loopDir, 'recipes');
+    if (fs.existsSync(projectRecipes) && fs.readdirSync(projectRecipes).length > 0) {
+      return projectRecipes;
+    }
+    return BUNDLED_RECIPES_DIR;
+  }
+
   clearCache() {
     this.cache.clear();
   }