autosnippet 3.3.9 → 3.4.1

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/core/AstAnalyzer.js

@@ -482,7 +482,6 @@ function _maxNesting(node, depth) {
         'for_in_statement',
         'while_statement',
         'switch_statement',
-        'compound_statement',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-dart.js

@@ -550,7 +550,6 @@ function _maxNesting(node, depth) {
         'while_statement',
         'do_statement',
         'switch_statement',
-        'block',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-go.js

@@ -434,7 +434,6 @@ function _maxNesting(node, depth) {
         'expression_switch_statement',
         'type_switch_statement',
         'select_statement',
-        'block',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-java.js

@@ -387,7 +387,6 @@ function _maxNesting(node, depth) {
         'enhanced_for_statement',
         'while_statement',
         'switch_expression',
-        'block',
         'try_statement',
     ]);
     let max = depth;

package/dist/lib/core/ast/lang-javascript.js

@@ -204,7 +204,6 @@ function _maxNesting(node, depth) {
         'for_in_statement',
         'while_statement',
         'switch_statement',
-        'statement_block',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-objc.js

@@ -312,7 +312,6 @@ function _maxNesting(node, depth) {
         'for_in_statement',
         'while_statement',
         'switch_statement',
-        'compound_statement',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-python.js

@@ -330,7 +330,6 @@ function _maxNesting(node, depth) {
         'while_statement',
         'with_statement',
         'try_statement',
-        'block',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-rust.js

@@ -641,7 +641,6 @@ function _maxNesting(node, depth) {
         'while_let_expression',
         'loop_expression',
         'match_expression',
-        'block',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-swift.js

@@ -249,7 +249,6 @@ function _maxNesting(node, depth) {
         'for_in_statement',
         'while_statement',
         'switch_statement',
-        'compound_statement',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

package/dist/lib/core/ast/lang-typescript.js

@@ -663,7 +663,6 @@ function _maxNesting(node, depth) {
         'for_in_statement',
         'while_statement',
         'switch_statement',
-        'statement_block',
     ]);
     let max = depth;
     const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;

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[][];
 /**

package/dist/lib/domain/dimension/DimensionRegistry.js

@@ -145,7 +145,7 @@ const D7_NETWORKING_API = {
     weight: 0.7,
     suggestedTopics: ['api-contract', 'retry-strategy', 'request-pattern'],
     relatedRoles: ['networking'],
-    tierHint: 3,
+    tierHint: 2,
     displayGroup: 'data-event-flow',
 };
 const D8_UI_INTERACTION = {
@@ -163,7 +163,7 @@ const D8_UI_INTERACTION = {
     weight: 0.7,
     suggestedTopics: ['component-pattern', 'lifecycle', 'navigation'],
     relatedRoles: ['ui', 'feature'],
-    tierHint: 3,
+    tierHint: 4,
     displayGroup: 'architecture',
 };
 const D9_TESTING_QUALITY = {
@@ -181,7 +181,7 @@ const D9_TESTING_QUALITY = {
     weight: 0.9,
     suggestedTopics: ['unit-test', 'mock-strategy', 'ci-cd'],
     relatedRoles: [],
-    tierHint: 3,
+    tierHint: 4,
     displayGroup: 'best-practice',
 };
 const D10_SECURITY_AUTH = {
@@ -199,7 +199,7 @@ const D10_SECURITY_AUTH = {
     weight: 1.0,
     suggestedTopics: ['authentication', 'authorization', 'encryption'],
     relatedRoles: ['networking', 'service'],
-    tierHint: 3,
+    tierHint: 4,
     displayGroup: 'best-practice',
 };
 const D11_PERFORMANCE_OPTIMIZATION = {
@@ -217,7 +217,7 @@ const D11_PERFORMANCE_OPTIMIZATION = {
     weight: 0.8,
     suggestedTopics: ['memory-management', 'lazy-loading', 'rendering'],
     relatedRoles: ['ui', 'storage'],
-    tierHint: 3,
+    tierHint: 5,
     displayGroup: 'data-event-flow',
 };
 const D12_OBSERVABILITY_LOGGING = {
@@ -235,7 +235,7 @@ const D12_OBSERVABILITY_LOGGING = {
     weight: 0.7,
     suggestedTopics: ['logging-standard', 'event-tracking', 'diagnostics'],
     relatedRoles: ['service', 'core'],
-    tierHint: 3,
+    tierHint: 5,
     displayGroup: 'data-event-flow',
 };
 const D13_AGENT_GUIDELINES = {
@@ -253,7 +253,7 @@ const D13_AGENT_GUIDELINES = {
     weight: 0.6,
     suggestedTopics: ['constraints', 'deprecated-api', 'agent-rules'],
     relatedRoles: [],
-    tierHint: 3,
+    tierHint: 5,
     displayGroup: 'best-practice',
 };
 // ═══════════════════════════════════════════════════════════
@@ -569,28 +569,24 @@ export function resolveActiveDimensions(primaryLang, detectedFrameworks = []) {
 /**
  * 构建 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 function buildTierPlan(activeDims = DIMENSION_REGISTRY) {
-    const tier1 = [];
-    const tier2 = [];
-    const tier3 = [];
+    const tierMap = new Map();
     for (const dim of activeDims) {
         const hint = dim.tierHint ?? 3;
-        if (hint === 1) {
-            tier1.push(dim.id);
-        }
-        else if (hint === 2) {
-            tier2.push(dim.id);
-        }
-        else {
-            tier3.push(dim.id);
+        if (!tierMap.has(hint)) {
+            tierMap.set(hint, []);
         }
+        tierMap.get(hint).push(dim.id);
     }
-    return [tier1, tier2, tier3].filter((t) => t.length > 0);
+    // 按 tier 编号升序排列，过滤空层
+    return [...tierMap.entries()].sort(([a], [b]) => a - b).map(([, dims]) => dims);
 }
 /**
  * 将 Recipe 分类到最匹配的维度

package/dist/lib/external/ai/AiFactory.d.ts

@@ -27,10 +27,23 @@ export declare function isGeoOrProviderError(err: unknown): boolean;
  * 当主 provider 调用失败（地理限制等）时自动切换到备选 provider
  */
 export declare function getProviderWithFallback(): Promise<ClaudeProvider | GoogleGeminiProvider | MockProvider | OpenAiProvider | null>;
+/**
+ * 创建独立的 Embedding Provider
+ *
+ * 当 ASD_EMBED_PROVIDER 被设置时，创建一个专用于 embedding 的 provider 实例，
+ * 使 embedding 和 LLM 生成可以使用不同的提供商/模型。
+ *
+ * 典型场景：LLM 用 Google Gemini，Embedding 用本地 Ollama + qwen3-embedding
+ *
+ * @returns 独立的 embed provider，或 null（未配置时）
+ */
+export declare function createEmbedProvider(): ReturnType<typeof createProvider> | null;
 /** 获取当前 AI 配置信息（同步，用于 UI 展示） */
 export declare function getAiConfigInfo(): {
     provider: string;
     model: string;
+    embedProvider: string;
+    embedModel: string;
     hasKey: boolean;
     keys: {
         google: boolean;
@@ -46,6 +59,7 @@ export { MockProvider } from './providers/MockProvider.js';
 export { OpenAiProvider } from './providers/OpenAiProvider.js';
 declare const _default: {
     createProvider: typeof createProvider;
+    createEmbedProvider: typeof createEmbedProvider;
     autoDetectProvider: typeof autoDetectProvider;
     getAiConfigInfo: typeof getAiConfigInfo;
     getProviderWithFallback: typeof getProviderWithFallback;