autosnippet 3.3.8 → 3.4.0

package/dashboard/dist/index.html

@@ -5,7 +5,7 @@
     <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-DV8biUkH.js"></script>
+    <script type="module" crossorigin src="/assets/index-8b1Gf3Bb.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-BMNb0V6L.js">

package/dist/lib/agent/AgentRuntime.js

@@ -252,7 +252,7 @@ export class AgentRuntime {
     // ─── 提取方法: reactLoop 内部阶段 ────────────
     /** 初始化循环上下文 — 封装 reactLoop 前 ~60 行初始化逻辑 */
     #initLoop(prompt, opts) {
-        const { history = [], context = {}, capabilityOverride, budgetOverride, systemPromptOverride, onToolCall, contextWindow, tracker, trace, memoryCoordinator, sharedState, source, toolChoiceOverride, } = opts;
+        const { history = [], context = {}, capabilityOverride, budgetOverride, systemPromptOverride, onToolCall, contextWindow, tracker, trace, memoryCoordinator, sharedState, source, toolChoiceOverride, abortSignal, } = opts;
         // 解析 capabilities
         const caps = capabilityOverride
             ? this.#resolveCapabilities(capabilityOverride)
@@ -314,6 +314,7 @@ export class AgentRuntime {
             context: context || {},
             contextWindow: contextWindow || null,
             toolChoiceOverride: toolChoiceOverride || null,
+            abortSignal: abortSignal || null,
         });
     }
     /**
@@ -321,6 +322,11 @@ export class AgentRuntime {
      * @returns true = 应退出循环
      */
     #shouldExit(ctx) {
+        // 外部中止信号 — 立即退出
+        if (ctx.abortSignal?.aborted) {
+            this.logger.info('[AgentRuntime] ⛔ abortSignal fired — exiting loop');
+            return true;
+        }
         // ExplorationTracker: tick + 退出检查
         if (ctx.tracker) {
             ctx.tracker.tick();
@@ -451,6 +457,7 @@ export class AgentRuntime {
                 systemPrompt: effectiveSystemPrompt,
                 temperature: ctx.budget.temperature ?? (ctx.isSystem ? 0.3 : 0.7),
                 maxTokens: ctx.budget.maxTokens ?? (ctx.isSystem ? 8192 : 4096),
+                abortSignal: ctx.abortSignal ?? undefined,
             }));
             ctx.consecutiveAiErrors = 0;
         }
