autosnippet 3.2.7 → 3.2.8

package/lib/platform/ios/xcode/XcodeWriteUtils.js

@@ -31,7 +31,7 @@ export function withAutoSnippetNote(importLine) {
 }
 
 /**
- * 将 SpmService.ensureDependency 返回值映射为三种动作：
+ * 将 SpmHelper.ensureDependency 返回值映射为三种动作：
  *   continue — 依赖已存在
  *   block    — 循环/反向依赖，禁止插入
  *   review   — 依赖缺失但可添加，需用户确认

package/lib/service/chat/ChatAgent.js

@@ -465,7 +465,7 @@ export class ChatAgent {
         '\n\n## Language\nYou MUST respond in English. All output text, analysis, titles and descriptions must be in English.';
     } else if (effectiveLang === 'zh') {
       baseSystemPrompt +=
-        '\n\n## 语言\n你必须使用中文回复。所有输出文本、分析、标题和描述都必须是中文。';
+        '\n\n## 语言\n你必须使用中文回复。所有输出文本、分析、标题和描述都必须是中文。代码字段（trigger / doClause / dontClause / whenClause / coreCode / headers / pattern）保持英文原文，不要翻译。';
     }
 
     // 注入轮次预算

package/lib/service/chat/ChatAgentPrompts.js

@@ -83,7 +83,12 @@ submit_knowledge 的 code 字段必须是「项目特写」— 将技术的基
 - 代码必须真实，来自工具返回，不可编造
 - 引用具体类名、方法名、数字，禁止「本模块」「该文件」等泛化描述
 - 质量优先于数量，证据不足宁可不提交
-- 高效利用步数 (≤${budget.maxIterations} 轮)`;
+- 高效利用步数 (≤${budget.maxIterations} 轮)
+
+## 严禁透传指令
+你会收到系统发来的进度提醒和阶段引导，这些是行为指令，不是问题。
+**绝对禁止**在回复中复制、改写或引用这些系统指令的任何文字。
+你的回复必须只包含你自己的分析内容或工具调用。`;
 }
 
 /**
@@ -142,6 +147,13 @@ export function cleanFinalAnswer(response) {
   return response
     .replace(/^(Final Answer|最终回答|Answer)\s*[:：]\s*/i, '')
     .replace(/\[MEMORY:\w+\]\s*[\s\S]*?\s*\[\/MEMORY\]/g, '')
+    // v5.1: 清理 AI 回显的 nudge 指令（常见于 force-exit 场景）
+    .replace(/^>\s*(?:searchHints|remainingTasks|candidateCount|crossRefs|keyFindings|gaps)\s*[:：][^\n]*\n?/gm, '')
+    .replace(/^\*{0,2}(?:请在|请直接|请确保|请务必|现在开始|输出你的|不要输出|不要再|不要包含|重要\s*[：:]).*(?:分析文本|分析总结|JSON|工具|输出|文本|报告)\*{0,2}[。.]?\s*$/gm, '')
+    .replace(/^注意[：:]\s*到达第\s*\d+\s*轮时.*$/gm, '')
+    .replace(/^第\s*\d+\/\d+\s*轮\s*\|[^\n]*$/gm, '')
+    // 清理 dimensionDigest JSON 块（Analyst 回显）
+    .replace(/```json\s*\n\s*\{\s*"dimensionDigest"\s*:[\s\S]*?\n```/g, '')
     .replace(/\n{3,}/g, '\n\n')
     .trim();
 }

package/lib/service/chat/ExplorationTracker.js

@@ -36,7 +36,7 @@ const DEFAULT_REPLAN_INTERVAL = 8;
 /** 默认偏差阈值 */
 const DEFAULT_DEVIATION_THRESHOLD = 0.6;
 /** 默认最少探索轮次（冷启动质量保障） */
