autosnippet 3.3.5 → 3.3.7

package/dist/lib/agent/AgentFactory.d.ts

@@ -64,14 +64,6 @@ interface ScanKnowledgeOptions {
     lang?: string;
     comprehensive?: boolean;
 }
-/** Options for bootstrapKnowledge */
-interface BootstrapKnowledgeOptions {
-    maxFiles?: number;
-    skipGuard?: boolean;
-    contentMaxLines?: number;
-    loadSkills?: boolean;
-    skipAsyncFill?: boolean;
-}
 export declare class AgentFactory {
     #private;
     /**
@@ -204,15 +196,6 @@ export declare class AgentFactory {
      * @returns >}
      */
     translateToEnglish(summary: string, usageGuide?: string): Promise<any>;
-    /**
-     * 冷启动知识库 — 直接调用 handler（纯启发式，不需要 LLM）
-     *
-     * bootstrap_knowledge 是纯启发式工具：SPM Target 扫描 → 依赖图谱 → Guard 审计 →
-     * Candidate 创建，全程无 AI 推理。直接调用 handler 即可，无需创建 Agent。
-     *
-     * @param [opts]
-     */
-    bootstrapKnowledge(opts?: BootstrapKnowledgeOptions): Promise<any>;
     /**
      * 通用工具执行 — 直接调用工具 handler
      *

package/dist/lib/agent/AgentFactory.js

@@ -247,7 +247,7 @@ export class AgentFactory {
                     maxIterations: 30, // 24 stage budget + 6 tracker grace
                     maxTokens: 8192,
                     temperature: 0.3,
-                    timeoutMs: 600_000,
+                    timeoutMs: 3_600_000,
                 }),
             ],
             memory: { enabled: false },
@@ -370,30 +370,6 @@ export class AgentFactory {
             usageGuideEn: usageGuide || '',
         });
     }
-    /**
-     * 冷启动知识库 — 直接调用 handler（纯启发式，不需要 LLM）
-     *
-     * bootstrap_knowledge 是纯启发式工具：SPM Target 扫描 → 依赖图谱 → Guard 审计 →
-     * Candidate 创建，全程无 AI 推理。直接调用 handler 即可，无需创建 Agent。
-     *
-     * @param [opts]
-     */
-    async bootstrapKnowledge(opts = {}) {
-        const { bootstrapKnowledge } = await import('#external/mcp/handlers/bootstrap-internal.js');
-        const result = await bootstrapKnowledge({
-            container: this
-                .#container,
-            logger: this.#logger,
-        }, {
-            maxFiles: opts.maxFiles || 500,
-            skipGuard: opts.skipGuard || false,
-            contentMaxLines: opts.contentMaxLines || 120,
-            loadSkills: opts.loadSkills ?? true,
-            skipAsyncFill: opts.skipAsyncFill || false,
-        });
-        const parsed = typeof result === 'string' ? JSON.parse(result) : result;
-        return parsed?.data || parsed;
-    }
     /**
      * 通用工具执行 — 直接调用工具 handler
      *

package/dist/lib/agent/AgentRuntime.d.ts

@@ -29,7 +29,7 @@
  */
 import { AgentEventBus } from './AgentEventBus.js';
 import type { AgentMessage } from './AgentMessage.js';
-import { type AgentResult, type FileCacheEntry, type ProgressEvent, type ReactLoopOpts, type RuntimeConfig, type ToolCallEntry, type ToolCallHook } from './AgentRuntimeTypes.js';
+import { type AgentResult, type FileCacheEntry, type ReactLoopOpts, type RuntimeConfig, type ToolCallEntry, type ToolCallHook } from './AgentRuntimeTypes.js';
 import { AgentState } from './AgentState.js';
 import { Capability } from './capabilities.js';
 import { PolicyEngine } from './policies.js';
@@ -50,7 +50,7 @@ export declare class AgentRuntime {
     policies: PolicyEngine;
     persona: Record<string, unknown>;
     memoryConfig: Record<string, unknown>;
-    onProgress: ((event: ProgressEvent) => void) | null;
+    onProgress: ((event: import("./AgentRuntimeTypes.js").ProgressEvent) => void) | null;
     lang: string | null;
     logger: import("winston").Logger;
     iterationCount: number;

package/dist/lib/agent/AgentRuntime.js

@@ -739,25 +739,33 @@ export class AgentRuntime {
             const recipeCount = ctx.toolCalls.filter((tc) => (tc.tool || tc.name) === 'collect_scan_recipe').length;
             ctx.lastReply = `[scan complete: ${recipeCount} recipes collected]`;
         }
-        // 强制摘要 (系统场景或 tracker 场景)
-        if (!ctx.lastReply && (ctx.tracker || ctx.isSystem)) {
-            const forcedResult = await produceForcedSummary({
-                aiProvider: this.aiProvider,
-                source: ctx.source,
-                toolCalls: ctx.toolCalls,
-                tracker: ctx.tracker ?? undefined,
-                contextWindow: ctx.contextWindow,
-                prompt: ctx.prompt,
-                tokenUsage: this.tokenUsage,
-            });
-            ctx.lastReply = forcedResult.reply;
-            if (forcedResult.tokenUsage) {
-                this.tokenUsage.input += forcedResult.tokenUsage.input || 0;
-                this.tokenUsage.output += forcedResult.tokenUsage.output || 0;
-                ctx.addTokenUsage({
-                    inputTokens: forcedResult.tokenUsage.input || 0,
-                    outputTokens: forcedResult.tokenUsage.output || 0,
+        // 强制摘要 — 循环结束后无文本回复时，生成摘要
+        // 覆盖所有场景: 系统管线、tracker 管线、用户对话(有/无工具调用)
+        if (!ctx.lastReply) {
+            if (ctx.toolCalls.length > 0 || ctx.tracker || ctx.isSystem) {
+                const forcedResult = await produceForcedSummary({
+                    aiProvider: this.aiProvider,
+                    source: ctx.source,
+                    toolCalls: ctx.toolCalls,
+                    tracker: ctx.tracker ?? undefined,
+                    contextWindow: ctx.contextWindow,
+                    prompt: ctx.prompt,
+                    tokenUsage: this.tokenUsage,
                 });
+                ctx.lastReply = forcedResult.reply;
+                if (forcedResult.tokenUsage) {
+                    this.tokenUsage.input += forcedResult.tokenUsage.input || 0;
+                    this.tokenUsage.output += forcedResult.tokenUsage.output || 0;
+                    ctx.addTokenUsage({
+                        inputTokens: forcedResult.tokenUsage.input || 0,
+                        outputTokens: forcedResult.tokenUsage.output || 0,
+                    });
+                }
+            }
+            else {
+                // 兜底: 既无工具调用也无文本回复
+                ctx.lastReply = '抱歉，AI 未能生成有效回复。请重试或换个问题。';
+                this.logger.warn(`[AgentRuntime] ⚠ finalize: no reply, no tool calls (iter=${ctx.iteration}) — fallback message`);
             }
         }
         return ctx.buildResult();

package/dist/lib/agent/capabilities.d.ts

@@ -142,6 +142,16 @@ export declare class ScanProduction extends Capability {
     get promptFragment(): string;
     get tools(): string[];
 }
+/**
+ * Evolution Analysis — 现有 Recipe 进化决策能力
+ *
+ * 用于: evolution preset 的 evolve 阶段
+ */
+export declare class EvolutionAnalysis extends Capability {
+    get name(): string;
+    get promptFragment(): string;
+    get tools(): string[];
+}
 /**
  * 所有内置 Capability 的注册表
  *
@@ -163,6 +173,7 @@ declare const _default: {
     CodeAnalysis: typeof CodeAnalysis;
     KnowledgeProduction: typeof KnowledgeProduction;
     SystemInteraction: typeof SystemInteraction;
+    EvolutionAnalysis: typeof EvolutionAnalysis;
     CapabilityRegistry: {
         _registry: Map<string, typeof Capability>;
         /** 按名称创建 Capability 实例 */

package/dist/lib/agent/capabilities.js

@@ -214,7 +214,7 @@ export class KnowledgeProduction extends Capability {
 你是知识管理专家，将代码分析转化为结构化知识候选。
 
 每个候选必须有:
-1. 清晰的标题 (使用项目真实类名/模块名)
+1. 清晰的标题 (使用项目真实类名/模块名，不以项目名开头)
 2. 项目特写风格的正文 (content.markdown)
 3. 相关文件路径
 4. 正确的 kind (rule / pattern / fact)
@@ -222,14 +222,13 @@ export class KnowledgeProduction extends Capability {
 
 工作流:
 1. 识别分析中的知识点
-2. read_project_file 获取代码片段 (如需)
+2. read_project_file 批量获取代码片段 (如需)
 3. submit_knowledge 或 submit_with_check 提交
 4. 提交优先于完美 — 文件读取失败时用已有信息直接提交`;
     }
     get tools() {
-        // 与旧版 PRODUCER_TOOLS 保持一致: 仅 3 个核心工具
+        // 与 PRODUCER_TOOLS 保持一致: 提交 + 文件读取
         // guard_check_code / validate_candidate 不需要：提交时 UnifiedValidator 已自动校验
-        // 额外工具会分散 LLM 注意力，浪费 produce 轮次在验证而非提交上
         return [
             'submit_knowledge',
             'submit_with_check',
@@ -321,7 +320,7 @@ export class ScanProduction extends Capability {
 你是知识管理专家，将代码分析转化为结构化知识候选。
 
 每个候选必须有:
-1. 清晰的标题 (使用项目真实类名/模块名)
+1. 清晰的标题 (使用项目真实类名/模块名，不以项目名开头)
 2. 项目特写风格的正文 (content.markdown ≥200字)
 3. 设计原理说明 (content.rationale)
 4. 相关文件路径 (reasoning.sources)
@@ -341,6 +340,29 @@ export class ScanProduction extends Capability {
         ];
     }
 }
+// ─── Evolution Analysis ─────────────────────────
+/**
+ * Evolution Analysis — 现有 Recipe 进化决策能力
+ *
+ * 用于: evolution preset 的 evolve 阶段
+ */
+export class EvolutionAnalysis extends Capability {
+    get name() {
+        return 'evolution_analysis';
+    }
+    get promptFragment() {
+        return '你是知识进化专家，负责验证现有 Recipe 真实性并通过提案推动知识演化。';
+    }
+    get tools() {
+        return [
+            'read_project_file',
+            'search_project_code',
+            'propose_evolution',
+            'confirm_deprecation',
+            'skip_evolution',
+        ];
+    }
+}
 // ─── Capability 注册表 ─────────────────────────
 /**
  * 所有内置 Capability 的注册表
@@ -355,6 +377,7 @@ export const CapabilityRegistry = {
         ['knowledge_production', KnowledgeProduction],
         ['scan_production', ScanProduction],
         ['system_interaction', SystemInteraction],
+        ['evolution_analysis', EvolutionAnalysis],
     ]),
     /** 按名称创建 Capability 实例 */
     create(name, opts = {}) {
@@ -379,5 +402,6 @@ export default {
     CodeAnalysis,
     KnowledgeProduction,
     SystemInteraction,
+    EvolutionAnalysis,
     CapabilityRegistry,
 };

package/dist/lib/agent/context/ExplorationTracker.js

@@ -54,6 +54,7 @@ export class ExplorationTracker {
         iteration: 0,
         searchRoundsInPhase: 0,
         phaseRounds: 0,
+        consecutiveIdleRounds: 0,
     };
     // ── 阶段控制 ──
     /** 是否刚完成阶段转换（用于 pending nudge） */
@@ -273,6 +274,13 @@ export class ExplorationTracker {
         if (hasSearchTool) {
             this.#metrics.searchRoundsInPhase++;
         }
+        // 2.5 连续空闲轮次追踪（无任何工具调用 = 真正空转，有工具调用 = 活跃工作）
+        if (toolNames.length === 0) {
+            this.#metrics.consecutiveIdleRounds++;
+        }
+        else {
+            this.#metrics.consecutiveIdleRounds = 0;
+        }
         // 3. 检查 metrics 驱动的阶段转换
         this.#checkMetricsTransition();
         // 4. 如果发生了转换，生成 nudge
@@ -446,8 +454,9 @@ export class ExplorationTracker {
         // (SCAN 阶段的 roundsSinceNewInfo 不应影响 EXPLORE→VERIFY 的判定)
         this.#metrics.roundsSinceNewInfo = 0;
         this.#metrics.roundsSinceSubmit = 0;
+        this.#metrics.consecutiveIdleRounds = 0;
         this.#justTransitioned = true;
-        this.#logger.info(`[ExplorationTracker] ${oldPhase} → ${newPhase} (iter=${this.#metrics.iteration}, submits=${this.#metrics.submitCount})`);
+        this.#logger.info(`[ExplorationTracker] ${oldPhase} → ${newPhase} (iter=${this.#metrics.iteration}, submits=${this.#metrics.submitCount}, phaseRounds=${this.#metrics.phaseRounds}, idleRounds=${this.#metrics.consecutiveIdleRounds})`);
         // Phase 3: 发射阶段转换信号
         if (this.#signalBus) {
             const terminalPhase = this.#getTerminalPhase();

package/dist/lib/agent/context/exploration/ExplorationStrategies.d.ts

@@ -30,6 +30,8 @@ export interface ExplorationMetrics {
     phaseRounds: number;
     roundsSinceSubmit: number;
     roundsSinceNewInfo: number;
+    /** 连续无任何工具调用的轮次数（用于 grace exit 判定） */
+    consecutiveIdleRounds: number;
 }
 /** 探索预算配置 */
 export interface ExplorationBudget {

package/dist/lib/agent/context/exploration/ExplorationStrategies.js

@@ -37,7 +37,7 @@ export function createBootstrapStrategy(isSkillOnly = false) {
                     'PRODUCE→SUMMARIZE': {
                         onMetrics: (m, b) => m.submitCount >= b.maxSubmits ||
                             (m.submitCount > 0 && m.roundsSinceSubmit >= b.idleRoundsToExit) ||
-                            (m.phaseRounds >= b.searchBudgetGrace && m.submitCount === 0),
+                            (m.consecutiveIdleRounds >= b.searchBudgetGrace && m.submitCount === 0),
                         onTextResponse: (m, b) => m.submitCount >= b.softSubmitLimit,
                     },
                 }),
@@ -106,7 +106,7 @@ export const STRATEGY_PRODUCER = {
         'PRODUCE→SUMMARIZE': {
             onMetrics: (m, b) => m.submitCount >= b.maxSubmits ||
                 (m.submitCount > 0 && m.roundsSinceSubmit >= b.idleRoundsToExit) ||
-                (m.phaseRounds >= b.searchBudgetGrace && m.submitCount === 0),
+                (m.consecutiveIdleRounds >= b.searchBudgetGrace && m.submitCount === 0),
             onTextResponse: (m, b) => m.submitCount >= b.softSubmitLimit,
         },
     },

package/dist/lib/agent/domain/ChatAgentTasks.js

@@ -61,6 +61,10 @@ ${highSim.map((s) => `- ${s.title} (相似度: ${s.similarity})`).join('\n')}
 export async function taskDiscoverAllRelations(context, { batchSize = 20 } = {}) {
     const { container } = context;
     const agentFactory = container.get('agentFactory');
+    // Mock 模式下跳过 AI 关系发现
+    if (agentFactory.getAiProviderInfo?.()?.name === 'mock') {
+        return { discovered: 0, message: 'AI Provider 未配置（Mock 模式），跳过关系发现。' };
+    }
     return agentFactory.discoverRelations({ batchSize });
 }
 /** 任务: 批量 AI 补全候选语义字段 */

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

@@ -59,7 +59,7 @@ interface CodeEntityGraphLike {
         maxEdges: number;
     }): string | null;
 }
-export declare const ANALYST_SYSTEM_PROMPT = "\u4F60\u662F\u4E00\u4F4D\u9AD8\u7EA7\u8F6F\u4EF6\u67B6\u6784\u5E08\uFF0C\u6B63\u5728\u6DF1\u5EA6\u5206\u6790\u4E00\u4E2A\u771F\u5B9E\u9879\u76EE\u7684\u67D0\u4E2A\u7EF4\u5EA6\u3002\n\n## \u6267\u884C\u8BA1\u5212\n\u4F60\u6709 **N \u8F6E**\u5DE5\u5177\u8C03\u7528\u673A\u4F1A\uFF08\u7CFB\u7EDF\u4F1A\u544A\u77E5\u5177\u4F53\u6570\u5B57\uFF09\u3002\u8BF7\u4E25\u683C\u6309\u4EE5\u4E0B\u8282\u594F\u5206\u914D\uFF1A\n\n| \u9636\u6BB5 | \u8F6E\u6B21\u5360\u6BD4 | \u76EE\u6807 |\n|------|---------|------|\n| 1. \u5168\u5C40\u626B\u63CF | \u7B2C 1-3 \u8F6E | get_project_overview + list_project_structure \u4E86\u89E3\u9879\u76EE\u7ED3\u6784 |\n| 2. \u7ED3\u6784\u5316\u63A2\u7D22 | \u7B2C 4-N\u00D760% \u8F6E | get_class_hierarchy / get_class_info \u7406\u89E3\u6838\u5FC3\u7C7B\uFF1Bsearch_project_code \u6279\u91CF\u641C\u7D22\u5173\u952E\u6A21\u5F0F |\n| 3. \u6DF1\u5EA6\u9A8C\u8BC1 | \u7B2C N\u00D760%-N\u00D780% \u8F6E | read_project_file \u9605\u8BFB\u5173\u952E\u5B9E\u73B0\uFF0C\u786E\u8BA4\u7EC6\u8282 |\n| 4. \u8F93\u51FA\u603B\u7ED3 | \u6700\u540E 20% | **\u505C\u6B62\u8C03\u7528\u5DE5\u5177**\uFF0C\u76F4\u63A5\u8F93\u51FA\u4F60\u7684\u5206\u6790\u6587\u672C |\n\n## \u5173\u952E\u89C4\u5219\n- **\u5230\u8FBE 80% \u8F6E\u6B21\u65F6\u5FC5\u987B\u5F00\u59CB\u5199\u603B\u7ED3**\uFF0C\u4E0D\u8981\u7B49\u7CFB\u7EDF\u63D0\u9192\n- \u6BCF\u4E00\u8F6E\u90FD\u5FC5\u987B\u8C03\u7528\u5DE5\u5177\u83B7\u53D6\u65B0\u4FE1\u606F\uFF0C\u4E0D\u8981\u82B1\u8F6E\u6B21\u5728\u7EAF\u6587\u672C\u601D\u8003\u4E0A\n- \u4E0D\u8981\u91CD\u590D\u641C\u7D22\u76F8\u540C\u5173\u952E\u8BCD\u6216\u8BFB\u53D6\u76F8\u540C\u6587\u4EF6\uFF08\u7CFB\u7EDF\u4F1A\u8FD4\u56DE\u7F13\u5B58\u5E76\u6263\u8F6E\u6B21\uFF09\n\n## \u5DE5\u5177\u6548\u7387\n- **\u6279\u91CF\u641C\u7D22**: search_project_code({ patterns: [\"keywordA\", \"keywordB\", \"keywordC\"] }) \u2014 \u4E00\u6B21\u641C 3-5 \u4E2A\n- **\u6279\u91CF\u8BFB\u6587\u4EF6**: read_project_file({ filePaths: [\"a.m\", \"b.m\", \"c.m\"] }) \u2014 \u4E00\u6B21\u8BFB 3-5 \u4E2A\n- **\u7ED3\u6784\u5316\u67E5\u8BE2\u4F18\u5148**: get_class_hierarchy / get_class_info \u6BD4\u6587\u672C\u641C\u7D22\u66F4\u7CBE\u786E\u9AD8\u6548\n\n## \u8F93\u51FA\u8981\u6C42\n\u8F93\u51FA\u4F60\u7684\u5206\u6790\u53D1\u73B0\uFF0C\u5305\u62EC\u5177\u4F53\u7684\u6587\u4EF6\u8DEF\u5F84\u548C\u4EE3\u7801\u4F4D\u7F6E\u3002\n\u7528\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u4F60\u7684\u7406\u89E3\uFF0C\u4E0D\u9700\u8981\u7279\u5B9A\u683C\u5F0F\u3002";
+export declare const ANALYST_SYSTEM_PROMPT = "\u4F60\u662F\u4E00\u4F4D\u9AD8\u7EA7\u8F6F\u4EF6\u67B6\u6784\u5E08\uFF0C\u6B63\u5728\u6DF1\u5EA6\u5206\u6790\u4E00\u4E2A\u771F\u5B9E\u9879\u76EE\u7684\u67D0\u4E2A\u7EF4\u5EA6\u3002\n\n## \u6267\u884C\u8BA1\u5212\n\u4F60\u6709 **N \u8F6E**\u5DE5\u5177\u8C03\u7528\u673A\u4F1A\uFF08\u7CFB\u7EDF\u4F1A\u544A\u77E5\u5177\u4F53\u6570\u5B57\uFF09\u3002\u8BF7\u4E25\u683C\u6309\u4EE5\u4E0B\u8282\u594F\u5206\u914D\uFF1A\n\n| \u9636\u6BB5 | \u8F6E\u6B21\u5360\u6BD4 | \u76EE\u6807 |\n|------|---------|------|\n| 1. \u5168\u5C40\u626B\u63CF | \u7B2C 1-3 \u8F6E | get_project_overview + list_project_structure \u4E86\u89E3\u9879\u76EE\u7ED3\u6784 |\n| 2. \u7ED3\u6784\u5316\u63A2\u7D22 | \u7B2C 4-N\u00D760% \u8F6E | get_class_hierarchy / get_class_info \u7406\u89E3\u6838\u5FC3\u7C7B\uFF1Bsearch_project_code \u6279\u91CF\u641C\u7D22\u5173\u952E\u6A21\u5F0F |\n| 3. \u6DF1\u5EA6\u9A8C\u8BC1 | \u7B2C N\u00D760%-N\u00D780% \u8F6E | read_project_file \u9605\u8BFB\u5173\u952E\u5B9E\u73B0\uFF0C\u786E\u8BA4\u7EC6\u8282 |\n| 4. \u8F93\u51FA\u603B\u7ED3 | \u6700\u540E 20% | **\u505C\u6B62\u8C03\u7528\u5DE5\u5177**\uFF0C\u76F4\u63A5\u8F93\u51FA\u4F60\u7684\u5206\u6790\u6587\u672C |\n\n## \u5173\u952E\u89C4\u5219\n- **\u5230\u8FBE 80% \u8F6E\u6B21\u65F6\u5FC5\u987B\u5F00\u59CB\u5199\u603B\u7ED3**\uFF0C\u4E0D\u8981\u7B49\u7CFB\u7EDF\u63D0\u9192\n- \u6BCF\u4E00\u8F6E\u90FD\u5FC5\u987B\u8C03\u7528\u5DE5\u5177\u83B7\u53D6\u65B0\u4FE1\u606F\uFF0C\u4E0D\u8981\u82B1\u8F6E\u6B21\u5728\u7EAF\u6587\u672C\u601D\u8003\u4E0A\n- \u4E0D\u8981\u91CD\u590D\u641C\u7D22\u76F8\u540C\u5173\u952E\u8BCD\u6216\u8BFB\u53D6\u76F8\u540C\u6587\u4EF6\uFF08\u7CFB\u7EDF\u4F1A\u8FD4\u56DE\u7F13\u5B58\u5E76\u6263\u8F6E\u6B21\uFF09\n\n## \u5DE5\u5177\u6548\u7387\n- **\u6279\u91CF\u641C\u7D22**: search_project_code({ patterns: [\"keywordA\", \"keywordB\", \"keywordC\"] }) \u2014 \u4E00\u6B21\u641C 3-5 \u4E2A\n- **\u6279\u91CF\u8BFB\u6587\u4EF6**: read_project_file({ filePaths: [\"a.m\", \"b.m\", \"c.m\"] }) \u2014 \u4E00\u6B21\u8BFB 3-5 \u4E2A\n- **\u7ED3\u6784\u5316\u67E5\u8BE2\u4F18\u5148**: get_class_hierarchy / get_class_info \u6BD4\u6587\u672C\u641C\u7D22\u66F4\u7CBE\u786E\u9AD8\u6548\n\n## \u8F93\u51FA\u8981\u6C42\n\u8F93\u51FA\u4F60\u7684\u5206\u6790\u53D1\u73B0\uFF0C\u5305\u62EC\u5177\u4F53\u7684\u6587\u4EF6\u5B8C\u6574\u76F8\u5BF9\u8DEF\u5F84\uFF08\u4ECE\u9879\u76EE\u6839\u76EE\u5F55\u5F00\u59CB\uFF09\u548C\u884C\u53F7\u3002\n\u6BCF\u4E2A\u6587\u4EF6\u5F15\u7528\u683C\u5F0F: (\u6765\u6E90: Full/Relative/Path/FileName.ext:\u884C\u53F7)\n\u7981\u6B62\u53EA\u5199\u6587\u4EF6\u540D\uFF0C\u5FC5\u987B\u5199\u4ECE\u9879\u76EE\u6839\u5F00\u59CB\u7684\u5B8C\u6574\u8DEF\u5F84\u3002\n\u6807\u6CE8\u6BCF\u4E2A\u53D1\u73B0\u6240\u5C5E\u7684\u6A21\u5757/\u5305\u540D\u3002\n\u7528\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u4F60\u7684\u7406\u89E3\uFF0C\u4E0D\u9700\u8981\u7279\u5B9A\u683C\u5F0F\u3002";
 export declare const ANALYST_TOOLS: string[];
 export declare const ANALYST_BUDGET: {
     maxIterations: number;
@@ -69,10 +69,42 @@ export declare const ANALYST_BUDGET: {
     softSubmitLimit: number;
     idleRoundsToExit: number;
 };
+/** Panorama context — module role, layer, coupling, gaps */
+interface PanoramaContextLike {
+    moduleRole: string | null;
+    moduleLayer: number | null;
+    moduleCoupling: {
+        fanIn: number;
+        fanOut: number;
+    } | null;
+    knownGaps: string[];
+    layerContext: string | null;
+}
+/** Evidence starters — per-dimension evidence hints from Phase 1-4 */
+interface EvidenceStarterEntry {
+    hint: string;
+    data: unknown;
+    strength?: number;
+}
+/** Rescan context — existing recipes in this dimension */
+interface RescanContextLike {
+    existingRecipes: Array<{
+        title: string;
+        trigger: string;
+    }>;
+    decayingRecipes?: Array<{
+        title: string;
+        trigger: string;
+        id?: string;
+        decayReason?: string;
+    }>;
+    gap: number;
+    existing: number;
+}
 /**
  * 构建 Analyst Prompt
  *
- * 9 段结构:
+ * 12 段结构:
  *   §1 任务描述
  *   §2 维度指引
  *   §3 SOP (分析步骤 + 常见错误)
@@ -82,6 +114,9 @@ export declare const ANALYST_BUDGET: {
  *   §7 Tier Reflection 洞察
  *   §8 历史语义记忆 (Tier 3)
  *   §9 代码实体图谱 (Phase E)
+ *   §ES 分析起点证据 (Phase 1-4 Evidence Starters)
+ *   §M1 全景上下文 (Panorama Phase 1.8)
+ *   §10 Rescan 已有知识上下文
  *
  * @param dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
  * @param projectInfo { name, lang, fileCount }
@@ -89,6 +124,15 @@ export declare const ANALYST_BUDGET: {
  * @param [episodicMemory] SessionStore 实例 (v4.0 增强上下文)
  * @param [semanticMemory] PersistentMemory 实例 (v4.1 历史记忆)
  * @param [codeEntityGraph] CodeEntityGraph 实例 (Phase E 代码实体图谱)
+ * @param [rescanContext] Rescan 已有知识上下文 (增量扫描时注入)
+ * @param [panorama] 全景上下文 — 模块角色/层级/耦合/空白区 (Phase 1.8)
+ * @param [evidenceStarters] Phase 1-4 证据启发 — 维度级分析起点
+ * @param [evolutionResult] Evolution Stage 产出 — 避免重复分析已处理的 Recipe
  */
-export declare function buildAnalystPrompt(dimConfig: AnalystDimConfig, projectInfo: AnalystProjectInfo, dimensionContext: DimensionContextLike | null | undefined, episodicMemory: EpisodicMemoryLike | null | undefined, semanticMemory: SemanticMemoryLike | null | undefined, codeEntityGraph: CodeEntityGraphLike | null | undefined): Promise<string>;
+export declare function buildAnalystPrompt(dimConfig: AnalystDimConfig, projectInfo: AnalystProjectInfo, dimensionContext: DimensionContextLike | null | undefined, episodicMemory: EpisodicMemoryLike | null | undefined, semanticMemory: SemanticMemoryLike | null | undefined, codeEntityGraph: CodeEntityGraphLike | null | undefined, rescanContext?: RescanContextLike | null, panorama?: PanoramaContextLike | null, evidenceStarters?: Record<string, EvidenceStarterEntry> | null, evolutionResult?: {
+    evolved?: number;
+    deprecated?: number;
+    skipped?: number;
+    totalRecipes?: number;
+} | null): Promise<string>;
 export {};

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

@@ -12,7 +12,7 @@
  *
  * @module insight-analyst
  */
-import { getDimensionSOP } from '#external/mcp/handlers/bootstrap/shared/dimension-sop.js';
+import { getDimensionSOP } from '#domain/dimension/DimensionSop.js';
 // ──────────────────────────────────────────────────────────────────
 // System Prompt — Analyst 专用 (~100 tokens)
 // ──────────────────────────────────────────────────────────────────
@@ -39,7 +39,10 @@ export const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在
 - **结构化查询优先**: get_class_hierarchy / get_class_info 比文本搜索更精确高效
 
 ## 输出要求
-输出你的分析发现，包括具体的文件路径和代码位置。
+输出你的分析发现，包括具体的文件完整相对路径（从项目根目录开始）和行号。
+每个文件引用格式: (来源: Full/Relative/Path/FileName.ext:行号)
+禁止只写文件名，必须写从项目根开始的完整路径。
+标注每个发现所属的模块/包名。
 用自然语言描述你的理解，不需要特定格式。`;
 // ──────────────────────────────────────────────────────────────────
 // Analyst 可用工具白名单 — 只做探索，不做提交
@@ -77,13 +80,10 @@ export const ANALYST_BUDGET = {
     softSubmitLimit: 0,
     idleRoundsToExit: 2,
 };
-// ──────────────────────────────────────────────────────────────────
-// 维度 Prompt 模板 (9 段式)
-// ──────────────────────────────────────────────────────────────────
 /**
  * 构建 Analyst Prompt
  *
- * 9 段结构:
+ * 12 段结构:
  *   §1 任务描述
  *   §2 维度指引
  *   §3 SOP (分析步骤 + 常见错误)
@@ -93,6 +93,9 @@ export const ANALYST_BUDGET = {
  *   §7 Tier Reflection 洞察
  *   §8 历史语义记忆 (Tier 3)
  *   §9 代码实体图谱 (Phase E)
+ *   §ES 分析起点证据 (Phase 1-4 Evidence Starters)
+ *   §M1 全景上下文 (Panorama Phase 1.8)
+ *   §10 Rescan 已有知识上下文
  *
  * @param dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
  * @param projectInfo { name, lang, fileCount }
@@ -100,8 +103,12 @@ export const ANALYST_BUDGET = {
  * @param [episodicMemory] SessionStore 实例 (v4.0 增强上下文)
  * @param [semanticMemory] PersistentMemory 实例 (v4.1 历史记忆)
  * @param [codeEntityGraph] CodeEntityGraph 实例 (Phase E 代码实体图谱)
+ * @param [rescanContext] Rescan 已有知识上下文 (增量扫描时注入)
+ * @param [panorama] 全景上下文 — 模块角色/层级/耦合/空白区 (Phase 1.8)
+ * @param [evidenceStarters] Phase 1-4 证据启发 — 维度级分析起点
+ * @param [evolutionResult] Evolution Stage 产出 — 避免重复分析已处理的 Recipe
  */
-export async function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMemory, semanticMemory, codeEntityGraph) {
+export async function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMemory, semanticMemory, codeEntityGraph, rescanContext, panorama, evidenceStarters, evolutionResult) {
     const parts = [];
     // §1 任务描述
     parts.push(`分析项目 ${projectInfo.name} (${projectInfo.lang}, ${projectInfo.fileCount} 个文件) 的 ${dimConfig.label}。`);
@@ -144,17 +151,21 @@ export async function buildAnalystPrompt(dimConfig, projectInfo, dimensionContex
     const outputType = dimConfig.outputType || 'analysis';
     const needsCandidates = outputType === 'dual' || outputType === 'candidate';
     const depthHint = needsCandidates
-        ? '你的分析将被转化为知识候选，请确保每个发现都有足够的代码证据和文件引用。目标: 发现 3-5 个独立的知识点。'
+        ? '你的分析将被转化为知识候选，请确保每个发现都有足够的代码证据和文件引用。按实际发现总结，有几个独立知识点就写几个。'
         : '';
     parts.push(`请将分析组织成结构化段落，包含:
-1. 在哪些文件/类中发现 (写出具体文件路径)
+1. 在哪些文件/类中发现 (写出从项目根目录开始的完整相对路径+行号，如 Packages/ModuleName/Sources/.../FileName.swift:42)
 2. 具体的实现方式和代码特征
 3. 为什么选择这种方式（设计意图）
 4. 统计数据 (如数量、占比)
+5. 所属模块/包名（特别是来自本地子包的发现）
 
-每个关键发现用编号列表呈现，引用 3 个以上具体文件。
+每个关键发现用编号列表呈现，引用 3 个以上具体文件（完整相对路径）。
+禁止只写文件名（如 NetworkClient.swift），必须写完整路径（如 Packages/AOXNetworkKit/Sources/AOXNetworkKit/Client/NetworkClient.swift:42）。
 ${depthHint}
-重要: 务必使用 read_project_file 阅读代码确认，不要假设文件存在。引用的每个文件路径都必须是你亲眼看到的。`);
+重要: 务必使用 read_project_file 阅读代码确认，不要假设文件存在。引用的每个文件路径都必须是你亲眼看到的。
+【跨维度去重】只分析属于当前维度视角的内容。不要将其他维度的知识点混入本维度来充数。例如: 分析 code-standard 时只关注命名/注释/文件组织，不要混入设计模式(code-pattern)或分层架构(architecture)的内容。如果某个发现与多个维度相关，则只从当前维度的核心视角分析，避免与其他维度产生重叠。
+【本地子包覆盖】如果项目有本地子包/模块（如 Packages/ 目录下的包），必须同时分析其内部实现，不得仅看主项目对其的调用。`);
     // §5 前序上下文提示
     parts.push('可以调用 get_previous_analysis 获取前序维度的分析结果，避免重复分析。');
     parts.push('使用 note_finding 工具记录关键发现到工作记忆，确保重要信息不会在后期被遗忘。');
@@ -218,5 +229,94 @@ ${depthHint}
             /* CodeEntityGraph context failed, non-critical */
         }
     }
+    // §ES: 分析起点证据 (Phase 1-4 Evidence Starters)
+    if (evidenceStarters && Object.keys(evidenceStarters).length > 0) {
+        const esLines = ['## 📊 分析起点 (Phase 1-4 自动检测)'];
+        esLines.push('以下是自动化分析阶段检测到的与本维度相关的信号，可作为分析起点:');
+        // 按 strength 降序排列，取前 6 个最强信号
+        const sorted = Object.entries(evidenceStarters)
+            .sort(([, a], [, b]) => (b.strength ?? 50) - (a.strength ?? 50))
+            .slice(0, 6);
+        for (const [key, entry] of sorted) {
+            const strengthBadge = (entry.strength ?? 50) >= 75 ? '⚠️' : '📝';
+            esLines.push(`${strengthBadge} **${key}**: ${entry.hint}`);
+            if (entry.data) {
+                const dataStr = Array.isArray(entry.data)
+                    ? entry.data
+                        .slice(0, 5)
+                        .map((d) => `  - ${typeof d === 'string' ? d : JSON.stringify(d)}`)
+                        .join('\n')
+                    : typeof entry.data === 'string'
+                        ? `  ${entry.data}`
+                        : `  ${JSON.stringify(entry.data, null, 0).slice(0, 300)}`;
+                esLines.push(dataStr);
+            }
+        }
+        esLines.push('');
+        esLines.push('利用上述信号作为分析切入点，用 read_project_file 验证并深入探索。');
+        parts.push(esLines.join('\n'));
+    }
+    // §M1: 全景上下文 (Panorama Phase 1.8) — 模块角色/层级/耦合/空白区
+    if (panorama) {
+        const pLines = ['## 🏗️ 项目全景 (Panorama)'];
+        if (panorama.layerContext) {
+            pLines.push(`架构层级: ${panorama.layerContext}`);
+        }
+        if (panorama.moduleRole) {
+            pLines.push(`当前模块角色: ${panorama.moduleRole}${panorama.moduleLayer !== null ? ` (L${panorama.moduleLayer})` : ''}`);
+        }
+        if (panorama.moduleCoupling) {
+            pLines.push(`耦合度: fanIn=${panorama.moduleCoupling.fanIn}, fanOut=${panorama.moduleCoupling.fanOut}`);
+        }
+        if (panorama.knownGaps.length > 0) {
+            pLines.push(`已知空白区: ${panorama.knownGaps.join(', ')}`);
+            pLines.push('分析时请特别关注上述空白区，它们是最可能产出新知识的方向。');
+        }
+        parts.push(pLines.join('\n'));
+    }
+    // §EVO: Evolution 结果 — 避免重复覆盖已被 Evolution Agent 处理的模式
+    if (evolutionResult && evolutionResult.totalRecipes && evolutionResult.totalRecipes > 0) {
+        const evoLines = [
+            '## 🔄 Evolution 结果',
+            `Evolution Agent 已审查本维度 ${evolutionResult.totalRecipes} 个现有 Recipe:`,
+            `- 进化: ${evolutionResult.evolved ?? 0} 个（已提交新版本替代旧 Recipe）`,
+            `- 废弃: ${evolutionResult.deprecated ?? 0} 个（已确认过时）`,
+            `- 跳过: ${evolutionResult.skipped ?? 0} 个（仍然有效或信息不足）`,
+            '',
+            '**你的分析应关注发现新知识点**，不要重复覆盖已处理的模式。',
+        ];
+        parts.push(evoLines.join('\n'));
+    }
+    // §10a: Rescan 有效知识上下文 — 避免重复分析已覆盖的模式
+    if (rescanContext && rescanContext.existingRecipes.length > 0) {
+        const lines = [
+            '## ⚠️ 增量扫描模式 — 已有知识 (勿重复)',
+            `本维度已有 ${rescanContext.existing} 个有效 Recipe，需补齐 ${rescanContext.gap} 个。`,
+            '已有 Recipe 标题:',
+        ];
+        for (const r of rescanContext.existingRecipes.slice(0, 10)) {
+            const triggerTag = r.trigger ? ` (trigger: ${r.trigger})` : '';
+            lines.push(`- "${r.title}"${triggerTag}`);
+        }
+        if (rescanContext.existingRecipes.length > 10) {
+            lines.push(`- ... 共 ${rescanContext.existingRecipes.length} 个`);
+        }
+        lines.push('');
+        lines.push('**你的任务**: 专注发现上述 Recipe **尚未覆盖**的新模式。不要重复分析相同的代码特征。');
+        parts.push(lines.join('\n'));
+    }
+    // §10b: Rescan 衰退知识 — 可以替换
+    if (rescanContext?.decayingRecipes && rescanContext.decayingRecipes.length > 0) {
+        const dLines = [
+            '## 🔄 衰退中的知识 (可替换)',
+            '以下 Recipe 正在衰退，其描述的模式可能已过时或迁移：',
+        ];
+        for (const r of rescanContext.decayingRecipes.slice(0, 5)) {
+            dLines.push(`- "${r.title}" — 衰退原因: ${r.decayReason || '未知'}`);
+        }
+        dLines.push('如果你在分析中发现了这些模式的**更新版本**（例如类改名、迁移到新模块），');
+        dLines.push('请记录下来，后续 Producer 可以用 supersedes 参数提交替代版本。');
+        parts.push(dLines.join('\n'));
+    }
     return parts.join('\n\n');
 }