autosnippet 3.3.5 → 3.3.7

package/dist/lib/agent/domain/insight-evolver.d.ts

@@ -0,0 +1,69 @@
+/**
+ * insight-evolver.ts — Evolution Agent 领域函数
+ *
+ * Evolution Agent 是管线中的专职进化角色：
+ *   - 接收当前维度的**全部**现有 Recipe（不仅是衰退的）
+ *   - 使用工具读取真实代码，验证每个 Recipe 的真实性
+ *   - 通过**附加提案**（Proposal）驱动状态变更，不创建新 Recipe
+ *   - 三种决策: propose_evolution / confirm_deprecation / skip_evolution
+ *
+ * 被 PipelineStrategy 的 evolution preset 引用。
+ * 按维度隔离：每个维度的 Evolve Stage 只处理属于该维度的 Recipe。
+ *
+ * @module insight-evolver
+ */
+/** 静态审计 hint（可选）— 来自 RecipeRelevanceAuditor */
+export interface AuditHint {
+    relevanceScore: number;
+    verdict: string;
+    evidence: {
+        triggerStillMatches: boolean;
+        symbolsAlive: number;
+        depsIntact: boolean;
+        codeFilesExist: number;
+    };
+    decayReasons: string[];
+}
+/** 现有 Recipe（含可选的 audit hint） */
+export interface ExistingRecipeForEvolution {
+    id: string;
+    title: string;
+    trigger: string;
+    content?: {
+        markdown?: string;
+        rationale?: string;
+        coreCode?: string;
+    };
+    sourceRefs?: string[];
+    /** 静态审计 hint — 仅供参考，Agent 应通过读代码自行验证 */
+    auditHint?: AuditHint | null;
+}
+/** Evolution Agent 上下文 */
+export interface EvolutionContext {
+    /** 当前维度的全部现有 Recipe（healthy + decaying），按维度过滤后注入 */
+    existingRecipes: ExistingRecipeForEvolution[];
+    dimensionId: string;
+    dimensionLabel: string;
+    projectOverview: {
+        primaryLang: string;
+        fileCount: number;
+        modules: string[];
+    };
+}
+export declare const EVOLVER_SYSTEM_PROMPT = "\u4F60\u662F AutoSnippet \u7684 **Evolution Agent**\uFF0C\u4E13\u804C\u9A8C\u8BC1\u9879\u76EE\u4E2D\u73B0\u6709\u77E5\u8BC6\u6761\u76EE\uFF08Recipe\uFF09\u7684\u771F\u5B9E\u6027\u4E0E\u65F6\u6548\u6027\u3002\n\n## \u6838\u5FC3\u804C\u8D23\n\n\u4F60\u901A\u8FC7\u9605\u8BFB\u9879\u76EE\u771F\u5B9E\u4EE3\u7801\u6765\u9A8C\u8BC1\u6BCF\u6761 Recipe \u662F\u5426\u4ECD\u7136\u53CD\u6620\u5F53\u524D\u9879\u76EE\u5B9E\u8DF5\u3002\n\u4F60\u7684\u5DE5\u4F5C\u7ED3\u679C\u4EE5**\u63D0\u6848\uFF08Proposal\uFF09**\u65B9\u5F0F\u9644\u52A0\u5230\u73B0\u6709 Recipe \u4E0A\uFF0C\u63A8\u52A8\u77E5\u8BC6\u5E93\u7684\u6E10\u8FDB\u5F0F\u6F14\u5316\u3002\n\u4F60**\u4E0D\u521B\u5EFA\u65B0 Recipe**\u2014\u2014\u90A3\u662F\u540E\u7EED Produce \u9636\u6BB5\u7684\u804C\u8D23\u3002\n\n## \u9A8C\u8BC1\u6D41\u7A0B\n\n\u5BF9\u6BCF\u4E2A Recipe \u6309\u4EE5\u4E0B\u6B65\u9AA4\u9A8C\u8BC1:\n1. \u9605\u8BFB Recipe \u7684\u6838\u5FC3\u4EE3\u7801\u7247\u6BB5\u548C\u6E90\u6587\u4EF6\u5F15\u7528\uFF0C\u7406\u89E3\u5176\u63CF\u8FF0\u7684\u6A21\u5F0F\n2. \u4F7F\u7528 `read_project_file` \u8BFB\u53D6\u6E90\u6587\u4EF6\uFF0C\u9A8C\u8BC1\u4EE3\u7801\u662F\u5426\u5B58\u5728\u4E14\u4E0E Recipe \u63CF\u8FF0\u5339\u914D\n3. \u5982\u679C\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728\u6216\u4EE3\u7801\u4E0D\u5339\u914D\uFF0C\u4F7F\u7528 `search_project_code` \u641C\u7D22\u8BE5\u6A21\u5F0F\u662F\u5426\u5DF2\u8FC1\u79FB\u5230\u5176\u4ED6\u4F4D\u7F6E\n4. \u57FA\u4E8E\u771F\u5B9E\u4EE3\u7801\u7684\u9A8C\u8BC1\u7ED3\u679C\u505A\u51FA\u51B3\u7B56\n\n## \u51B3\u7B56\u89C4\u5219\n\n\u6309\u4EE5\u4E0B\u51B3\u7B56\u6811\u5224\u65AD\uFF08\u4F18\u5148\u7EA7\u4ECE\u4E0A\u5230\u4E0B\uFF09:\n\n| \u9A8C\u8BC1\u7ED3\u679C | \u51B3\u7B56 | \u5DE5\u5177 |\n|---------|------|------|\n| \u6E90\u6587\u4EF6\u5B58\u5728 + \u4EE3\u7801\u5339\u914D Recipe \u63CF\u8FF0 | **\u8DF3\u8FC7**: \u4ECD\u7136\u6709\u6548 | `skip_evolution` |\n| \u6E90\u6587\u4EF6\u5B58\u5728 + \u4EE3\u7801\u5DF2\u53D8\u5316\uFF08\u63A5\u53E3\u6539\u53D8/\u91CD\u6784\uFF09 | **\u8FDB\u5316\u63D0\u6848**: \u9644\u52A0\u53D8\u66F4\u8BC1\u636E | `propose_evolution` |\n| \u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 + \u6A21\u5F0F\u5DF2\u8FC1\u79FB\u5230\u65B0\u4F4D\u7F6E | **\u8FDB\u5316\u63D0\u6848**: \u9644\u52A0\u8FC1\u79FB\u8BC1\u636E | `propose_evolution` |\n| \u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 + \u5B8C\u5168\u65E0\u66FF\u4EE3 | **\u786E\u8BA4\u5E9F\u5F03**: \u77E5\u8BC6\u5DF2\u5931\u6548 | `confirm_deprecation` |\n| \u4FE1\u606F\u4E0D\u8DB3\u4EE5\u505A\u51FA\u5224\u65AD | **\u8DF3\u8FC7**: \u4EA4\u7ED9\u65F6\u9650\u673A\u5236 | `skip_evolution` |\n\n## \u5DE5\u5177\u8BF4\u660E\n\n- `propose_evolution` \u2014 \u4E3A Recipe \u9644\u52A0\u8FDB\u5316\u63D0\u6848\uFF0C\u5305\u542B\u4EE3\u7801\u9A8C\u8BC1\u8BC1\u636E\u548C\u5EFA\u8BAE\u53D8\u66F4\u3002\u63D0\u6848\u8FDB\u5165\u89C2\u5BDF\u7A97\u53E3\uFF08enhance: 48h, correction: 24h\uFF09\uFF0C\u4E0D\u76F4\u63A5\u4FEE\u6539 Recipe\n- `confirm_deprecation` \u2014 \u786E\u8BA4 Recipe \u5DF2\u8FC7\u65F6\uFF0C\u7ACB\u5373\u6807\u8BB0\u4E3A deprecated\uFF08\u8DF3\u8FC7\u89C2\u5BDF\u7A97\u53E3\uFF09\n- `skip_evolution` \u2014 \u663E\u5F0F\u8DF3\u8FC7\uFF0Creason \u4E2D\u8BF4\u660E\u662F\"\u9A8C\u8BC1\u6709\u6548\"\u8FD8\u662F\"\u4FE1\u606F\u4E0D\u8DB3\"\n\n## \u91CD\u8981\u7EA6\u675F\n\n- \u6BCF\u4E2A Recipe \u5FC5\u987B\u6709\u4E00\u4E2A\u660E\u786E\u51B3\u7B56\uFF0C\u4E0D\u8981\u9057\u6F0F\u4EFB\u4F55\u4E00\u4E2A\n- `propose_evolution` \u7684 evidence \u5B57\u6BB5\u5FC5\u987B\u5305\u542B\u4F60\u8BFB\u5230\u7684\u771F\u5B9E\u4EE3\u7801\uFF0C\u4E0D\u8981\u7F16\u9020\n- `propose_evolution` \u7684 type \u533A\u5206: enhance\uFF08\u6A21\u5F0F\u8FC1\u79FB/\u529F\u80FD\u6269\u5C55\uFF09vs correction\uFF08\u63CF\u8FF0\u9519\u8BEF/\u63A5\u53E3\u53D8\u66F4\uFF09\n- \u90E8\u5206 Recipe \u9644\u5E26\u7CFB\u7EDF\u9884\u68C0\u63D0\u793A\uFF08auditHint\uFF09\uFF0C\u4EC5\u4F9B\u53C2\u8003\u2014\u2014\u4F60\u5FC5\u987B\u4EE5\u5B9E\u9645\u8BFB\u5230\u7684\u4EE3\u7801\u4E3A\u51C6\n- \u5373\u4F7F\u9884\u68C0\u63D0\u793A\u8BF4\"healthy\"\uFF0C\u4F60\u8BFB\u4EE3\u7801\u540E\u53D1\u73B0\u4E0D\u5339\u914D\u4E5F\u8981\u63D0\u4EA4\u63D0\u6848";
+export declare const EVOLVER_TOOLS: string[];
+export declare const EVOLVER_BUDGET: {
+    maxIterations: number;
+    searchBudget: number;
+    searchBudgetGrace: number;
+    maxSubmits: number;
+    softSubmitLimit: number;
+    idleRoundsToExit: number;
+};
+/**
+ * 构建 Evolution Agent 的用户 Prompt
+ *
+ * 按维度打包全部现有 Recipe 清单 + 可选 audit hint + 项目概览，
+ * 让 Agent 通过提案机制对每个 Recipe 做出进化/废弃/跳过决策。
+ */
+export declare function buildEvolverPrompt(_phaseInput: unknown, _phaseResults: unknown, strategyContext: EvolutionContext): string;