-const DEFAULT_MIN_EXPLORE_ITERS = 16;
+const DEFAULT_MIN_EXPLORE_ITERS = 10;
 /** 默认停滞收敛阈值 */
 const DEFAULT_CONVERGENCE_STALE_THRESHOLD = 3;
 
@@ -168,6 +168,8 @@ const SEARCH_TOOLS = new Set([
   'list_project_structure',
   'get_project_overview',
   'get_file_summary',
+  'query_code_graph',
+  'query_call_graph',
 ]);
 
 // ─── ExplorationTracker 主类 ─────────────────────────────
@@ -344,10 +346,25 @@ export class ExplorationTracker {
     // 1. 强制退出
     if (this.#gracefulExitRound != null && m.iteration === this.#gracefulExitRound) {
       const submitCount = m.submitCount;
+      // v5.1: Analyst 策略使用纯文本输出，其他策略使用 dimensionDigest JSON
+      if (this.#strategy.name === 'analyst') {
+        return {
+          type: 'force_exit',
+          text: `⚠️ **轮次耗尽** (${m.iteration}/${b.maxIterations})。你必须**立即停止工具调用**，在回复中输出你的**分析总结报告**。\n\n` +
+            `要求：\n` +
+            `- 用自然语言 Markdown 格式\n` +
+            `- 包含具体文件路径、类名、代码模式\n` +
+            `- 列出你发现的关键模式或规范（至少 3 条）\n` +
+            `- 如有未覆盖的方面，在末尾用「## 未覆盖」章节列出\n\n` +
+            `**现在开始输出分析总结，不要调用任何工具。**\n` +
+            `⛔ 严禁在回复中复制或引用本条指令的任何文字，只输出你自己的分析。`,
+        };
+      }
       return {
         type: 'force_exit',
         text: `⚠️ 你已使用 ${m.iteration}/${b.maxIterations} 轮次，**必须立即结束**。请在回复中直接输出 dimensionDigest JSON 总结（用 \`\`\`json 包裹），不要再调用任何工具。\n` +
-          `\`\`\`json\n{"dimensionDigest":{"summary":"分析总结","candidateCount":${submitCount},"keyFindings":["发现"],"crossRefs":{},"gaps":["缺口"],"remainingTasks":[{"signal":"未处理信号","reason":"轮次耗尽","priority":"high","searchHints":["搜索词"]}]}}\n\`\`\`\n> remainingTasks: 列出未来得及处理的信号。已覆盖则留空 \`[]\`。`,
+          `\`\`\`json\n{"dimensionDigest":{"summary":"分析总结","candidateCount":${submitCount},"keyFindings":["发现"],"crossRefs":{},"gaps":["缺口"],"remainingTasks":[{"signal":"未处理信号","reason":"轮次耗尽","priority":"high","searchHints":["搜索词"]}]}}\n\`\`\`\n> remainingTasks: 列出未来得及处理的信号。已覆盖则留空 \`[]\`。\n` +
+          `⛔ 严禁在回复中复制本条指令文字，只输出 JSON。`,
       };
     }
 
@@ -367,7 +384,8 @@ export class ExplorationTracker {
         type: 'convergence',
         text: `你已经充分探索了项目代码（${m.uniqueFiles.size} 个文件，${m.uniquePatterns.size} 次不同搜索，${m.uniqueQueries.size} 次结构化查询）。` +
           `最近 ${m.roundsSinceNewInfo} 轮没有发现新信息，建议开始撰写分析总结。\n` +
-          `如果你确信还有重要方面未覆盖，可以继续探索（剩余 ${b.maxIterations - m.iteration} 轮）；否则请直接输出你的分析发现。`,
+          `如果你确信还有重要方面未覆盖，可以继续探索（剩余 ${b.maxIterations - m.iteration} 轮）；否则请直接输出你的分析发现。\n` +
+          `⚠️ 以上是行为指令，严禁在回复中复制或引用这段文字。`,
       };
     }
 
