claude-coder 1.9.2 → 1.10.1

package/src/common/config.js

@@ -115,9 +115,31 @@ function updateEnvVar(key, value) {
   return true;
 }
 
+const REPO_URL = 'https://lk19940215.github.io/claude-coder';
+
+/**
+ * @param {string} command - 命令名（run / plan / design / go / simplify / scan）
+ * @param {string} detail  - 右侧附加信息（模式、范围等）
+ * @param {string} [model] - 模型名
+ */
+function printModeBanner(command, detail, model) {
+  const sep = `  ${COLOR.dim}│${COLOR.reset}  `;
+  const parts = [`${COLOR.bold}Claude Coder${COLOR.reset}`, command];
+  if (model)  parts.push(`model: ${model}`);
+  if (detail) parts.push(detail);
+  const inner = parts.join(sep);
+  console.error('');
+  console.error(`${COLOR.cyan}╔══════════════════════════════════════════════╗${COLOR.reset}`);
+  console.error(`${COLOR.cyan}║${COLOR.reset}  ${inner}`);
+  console.error(`${COLOR.cyan}║${COLOR.reset}  ${COLOR.dim}${REPO_URL}${COLOR.reset}`);
+  console.error(`${COLOR.cyan}╚══════════════════════════════════════════════╝${COLOR.reset}`);
+  console.error('');
+}
+
 module.exports = {
   COLOR,
   log,
+  printModeBanner,
   parseEnvFile,
   loadConfig,
   buildEnvVars,

package/src/common/sdk.js

@@ -43,9 +43,7 @@ async function loadSDK() {
     } catch { /* try next */ }
   }
 
-  log('error', `未找到 ${pkgName}`);
-  log('error', `请先安装：npm install -g ${pkgName}`);
-  process.exit(1);
+  throw new Error(`未找到 ${pkgName}，请先安装：npm install -g ${pkgName}`);
 }
 
 module.exports = { loadSDK };

package/src/common/utils.js