package/dist/lib/agent/domain/insight-evolver.js

@@ -0,0 +1,230 @@
+/**
+ * insight-evolver.ts — Evolution Agent 领域函数
+ *
+ * Evolution Agent 是管线中的专职进化角色：
+ *   - 接收当前维度的**全部**现有 Recipe（不仅是衰退的）
+ *   - 使用工具读取真实代码，验证每个 Recipe 的真实性
+ *   - 通过**附加提案**（Proposal）驱动状态变更，不创建新 Recipe
+ *   - 三种决策: propose_evolution / confirm_deprecation / skip_evolution
+ *
+ * 被 PipelineStrategy 的 evolution preset 引用。
+ * 按维度隔离：每个维度的 Evolve Stage 只处理属于该维度的 Recipe。
+ *
+ * @module insight-evolver
+ */
+// ──────────────────────────────────────────────────────────────────
+// System Prompt
+// ──────────────────────────────────────────────────────────────────
+export const EVOLVER_SYSTEM_PROMPT = `你是 AutoSnippet 的 **Evolution Agent**，专职验证项目中现有知识条目（Recipe）的真实性与时效性。
+
+## 核心职责
+
+你通过阅读项目真实代码来验证每条 Recipe 是否仍然反映当前项目实践。
+你的工作结果以**提案（Proposal）**方式附加到现有 Recipe 上，推动知识库的渐进式演化。
+你**不创建新 Recipe**——那是后续 Produce 阶段的职责。
+
+## 验证流程
+
+对每个 Recipe 按以下步骤验证:
+1. 阅读 Recipe 的核心代码片段和源文件引用，理解其描述的模式
+2. 使用 \`read_project_file\` 读取源文件，验证代码是否存在且与 Recipe 描述匹配
+3. 如果源文件不存在或代码不匹配，使用 \`search_project_code\` 搜索该模式是否已迁移到其他位置
+4. 基于真实代码的验证结果做出决策
+
+## 决策规则
+
+按以下决策树判断（优先级从上到下）:
+
+| 验证结果 | 决策 | 工具 |
+|---------|------|------|
+| 源文件存在 + 代码匹配 Recipe 描述 | **跳过**: 仍然有效 | \`skip_evolution\` |
+| 源文件存在 + 代码已变化（接口改变/重构） | **进化提案**: 附加变更证据 | \`propose_evolution\` |
+| 源文件不存在 + 模式已迁移到新位置 | **进化提案**: 附加迁移证据 | \`propose_evolution\` |
+| 源文件不存在 + 完全无替代 | **确认废弃**: 知识已失效 | \`confirm_deprecation\` |
+| 信息不足以做出判断 | **跳过**: 交给时限机制 | \`skip_evolution\` |
+
+## 工具说明
+
+- \`propose_evolution\` — 为 Recipe 附加进化提案，包含代码验证证据和建议变更。提案进入观察窗口（enhance: 48h, correction: 24h），不直接修改 Recipe
+- \`confirm_deprecation\` — 确认 Recipe 已过时，立即标记为 deprecated（跳过观察窗口）
+- \`skip_evolution\` — 显式跳过，reason 中说明是"验证有效"还是"信息不足"
+
+## 重要约束
+
+- 每个 Recipe 必须有一个明确决策，不要遗漏任何一个
+- \`propose_evolution\` 的 evidence 字段必须包含你读到的真实代码，不要编造
+- \`propose_evolution\` 的 type 区分: enhance（模式迁移/功能扩展）vs correction（描述错误/接口变更）
+- 部分 Recipe 附带系统预检提示（auditHint），仅供参考——你必须以实际读到的代码为准
+- 即使预检提示说"healthy"，你读代码后发现不匹配也要提交提案`;
+// ──────────────────────────────────────────────────────────────────
+// 工具白名单
+// ──────────────────────────────────────────────────────────────────
+export const EVOLVER_TOOLS = [
+    'read_project_file',
+    'search_project_code',
+    'propose_evolution',
+    'confirm_deprecation',
+    'skip_evolution',
+];
+// ──────────────────────────────────────────────────────────────────
+// 预算
+// ──────────────────────────────────────────────────────────────────
+export const EVOLVER_BUDGET = {
+    maxIterations: 20,
+    searchBudget: 10,
+    searchBudgetGrace: 4,
+    maxSubmits: 8,
+    softSubmitLimit: 8,
+    idleRoundsToExit: 2,
+};
+// ──────────────────────────────────────────────────────────────────
+// Prompt 构建
+// ──────────────────────────────────────────────────────────────────
+/**
+ * 构建 Evolution Agent 的用户 Prompt
+ *
+ * 按维度打包全部现有 Recipe 清单 + 可选 audit hint + 项目概览，
+ * 让 Agent 通过提案机制对每个 Recipe 做出进化/废弃/跳过决策。
+ */
+export function buildEvolverPrompt(_phaseInput, _phaseResults, strategyContext) {
+    const { existingRecipes, dimensionId, dimensionLabel, projectOverview } = strategyContext;
+    const parts = [];
+    // §1 任务概述
+    parts.push(`# 验证任务: ${dimensionLabel} [${dimensionId}]`);
+    parts.push(`你需要验证 **${existingRecipes.length}** 个现有 Recipe 的真实性。`);
+    parts.push(`项目概况: ${projectOverview.primaryLang} 语言，${projectOverview.fileCount} 个文件。`);
+    if (projectOverview.modules.length > 0) {
+        parts.push(`主要模块: ${projectOverview.modules.slice(0, 10).join(', ')}`);
+    }
+    // §2 现有 Recipe 清单
+    parts.push('# 现有 Recipe 清单');
+    parts.push('以下是需要你验证的全部 Recipe。对每一个，你需要读取源文件、验证代码、然后做出决策。');
+    for (let i = 0; i < existingRecipes.length; i++) {
+        const recipe = existingRecipes[i];
+        const lines = [];
+        lines.push(`## [${i + 1}/${existingRecipes.length}] ${recipe.title}`);
+        lines.push(`- **ID**: \`${recipe.id}\``);
+        lines.push(`- **Trigger**: \`${recipe.trigger}\``);
+        // 源文件引用 — 验证的起点
+        if (recipe.sourceRefs && recipe.sourceRefs.length > 0) {
+            lines.push(`- **源文件引用** (请用 \`read_project_file\` 读取验证):`);
+            for (const ref of recipe.sourceRefs.slice(0, 5)) {
+                lines.push(`  - \`${ref}\``);
+            }
+            if (recipe.sourceRefs.length > 5) {
+                lines.push(`  - ... 及其他 ${recipe.sourceRefs.length - 5} 个文件`);
+            }
+        }
+        else {
+            lines.push('- **源文件引用**: 无（需要用 `search_project_code` 搜索相关代码）');
+        }
+        // Recipe 声称的核心代码（缩略）
+        if (recipe.content?.coreCode) {
+            const truncated = recipe.content.coreCode.length > 400
+                ? `${recipe.content.coreCode.slice(0, 400)}...`
+                : recipe.content.coreCode;
+            lines.push(`- **Recipe 声称的核心代码** (需验证是否与实际一致):`);
+            lines.push(`\`\`\`\n${truncated}\n\`\`\``);
+        }
+        // Recipe 的设计原理
+        if (recipe.content?.rationale) {
+            const rationale = recipe.content.rationale.length > 200
+                ? `${recipe.content.rationale.slice(0, 200)}...`
+                : recipe.content.rationale;
+            lines.push(`- **设计原理**: ${rationale}`);
+        }
+        // 静态审计 hint（可选）
+        if (recipe.auditHint) {
+            lines.push('- **系统预检提示** ⚠️ 仅供参考，以你读到的代码为准:');
+            lines.push(`  - 评分: ${recipe.auditHint.relevanceScore}/100 → ${recipe.auditHint.verdict}`);
+            const ev = recipe.auditHint.evidence;
+            const checks = [
+                `Trigger: ${ev.triggerStillMatches ? '✅' : '❌'}`,
+                `符号: ${(ev.symbolsAlive * 100).toFixed(0)}%`,
+                `依赖: ${ev.depsIntact ? '✅' : '❌'}`,
+                `代码文件: ${(ev.codeFilesExist * 100).toFixed(0)}%`,
+            ];
+            lines.push(`  - ${checks.join(' | ')}`);
+            if (recipe.auditHint.decayReasons.length > 0) {
+                lines.push(`  - 预检原因: ${recipe.auditHint.decayReasons.join('; ')}`);
+            }
+        }
+        parts.push(lines.join('\n'));
+    }
+    // §3 验证工作流
+    parts.push('# 验证工作流');
+    parts.push('对每个 Recipe 按以下步骤执行:');
+    parts.push('');
+    parts.push('**步骤 1 — 读取源文件**');
+    parts.push('- 使用 `read_project_file` 读取 sourceRefs 中列出的文件');
+    parts.push('- 如果没有 sourceRefs，跳到步骤 2');
+    parts.push('');
+    parts.push('**步骤 2 — 搜索验证**（仅在源文件缺失或代码不匹配时）');
+    parts.push('- 使用 `search_project_code` 搜索 Recipe 中的类名、函数名、关键模式');
+    parts.push('- 确认该模式是否迁移到了新位置或已被完全移除');
+    parts.push('');
+    parts.push('**步骤 3 — 做出决策**');
+    parts.push('- 基于步骤 1-2 的验证结果，调用对应的决策工具');
+    // §4 决策指令
+    parts.push('# 决策指令');
+    parts.push('对上述每个 Recipe 做出以下三种决策之一:');
+    parts.push('');
+    parts.push('### 1. 🔄 附加进化提案 — 代码已变但知识仍有价值');
+    parts.push('调用 `propose_evolution`:');
+    parts.push('```json');
+    parts.push('{');
+    parts.push('  "recipeId": "recipe-xxx",');
+    parts.push('  "type": "enhance",        // enhance=模式迁移/功能扩展, correction=描述错误/接口变更');
+    parts.push('  "description": "说明发生了什么变化",');
+    parts.push('  "evidence": {');
+    parts.push('    "sourceStatus": "modified", // exists|moved|modified|deleted');
+    parts.push('    "currentCode": "你读到的实际代码片段",');
+    parts.push('    "newLocation": "新路径（仅 moved 时）",');
+    parts.push('    "suggestedChanges": "{结构化 JSON — 见下方格式}"');
+    parts.push('  },');
+    parts.push('  "confidence": 0.85');
+    parts.push('}');
+    parts.push('```');
+    parts.push('');
+    parts.push('#### suggestedChanges 格式（重要！）');
+    parts.push('suggestedChanges 必须是一个 JSON 字符串，格式如下:');
+    parts.push('```json');
+    parts.push('{');
+    parts.push('  "patchVersion": 1,');
+    parts.push('  "changes": [');
+    parts.push('    {');
+    parts.push('      "field": "coreCode",');
+    parts.push('      "action": "replace",');
+    parts.push('      "newValue": "更新后的代码片段"');
+    parts.push('    },');
+    parts.push('    {');
+    parts.push('      "field": "content.markdown",');
+    parts.push('      "action": "replace-section",');
+    parts.push('      "section": "### 使用指南",');
+    parts.push('      "newContent": "### 使用指南\\n更新后的内容"');
+    parts.push('    }');
+    parts.push('  ],');
+    parts.push('  "reasoning": "源代码变更原因说明"');
+    parts.push('}');
+    parts.push('```');
+    parts.push('');
+    parts.push('可修改的字段: `coreCode`, `doClause`, `dontClause`, `whenClause`, `content.markdown`, `content.rationale`, `sourceRefs`, `headers`');
+    parts.push('操作类型: `replace`=全量替换, `replace-section`=替换 Markdown section, `append`=追加');
+    parts.push('');
+    parts.push('### 2. ⛔ 确认废弃 — 知识确实过时，无法挽救');
+    parts.push('调用 `confirm_deprecation`:');
+    parts.push('```json');
+    parts.push('{ "recipeId": "recipe-xxx", "reason": "具体废弃原因" }');
+    parts.push('```');
+    parts.push('');
+    parts.push('### 3. ⏭️ 跳过 — 仍然有效 或 信息不足');
+    parts.push('调用 `skip_evolution`:');
+    parts.push('```json');
+    parts.push('{ "recipeId": "recipe-xxx", "reason": "验证有效: 代码与描述完全匹配" }');
+    parts.push('```');
+    parts.push('或:');
+    parts.push('```json');
+    parts.push('{ "recipeId": "recipe-xxx", "reason": "信息不足: 无法确认源文件位置" }');
+    parts.push('```');
+    return parts.join('\n\n');
+}

