npm - autosnippet - Versions diffs - 3.3.5 → 3.3.6 - Mend

autosnippet 3.3.5 → 3.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (203) hide show

package/dashboard/dist/index.html CHANGED Viewed

@@ -5,13 +5,13 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-B659K9t5.js"></script>
+    <script type="module" crossorigin src="/assets/index-DDdAOpYT.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-BZEJEVBn.js">
-    <link rel="modulepreload" crossorigin href="/assets/icons-BJ2mUBi8.js">
+    <link rel="modulepreload" crossorigin href="/assets/icons-D1aVZYFW.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-42ANG6Sg.js">
     <link rel="modulepreload" crossorigin href="/assets/framer-motion-CZfOSYpP.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-NCm40PMD.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-CxHOu8Hd.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/bin/api-server.js CHANGED Viewed

@@ -3,6 +3,7 @@
  * HTTP API 服务器启动脚本
  * 用于开发和测试 REST API
  */
+process.env.ASD_API_SERVER = '1';
 import Bootstrap from '../lib/bootstrap.js';
 import HttpServer from '../lib/http/HttpServer.js';
 import Logger from '../lib/infrastructure/logging/Logger.js';

package/dist/bin/cli.d.ts CHANGED Viewed

@@ -6,6 +6,7 @@
  *   asd setup           - 初始化项目（--repo 指定子仓库远程地址）
  *   asd remote <url>    - 将 recipes 目录转为独立子仓库并关联远程仓库
  *   asd coldstart       - 冷启动知识库（9 维度分析 + AI 填充）
+ *   asd rescan          - 增量知识更新（保留 Recipe，重新扫描）
  *   asd ais [Target]    - AI 扫描 Target → 直接发布 Recipes
  *   asd search <query>  - 搜索知识库
  *   asd guard <file>    - Guard 检查

package/dist/bin/cli.js CHANGED Viewed

@@ -6,6 +6,7 @@
  *   asd setup           - 初始化项目（--repo 指定子仓库远程地址）
  *   asd remote <url>    - 将 recipes 目录转为独立子仓库并关联远程仓库
  *   asd coldstart       - 冷启动知识库（9 维度分析 + AI 填充）
+ *   asd rescan          - 增量知识更新（保留 Recipe，重新扫描）
  *   asd ais [Target]    - AI 扫描 Target → 直接发布 Recipes
  *   asd search <query>  - 搜索知识库
  *   asd guard <file>    - Guard 检查
@@ -158,6 +159,7 @@ program
     .description('冷启动知识库：9 维度项目分析 + AI 异步填充（与 Dashboard 点击冷启动流程一致）')
     .option('-d, --dir <path>', '项目目录', '.')
     .option('-m, --max-files <n>', '最大扫描文件数', '500')
+    .option('--dims <ids...>', '仅运行指定维度（逗号分隔或多次指定）')
     .option('--skip-guard', '跳过 Guard 审计')
     .option('--no-skills', '禁用 Skill 加载')
     .option('--wait', '等待 AI 异步填充完成（默认骨架完成即退出）')
@@ -169,17 +171,21 @@ program
     }
     try {
         const { bootstrap, container } = await initContainer({ projectRoot });
-        // 通过 Agent 统一管道执行 bootstrap_knowledge
-        const agentFactory = container.get('agentFactory');
         const ora = (await import('ora')).default;
         const spinner = ora('Phase 1-4: 收集文件、AST 分析、SPM 依赖、Guard 审计...').start();
-        const result = await agentFactory.bootstrapKnowledge({
+        // 直接调用 bootstrap-internal handler（统一编排管线）
+        const { bootstrapKnowledge } = await import('../lib/external/mcp/handlers/bootstrap-internal.js');
+        const logger = container.get('logger');
+        const raw = await bootstrapKnowledge({ container, logger }, {
             maxFiles: parseInt(opts.maxFiles, 10),
             skipGuard: opts.skipGuard || false,
             contentMaxLines: 120,
             loadSkills: opts.skills !== false,
-            skipAsyncFill: !opts.wait, // CLI 非 --wait 模式: 跳过异步 AI 填充 (DB 将被关闭)
+            skipAsyncFill: !opts.wait,
+            dimensions: opts.dims,
         });
+        const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;
+        const result = parsed?.data || parsed;
         spinner.stop();
         if (opts.json) {
             cli.json(result);
@@ -239,7 +245,7 @@ program
             const waitSpinner = ora2('Phase 5: AI 正在逐维度填充知识...').start();
             let lastStatus = '';
             let attempts = 0;
-            const maxAttempts = 600; // 最多等 10 分钟（每秒轮询）
+            const maxAttempts = Infinity; // 不限时——冷启动/增量扫描本身就耗时较长
             while (attempts < maxAttempts) {
                 await new Promise((r) => setTimeout(r, 1000));
                 attempts++;
@@ -279,9 +285,6 @@ program
                     // bootstrapTaskManager 可能还没就绪
                 }
             }
-            if (attempts >= maxAttempts) {
-                waitSpinner.warn('AI 填充超时（10 分钟），可通过 asd ui 查看进度');
-            }
         }
         else if (!opts.json) {
             cli.log('');
@@ -303,6 +306,128 @@ program
     }
 });
 // ─────────────────────────────────────────────────────