@@ -133,6 +133,8 @@ function ensureGitignore(projectRoot) {
     '.claude-coder/*',
     '!.claude-coder/tasks.json',
     '!.claude-coder/project_profile.json',
+    '!.claude-coder/design/',
+    '!.claude-coder/harness_state.json',
   ];
   let added = false;
   for (const p of patterns) {
@@ -171,7 +173,7 @@ function killServices(projectRoot) {
   const { assets } = require('./assets');
   const profile = assets.readJson('profile', null);
   if (!profile) return;
-  const ports = (profile.services || []).map(s => s.port).filter(Boolean);
+  const ports = (profile.services || []).map(s => s.port).filter(p => p && /^\d+$/.test(String(p)));
   if (ports.length === 0) return;
 
   for (const port of ports) {

package/src/core/coding.js

@@ -19,7 +19,9 @@ async function executeCoding(config, sessionNum, opts = {}) {
       queryOpts.systemPrompt = buildSystemPrompt('coding');
       queryOpts.disallowedTools = ['askUserQuestion'];
 
-      const { subtype, cost, usage } = await session.runQuery(prompt, queryOpts);
+      const { subtype, cost, usage } = await session.runQuery(prompt, queryOpts, {
+        continue: true,
+      });
 
       if (subtype && subtype !== 'success' && subtype !== 'unknown') {
         log('warn', `session 结束原因: ${subtype}`);

package/src/core/design.js

@@ -0,0 +1,268 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { buildSystemPrompt } = require('./prompts');
+const { log, printModeBanner } = require('../common/config');
+const { assets } = require('../common/assets');
+const { saveDesignState } = require('./state');
+const { Session } = require('./session');
+
+// ─── Design Dir ───────────────────────────────────────────
+
+function getDesignDir() {
+  return assets.dir('design');
+}
+
+function scanPenFiles(designDir) {
+  const files = [];
+  const scan = (dir, prefix = '') => {
+    if (!fs.existsSync(dir)) return;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (entry.isDirectory()) {
+        scan(path.join(dir, entry.name), prefix + entry.name + '/');
+      } else if (entry.name.endsWith('.pen')) {
+        files.push({ rel: prefix + entry.name, abs: path.join(dir, entry.name) });
+      }
+    }
+  };
+  scan(designDir);
+  return files;
+}
+
+// ─── Type Resolution ─────────────────────────────────────
+
+function resolveType(opts, designDir) {
+  if (opts.type) return opts.type;
+
+  const systemPenPath = path.join(designDir, 'system.lib.pen');
+  if (!fs.existsSync(systemPenPath)) return 'init';
+
+  return 'new';
+}
+
+// ─── Prompt Builders ─────────────────────────────────────
+
+function hasProjectCode(root) {
+  const markers = ['package.json', 'pyproject.toml', 'requirements.txt', 'Cargo.toml', 'go.mod', 'pom.xml'];
+  const dirs = ['src', 'lib', 'app', 'frontend', 'web', 'client', 'pages'];
+  for (const m of markers) { if (fs.existsSync(path.join(root, m))) return true; }
+  for (const d of dirs) {
+    const p = path.join(root, d);
+    if (fs.existsSync(p) && fs.statSync(p).isDirectory()) return true;
+  }
+  return false;
+}
+
+function buildProjectContext() {
+  const root = assets.projectRoot;
+  const hasCode = hasProjectCode(root);
+  let ctx = `### 项目类型\n${hasCode ? '已有代码项目（设计时应 Read 源码还原真实内容）' : '全新项目（无现有代码，根据需求从零设计）'}\n- 项目根路径: ${root}\n\n`;
+
+  if (hasCode) {
+    const pkgPath = path.join(root, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        ctx += `### 项目信息\n- name: ${pkg.name || '未定义'}\n- description: ${pkg.description || '未定义'}\n\n`;
+      } catch { /* ignore */ }
+    }
+  }
+
+  return ctx;
+}
+
+function buildDesignPrompt(instruction, designDir) {
+  let designContext = `### 设计文件目录\n绝对路径: ${designDir}\n`;
+
+  const systemPenPath = path.join(designDir, 'system.lib.pen');
+  const isInit = !fs.existsSync(systemPenPath);
+  designContext += isInit
+    ? '### 设计库\n尚未创建 system.lib.pen，请先根据下方「初始化模板」生成。\n\n'
+    : '### 设计库\n已有 system.lib.pen，请先 Read 查看并复用。\n\n';
+
+  if (isInit) {
+    const initTemplate = assets.read('designInit') || '';
+    if (initTemplate) {
+      designContext += `### 初始化模板\n\n${initTemplate}\n\n`;
+    }
+  }
+
+  const mapPath = path.join(designDir, 'design_map.json');
+  if (fs.existsSync(mapPath)) {
+    try {
+      const map = JSON.parse(fs.readFileSync(mapPath, 'utf8'));
+      const pages = Object.entries(map.pages || {});
+      if (pages.length > 0) {
+        designContext += '### 已有页面\n';
+        for (const [name, info] of pages) {
+          designContext += `- **${name}**: ${info.description} (${path.join(designDir, info.pen)})\n`;
+        }
+        designContext += '\n';
+      }
+    } catch { /* ignore */ }
+  }
+
+  designContext += buildProjectContext();
+
+  return assets.render('designUser', {
+    designContext,
+    instruction: instruction
+      ? `用户需求:\n${instruction}`
+      : '用户未提供需求，使用对话模式收集。',
+    modeHint: instruction
+      ? '【自动模式】用户已提供需求，直接设计，不要提问。'
+      : '【对话模式】使用 AskUserQuestion 工具引导用户描述需求。',
+  });
+}
+
+function buildFixPrompt(designDir, userInput) {
+  const penFiles = scanPenFiles(designDir);
+  let designContext = '### 需要检查修复的 .pen 文件\n\n';
+  if (penFiles.length === 0) {
+    designContext += '（未发现 .pen 文件）\n';
+  } else {
+    for (const f of penFiles) {
+      designContext += `- ${f.abs}\n`;
+    }
+  }
+  designContext += '\n';
+
+  const instruction = userInput
+    ? `用户反馈的问题:\n${userInput}\n\n请 Read 每个文件，检查并修复所有不合规内容。`
+    : '请 Read 每个文件，检查并修复所有不合规内容。';
+
+  return assets.render('designFixUser', { designContext, instruction });
+}
+
+// ─── Post-session Summary ─────────────────────────────────
+
+function showDesignSummary(designDir) {
+  const penFiles = scanPenFiles(designDir);
+  if (penFiles.length === 0) {
+    log('warn', '设计目录中没有 .pen 文件');
+    return 0;
+  }
+
+  console.log('');
+  console.log('┌─ 设计文件 ─────────────────────────────────────┐');
+  for (const f of penFiles) {
+    console.log(`│  ${f.rel.padEnd(52)}│`);
+  }
+  console.log('└───────────────────────────────────────────────┘');
+
+  const hasMap = fs.existsSync(path.join(designDir, 'design_map.json'));
+  if (hasMap) log('info', 'design_map.json OK');
+
+  let hasJsonError = false;
+  for (const f of penFiles) {
+    try {
+      JSON.parse(fs.readFileSync(f.abs, 'utf8'));
+    } catch (e) {
+      hasJsonError = true;
+      log('error', `${f.rel}: JSON 语法错误 — ${e.message}`);
+    }
+  }
+  if (hasJsonError) {
+    log('warn', '存在 JSON 格式问题，建议运行: claude-coder design --type fix');
+  }
+
+  return penFiles.length;
+}
+
+// ─── User Confirm ────────────────────────────────────────
+
+function askUser(question) {
+  if (!process.stdin.isTTY) return Promise.resolve('');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    rl.question(question, answer => { rl.close(); resolve(answer.trim()); });
+  });
+}
+
+// ─── Fix Session ─────────────────────────────────────────
+
+async function runFixSession(config, designDir, userInput, opts) {
+  const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 12);
+  log('info', '正在修复 .pen 文件...');
+
+  await Session.run('design', config, {
+    logFileName: `design_fix_${ts}.log`,
+    label: 'design_fix',
+    async execute(session) {
+      const queryOpts = session.buildQueryOptions(opts);
+      queryOpts.systemPrompt = buildSystemPrompt('designFix');
+      return await session.runQuery(buildFixPrompt(designDir, userInput), queryOpts);
+    },
+  });
+
+  log('ok', '修复完成');
+  showDesignSummary(designDir);
+}
+
+// ─── Main Entry ──────────────────────────────────────────
+
+async function executeDesign(config, input, opts = {}) {
+  if (opts.reset) {
+    saveDesignState({});
+    log('ok', 'Design 状态已重置');
+    return;
+  }
+
+  const designDir = getDesignDir();
+  if (!fs.existsSync(designDir)) fs.mkdirSync(designDir, { recursive: true });
+  const pagesDir = path.join(designDir, 'pages');
+  if (!fs.existsSync(pagesDir)) fs.mkdirSync(pagesDir, { recursive: true });
+
+  const type = resolveType(opts, designDir);
+  const instruction = input || '';
+  const isAutoMode = !!instruction;
+  const designLabel = type === 'fix' ? '修复' : isAutoMode ? '自动' : '对话';
+  printModeBanner('design', `${type} · ${designLabel}`, config?.model);
+
+  if (!opts.model || !opts.model.includes('glm-5')) {
+    log('info', '提示: design 推荐使用 --model glm-5 获得最佳效果');
+  }
+
+  if (type === 'fix') {
+    const penFiles = scanPenFiles(designDir);
+    if (penFiles.length === 0) {
+      log('warn', '设计目录中没有 .pen 文件需要修复');
+      return;
+    }
+    const answer = await askUser(`\n发现 ${penFiles.length} 个 .pen 文件，是否进行修复？(Y/n) `);
+    if (answer.toLowerCase() === 'n') { log('info', '已取消'); return; }
+    await runFixSession(config, designDir, input, opts);
+    return;
+  }
+
+  const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 12);
+
+  const sessionResult = await Session.run('design', config, {
+    logFileName: `design_${ts}_1.log`,
+    label: isAutoMode ? 'design_auto' : 'design_dialogue',
+    async execute(session) {
+      const queryOpts = session.buildQueryOptions(opts);
+      queryOpts.systemPrompt = buildSystemPrompt('design');
+      return await session.runQuery(buildDesignPrompt(instruction, designDir), queryOpts);
+    },
+  });
+
+  if (sessionResult && !sessionResult.success) {
+    log('warn', 'AI 会话未正常完成，检查生成结果...');
+  }
+
+  const penCount = showDesignSummary(designDir);
+  if (penCount === 0) {
+    log('error', 'AI 未生成任何 .pen 文件');
+    return;
+  }
+
+  saveDesignState({ lastTimestamp: new Date().toISOString(), designDir, penCount, type });
+  log('ok', `设计完成！ 文件: ${penCount}`);
+  log('info', '迭代调整: claude-coder design "修改xxx"');
+  log('info', '修复文件: claude-coder design --type fix');
+}
+
+module.exports = { executeDesign };