package/dist/lib/agent/domain/insight-gate.d.ts

@@ -190,4 +190,46 @@ export declare function insightGateEvaluator(source: unknown, phaseResults: Reco
         };
     };
 };
+/** Tool call record for evolution gate */
+interface EvolutionToolCallRecord {
+    tool?: string;
+    name?: string;
+    args?: Record<string, unknown>;
+    result?: unknown;
+}
+/**
+ * Evolution Gate 评估器 — 面向 PipelineStrategy gate.evaluator
+ *
+ * 检查 Evolution Agent 是否对所有现有 Recipe 做出了决策:
+ * - evolved (submit_knowledge with supersedes)
+ * - deprecated (confirm_deprecation)
+ * - skipped (skip_evolution)
+ *
+ * 如果还有未处理的 Recipe，返回 retry 要求补充决策。
+ *
+ * 兼容旧字段: 优先读 existingRecipes，回退 decayedRecipes。
+ */
+export declare function evolutionGateEvaluator(source: {
+    toolCalls?: EvolutionToolCallRecord[];
+} | null | undefined, _phaseResults: unknown, strategyContext?: {
+    existingRecipes?: Array<{
+        id: string;
+    }>;
+    decayedRecipes?: Array<{
+        id: string;
+    }>;
+}): {
+    action: string;
+    reason: string;
+    artifact?: undefined;
+} | {
+    action: string;
+    artifact: {
+        evolved: number;
+        deprecated: number;
+        skipped: number;
+        totalRecipes: number;
+    };
+    reason?: undefined;
+};
 export {};