+// rescan 命令 (增量知识更新)
+// ─────────────────────────────────────────────────────
+program
+    .command('rescan')
+    .description('增量知识更新：保留已审核 Recipe，清理衍生缓存，重新扫描项目 + AI 补齐')
+    .option('-d, --dir <path>', '项目目录', '.')
+    .option('-m, --max-files <n>', '最大扫描文件数', '500')
+    .option('--dims <ids...>', '仅扫描指定维度（逗号分隔或多次指定）')
+    .option('--reason <text>', '重扫原因（记录到日志）')
+    .option('--wait', '等待 AI 异步填充完成（默认骨架完成即退出）')
+    .option('--json', '以 JSON 格式输出')
+    .action(async (opts) => {
+    const projectRoot = resolve(opts.dir);
+    try {
+        const { bootstrap, container } = await initContainer({ projectRoot });
+        const ora = (await import('ora')).default;
+        const spinner = ora('Rescan: 快照 Recipe → 清理缓存 → Phase 1-4 + 证据审计...').start();
+        // 直接调用 rescan-internal handler（统一编排管线）
+        const { rescanInternal } = await import('../lib/external/mcp/handlers/rescan-internal.js');
+        const logger = container.get('logger');
+        const raw = await rescanInternal({ container, logger }, {
+            reason: opts.reason || 'cli-rescan',
+            dimensions: opts.dims,
+            skipAsyncFill: !opts.wait,
+        });
+        const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;
+        const result = parsed?.data || parsed;
+        spinner.stop();
+        if (opts.json) {
+            cli.json(result);
+        }
+        else {
+            cli.log('\n📊 Rescan Report');
+            cli.log(`${'─'.repeat(50)}`);
+            const rescan = result.rescan || {};
+            const audit = result.relevanceAudit || {};
+            const gap = result.gapAnalysis || {};
+            cli.log(`  保留 Recipe: ${rescan.preservedRecipes ?? '?'}`);
+            cli.log(`  扫描文件: ${result.files ?? '?'}`);
+            cli.log(`  维度: ${gap.totalDimensions ?? '?'} (gap: ${gap.gapDimensions ?? 0})`);
+            cli.log('\n  证据审计:');
+            cli.log(`    健康: ${audit.healthy ?? '?'}  观察: ${audit.watch ?? '?'}`);
+            cli.log(`    衰退: ${audit.decay ?? '?'}  严重: ${audit.severe ?? '?'}  死亡: ${audit.dead ?? '?'}`);
+            if (audit.proposalsCreated > 0) {
+                cli.log(`    创建进化提案: ${audit.proposalsCreated}`);
+            }
+            if (audit.immediateDeprecated > 0) {
+                cli.log(`    即时淘汰: ${audit.immediateDeprecated}`);
+            }
+            if (gap.gapDimensions > 0 && opts.wait) {
+                cli.log(`\n  AI 正在异步填充 ${gap.gapDimensions} 个 gap 维度...`);
+            }
+            else if (gap.gapDimensions > 0) {
+                cli.log(`\n  ${gap.gapDimensions} 个 gap 维度可通过 --wait 等待 AI 填充`);
+            }
+            else {
+                cli.log('\n  所有维度已完全覆盖，无需 AI 补齐。');
+            }
+        }
+        // --wait 模式: 轮询 BootstrapTaskManager
+        if (opts.wait && result.asyncFill) {
+            const ora2 = (await import('ora')).default;
+            const waitSpinner = ora2('AI 正在逐维度填充知识...').start();
+            let lastStatus = '';
+            let attempts = 0;
+            const maxAttempts = Infinity; // 不限时——增量扫描本身就耗时较长
+            while (attempts < maxAttempts) {
+                await new Promise((r) => setTimeout(r, 1000));
+                attempts++;
+                try {
+                    const taskManager = container.get('bootstrapTaskManager');
+                    const sessionStatus = taskManager.getSessionStatus();
+                    if (!sessionStatus || !('tasks' in sessionStatus)) {
+                        break;
+                    }
+                    const total = sessionStatus.tasks.length;
+                    const done = sessionStatus.tasks.filter((t) => t.status === 'done' || t.status === 'error').length;
+                    const current = sessionStatus.tasks.find((t) => t.status === 'running');
+                    const statusText = current
+                        ? `[${done}/${total}] 正在处理: ${current.meta?.label || current.id}`
+                        : `[${done}/${total}] 等待中...`;
+                    if (statusText !== lastStatus) {
+                        waitSpinner.text = statusText;
+                        lastStatus = statusText;
+                    }
+                    if (done >= total) {
+                        waitSpinner.succeed(`AI 填充完成: ${total} 个维度`);
+                        if (!opts.json) {
+                            const succeeded = sessionStatus.tasks.filter((t) => t.status === 'done').length;
+                            const failed = sessionStatus.tasks.filter((t) => t.status === 'error').length;
+                            cli.log(`\n  Results: ${succeeded} succeeded, ${failed} failed`);
+                            for (const t of sessionStatus.tasks) {
+                                const icon = t.status === 'done' ? '✅' : '❌';
+                                cli.log(`    ${icon} ${t.meta?.label || t.id}`);
+                            }
+                            cli.blank();
+                        }
+                        break;
+                    }
+                }
+                catch {
+                    /* bootstrapTaskManager 可能还没就绪 */
+                }
+            }
+        }
+        await bootstrap.shutdown();
+        if (process.stdout.writableLength > 0) {
+            await new Promise((resolve) => process.stdout.once('drain', resolve));
+        }
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        process.exit(0);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        cli.error(`\n❌ ${msg}`);
+        if (err instanceof Error && err.stack) {
+            cli.debug(err.stack);
+        }
+        process.exit(1);
+    }
+});
+// ─────────────────────────────────────────────────────
 // ais 命令 (AI Scan)
 // ─────────────────────────────────────────────────────
 program