@@ -518,6 +525,11 @@ export class AgentRuntime {
      * @returns continueResult() 或 null (退出)
      */
     async #handleAiError(ctx, aiErr) {
+        // AbortError — 外部中止信号已触发，不计入错误计数，立即退出
+        if (ctx.abortSignal?.aborted) {
+            this.logger.info('[AgentRuntime] ⛔ abortSignal fired during LLM call — exiting');
+            return null;
+        }
         ctx.consecutiveAiErrors++;
         this.logger.warn(`[AgentRuntime] AI call failed (attempt ${ctx.consecutiveAiErrors}): ${aiErr.message}`);
         ctx.tracker?.rollbackTick?.();

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

@@ -106,6 +106,8 @@ export interface ReactLoopOpts {
     sharedState?: Record<string, unknown>;
     source?: string;
     toolChoiceOverride?: string | null;
+    /** 外部中止信号 — PipelineStrategy hard timeout 时取消进行中的 LLM 调用 */
+    abortSignal?: AbortSignal;
     [key: string]: unknown;
 }
 /** 单次迭代允许的最大工具调用数 */

package/dist/lib/agent/PipelineStrategy.js

@@ -208,7 +208,30 @@ export class PipelineStrategy extends Strategy {
             `tracker: ${stageTracker?.constructor?.name || 'none'}` +
             `${submitToolName ? `, submitTool: ${submitToolName}` : ''}`);
         // 执行 reactLoop (含 per-stage 硬超时保护)
-        const stageResult = await this.#runWithTimeout(runtime, stagePrompt, message, stage, effectiveBudget, ctxWin, stageTracker, strategyContext, phaseResults, bus);
+        let stageResult = await this.#runWithTimeout(runtime, stagePrompt, message, stage, effectiveBudget, ctxWin, stageTracker, strategyContext, phaseResults, bus);
+        // ── 超时零输出快速重试 ──
+        // 当阶段 hard timeout 且 0 tool calls（LLM 完全卡住），
+        // 如果有 retryBudget 且本次非 retry，立即以降级预算重跑一次，
+        // 跳过 gate 往返，争取在更短时限内拿到输出。
+        if (stageResult.timedOut && !stageResult.toolCalls?.length && !isRetry && stage.retryBudget) {
+            _pipelineLogger.info(`[PipelineStrategy] ♻️ Stage "${stage.name}" timed out with 0 tool calls — fast-retrying with retryBudget`);
+            bus.publish(AgentEvents.PROGRESS, {
+                type: 'pipeline_stage_fast_retry',
+                stage: stage.name,
+            });
+            // 重置 ContextWindow (清空上一轮的空消息)
+            if (ctxWin) {
+                ctxWin.resetForNewStage();
+            }
+            // 重建 tracker — 用 retryBudget 的更短限制
+            const retryTracker = this.#resolveStageTracker(stage, ctx, strategyContext, stage.retryBudget);
+            // 构建简化 prompt（如果有 retryPromptBuilder 则使用）
+            let retryPrompt = stagePrompt;
+            if (typeof stage.retryPromptBuilder === 'function') {
+                retryPrompt = stage.retryPromptBuilder({ reason: 'Stage hard timeout with 0 tool calls', artifact: null }, message.content, phaseResults);
+            }
+            stageResult = await this.#runWithTimeout(runtime, retryPrompt, message, stage, stage.retryBudget, ctxWin, retryTracker, strategyContext, phaseResults, bus);
+        }
         // 累计结果
         phaseResults[stage.name] = stageResult;
         ctx.totalToolCalls.push(...(stageResult.toolCalls || []));
@@ -283,6 +306,8 @@ export class PipelineStrategy extends Strategy {
     }
     /** 执行 reactLoop 并添加硬超时保护 */
     async #runWithTimeout(runtime, stagePrompt, message, stage, effectiveBudget, ctxWin, stageTracker, strategyContext, phaseResults, bus) {
+        // 创建 AbortController — hard timeout 时取消进行中的 LLM 请求
+        const abortController = new AbortController();
         const reactPromise = runtime.reactLoop(stagePrompt, {
             history: message.history,
             context: {
@@ -300,6 +325,7 @@ export class PipelineStrategy extends Strategy {
             memoryCoordinator: strategyContext.memoryCoordinator || null,
             sharedState: strategyContext.sharedState || null,
             source: strategyContext.source || null,
+            abortSignal: abortController.signal,
         });
         const stageTimeoutMs = effectiveBudget?.timeoutMs;
         if (!stageTimeoutMs) {
@@ -311,7 +337,11 @@ export class PipelineStrategy extends Strategy {
         return Promise.race([
             reactPromise,
             new Promise((_, reject) => {
-                hardTimer = setTimeout(() => reject(new Error('__STAGE_HARD_TIMEOUT__')), hardLimitMs);
+                hardTimer = setTimeout(() => {
+                    // 先中止进行中的 LLM HTTP 请求，再触发 reject
+                    abortController.abort();
+                    reject(new Error('__STAGE_HARD_TIMEOUT__'));
+                }, hardLimitMs);
             }),
         ])
             .catch((err) => {

package/dist/lib/agent/context/ContextWindow.d.ts

@@ -56,12 +56,13 @@ export declare class ContextWindow {
      * 根据模型名称解析合适的 ContextWindow token 预算。
      *
      * 策略: 取模型最大上下文窗口的一个安全分片，
+     *   - 超大窗口 (≥400k): 预算 48000（1M 级模型可容纳更多上下文）
      *   - 大窗口 (≥200k): 预算 32000（tool schemas + system prompt 占显著空间）
      *   - 中窗口 (≥64k):  预算 24000
      *   - 小窗口 (≥16k):  预算 12000
      *   - 微窗口 (<16k):  预算 = 窗口 × 0.7（留 30% 给 prompt/tool schema）
      *
-     * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
+     * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-5.4-mini'
      * @param [opts] - isSystem 为 true 时给予更高预算
      * @returns 建议的 token 预算
      */

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

@@ -53,6 +53,8 @@ export class ContextWindow {
         [/gemini-1\.0/i, 32_000],
         [/gemini/i, 1_000_000], // 未知版本回退
         // ── OpenAI ──
+        [/gpt-5\.4-(?:mini|nano)/i, 400_000],
+        [/gpt-5/i, 1_000_000],
         [/gpt-4o/i, 128_000],
         [/gpt-4-turbo/i, 128_000],
         [/gpt-4-(?!turbo)/i, 8_192],
@@ -60,6 +62,7 @@ export class ContextWindow {
         [/gpt-3\.5/i, 4_096],
         [/o1|o3|o4/i, 200_000], // OpenAI reasoning models
         // ── Anthropic ──
+        [/claude-(?:opus|sonnet)-4[.-]6/i, 1_000_000], // Opus 4.6 / Sonnet 4.6
         [/claude-.*sonnet-4/i, 200_000],
         [/claude-3[.-]5/i, 200_000],
         [/claude-3[.-]opus/i, 200_000],
@@ -81,12 +84,13 @@ export class ContextWindow {
      * 根据模型名称解析合适的 ContextWindow token 预算。
      *
      * 策略: 取模型最大上下文窗口的一个安全分片，
+     *   - 超大窗口 (≥400k): 预算 48000（1M 级模型可容纳更多上下文）
      *   - 大窗口 (≥200k): 预算 32000（tool schemas + system prompt 占显著空间）
      *   - 中窗口 (≥64k):  预算 24000
      *   - 小窗口 (≥16k):  预算 12000
      *   - 微窗口 (<16k):  预算 = 窗口 × 0.7（留 30% 给 prompt/tool schema）
      *
-     * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
+     * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-5.4-mini'
      * @param [opts] - isSystem 为 true 时给予更高预算
      * @returns 建议的 token 预算
      */
@@ -104,7 +108,10 @@ export class ContextWindow {
         }
         // 2. 按分级策略计算 token 预算
         let budget;
-        if (contextSize >= 200_000) {
+        if (contextSize >= 400_000) {
+            budget = isSystem ? 48_000 : 36_000;
+        }
+        else if (contextSize >= 200_000) {
             budget = isSystem ? 32_000 : 24_000;
         }
         else if (contextSize >= 64_000) {
@@ -209,7 +216,10 @@ export class ContextWindow {
             }
         }
         if (truncated > 0) {
-            this.#logger.info(`[ContextWindow] L1 compact: truncated ${truncated} tool results`);
+            const afterTokens = this.estimateTokens();
+            const ratio = this.getTokenUsageRatio();
+            this.#logger.info(`[ContextWindow] L1 compact: truncated ${truncated} tool results | ` +
+                `tokens≈${afterTokens}/${this.#tokenBudget} (${(ratio * 100).toFixed(1)}%)`);
         }
         return { level: 1, removed: truncated };
     }
@@ -285,7 +295,11 @@ export class ContextWindow {
         });
         const removedCount = keepFrom - 1;
         this.#compactionLog.push(`L${level}: removed ${removedCount} messages (${toolCallCount} rounds)`);
-        this.#logger.info(`[ContextWindow] L${level} compact: removed ${removedCount} messages, kept last ${level === 2 ? 2 : 1} rounds`);
+        const afterTokens = this.estimateTokens();
+        const ratio = this.getTokenUsageRatio();
+        this.#logger.info(`[ContextWindow] L${level} compact: removed ${removedCount} messages (${toolCallCount} rounds), ` +
+            `kept last ${level === 2 ? 2 : 1} round(s) | ` +
+            `tokens≈${afterTokens}/${this.#tokenBudget} (${(ratio * 100).toFixed(1)}%)`);
         return { level, removed: removedCount };
     }
     // ─── 查询 API ─────────────────────────────────────────

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

@@ -70,6 +70,8 @@ export class ExplorationTracker {
     #submitToolName = 'submit_knowledge';
     /** 管线类型标识 — 统一场景判别（替代 submitToolName / strategy.name 字符串比较） */
     #pipelineType;
+    /** 当前阶段开始时间（用于 dwell time 统计） */
+    #phaseStartTime = Date.now();
     /**
      * @param strategy 策略配置对象
      * @param budget 预算配置 { maxIterations, searchBudget, ... }
@@ -446,8 +448,10 @@ export class ExplorationTracker {
     }
     #transitionTo(newPhase) {
         const oldPhase = this.#phase;
+        const dwellMs = Date.now() - this.#phaseStartTime;
         this.#transitionFromPhase = oldPhase;
         this.#phase = newPhase;
+        this.#phaseStartTime = Date.now();
         this.#metrics.phaseRounds = 0;
         this.#metrics.searchRoundsInPhase = 0;
         // 重置停滞计数器 — 防止跨阶段累积导致级联式过早转换
@@ -456,7 +460,8 @@ export class ExplorationTracker {
         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}, phaseRounds=${this.#metrics.phaseRounds}, idleRounds=${this.#metrics.consecutiveIdleRounds})`);
+        this.#logger.info(`[ExplorationTracker] ${oldPhase} → ${newPhase} (iter=${this.#metrics.iteration}, submits=${this.#metrics.submitCount}, ` +
+            `dwellMs=${dwellMs}, files=${this.#metrics.uniqueFiles.size}, patterns=${this.#metrics.uniquePatterns.size})`);
         // Phase 3: 发射阶段转换信号
         if (this.#signalBus) {
             const terminalPhase = this.#getTerminalPhase();

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

@@ -66,7 +66,8 @@ export const STRATEGY_ANALYST = {
     phases: ['SCAN', 'EXPLORE', 'VERIFY', 'SUMMARIZE'],
     transitions: {
         'SCAN→EXPLORE': {
-            onMetrics: (m) => m.iteration >= 3,
+            // 2 轮结构扫描足够获取项目骨架（目录 + 关键文件列表），将 1 轮还给 EXPLORE
+            onMetrics: (m) => m.iteration >= 2,
             onTextResponse: false,
         },
         'EXPLORE→VERIFY': {

package/dist/lib/agent/core/LoopContext.d.ts

@@ -62,6 +62,7 @@ interface LoopContextConfig {
     context?: Record<string, unknown>;
     contextWindow?: ContextWindow | null;
     toolChoiceOverride?: string | null;
+    abortSignal?: AbortSignal | null;
 }
 export declare class LoopContext {
     /** 统一消息适配器 */
@@ -110,6 +111,8 @@ export declare class LoopContext {
     contextWindow: ContextWindow | null;
     /** 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
     toolChoiceOverride: string | null;
+    /** 外部中止信号 — hard timeout 时取消进行中的 LLM 调用 */
+    abortSignal: AbortSignal | null;
     constructor(config: LoopContextConfig);
     /** 是否为 system 场景 */
     get isSystem(): boolean;

package/dist/lib/agent/core/LoopContext.js

@@ -60,6 +60,8 @@ export class LoopContext {
     contextWindow;
     /** 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
     toolChoiceOverride;
+    /** 外部中止信号 — hard timeout 时取消进行中的 LLM 调用 */
+    abortSignal;
     constructor(config) {
         this.messages = config.messages;
         this.tracker = (config.tracker || null);
@@ -76,6 +78,7 @@ export class LoopContext {
         this.context = config.context || {};
         this.contextWindow = config.contextWindow || null;
         this.toolChoiceOverride = config.toolChoiceOverride || null;
+        this.abortSignal = (config.abortSignal || null);
         this.loopStartTime = Date.now();
     }
     // ─── 计算属性 ───

package/dist/lib/agent/domain/EpisodicConsolidator.d.ts

@@ -97,6 +97,11 @@ export declare class EpisodicConsolidator {
         };
         total: ConsolidateResult;
         durationMs: number;
+        perDimension: {
+            [k: string]: number;
+        };
+        importanceDistribution: Record<number, number>;
+        entityCount: number;
     };
 }
 export default EpisodicConsolidator;

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

@@ -25,16 +25,18 @@ import Logger from '#infra/logging/Logger.js';
  *   - "XX 采用了 YY"
  */
 const FACT_PATTERNS = [
-    // "项目使用/采用了 XXX"
+    // Chinese
     /(?:项目|工程|代码库)(?:使用|采用|基于|遵循)了?\s*([^，。,.\n]{5,60})/g,
-    // "主要/核心 XXX 是 YYY"
     /(?:主要|核心|主|主力)\s*(\S+)\s*(?:是|为|使用)\s*([^，。,.\n]{3,40})/g,
-    // "发现了? N 个 XXX"
     /(?:发现|找到|扫描到|识别|共有|包含)\s*了?\s*(\d+)\s*个?\s*([^，。,.\n]{2,30})/g,
-    // "XXX 是唯一的/主要的 YYY"
     /(\S{2,20})\s*是\s*(?:唯一的?|主要的?|核心的?|全局的?)\s*([^，。,.\n]{3,30})/g,
-    // "使用了 XXX 前缀/后缀/命名"
     /(?:使用|采用|遵循)了?\s*(\S{1,10})\s*(?:前缀|后缀|命名|约定|规范)/g,
+    // English
+    /(?:the\s+)?project\s+(?:uses?|adopts?|relies\s+on|follows?)\s+([^.,\n]{5,60})/gi,
+    /(?:found|discovered|identified|detected)\s+(\d+)\s+([^.,\n]{3,40})/gi,
+    /(?:the\s+)?(?:primary|main|core)\s+(\S+)\s+(?:is|are)\s+([^.,\n]{3,40})/gi,
+    /(?:all|every)\s+([^.,\n]{3,30})\s+(?:use|adopt|follow|implement)\s+([^.,\n]{3,40})/gi,
+    /(?:there\s+(?:is|are))\s+(\d+)\s+([^.,\n]{3,40})/gi,
 ];
 /**
  * 匹配洞察性陈述:
@@ -43,9 +45,14 @@ const FACT_PATTERNS = [
  *   - "建议/推荐 XXX"
  */
 const INSIGHT_PATTERNS = [
+    // Chinese
     /([^，。,.\n]{5,40})(?:暗示|表明|说明|意味着|揭示)\s*([^，。,.\n]{5,60})/g,
     /([^，。,.\n]{3,20})\s*(?:与|和)\s*([^，。,.\n]{3,20})\s*(?:耦合|关联|存在依赖|有关系)/g,
     /(?:建议|推荐|应该|需要)\s*([^，。,.\n]{5,60})/g,
+    // English
+    /([^.,\n]{5,40})\s+(?:suggests?|indicates?|implies?|reveals?)\s+(?:that\s+)?([^.,\n]{5,60})/gi,
+    /([^.,\n]{3,20})\s+(?:is|are)\s+(?:tightly\s+)?(?:coupled|linked|related)\s+(?:to|with)\s+([^.,\n]{3,30})/gi,
+    /(?:recommend|should|consider|suggest)\s+([^.,\n]{5,60})/gi,
 ];
 // ──────────────────────────────────────────────────────────────
 // EpisodicConsolidator 类
@@ -81,9 +88,15 @@ export class EpisodicConsolidator {
         const textFactMemories = this.#extractFromAnalysisText(sessionStore);
         // 5. 合并所有候选, 使用 consolidate 去重
         const allCandidates = [...findingMemories, ...insightMemories, ...textFactMemories];
+        // ── 结构化统计日志 ──
+        const dimStats = this.#computeDimStats(allCandidates);
+        const importanceDist = this.#computeImportanceDistribution(allCandidates);
+        const entityCount = allCandidates.reduce((sum, c) => sum + (c.relatedEntities?.length || 0), 0);
         this.#logger.info(`[Consolidator] Extracted ${allCandidates.length} candidate memories: ` +
             `${findingMemories.length} findings, ${insightMemories.length} insights, ` +
             `${textFactMemories.length} text facts`);
+        this.#logger.info(`[Consolidator] Per-dimension: ${dimStats.map((d) => `${d.dim}=${d.count}`).join(', ')}`);
+        this.#logger.info(`[Consolidator] Importance distribution: ${importanceDist} | Entities extracted: ${entityCount}`);
         const result = this.#semanticMemory.consolidate(allCandidates, { bootstrapSession });
         const durationMs = Date.now() - t0;
         this.#logger.info(`[Consolidator] Consolidation complete in ${durationMs}ms: ` +
@@ -95,6 +108,9 @@ export class EpisodicConsolidator {
             textFacts: { extracted: textFactMemories.length },
             total: result,
             durationMs,
+            perDimension: Object.fromEntries(dimStats.map((d) => [d.dim, d.count])),
+            importanceDistribution: this.#importanceHistogram(allCandidates),
+            entityCount,
         };
     }
     // ─── 提取器 ───────────────────────────────────────────
@@ -273,6 +289,45 @@ export class EpisodicConsolidator {
         return memories;
     }
     // ─── 辅助方法 ─────────────────────────────────────────
+    /** 按维度聚合候选数量 */
+    #computeDimStats(candidates) {
+        const counts = new Map();
+        for (const c of candidates) {
+            const dim = c.sourceDimension || 'unknown';
+            counts.set(dim, (counts.get(dim) || 0) + 1);
+        }
+        return [...counts.entries()]
+            .map(([dim, count]) => ({ dim, count }))
+            .sort((a, b) => b.count - a.count);
+    }
+    /** 生成重要性分布字符串: "[1-3]=N [4-6]=N [7-10]=N" */
+    #computeImportanceDistribution(candidates) {
+        let low = 0;
+        let mid = 0;
+        let high = 0;
+        for (const c of candidates) {
+            const imp = c.importance || 5;
+            if (imp <= 3) {
+                low++;
+            }
+            else if (imp <= 6) {
+                mid++;
+            }
+            else {
+                high++;
+            }
+        }
+        return `[1-3]=${low} [4-6]=${mid} [7-10]=${high}`;
+    }
+    /** 构建重要性直方图对象 (供返回值使用) */
+    #importanceHistogram(candidates) {
+        const hist = {};
+        for (const c of candidates) {
+            const imp = c.importance || 5;
+            hist[imp] = (hist[imp] || 0) + 1;
+        }
+        return hist;
+    }
     /**
      * 从文本中提取实体名 (类名/文件名/模块名)
      *

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

@@ -61,6 +61,7 @@ interface CodeEntityGraphLike {
 }
 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[];
+/** 默认 Analyst 预算（24 轮基线） */
 export declare const ANALYST_BUDGET: {
     maxIterations: number;
     searchBudget: number;
@@ -69,6 +70,21 @@ export declare const ANALYST_BUDGET: {
     softSubmitLimit: number;
     idleRoundsToExit: number;
 };
+/**
+ * 根据项目规模自适应计算 Analyst 预算
+ *
+ * 策略: 以文件数为主要缩放因子，保持 searchBudget/maxIterations 的比例关系。
+ *   - ≤40 文件: 基线 24 轮（小型项目无需额外预算）
+ *   - 41~100 文件: 线性插值到 32 轮
+ *   - 101~200 文件: 线性插值到 40 轮
+ *   - >200 文件: 封顶 40 轮（避免单维度成本失控）
+ *
+ * searchBudget 按比例随 maxIterations 缩放（保持 75%）。
+ * timeoutMs 按比例随 maxIterations 缩放（基线 300s 对应 24 轮）。
+ */
+export declare function computeAnalystBudget(fileCount: number): typeof ANALYST_BUDGET & {
+    timeoutMs: number;
+};
 /** Panorama context — module role, layer, coupling, gaps */
 interface PanoramaContextLike {
     moduleRole: string | null;

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

@@ -72,6 +72,7 @@ export const ANALYST_TOOLS = [
 // ──────────────────────────────────────────────────────────────────
 // Analyst 预算 — 使用 analyst 策略（自由探索，无阶段约束）
 // ──────────────────────────────────────────────────────────────────
+/** 默认 Analyst 预算（24 轮基线） */
 export const ANALYST_BUDGET = {
     maxIterations: 24,
     searchBudget: 18,
@@ -80,6 +81,43 @@ export const ANALYST_BUDGET = {
     softSubmitLimit: 0,
     idleRoundsToExit: 2,
 };
+/**
+ * 根据项目规模自适应计算 Analyst 预算
+ *
+ * 策略: 以文件数为主要缩放因子，保持 searchBudget/maxIterations 的比例关系。
+ *   - ≤40 文件: 基线 24 轮（小型项目无需额外预算）
+ *   - 41~100 文件: 线性插值到 32 轮
+ *   - 101~200 文件: 线性插值到 40 轮
+ *   - >200 文件: 封顶 40 轮（避免单维度成本失控）
+ *
+ * searchBudget 按比例随 maxIterations 缩放（保持 75%）。
+ * timeoutMs 按比例随 maxIterations 缩放（基线 300s 对应 24 轮）。
+ */
+export function computeAnalystBudget(fileCount) {
+    const clamped = Math.max(0, fileCount);
+    let maxIter;
+    if (clamped <= 40) {
+        maxIter = 24;
+    }
+    else if (clamped <= 100) {
+        // 40→100 文件: 24→32 轮（线性插值）
+        maxIter = Math.round(24 + ((clamped - 40) / 60) * 8);
+    }
+    else if (clamped <= 200) {
+        // 100→200 文件: 32→40 轮
+        maxIter = Math.round(32 + ((clamped - 100) / 100) * 8);
+    }
+    else {
+        maxIter = 40;
+    }
+    return {
+        ...ANALYST_BUDGET,
+        maxIterations: maxIter,
+        searchBudget: Math.round(maxIter * 0.75),
+        // 超时随轮次等比缩放: 24轮→300s, 40轮→500s
+        timeoutMs: Math.round((maxIter / 24) * 300_000),
+    };
+}
 /**
  * 构建 Analyst Prompt
  *

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

@@ -14,7 +14,9 @@
  *
  * @module insight-gate
  */
+import Logger from '#infra/logging/Logger.js';
 import { EvidenceCollector, } from './EvidenceCollector.js';
+const logger = Logger.getInstance();
 // ──────────────────────────────────────────────────────────────────
 // AnalysisReport 构建
 // ──────────────────────────────────────────────────────────────────
@@ -376,6 +378,16 @@ export function insightGateEvaluator(source, phaseResults, strategyContext = {})
         ? buildAnalysisArtifact(source, dimId, projectGraph, activeContext)
         : buildAnalysisReport(source, dimId, projectGraph);
     const gate = analysisQualityGate(artifact, { outputType: outputType || 'analysis' });
+    const qr = artifact.qualityReport;
+    if (qr?.scores) {
+        logger.info(`[QualityGate] dim="${dimId}" action=${gate.pass ? 'pass' : gate.action} ` +
+            `total=${qr.totalScore} depth=${qr.scores.depthScore} breadth=${qr.scores.breadthScore} ` +
+            `evidence=${qr.scores.evidenceScore} coherence=${qr.scores.coherenceScore}` +
+            (qr.suggestions.length > 0 ? ` suggestions=[${qr.suggestions.join('; ')}]` : ''));
+    }
+    else {
+        logger.info(`[QualityGate] dim="${dimId}" action=${gate.pass ? 'pass' : gate.action} reason="${gate.reason || 'v1-rules'}" (v1 fallback)`);
+    }
     return {
         action: gate.action || (gate.pass ? 'pass' : 'retry'),
         reason: gate.reason || '',

package/dist/lib/agent/memory/MemoryConsolidator.js

@@ -17,6 +17,8 @@ import { MemoryStore } from './MemoryStore.js';
 /** 相似度阈值 */
 const SIMILARITY_UPDATE = 0.85; // ≥85% 同义 → UPDATE
 const SIMILARITY_MERGE = 0.6; // ≥60% 相关 → MERGE
+/** 详细日志开关 (合并时记录每次 MERGE/UPDATE/REPLACE 的内容摘要) */
+const VERBOSE_CONSOLIDATION = true;
 // ─── 矛盾检测模式 (Mem0 风格冲突解决) ─────────────────
 /** 中文否定/禁止模式 */
 const NEGATION_PATTERNS_ZH = /不(再)?使用|不(再)?用|禁止|废弃|移除|取消|停止|不要|不采用|弃用|淘汰/;
@@ -68,6 +70,9 @@ export class MemoryConsolidator {
                         accessCount: topMatch.access_count + 1,
                     });
                     stats.updated++;
+                    if (VERBOSE_CONSOLIDATION) {
+                        this.#logDebug(`UPDATE sim=${(topMatch.similarity ?? 0).toFixed(2)}: "${content.substring(0, 40)}..." → existing "${topMatch.content.substring(0, 40)}..."`);
+                    }
                 }
                 else if ((topMatch.similarity ?? 0) >= SIMILARITY_MERGE) {
                     // MERGE: 相关但不同 → 合并信息
@@ -79,6 +84,9 @@ export class MemoryConsolidator {
                         relatedMemories: [...existingRelated, `merged:${Date.now()}`],
                     });
                     stats.merged++;
+                    if (VERBOSE_CONSOLIDATION) {
+                        this.#logDebug(`MERGE sim=${(topMatch.similarity ?? 0).toFixed(2)}: "${content.substring(0, 40)}..." ⊕ "${topMatch.content.substring(0, 40)}..."`);
+                    }
                 }
                 else {
                     this.#store.add({ ...candidate, bootstrapSession });
@@ -299,6 +307,15 @@ export class MemoryConsolidator {
                 return 'fact';
         }
     }
+    #logDebug(msg) {
+        const formatted = `[MemoryConsolidator] ${msg}`;
+        if (this.#logger?.debug) {
+            this.#logger.debug(formatted);
+        }
+        else if (this.#logger?.info) {
+            this.#logger.info(formatted);
+        }
+    }
     #log(msg) {
         const formatted = `[MemoryConsolidator] ${msg}`;
         if (this.#logger?.info) {

package/dist/lib/bootstrap.js

@@ -44,7 +44,12 @@ export class Bootstrap {
             // 0.5 确保 PathGuard 已配置（如果调用方未提前配置）
             // MCP 服务器会在 initialize() 之前配置，但 CLI/测试可能跳过
             if (!pathGuard.configured) {
-                const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+                const isMcpMode = process.env.ASD_MCP_MODE === '1';
+                const projectRoot = process.env.ASD_PROJECT_DIR || (isMcpMode ? undefined : process.cwd());
+                if (!projectRoot) {
+                    throw new Error('[Bootstrap] MCP 模式下缺少 ASD_PROJECT_DIR 环境变量，' +
+                        '且 PathGuard 未提前配置。请在 .vscode/mcp.json 中设置 ASD_PROJECT_DIR。');
+                }
                 Bootstrap.configurePathGuard(projectRoot);
             }
             // 1. 加载配置

package/dist/lib/cli/SetupService.js

@@ -46,7 +46,7 @@
 import { execSync } from 'node:child_process';
 import { copyFileSync, cpSync, existsSync, mkdirSync, readdirSync, renameSync, rmdirSync, rmSync, writeFileSync, } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { isAutoSnippetDevRepo } from '../shared/isOwnDevRepo.js';
+import { isExcludedProject } from '../shared/isOwnDevRepo.js';
 import { DEFAULT_KNOWLEDGE_BASE_DIR, DEFAULT_SUB_REPO_DIR, isGitRepo, } from '../shared/ProjectMarkers.js';
 import { PACKAGE_ROOT } from '../shared/package-root.js';
 import { FileDeployer } from './deploy/FileDeployer.js';
@@ -81,9 +81,10 @@ export class SetupService {
         this.seed = options.seed || false;
         this.subRepoDir = options.subRepoDir || DEFAULT_SUB_REPO_DIR;
         this.subRepoUrl = options.subRepoUrl;
-        // ── 开发仓库保护 ──────────────────────────────────
-        if (isAutoSnippetDevRepo(this.projectRoot)) {
-            throw new Error('[SetupService] 检测到当前目录是 AutoSnippet 源码开发仓库，' +
+        // ── 排除项目保护 ──────────────────────────────────
+        const exclusion = isExcludedProject(this.projectRoot);
+        if (exclusion.excluded) {
+            throw new Error(`[SetupService] 检测到当前目录是排除项目（${exclusion.reason}），` +
                 '拒绝执行 setup 以避免创建 .autosnippet/ 和 AutoSnippet/ 运行时数据。' +
                 '\n提示: 请在用户项目目录中运行 asd setup。');
         }

package/dist/lib/domain/dimension/DimensionRegistry.d.ts

@@ -38,10 +38,12 @@ export declare function resolveActiveDimensions(primaryLang: string, detectedFra
 /**
  * 构建 Tier 分层调度计划
  *
- * 基于每个维度的 tierHint 字段将活跃维度分为 3 层:
- * - Tier 1 (tierHint=1): 基础数据层 — architecture + 语言/框架条件维度
- * - Tier 2 (tierHint=2): 规范+设计层 — coding-standards, design-patterns
- * - Tier 3 (tierHint=3): 实践+质量层 — 其余所有维度
+ * 基于每个维度的 tierHint 字段动态分为 N 层 (不再硬编码 3 层):
+ * - tierHint=1: 基础数据层 — architecture + 语言/框架条件维度
+ * - tierHint=2: 规范+设计层 — coding-standards, design-patterns 等
+ * - tierHint=3+: 实践+质量层 — 按声明值自动分桶
+ *
+ * 未声明 tierHint 的维度默认归入最后一层 (tierHint=max 或 3)。
  */
 export declare function buildTierPlan(activeDims?: readonly UnifiedDimension[]): string[][];
 /**