package/dist/lib/agent/domain/insight-gate.js

@@ -382,6 +382,47 @@ export function insightGateEvaluator(source, phaseResults, strategyContext = {})
         artifact,
     };
 }
+/**
+ * Evolution Gate 评估器 — 面向 PipelineStrategy gate.evaluator
+ *
+ * 检查 Evolution Agent 是否对所有现有 Recipe 做出了决策:
+ * - evolved (submit_knowledge with supersedes)
+ * - deprecated (confirm_deprecation)
+ * - skipped (skip_evolution)
+ *
+ * 如果还有未处理的 Recipe，返回 retry 要求补充决策。
+ *
+ * 兼容旧字段: 优先读 existingRecipes，回退 decayedRecipes。
+ */
+export function evolutionGateEvaluator(source, _phaseResults, strategyContext = {}) {
+    const totalRecipes = (strategyContext.existingRecipes ?? strategyContext.decayedRecipes ?? [])
+        .length;
+    const toolCalls = source?.toolCalls || [];
+    // 统计各决策数
+    const evolved = toolCalls.filter((tc) => {
+        const tool = tc.tool || tc.name;
+        return tool === 'submit_knowledge' && tc.args?.supersedes;
+    }).length;
+    const deprecated = toolCalls.filter((tc) => {
+        const tool = tc.tool || tc.name;
+        return tool === 'confirm_deprecation';
+    }).length;
+    const skipped = toolCalls.filter((tc) => {
+        const tool = tc.tool || tc.name;
+        return tool === 'skip_evolution';
+    }).length;
+    const processed = evolved + deprecated + skipped;
+    if (totalRecipes > 0 && processed < totalRecipes) {
+        return {
+            action: 'retry',
+            reason: `只处理了 ${processed}/${totalRecipes} 个 Recipe，还有 ${totalRecipes - processed} 个未决策`,
+        };
+    }
+    return {
+        action: 'pass',
+        artifact: { evolved, deprecated, skipped, totalRecipes },
+    };
+}
 // ──────────────────────────────────────────────────────────────────
 // 类型定义 (JSDoc)
 // ──────────────────────────────────────────────────────────────────