@@ -368,7 +493,7 @@ program
     .command('search <query>')
     .description('搜索知识库')
     .option('-t, --type <type>', '搜索类型: all, recipe, solution, rule', 'all')
-    .option('-m, --mode <mode>', '搜索模式: keyword, bm25, semantic, auto', 'bm25')
+    .option('-m, --mode <mode>', '搜索模式: keyword, weighted, semantic, auto', 'auto')
     .option('-l, --limit <n>', '结果数量', '10')
     .option('-r, --rank', '启用排序管线 (CoarseRanker + MultiSignalRanker)')
     .option('-o, --output <format>', '输出格式: text, json', 'text')
@@ -720,6 +845,8 @@ program
     .option('--api-only', '仅启动 API 服务（不启动前端）')
     .action(async (opts) => {
     const { spawn } = await import('node:child_process');
+    // 标记为长驻 API 服务进程（CacheCoordinator 用于判断是否启动轮询）
+    process.env.ASD_API_SERVER = '1';
     // 项目根目录：-d 选项 > 环境变量 ASD_CWD > 当前目录
     const projectRoot = opts.dir || process.env.ASD_CWD || process.cwd();
     const port = opts.port;

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

@@ -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 CHANGED Viewed

@@ -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/capabilities.d.ts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/insight-analyst.d.ts CHANGED Viewed

@@ -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 {};