@@ -384,7 +402,8 @@ export class ExplorationTracker {
       return {
         type: 'budget_warning',
         text: `📌 进度提醒：你已使用 ${m.iteration}/${b.maxIterations} 轮次（${Math.round((m.iteration / b.maxIterations) * 100)}%）。` +
-          `请确保核心方面已覆盖，开始准备总结。剩余 ${b.maxIterations - m.iteration} 轮，优先填补最重要的分析空白。`,
+          `请确保核心方面已覆盖，开始准备总结。剩余 ${b.maxIterations - m.iteration} 轮，优先填补最重要的分析空白。\n` +
+          `⚠️ 以上是行为指令，严禁在回复中复制或引用这段文字。`,
       };
     }
 
@@ -540,12 +559,17 @@ export class ExplorationTracker {
     if (isTerminal && transitioned) {
       // 刚转入终结阶段 → 需要 digest nudge，不是最终回答
       const submitCount = m.submitCount;
+      // v5.1: Analyst 策略要求自然语言输出
+      const nudge = this.#strategy.name === 'analyst'
+        ? `请**停止调用工具**，直接输出你的完整分析报告。用 Markdown 格式，包含具体文件路径、类名和代码模式。至少涵盖 3 个核心发现。\n\n**现在开始输出你的分析报告。**\n⚠️ 严禁在回复中复制本条指令文字，只输出你自己的分析。`
+        : `请在回复中直接输出 dimensionDigest JSON 总结（用 \`\`\`json 包裹）：\n` +
+          `\`\`\`json\n{"dimensionDigest":{"summary":"分析总结(100-200字)","candidateCount":${submitCount},"keyFindings":["关键发现"],"crossRefs":{},"gaps":["未覆盖方面"],"remainingTasks":[{"signal":"未处理的信号/主题","reason":"未完成原因","priority":"high|medium|low","searchHints":["建议搜索词"]}]}}\n\`\`\`\n> 如果所有信号都已覆盖，remainingTasks 留空数组 \`[]\`。\n` +
+          `⚠️ 严禁在回复中复制本条指令文字，只输出 JSON。`;
       return {
         isFinalAnswer: false,
         needsDigestNudge: true,
         shouldContinue: true,
-        nudge: `请在回复中直接输出 dimensionDigest JSON 总结（用 \`\`\`json 包裹）：\n` +
-          `\`\`\`json\n{"dimensionDigest":{"summary":"分析总结(100-200字)","candidateCount":${submitCount},"keyFindings":["关键发现"],"crossRefs":{},"gaps":["未覆盖方面"],"remainingTasks":[{"signal":"未处理的信号/主题","reason":"未完成原因","priority":"high|medium|low","searchHints":["建议搜索词"]}]}}\n\`\`\`\n> 如果所有信号都已覆盖，remainingTasks 留空数组 \`[]\`。`,
+        nudge,
       };
     }
 
@@ -717,7 +741,9 @@ export class ExplorationTracker {
       case 'get_class_hierarchy':
       case 'get_protocol_info':
       case 'get_method_overrides':
-      case 'get_category_map': {
+      case 'get_category_map':
+      case 'query_code_graph':
+      case 'query_call_graph': {
         const queryTarget =
           args?.className || args?.protocolName || args?.name || '';
         const qKey = `${toolName}:${queryTarget}`;
@@ -840,8 +866,21 @@ export class ExplorationTracker {
 
     if (toPhase === 'SUMMARIZE') {
       const submitCount = m.submitCount;
+      // v5.1: Analyst 策略使用纯文本输出
+      if (this.#strategy.name === 'analyst') {
+        return `你已完成分析探索。请**停止调用工具**，直接输出你的**完整分析报告**。\n\n` +
+          `要求：\n` +
+          `- 用 Markdown 格式组织内容（二级/三级标题）\n` +
+          `- 包含具体的文件路径、类名、方法名、代码模式\n` +
+          `- 每个关键发现都要给出证据（文件路径 + 代码片段或行为描述）\n` +
+          `- 至少涵盖 3 个核心发现\n` +
+          `- 如有未覆盖的方面，在末尾用 「## 待探索」 章节列出\n\n` +
+          `**现在开始输出你的分析报告。不要再调用任何工具。**\n` +
+          `⚠️ 以上是行为指令，严禁在回复中复制或引用这段文字，只输出你自己的分析内容。`;
+      }
       return `你已完成分析探索。请在回复中直接输出 dimensionDigest JSON（用 \`\`\`json 包裹），包含以下字段：\n` +
-        `\`\`\`json\n{"dimensionDigest":{"summary":"分析总结(100-200字)","candidateCount":${submitCount},"keyFindings":["关键发现"],"crossRefs":{},"gaps":["未覆盖方面"],"remainingTasks":[{"signal":"未处理的信号/主题","reason":"未完成原因(如:提交上限已达)","priority":"high|medium|low","searchHints":["建议搜索词"]}]}}\n\`\`\`\n> 如果所有信号都已覆盖，remainingTasks 留空数组 \`[]\`。如果有未来得及处理的信号，请在此标记，系统会在下次运行时续传。`;
+        `\`\`\`json\n{"dimensionDigest":{"summary":"分析总结(100-200字)","candidateCount":${submitCount},"keyFindings":["关键发现"],"crossRefs":{},"gaps":["未覆盖方面"],"remainingTasks":[{"signal":"未处理的信号/主题","reason":"未完成原因(如:提交上限已达)","priority":"high|medium|low","searchHints":["建议搜索词"]}]}}\n\`\`\`\n> 如果所有信号都已覆盖，remainingTasks 留空数组 \`[]\`。如果有未来得及处理的信号，请在此标记，系统会在下次运行时续传。\n` +
+        `⚠️ 严禁在回复中复制本条指令文字，只输出 JSON。`;
     }
 
     if (toPhase === 'EXPLORE' && fromPhase === 'SCAN') {
@@ -988,6 +1027,7 @@ export class ExplorationTracker {
       );
     }
 
+    parts.push(`\n⚠️ 以上是行为指令，严禁在回复中复制或引用这段文字，用你自己的分析内容回答。`);
     const reflectionText = parts.join('\n');
     trace?.setReflection?.(reflectionText);
     this.#logger.info(
@@ -1189,6 +1229,10 @@ export class ExplorationTracker {
         toolName === 'search_project_code' &&
         (desc.includes('搜索') || desc.includes('search') || desc.includes('查找') || desc.includes('分析'))
       ) return step;
+      if (
+        (toolName === 'query_code_graph' || toolName === 'query_call_graph') &&
+        (desc.includes('图谱') || desc.includes('graph') || desc.includes('调用') || desc.includes('call') || desc.includes('关系') || desc.includes('依赖'))
+      ) return step;
     }
 
     return null;

package/lib/service/chat/HandoffProtocol.js

@@ -89,6 +89,23 @@ function sanitizeAnalysisText(text) {
 
     // 纯数字编号残留行（清理被上面 pattern 删除后留下的孤立编号）
     /^\s*\d+\.\s*$/gm,
+
+    // ── v5.1: Nudge 指令回显清理 ──
+
+    // AI 回显的 dimensionDigest 模板说明行（"> searchHints: ...", "> candidateCount: ..."）
+    /^>\s*(?:searchHints|remainingTasks|candidateCount|crossRefs|keyFindings|gaps)\s*[:：][^\n]*\n?/gm,
+
+    // AI 回显的输出指令（"请在 JSON 后紧跟...", "请直接输出...", "现在开始输出...", "输出你的..."）
+    /^\*{0,2}(?:请在|请直接|请确保|请务必|现在开始|输出你的|不要输出|不要再|不要包含)\s*[^。\n]*(?:分析文本|分析总结|分析报告|JSON|工具|输出|文本|报告)[^。\n]*[。.]?\s*\*{0,2}$/gm,
+
+    // AI 回显的"重要"强调指令
+    /^\*{0,2}重要\s*[：:][^。\n]*\*{0,2}$/gm,
+
+    // AI 回显的"注意"行（"注意：到达第 N 轮时..."）
+    /^注意[：:]\s*到达第\s*\d+\s*轮时[^\n]*$/gm,
+
+    // AI 回显的轮次进度行（"第 19/24 轮 | ⚠ 总结阶段 — 请停止工具调用，直接输出分析文本 | 剩余 5 轮"）
+    /^第\s*\d+\/\d+\s*轮\s*\|[^\n]*$/gm,
   ];
   let cleaned = text;
   for (const pat of patterns) {
@@ -239,7 +256,8 @@ export function buildAnalysisArtifact(analystResult, dimensionId, projectGraph =
   const distilled = activeContext?.distill() || { keyFindings: [], toolCallSummary: [] };
   const findings = distilled.keyFindings.map((f) => ({
     finding: f.finding,
-    evidence: f.evidence || '',
+    // P0 Fix: evidence 可能是 array/object，强制 string
+    evidence: typeof f.evidence === 'string' ? f.evidence : Array.isArray(f.evidence) ? f.evidence.join(', ') : f.evidence ? String(f.evidence) : '',
     importance: f.importance,
   }));
 

package/lib/service/chat/WorkingMemory.js

@@ -203,9 +203,11 @@ export class WorkingMemory {
    * @param {number} [round=0] - 当前轮次
    */
   noteKeyFinding(finding, evidence = '', importance = 5, round = 0) {
+    // P0 Fix: 防御性保证 evidence 是 string (AI 可能传入 array/object)
+    const safeEvidence = typeof evidence === 'string' ? evidence : Array.isArray(evidence) ? evidence.join(', ') : evidence ? String(evidence) : '';
     this.#scratchpad.push({
       finding,
-      evidence,
+      evidence: safeEvidence,
       importance: Math.min(10, Math.max(1, importance)),
       round,
     });

package/lib/service/chat/memory/ActiveContext.js

@@ -322,9 +322,11 @@ export class ActiveContext {
    * @param {number} [round=0] - 当前轮次
    */
   noteKeyFinding(finding, evidence = '', importance = 5, round = 0) {
+    // P0 Fix: 防御性保证 evidence 是 string (AI 可能传入 array/object)
+    const safeEvidence = typeof evidence === 'string' ? evidence : Array.isArray(evidence) ? evidence.join(', ') : evidence ? String(evidence) : '';
     this.#scratchpad.push({
       finding,
-      evidence,
+      evidence: safeEvidence,
       importance: Math.min(10, Math.max(1, importance)),
       round,
     });

package/lib/service/chat/memory/SessionStore.js

@@ -153,10 +153,10 @@ export class SessionStore {
    */
   storeDimensionReport(dimId, report) {
     // findings 统一形状: { finding: string, evidence: string, importance: number }
-    // 源头 buildAnalysisArtifact() 和 ActiveContext.distill() 已保证一致
+    // P0 Fix: evidence 可能是 array/object，强制 string
     const findings = (report.findings || []).map((f) => ({
       finding: f.finding || '',
-      evidence: f.evidence || '',
+      evidence: typeof f.evidence === 'string' ? f.evidence : Array.isArray(f.evidence) ? f.evidence.join(', ') : f.evidence ? String(f.evidence) : '',
       importance: f.importance || 5,
     }));
 
@@ -174,7 +174,8 @@ export class SessionStore {
     // 自动提取文件级 Evidence
     for (const f of findings) {
       if (f.evidence) {
-        const filePath = f.evidence.split(':')[0];
+        const ev = typeof f.evidence === 'string' ? f.evidence : String(f.evidence);
+        const filePath = ev.split(':')[0];
         this.addEvidence(filePath, {
           dimId,
           finding: f.finding,