package/dist/lib/agent/domain/insight-producer.d.ts

@@ -62,7 +62,7 @@ interface GateStrategyContext {
     submitToolNames?: string[];
     [key: string]: unknown;
 }
-export declare const PRODUCER_SYSTEM_PROMPT = "\u4F60\u662F\u77E5\u8BC6\u7BA1\u7406\u4E13\u5BB6\u3002\u4F60\u4F1A\u6536\u5230\u4E00\u6BB5\u4EE3\u7801\u5206\u6790\u6587\u672C\uFF0C\u9700\u8981\u5C06\u5176\u4E2D\u7684\u77E5\u8BC6\u70B9\u8F6C\u5316\u4E3A\u7ED3\u6784\u5316\u7684\u77E5\u8BC6\u5019\u9009\u3002\n\n\u6838\u5FC3\u539F\u5219: \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u4E86\u6240\u6709\u53D1\u73B0\uFF0C\u4F60\u7684\u552F\u4E00\u5DE5\u4F5C\u662F\u5C06\u5B83\u4EEC\u683C\u5F0F\u5316\u4E3A submit_knowledge \u8C03\u7528\u3002\n\n\u6BCF\u4E2A\u5019\u9009\u5FC5\u987B:\n1. \u6709\u6E05\u6670\u7684\u6807\u9898 (\u63CF\u8FF0\u77E5\u8BC6\u70B9\u7684\u6838\u5FC3\uFF0C\u4F7F\u7528\u9879\u76EE\u771F\u5B9E\u7C7B\u540D)\n2. \u6709\u9879\u76EE\u7279\u5199\u98CE\u683C\u7684\u6B63\u6587 (content.markdown \u5B57\u6BB5\uFF0C\u7ED3\u5408\u4EE3\u7801\u5C55\u793A)\n3. \u6807\u6CE8\u76F8\u5173\u6587\u4EF6\u8DEF\u5F84\n4. \u9009\u62E9\u6B63\u786E\u7684 kind (rule/pattern/fact)\n5. \u63D0\u4F9B\u5B8C\u6574\u7684 Cursor \u4EA4\u4ED8\u5B57\u6BB5 (trigger, doClause, whenClause \u7B49)\n\n\u5DE5\u4F5C\u6D41\u7A0B:\n1. \u9605\u8BFB\u5206\u6790\u6587\u672C\uFF0C\u8BC6\u522B\u6BCF\u4E2A\u72EC\u7ACB\u7684\u77E5\u8BC6\u70B9/\u53D1\u73B0\n2. \u7528 read_project_file \u6279\u91CF\u83B7\u53D6\u5173\u952E\u4EE3\u7801\u7247\u6BB5:\n   read_project_file({ filePaths: [\"FileA.m\", \"FileB.m\"], maxLines: 80 })\n3. \u7ACB\u523B\u8C03\u7528 submit_knowledge \u63D0\u4EA4\n4. \u91CD\u590D\u76F4\u5230\u5206\u6790\u4E2D\u7684\u6240\u6709\u77E5\u8BC6\u70B9\u90FD\u5DF2\u63D0\u4EA4\n\n\u5173\u952E\u89C4\u5219:\n- \u5206\u6790\u4E2D\u7684\u6BCF\u4E2A\u8981\u70B9/\u6BB5\u843D\u90FD\u5E94\u8F6C\u5316\u4E3A\u81F3\u5C11\u4E00\u4E2A\u5019\u9009\n- read_project_file \u652F\u6301 filePaths \u6570\u7EC4\u6279\u91CF\u8BFB\u53D6\u591A\u4E2A\u6587\u4EF6\uFF0C\u4E00\u6B21\u8C03\u7528\u5B8C\u6210\n- read_project_file \u65F6\u8BFB\u53D6\u8DB3\u591F\u591A\u7684\u884C\u6570\uFF08startLine + maxLines \u81F3\u5C11 30 \u884C\uFF09\n- reasoning.sources \u5FC5\u987B\u662F\u975E\u7A7A\u6570\u7EC4\uFF0C\u586B\u5199\u76F8\u5173\u6587\u4EF6\u8DEF\u5F84\u5982 [\"FileName.m\"]\n- \u5982\u679C\u5206\u6790\u63D0\u5230\u4E86 3 \u4E2A\u6A21\u5F0F\uFF0C\u5C31\u5E94\u8BE5\u63D0\u4EA4 3 \u4E2A\u5019\u9009\uFF0C\u4E0D\u8981\u5408\u5E76\n- \u7981\u6B62: \u4E0D\u8981\u641C\u7D22\u65B0\u6587\u4EF6\u3001\u4E0D\u8981\u505A\u989D\u5916\u5206\u6790\uFF0C\u4E13\u6CE8\u4E8E\u683C\u5F0F\u5316\u548C\u63D0\u4EA4\n\n\u5BB9\u9519\u89C4\u5219:\n- \u5982\u679C read_project_file \u8FD4\u56DE\"\u6587\u4EF6\u4E0D\u5B58\u5728\"\u6216\u9519\u8BEF\uFF0C\u4E0D\u8981\u91CD\u8BD5\u540C\u4E00\u6587\u4EF6\u7684\u5176\u4ED6\u8DEF\u5F84\u53D8\u4F53\n- \u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u65F6\uFF0C\u76F4\u63A5\u4F7F\u7528\u5206\u6790\u6587\u672C\u4E2D\u5DF2\u6709\u7684\u4EE3\u7801\u548C\u63CF\u8FF0\u6765\u63D0\u4EA4\u5019\u9009\n- \u6C38\u8FDC\u4E0D\u8981\u56E0\u4E3A\u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u800C\u8DF3\u8FC7\u77E5\u8BC6\u70B9 \u2014 \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u8DB3\u591F\u4FE1\u606F\n- \u5148\u63D0\u4EA4\u5019\u9009\uFF0C\u518D\u8003\u8651\u662F\u5426\u9700\u8981\u8BFB\u53D6\u66F4\u591A\u4EE3\u7801\uFF08\u63D0\u4EA4\u4F18\u5148\u4E8E\u9A8C\u8BC1\uFF09";
+export declare const PRODUCER_SYSTEM_PROMPT = "\u4F60\u662F\u77E5\u8BC6\u7BA1\u7406\u4E13\u5BB6\u3002\u4F60\u4F1A\u6536\u5230\u4E00\u6BB5\u4EE3\u7801\u5206\u6790\u6587\u672C\uFF0C\u9700\u8981\u5C06\u5176\u4E2D\u7684\u77E5\u8BC6\u70B9\u8F6C\u5316\u4E3A\u7ED3\u6784\u5316\u7684\u77E5\u8BC6\u5019\u9009\u3002\n\n\u6838\u5FC3\u539F\u5219: \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u4E86\u6240\u6709\u53D1\u73B0\uFF0C\u4F60\u7684\u552F\u4E00\u5DE5\u4F5C\u662F\u5C06\u5B83\u4EEC\u683C\u5F0F\u5316\u4E3A submit_knowledge \u8C03\u7528\u3002\n\n\u6BCF\u4E2A\u5019\u9009\u5FC5\u987B:\n1. \u6709\u6E05\u6670\u7684\u6807\u9898 (\u63CF\u8FF0\u77E5\u8BC6\u70B9\u7684\u6838\u5FC3\uFF0C\u4F7F\u7528\u9879\u76EE\u771F\u5B9E\u7C7B\u540D\uFF0C\u4E0D\u4EE5\u9879\u76EE\u540D\u5F00\u5934)\n2. \u6709\u9879\u76EE\u7279\u5199\u98CE\u683C\u7684\u6B63\u6587 (content.markdown \u5B57\u6BB5\uFF0C\u7ED3\u5408\u4EE3\u7801\u5C55\u793A)\n3. \u6807\u6CE8\u76F8\u5173\u6587\u4EF6\u7684\u5B8C\u6574\u76F8\u5BF9\u8DEF\u5F84 + \u884C\u53F7\uFF08\u4ECE\u9879\u76EE\u6839\u76EE\u5F55\u5F00\u59CB\uFF0C\u5982 Packages/AOXNetworkKit/Sources/.../NetworkClient.swift:42\uFF09\n4. \u9009\u62E9\u6B63\u786E\u7684 kind (rule/pattern/fact)\n5. \u63D0\u4F9B\u5B8C\u6574\u7684 Cursor \u4EA4\u4ED8\u5B57\u6BB5 (trigger, doClause, whenClause \u7B49)\n6. \u6807\u6CE8\u6240\u5C5E\u6A21\u5757/\u5305\u540D\uFF08\u5982\u300C\u6240\u5C5E\u6A21\u5757: AOXNetworkKit\u300D\uFF09\uFF0C\u7279\u522B\u662F\u6765\u81EA\u672C\u5730\u5B50\u5305\u7684\u77E5\u8BC6\n\n\u5DE5\u4F5C\u6D41\u7A0B:\n1. \u9605\u8BFB\u5206\u6790\u6587\u672C\uFF0C\u8BC6\u522B\u6BCF\u4E2A\u72EC\u7ACB\u7684\u77E5\u8BC6\u70B9/\u53D1\u73B0\n2. \u7528 read_project_file \u6279\u91CF\u83B7\u53D6\u5173\u952E\u4EE3\u7801\u7247\u6BB5:\n   read_project_file({ filePaths: [\"Full/Path/To/FileA.swift\", \"Full/Path/To/FileB.swift\"], maxLines: 80 })\n3. \u7ACB\u523B\u8C03\u7528 submit_knowledge \u63D0\u4EA4\n4. \u91CD\u590D\u76F4\u5230\u5206\u6790\u4E2D\u7684\u6240\u6709\u77E5\u8BC6\u70B9\u90FD\u5DF2\u63D0\u4EA4\n\n\u5173\u952E\u89C4\u5219:\n- \u5206\u6790\u4E2D\u7684\u6BCF\u4E2A\u8981\u70B9/\u6BB5\u843D\u90FD\u5E94\u8F6C\u5316\u4E3A\u81F3\u5C11\u4E00\u4E2A\u5019\u9009\n- read_project_file \u652F\u6301 filePaths \u6570\u7EC4\u6279\u91CF\u8BFB\u53D6\u591A\u4E2A\u6587\u4EF6\uFF0C\u4E00\u6B21\u8C03\u7528\u5B8C\u6210\n- read_project_file \u65F6\u8BFB\u53D6\u8DB3\u591F\u591A\u7684\u884C\u6570\uFF08startLine + maxLines \u81F3\u5C11 30 \u884C\uFF09\n- reasoning.sources \u5FC5\u987B\u662F\u975E\u7A7A\u6570\u7EC4\uFF0C\u586B\u5199\u6587\u4EF6\u7684\u5B8C\u6574\u76F8\u5BF9\u8DEF\u5F84\u5982 [\"Packages/AOXNetworkKit/Sources/AOXNetworkKit/Client/NetworkClient.swift\"]\uFF08\u7981\u6B62\u53EA\u5199\u6587\u4EF6\u540D\uFF09\n- content.markdown \u4E2D\u7684\u6765\u6E90\u6807\u6CE8\u5FC5\u987B\u4F7F\u7528\u5B8C\u6574\u76F8\u5BF9\u8DEF\u5F84+\u884C\u53F7: (\u6765\u6E90: Full/Path/FileName.ext:\u884C\u53F7)\n- \u5982\u679C\u5206\u6790\u63D0\u5230\u4E86 3 \u4E2A\u6A21\u5F0F\uFF0C\u5C31\u5E94\u8BE5\u63D0\u4EA4 3 \u4E2A\u5019\u9009\uFF0C\u4E0D\u8981\u5408\u5E76\n- \u7981\u6B62: \u4E0D\u8981\u641C\u7D22\u65B0\u6587\u4EF6\u3001\u4E0D\u8981\u505A\u989D\u5916\u5206\u6790\uFF0C\u4E13\u6CE8\u4E8E\u683C\u5F0F\u5316\u548C\u63D0\u4EA4\n- \u3010\u8DE8\u7EF4\u5EA6\u53BB\u91CD\u3011\u6BCF\u6761\u5019\u9009\u5FC5\u987B\u805A\u7126\u5F53\u524D\u7EF4\u5EA6\u72EC\u6709\u7684\u89C6\u89D2\uFF0C\u4E0D\u5F97\u5C06\u540C\u4E00\u77E5\u8BC6\u70B9\u6362\u4E2A\u8BF4\u6CD5\u91CD\u590D\u63D0\u4EA4\u3002\u76F8\u540C\u7684\u7C7B/\u6A21\u5F0F\u53EA\u5728\u6700\u76F8\u5173\u7684\u7EF4\u5EA6\u51FA\u73B0\u4E00\u6B21\uFF0C\u5B81\u53EF\u5C11\u63D0\u4EA4\u4E5F\u4E0D\u8981\u5145\u6570\n\n\u5BB9\u9519\u89C4\u5219:\n- \u5982\u679C read_project_file \u8FD4\u56DE\"\u6587\u4EF6\u4E0D\u5B58\u5728\"\u6216\u9519\u8BEF\uFF0C\u4E0D\u8981\u91CD\u8BD5\u540C\u4E00\u6587\u4EF6\u7684\u5176\u4ED6\u8DEF\u5F84\u53D8\u4F53\n- \u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u65F6\uFF0C\u76F4\u63A5\u4F7F\u7528\u5206\u6790\u6587\u672C\u4E2D\u5DF2\u6709\u7684\u4EE3\u7801\u548C\u63CF\u8FF0\u6765\u63D0\u4EA4\u5019\u9009\n- \u6C38\u8FDC\u4E0D\u8981\u56E0\u4E3A\u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u800C\u8DF3\u8FC7\u77E5\u8BC6\u70B9 \u2014 \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u8DB3\u591F\u4FE1\u606F\n- \u5148\u63D0\u4EA4\u5019\u9009\uFF0C\u518D\u8003\u8651\u662F\u5426\u9700\u8981\u8BFB\u53D6\u66F4\u591A\u4EE3\u7801\uFF08\u63D0\u4EA4\u4F18\u5148\u4E8E\u9A8C\u8BC1\uFF09";
 export declare const PRODUCER_TOOLS: string[];
 export declare const PRODUCER_BUDGET: {
     maxIterations: number;
@@ -79,6 +79,29 @@ export declare const PRODUCER_BUDGET: {
  * @param projectInfo { name }
  */
 export declare function buildProducerPrompt(analysisReport: AnalysisReportLike, dimConfig: DimConfig, projectInfo: ProjectInfo): string;
+/** Panorama context for Producer */
+interface ProducerPanoramaContext {
+    moduleRole: string | null;
+    moduleLayer: number | null;
+    knownGaps: string[];
+    layerContext: string | null;
+}
+/** Rescan context for Producer — gap info + existing recipe titles */
+interface ProducerRescanContext {
+    existingRecipes: Array<{
+        title: string;
+        trigger: string;
+    }>;
+    decayingRecipes?: Array<{
+        id?: string;
+        title: string;
+        trigger: string;
+        decayReason?: string;
+    }>;
+    occupiedTriggers: string[];
+    gap: number;
+    existing: number;
+}
 /**
  * 构建 Producer Prompt v2 — 用于 AnalysisArtifact
  *
@@ -86,8 +109,10 @@ export declare function buildProducerPrompt(analysisReport: AnalysisReportLike,
  * - §3 结构化发现 (findings)
  * - §4 代码证据 (evidenceMap → code context)
  * - §5 负空间信号
+ * - §9 (可选) Rescan 模式约束
+ * - §M1 (可选) 全景上下文
  */
-export declare function buildProducerPromptV2(artifact: AnalysisArtifactLike, dimConfig: DimConfig, projectInfo: ProjectInfo): string;
+export declare function buildProducerPromptV2(artifact: AnalysisArtifactLike, dimConfig: DimConfig, projectInfo: ProjectInfo, rescanContext?: ProducerRescanContext | null, panorama?: ProducerPanoramaContext | null): string;
 /**
  * 从 evidenceMap 构建代码上下文段
  *

package/dist/lib/agent/domain/insight-producer.js

@@ -23,16 +23,17 @@ export const PRODUCER_SYSTEM_PROMPT = `你是知识管理专家。你会收到
 核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 submit_knowledge 调用。
 
 每个候选必须:
-1. 有清晰的标题 (描述知识点的核心，使用项目真实类名)
+1. 有清晰的标题 (描述知识点的核心，使用项目真实类名，不以项目名开头)
 2. 有项目特写风格的正文 (content.markdown 字段，结合代码展示)
-3. 标注相关文件路径
+3. 标注相关文件的完整相对路径 + 行号（从项目根目录开始，如 Packages/AOXNetworkKit/Sources/.../NetworkClient.swift:42）
 4. 选择正确的 kind (rule/pattern/fact)
 5. 提供完整的 Cursor 交付字段 (trigger, doClause, whenClause 等)
+6. 标注所属模块/包名（如「所属模块: AOXNetworkKit」），特别是来自本地子包的知识
 
 工作流程:
 1. 阅读分析文本，识别每个独立的知识点/发现
 2. 用 read_project_file 批量获取关键代码片段:
-   read_project_file({ filePaths: ["FileA.m", "FileB.m"], maxLines: 80 })
+   read_project_file({ filePaths: ["Full/Path/To/FileA.swift", "Full/Path/To/FileB.swift"], maxLines: 80 })
 3. 立刻调用 submit_knowledge 提交
 4. 重复直到分析中的所有知识点都已提交
 
@@ -40,9 +41,11 @@ export const PRODUCER_SYSTEM_PROMPT = `你是知识管理专家。你会收到
 - 分析中的每个要点/段落都应转化为至少一个候选
 - read_project_file 支持 filePaths 数组批量读取多个文件，一次调用完成
 - read_project_file 时读取足够多的行数（startLine + maxLines 至少 30 行）
-- reasoning.sources 必须是非空数组，填写相关文件路径如 ["FileName.m"]
+- reasoning.sources 必须是非空数组，填写文件的完整相对路径如 ["Packages/AOXNetworkKit/Sources/AOXNetworkKit/Client/NetworkClient.swift"]（禁止只写文件名）
+- content.markdown 中的来源标注必须使用完整相对路径+行号: (来源: Full/Path/FileName.ext:行号)
 - 如果分析提到了 3 个模式，就应该提交 3 个候选，不要合并
 - 禁止: 不要搜索新文件、不要做额外分析，专注于格式化和提交
+- 【跨维度去重】每条候选必须聚焦当前维度独有的视角，不得将同一知识点换个说法重复提交。相同的类/模式只在最相关的维度出现一次，宁可少提交也不要充数
 
 容错规则:
 - 如果 read_project_file 返回"文件不存在"或错误，不要重试同一文件的其他路径变体
@@ -99,8 +102,10 @@ export function buildProducerPrompt(analysisReport, dimConfig, projectInfo) {
  * - §3 结构化发现 (findings)
  * - §4 代码证据 (evidenceMap → code context)
  * - §5 负空间信号
+ * - §9 (可选) Rescan 模式约束
+ * - §M1 (可选) 全景上下文
  */
-export function buildProducerPromptV2(artifact, dimConfig, projectInfo) {
+export function buildProducerPromptV2(artifact, dimConfig, projectInfo, rescanContext, panorama) {
     const parts = [];
     parts.push(`将以下对 ${projectInfo.name} 项目 "${dimConfig.label}" 维度的分析，转化为知识候选:`);
     parts.push(`---\n${artifact.analysisText}\n---`);
@@ -144,6 +149,56 @@ export function buildProducerPromptV2(artifact, dimConfig, projectInfo) {
     // §8 写作指南 + 提交要求
     parts.push(STYLE_GUIDE);
     parts.push(SUBMIT_REQUIREMENTS);
+    // §M1 全景上下文 — 帮助 Producer 理解模块定位
+    if (panorama) {
+        const pLines = [];
+        if (panorama.moduleRole) {
+            pLines.push(`模块角色: ${panorama.moduleRole}${panorama.moduleLayer !== null ? ` (L${panorama.moduleLayer})` : ''}`);
+        }
+        if (panorama.layerContext) {
+            pLines.push(`架构层级: ${panorama.layerContext}`);
+        }
+        if (panorama.knownGaps.length > 0) {
+            pLines.push(`知识空白区: ${panorama.knownGaps.join(', ')} — 优先为这些方向创建候选。`);
+        }
+        if (pLines.length > 0) {
+            parts.push(`## 🏗️ 项目全景\n${pLines.join('\n')}`);
+        }
+    }
+    // §9a Rescan 模式约束 — 限制提交数量，避免重复
+    if (rescanContext && rescanContext.gap > 0) {
+        const lines = [
+            '## ⚠️ 增量扫描模式 — 补齐约束',
+            `本维度已有 ${rescanContext.existing} 个有效知识，需补齐 **${rescanContext.gap}** 个。`,
+            `**提交上限: ${rescanContext.gap} 个候选**。达到目标后立即停止，不要多提交。`,
+        ];
+        if (rescanContext.occupiedTriggers.length > 0) {
+            lines.push(`已占用的 trigger: ${rescanContext.occupiedTriggers.slice(0, 15).join(', ')}`);
+            lines.push('禁止使用上述已占用的 trigger，必须为新模式创建新 trigger。');
+        }
+        if (rescanContext.existingRecipes.length > 0) {
+            lines.push('已有知识标题 (禁止重复):');
+            for (const r of rescanContext.existingRecipes.slice(0, 8)) {
+                lines.push(`- "${r.title}"`);
+            }
+        }
+        parts.push(lines.join('\n'));
+    }
+    // §9b 衰退 Recipe — 可用 supersedes 替换
+    if (rescanContext?.decayingRecipes && rescanContext.decayingRecipes.length > 0) {
+        const dLines = [
+            '## 🔄 可替换的衰退知识',
+            '以下 Recipe 正在衰退，如果 Analyst 发现了更新版本的模式，',
+            '你可以用 `supersedes` 参数提交替代版本：',
+        ];
+        for (const r of rescanContext.decayingRecipes.slice(0, 5)) {
+            dLines.push(`- [${r.id || '?'}] "${r.title}" — ${r.decayReason || '衰退中'}`);
+            dLines.push(`  → 替换方式: submit_knowledge({ ...newRecipe, supersedes: "${r.id || ''}" })`);
+        }
+        dLines.push('注意: supersedes 提交会创建观察窗口（72h），不是立即替换。');
+        dLines.push('替换的新 Recipe 必须基于当前代码，不要复制旧 Recipe 内容。');
+        parts.push(dLines.join('\n'));
+    }
     return parts.join('\n\n');
 }
 // ──────────────────────────────────────────────────────────────────

package/dist/lib/agent/domain/scan-prompts.js

@@ -30,32 +30,35 @@ export const SCAN_TASK_CONFIGS = {
 核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 collect_scan_recipe 调用。
 
 每个候选必须:
-1. 有清晰的标题 (描述知识点的核心，使用项目真实类名)
+1. 有清晰的标题 (描述知识点的核心，使用项目真实类名，不以项目名开头)
 2. 有项目特写风格的正文 (content.markdown 字段，结合代码展示)
-3. 标注相关文件路径 (reasoning.sources)
+3. 标注相关文件的完整相对路径 + 行号 (reasoning.sources，如 ["Packages/ModuleName/Sources/.../FileName.swift"])
 4. 选择正确的 kind (rule/pattern/fact)
 5. 提供完整的 Cursor 交付字段 (trigger, doClause, whenClause 等)
+6. 标注所属模块/包名（特别是来自本地子包的知识）
 
 ## 「项目特写」写作要求（content.markdown）
 content.markdown 字段必须是「项目特写」：
 1. **项目选择了什么** — 采用了哪种写法/模式/约定
 2. **为什么这样选** — 统计分布、占比、历史决策
 3. **项目禁止什么** — 反模式、已废弃写法
-4. **新代码怎么写** — 可直接复制使用的代码模板 + 来源标注 (来源: FileName.ext:行号)
+4. **新代码怎么写** — 可直接复制使用的代码模板 + 来源标注 (来源: Full/Relative/Path/FileName.ext:行号)
 
 ## 工作流程
 1. 阅读分析文本，识别每个独立的知识点/发现
 2. 用 read_project_file 批量获取关键代码片段:
-   read_project_file({ filePaths: ["FileA.m", "FileB.m"], maxLines: 80 })
+   read_project_file({ filePaths: ["Full/Path/To/FileA.swift", "Full/Path/To/FileB.swift"], maxLines: 80 })
 3. 立刻调用 collect_scan_recipe 提交
 4. 重复直到分析中的所有知识点都已提交
 
 ## 关键规则
 - 分析中的每个要点/段落都应转化为至少一个候选
 - read_project_file 支持 filePaths 数组批量读取多个文件，一次调用完成
-- reasoning.sources 必须是非空数组，填写相关文件路径如 ["FileName.m"]
+- reasoning.sources 必须是非空数组，填写文件的完整相对路径（从项目根目录开始），禁止只写文件名
+- content.markdown 中的来源标注必须使用完整相对路径: (来源: Full/Path/FileName.ext:行号)
 - 如果分析提到了 3 个模式，就应该提交 3 个候选，不要合并
 - 禁止: 不要搜索新文件、不要做额外分析，专注于格式化和提交
+- 【跨维度去重】每条候选必须聚焦当前维度独有的视角，不得将同一知识点换个说法重复提交到不同维度。宁可少提交也不要充数
 
 容错规则:
 - 如果 read_project_file 返回"文件不存在"或错误，不要重试同一文件的其他路径变体
@@ -71,7 +74,7 @@ content.markdown 字段必须是「项目特写」：
 核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 collect_scan_recipe 调用。
 
 这是单文件/代码片段的深度分析，提交一个（或少量）高质量的知识候选：
-1. 清晰的标题（描述代码的核心功能，使用项目真实类名）
+1. 清晰的标题（描述代码的核心功能，使用项目真实类名，不以项目名开头）
 2. 完整的技术文档正文（content.markdown 字段，≥200 字符）
 3. 实用的使用指南（usageGuide 字段，含示例）
 4. 准确的分类（category）和标签（tags）
@@ -206,7 +209,7 @@ export function buildScanPipelineStages({ task, producePrompt, analyzeCaps, prod
 2. content.markdown 字段 ≥ 200 字符，含代码块 (\`\`\`)
 3. content.rationale 必填 — 设计原理说明
 4. reasoning.sources 必须是非空数组
-5. 标题使用项目真实类名
+5. 标题使用项目真实类名，不以项目名开头
 6. 必填: trigger (@kebab-case)、kind (rule/pattern/fact)、doClause (英文祈使句)`;
                 },
                 skipOnDegrade: true,