package/src/core/go.js

@@ -4,7 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 const { buildSystemPrompt } = require('./prompts');
-const { log } = require('../common/config');
+const { log, printModeBanner } = require('../common/config');
 const { assets } = require('../common/assets');
 const { extractResultText } = require('../common/logging');
 const { loadState, saveState } = require('./state');
@@ -184,8 +184,8 @@ async function executeGo(config, input, opts = {}) {
   }
 
   const isAutoMode = !!(instruction || opts.reqFile);
-  const mode = isAutoMode ? '自动' : '对话';
-  log('info', `Go 模式: ${mode}`);
+  const mode = isAutoMode ? '自动模式' : '对话模式';
+  printModeBanner('go', mode, config?.model);
 
   const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 12);
 

package/src/core/hooks.js

@@ -88,8 +88,10 @@ class GuidanceInjector {
 
     if (condition.field && condition.pattern !== undefined) {
       const value = this.getFieldValue(input, condition.field);
-      const re = (ruleName && this._compiledConditions?.get(ruleName)) ||
-        new RegExp(condition.pattern, 'i');
+      let re = ruleName && this._compiledConditions?.get(ruleName);
+      if (!re) {
+        try { re = new RegExp(condition.pattern, 'i'); } catch { return false; }
+      }
       return re.test(String(value || ''));
     }
 
@@ -113,28 +115,41 @@ class GuidanceInjector {
 
   /**
    * Get rule file content
+   * Uses assets module for template resolution (supports user overrides + bundled fallback)
    * @param {object|string} file - File config or path string
-   * @param {string} basePath - Base directory for relative paths
    */
-  getFileContent(file, basePath) {
+  getFileContent(file) {
     if (!file) return null;
 
     const filePath = typeof file === 'string' ? file : file.path;
-    const absolutePath = path.isAbsolute(filePath)
-      ? filePath
-      : path.join(basePath, filePath);
 
-    try {
-      return fs.readFileSync(absolutePath, 'utf8');
-    } catch {
-      return null;
+    // Check if path matches a known registry entry (e.g., 'webTesting', 'bashProcess')
+    // by converting 'assets/web-testing.md' → ['other', 'web-testing.md']
+    if (filePath.startsWith('assets/')) {
+      const segments = filePath.replace(/^assets\//, '').split('/');
+      // Map to template directory structure: assets/web-testing.md → other/web-testing.md
+      if (segments.length === 1) {
+        segments.unshift('other');
+      }
+      const resolved = assets._resolveTemplate?.(segments);
+      if (resolved) {
+        try { return fs.readFileSync(resolved, 'utf8'); } catch { /* fall through */ }
+      }
+    }
+
+    // Fallback: try direct path resolution
+    const absolutePath = path.isAbsolute(filePath) ? filePath : assets.path(filePath);
+    if (absolutePath) {
+      try { return fs.readFileSync(absolutePath, 'utf8'); } catch { /* ignore */ }
     }
+
+    return null;
   }
 
   /**
    * Process a single rule and return guidance content
    */
-  processRule(rule, input, basePath) {
+  processRule(rule, input) {
     const matcherRe = this._compiledMatchers?.get(rule.name) ?? new RegExp(rule.matcher);
     if (!matcherRe.test(input.tool_name)) {
       return null;
@@ -161,7 +176,7 @@ class GuidanceInjector {
         // Get cached content or read file
         const cacheKey = `${rule.name}_content`;
         if (!this.cache[cacheKey]) {
-          this.cache[cacheKey] = this.getFileContent(fileConfig.path, basePath);
+          this.cache[cacheKey] = this.getFileContent(fileConfig.path);
         }
         result.guidance = this.cache[cacheKey] || '';
       }
@@ -198,8 +213,6 @@ class GuidanceInjector {
    * Create hook function for PreToolUse
    */
   createHook() {
-    const basePath = assets.dir('loop');
-
     return async (input, _toolUseID, _context) => {
       this.load();
 
@@ -209,7 +222,7 @@ class GuidanceInjector {
       const tipParts = [];
 
       for (const rule of this.rules) {
-        const result = this.processRule(rule, input, basePath);
+        const result = this.processRule(rule, input);
         if (result) {
           if (result.guidance) guidanceParts.push(result.guidance);
           if (result.tip) tipParts.push(result.tip);
@@ -394,6 +407,7 @@ const FEATURE_MAP = {
   add: [FEATURES.STOP, FEATURES.STALL],
   simplify: [FEATURES.STOP, FEATURES.STALL, FEATURES.INTERACTION],
   go: [FEATURES.STOP, FEATURES.STALL, FEATURES.INTERACTION],
+  design: [FEATURES.STOP, FEATURES.STALL, FEATURES.INTERACTION],
   custom: null
 };
 

package/src/core/init.js

@@ -127,6 +127,15 @@ async function executeInit(config, opts = {}) {
     throw new Error('project_profile.json 读取失败或已损坏');
   }
 
+  const reqDest = path.join(projectRoot, 'requirements.md');
+  if (!fs.existsSync(reqDest)) {
+    const reqTemplate = assets.read('requirements');
+    if (reqTemplate) {
+      fs.writeFileSync(reqDest, reqTemplate, 'utf8');
+      log('ok', '已生成 requirements.md（需求模板）');
+    }
+  }
+
   if (opts.deployTemplates) {
     for (const file of assets.deployAll()) log('ok', `已部署 → .claude-coder/assets/${file}`);
     const recipes = assets.deployRecipes();

package/src/core/plan.js

@@ -5,7 +5,7 @@ const path = require('path');
 const os = require('os');
 const readline = require('readline');
 const { buildSystemPrompt, buildPlanPrompt } = require('./prompts');
-const { log } = require('../common/config');
+const { log, printModeBanner } = require('../common/config');
 const { assets } = require('../common/assets');
 const { printStats } = require('../common/tasks');
 const { syncAfterPlan } = require('./state');
@@ -26,7 +26,11 @@ function buildPlanOnlySystem(opts = {}) {
 2. ${interactionRule}
 3. 使用 Write 工具将完整计划写入 ~/.claude/plans/ 目录（.md 格式）
 4. 写入后输出标记（独占一行）：PLAN_FILE_PATH: <计划文件绝对路径>
-5. 简要总结计划要点`;
+5. 简要总结计划要点
+
+【关键文件】
+- \`.claude-coder/project_profile.json\` — 项目元数据
+- \`.claude-coder/design/\` — UI 设计稿目录（design_map.json 索引 + .pen 设计文件），存在时应在方案中参考`;
 }
 
 function buildPlanOnlyPrompt(instruction, opts = {}) {
@@ -97,17 +101,19 @@ async function _executePlanGen(session, instruction, opts = {}) {
   return { success: false, reason: 'no_path', targetPath: null };
 }
 
-async function promptAutoRun() {
-  if (!process.stdin.isTTY) return false;
+function _askLine(question) {
+  if (!process.stdin.isTTY) return Promise.resolve('');
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise(resolve => {
-    rl.question('任务分解完成后是否自动开始执行？(y/n) ', answer => {
-      rl.close();
-      resolve(/^[Yy]/.test(answer.trim()));
-    });
+    rl.question(question, answer => { rl.close(); resolve(answer.trim()); });
   });
 }
 
+async function promptAutoRun() {
+  const answer = await _askLine('任务分解完成后是否自动开始执行？(y/n) ');
+  return /^[Yy]/.test(answer);
+}
+
 // ─── Main Entry ──────────────────────────────────────────
 
 async function executePlan(config, input, opts = {}) {
@@ -123,9 +129,8 @@ async function executePlan(config, input, opts = {}) {
     throw new Error('用法: claude-coder plan "需求内容"  或  claude-coder plan -r [requirements.md]');
   }
 
-  if (opts.interactive) {
-    log('info', '交互模式已启用，模型可能会向您提问');
-  }
+  const modeLabel = opts.planOnly ? 'planOnly' : opts.interactive ? '交互模式' : '自动模式';
+  printModeBanner('plan', modeLabel, config?.model);
 
   let shouldAutoRun = false;
   if (!opts.planOnly) {
@@ -146,7 +151,7 @@ async function executePlan(config, input, opts = {}) {
       const planResult = await _executePlanGen(session, instruction, opts);
 
       if (!planResult.success) {
-        log('error', `\n计划生成失败: ${planResult.reason || planResult.error}`);
+        log('error', `\n计划生成失败: ${planResult.reason}`);
         return { success: false, reason: planResult.reason };
       }
 
@@ -162,9 +167,10 @@ async function executePlan(config, input, opts = {}) {
       const queryOpts = session.buildQueryOptions(opts);
       queryOpts.systemPrompt = buildSystemPrompt('plan');
 
-      const { success } = await session.runQuery(tasksPrompt, queryOpts);
+      const { success } = await session.runQuery(tasksPrompt, queryOpts, { continue: true });
       if (!success) {
         log('warn', '任务分解查询未正常结束');
+        return { success: false, reason: '任务分解未正常完成' };
       }
 
       syncAfterPlan();
@@ -178,9 +184,9 @@ async function executePlan(config, input, opts = {}) {
 
     if (shouldAutoRun) {
       console.log('');
-      log('info', '开始自动执行任务...');
+      log('info', '开始自动执行任务（沿用会话上下文）...');
       const { executeRun } = require('./runner');
-      await executeRun(config, opts);
+      await executeRun(config, { ...opts });
     }
   }
 }

package/src/core/prompts.js

@@ -17,6 +17,12 @@ function buildSystemPrompt(type) {
     case 'coding':  specific = assets.read('codingSystem') || ''; break;
     case 'plan':    specific = assets.read('planSystem') || ''; break;
     case 'go':      specific = assets.read('goSystem') || ''; break;
+    case 'design':  specific = assets.read('designSystem') || ''; break;
+    case 'designFix': specific = assets.read('designFixSystem') || ''; break;
+  }
+  if (type === 'design' || type === 'designFix') {
+    const base = assets.read('designBase') || '';
+    return base ? `${specific}\n\n---\n\n${base}` : specific;
   }
   return specific ? `${specific}\n\n${core}` : core;
 }
@@ -156,6 +162,27 @@ function buildServiceHint(maxSessions) {
     : '连续模式：收尾时不要停止后台服务，保持服务运行以便下个 session 继续使用。';
 }
 
+// --------------- Design Hint ---------------
+
+function buildDesignHint(task) {
+  if (!needsWebTools(task)) return '';
+  if (!assets.exists('designMap')) return '';
+
+  const map = assets.readJson('designMap', null);
+  if (!map || !map.pages) return '';
+
+  const pages = Object.entries(map.pages);
+  if (pages.length === 0) return '';
+
+  const designDir = assets.dir('design');
+  let hint = `【设计稿参考】项目已有 UI 设计稿（design_map.json: ${assets.path('designMap')}）：\n`;
+  for (const [name, info] of pages) {
+    hint += `  - ${name}: ${info.description || ''} → ${path.join(designDir, info.pen)}\n`;
+  }
+  hint += '涉及 UI 的任务可先 Read 对应 .pen 文件了解设计意图。';
+  return hint;
+}
+
 // --------------- Context Builders ---------------
 
 function _resolveTask(taskId) {
@@ -187,6 +214,7 @@ function buildCodingContext(sessionNum, opts = {}) {
     webTestHint: buildWebTestHint(config, task),
     memoryHint: buildMemoryHint(),
     serviceHint: buildServiceHint(opts.maxSessions || 50),
+    designHint: buildDesignHint(task),
   });
 }
 
@@ -223,17 +251,34 @@ function buildPlanPrompt(planPath) {
 
   let testRuleHint = '';
   if (assets.exists('testRule') && assets.exists('mcpConfig')) {
+    const testRulePath = assets.path('testRule');
     testRuleHint = '【浏览器测试规则】项目已配置浏览器测试工具（.mcp.json），' +
-      '`.claude-coder/assets/test_rule.md` 包含测试规范（Smart Snapshot、等待策略、步骤模板等）。' +
-      '前端页面 test 类任务 steps 首步加入 `【规则】阅读 .claude-coder/assets/test_rule.md`。';
+      `\`${testRulePath}\` 包含测试规范（Smart Snapshot、等待策略、步骤模板等）。` +
+      `前端页面 test 类任务 steps 首步加入 \`【规则】阅读 ${testRulePath}\`。`;
   }
 
+  let designHint = '';
+  try {
+    if (assets.exists('designMap')) {
+      const map = assets.readJson('designMap', null);
+      if (map?.pages && Object.keys(map.pages).length > 0) {
+        const designDir = assets.dir('design');
+        designHint = `【设计稿】项目已有 UI 设计稿（${assets.path('designMap')}）：\n`;
+        for (const [name, info] of Object.entries(map.pages)) {
+          designHint += `  - ${name}: ${info.description || ''} → ${path.join(designDir, info.pen)}\n`;
+        }
+        designHint += '涉及 UI 的 task steps 应包含「Read 对应 .pen 设计稿」步骤。';
+      }
+    }
+  } catch { /* ignore */ }
+
   return assets.render('planUser', {
     taskContext,
     recentExamples,
     projectRoot,
     planPath,
     testRuleHint,
+    designHint,
   });
 }
 

package/src/core/repair.js

@@ -23,7 +23,7 @@ async function executeRepair(config, filePath, opts = {}) {
 
       async execute(session) {
         const queryOpts = session.buildQueryOptions(opts);
-        await session.runQuery(prompt, queryOpts);
+        await session.runQuery(prompt, queryOpts, { continue: true });
         log('ok', `AI 修复 ${fileName} 完成`);
         return {};
       },