feihong-code 0.2.3 → 0.6.0

package/dist/agent/self-improver.js

@@ -6,18 +6,20 @@ exports.createSelfImprover = createSelfImprover;
  * 飞虹 Code (Muse Code 参照复刻)
  * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
  *
- * 自我改进（M8）：
- * - 任务后反思：提取成功/失败模式
- * - 策略优化：基于历史表现调整行为
- * - 经验融合：将反思结果注入经验库
+ * 自我改进（M6 / 自我迭代核心）：
+ * - 任务后反思：从真实对话中统计工具调用、错误簇、自愈恢复，产出具体模式与改进
+ * - 经验融合：将反思结果以「稳定 id + upsert」写入与 orchestrator 同一套 experiences 库，
+ *   使自我迭代真正回流到后续任务（闭合环），而非写入互不相连的孤岛目录
+ * - 人类可读账本：另存 improvements.json 供 self-improve 命令展示
  */
 const fs_1 = require("fs");
 const path_1 = require("path");
+const os_1 = require("os");
 const experience_1 = require("./experience");
 const DEFAULT_CONFIG = {
     reflectionEnabled: true,
     maxPatternsPerTask: 5,
-    experienceDir: (0, path_1.join)(require('os').homedir(), '.feihong-code', 'improvements'),
+    experienceDir: (0, path_1.join)((0, os_1.homedir)(), '.feihong-code', 'experiences'),
 };
 class SelfImprover {
     config;
@@ -25,18 +27,57 @@ class SelfImprover {
     constructor(config = {}) {
         this.config = { ...DEFAULT_CONFIG, ...config };
     }
-    /** 任务后反思 */
-    reflect(messages, success, durationMs) {
-        const patterns = this.extractPatterns(messages, success);
-        const improvements = this.generateImprovements(messages, success, patterns);
-        const strategyChanges = this.deriveStrategyChanges(patterns, improvements);
+    /** 经验库目录（与 orchestrator 共用，供命令层展示） */
+    get experienceStoreDir() {
+        return this.config.experienceDir;
+    }
+    /** 任务后反思（基于真实对话内容分析，异步持久化到统一经验库） */
+    async reflect(messages, success, durationMs) {
+        const toolCalls = messages
+            .filter((m) => m.role === 'assistant' && m.toolCalls)
+            .flatMap((m) => m.toolCalls ?? []);
+        const errors = messages.filter((m) => m.role === 'tool' && (m.content || '').startsWith('错误:'));
+        const hasSelfHeal = errors.length > 0 &&
+            messages.some((m) => m.role === 'assistant' && /修复|已修复|解决|resolved|fixed|通过验证|验证通过/i.test(m.content || ''));
+        // 模式提取（具体、可观测）
+        const patterns = [];
+        if (success)
+            patterns.push('任务成功完成，核心策略有效');
+        else
+            patterns.push('任务未达成，需调整策略');
+        if (toolCalls.length >= 3)
+            patterns.push(`工具调用高频(${toolCalls.length}次)，注意批次化与最小改动`);
+        if (errors.length > 0)
+            patterns.push(`出现 ${errors.length} 处工具错误，需增强前置校验`);
+        if (hasSelfHeal)
+            patterns.push('发生自愈并恢复，闭环修复有效');
+        // 改进建议（针对性）
+        const improvements = [];
+        if (!success) {
+            improvements.push('复盘失败任务：定位首个错误根因，先最小化复现再修复');
+            improvements.push('考虑将大目标拆为更小、可独立验证的子任务');
+        }
+        if (errors.length > 0)
+            improvements.push('为高频错误类型补充前置校验，减少运行时失败');
+        if (toolCalls.length >= 5)
+            improvements.push('工具调用偏多，先勘察再动手可减少往返轮次');
+        if (improvements.length === 0)
+            improvements.push('维持当前执行节奏，持续监控工具效率');
+        // 策略变化
+        const strategyChanges = [];
+        if (errors.length > 0)
+            strategyChanges.push('增强错误检测与前置校验');
+        if (hasSelfHeal)
+            strategyChanges.push('固化自愈闭环为默认行为');
+        if (strategyChanges.length === 0)
+            strategyChanges.push('保持当前策略');
         const result = {
             success,
             patterns: patterns.slice(0, this.config.maxPatternsPerTask),
             improvements,
             strategyChanges,
         };
-        // 保存反思记录
+        // 内存账本
         this.improvements.push({
             timestamp: new Date().toISOString(),
             success,
@@ -44,26 +85,33 @@ class SelfImprover {
             patterns: result.patterns,
             improvements: result.improvements,
         });
-        // 写入经验库
+        // 写入统一经验库（与 orchestrator 共用，实现回流）
         if (this.config.reflectionEnabled) {
+            const key = `reflect:${result.patterns.slice(0, 2).join('|')}`;
             const exp = {
-                id: `improvement-${Date.now()}`,
+                id: (0, experience_1.normalizeExperienceId)(success ? 'success-pattern' : 'error-pattern', key),
                 type: success ? 'success-pattern' : 'error-pattern',
-                title: success ? '成功模式提取' : '失败模式分析',
-                content: result.improvements.join('\n'),
+                title: success ? '成功模式反思' : '失败模式反思',
+                content: `反思结论:\n${result.improvements.join('\n')}\n策略变化: ${result.strategyChanges.join('; ')}`,
                 metadata: {
                     successRate: success ? 1.0 : 0.0,
                     sessionCount: 1,
-                    tags: result.patterns.slice(0, 3),
+                    tags: result.patterns.slice(0, 3).map((p) => p.replace(/[^\p{L}\p{N}]/gu, '').slice(0, 12)),
                     createdAt: new Date().toISOString(),
                     lastUsedAt: new Date().toISOString(),
                 },
             };
             (0, fs_1.mkdirSync)(this.config.experienceDir, { recursive: true });
-            (0, experience_1.saveExperience)(this.config.experienceDir, exp).catch(() => { });
+            await (0, experience_1.upsertExperience)(this.config.experienceDir, exp);
+            this.saveImprovements(this.improvements);
         }
         return result;
     }
+    /** 基于目标召回既往学习，生成注入模型的「学习提示」 */
+    async getLearnedPrompt(goal) {
+        const exps = await (0, experience_1.retrieveRelevantExperiences)(this.config.experienceDir, goal);
+        return (0, experience_1.generateExperiencePrompt)(exps);
+    }
     /** 加载历史改进记录 */
     loadImprovements() {
         const file = (0, path_1.join)(this.config.experienceDir, 'improvements.json');
@@ -95,50 +143,6 @@ class SelfImprover {
             avgDurationMs: avgDuration,
         };
     }
-    extractPatterns(_messages, success) {
-        const patterns = [];
-        // 成功/失败模式
-        if (success) {
-            patterns.push('任务成功完成，策略有效');
-        }
-        else {
-            patterns.push('任务未完成，需要调整策略');
-        }
-        return patterns;
-    }
-    generateImprovements(_messages, success, patterns) {
-        const improvements = [];
-        if (!success) {
-            improvements.push('失败任务：检查错误分类并重试');
-            improvements.push('失败任务：考虑简化目标或分解子任务');
-        }
-        // 基于模式生成改进建议
-        for (const pattern of patterns) {
-            if (pattern.includes('工具') && pattern.includes('高频')) {
-                improvements.push('高频工具调用：考虑批量操作优化');
-            }
-            if (pattern.includes('错误')) {
-                improvements.push('错误模式：增加前置校验减少运行时错误');
-            }
-        }
-        if (improvements.length === 0) {
-            improvements.push('持续监控工具调用效率');
-        }
-        return improvements;
-    }
-    deriveStrategyChanges(patterns, improvements) {
-        const changes = [];
-        if (patterns.some((p) => p.includes('错误模式'))) {
-            changes.push('增强错误检测机制');
-        }
-        if (improvements.some((i) => i.includes('批量操作'))) {
-            changes.push('优化工具调用批次');
-        }
-        if (changes.length === 0) {
-            changes.push('保持当前策略');
-        }
-        return changes;
-    }
 }
 exports.SelfImprover = SelfImprover;
 /** 便捷函数 */

package/dist/agent/self-improver.js.map

@@ -1 +1 @@
-{"version":3,"file":"self-improver.js","sourceRoot":"","sources":["../../src/agent/self-improver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"self-improver.js","sourceRoot":"","sources":["../../src/agent/self-improver.ts"],"names":[],"mappings":"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"}

package/dist/agent/subagent-summary.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * 飞虹 Code (Muse Code 参照复刻)
+ * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+ *
+ * P2-2 子代理结果摘要（对齐 Claude Code subagents：只回摘要+元数据，
+ * 隔离中间结果，避免大输出撑爆主上下文）。
+ *
+ * 策略：保留首部关键信息（做什么/验证什么），超长截断并标注；同时输出
+ * 结构化元数据（字符数/截断标记），供上层报告或审计使用。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUBAGENT_SUMMARY_MAX = void 0;
+exports.summarizeSubTaskAnswer = summarizeSubTaskAnswer;
+/** 子代理结果摘要：默认保留长度 */
+exports.SUBAGENT_SUMMARY_MAX = 600;
+/**
+ * 摘要化子任务最终答案：
+ *  - ≤ max 直接返回原文
+ *  - > max 保留首部，尾部追加截断标注（含原始长度），不丢"做了什么"的语义
+ */
+function summarizeSubTaskAnswer(answer, max = exports.SUBAGENT_SUMMARY_MAX) {
+    const originalLength = answer.length;
+    if (answer.length <= max) {
+        return { text: answer, originalLength, truncated: false };
+    }
+    const head = answer.slice(0, max);
+    const tail = `\n…（已截断，原文 ${originalLength} 字符）`;
+    return { text: head + tail, originalLength, truncated: true };
+}
+//# sourceMappingURL=subagent-summary.js.map

package/dist/agent/subagent-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-summary.js","sourceRoot":"","sources":["../../src/agent/subagent-summary.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAmBH,wDAQC;AAzBD,qBAAqB;AACR,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAWxC;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,MAAc,EAAE,GAAG,GAAG,4BAAoB;IAC/E,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,cAAc,cAAc,MAAM,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAChE,CAAC"}

package/dist/agent/subagent.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SUBAGENT_DEPTH = void 0;
 exports.runSubAgent = runSubAgent;
 /**
  * 飞虹 Code (Muse Code 参照复刻)
@@ -11,6 +12,7 @@ exports.runSubAgent = runSubAgent;
  */
 const crypto_1 = require("crypto");
 const path_1 = require("path");
+const fs_1 = require("fs");
 const logger_1 = require("../shared/logger");
 const model_router_1 = require("../models/model-router");
 const mock_provider_1 = require("../models/providers/mock.provider");
@@ -18,10 +20,57 @@ const tools_1 = require("../tools");
 const event_log_1 = require("../runtime/event-log");
 const session_store_1 = require("../runtime/session-store");
 const orchestrator_1 = require("./orchestrator");
+const planner_1 = require("./planner");
+const subagent_summary_1 = require("./subagent-summary");
+/** P3-4：子代理最大嵌套深度（对齐 Claude subagents，默认 3 层） */
+exports.MAX_SUBAGENT_DEPTH = 3;
 async function runSubAgent(deps) {
-    const { worktree, goal, router, offline, security, approve, mockSteps } = deps;
+    const { worktree, goal, router, offline, security, approve, mockSteps, tags } = deps;
+    const depth = deps.depth ?? 1;
+    const maxDepth = deps.maxDepth ?? exports.MAX_SUBAGENT_DEPTH;
     const runId = (0, crypto_1.randomUUID)();
     (0, logger_1.setRunId)(runId);
+    // P3-4：深度未达上限且目标可拆解 → 递归派生子代理（子目录隔离，不建 git worktree）
+    if (depth < maxDepth) {
+        const subtasks = (0, planner_1.decomposeGoal)(goal);
+        if (subtasks.length > 1) {
+            logger_1.logger.info('subagent nesting', { runId, depth, children: subtasks.length, goal });
+            const parts = [];
+            let okAll = true;
+            let iterations = 0;
+            for (const st of subtasks) {
+                const subDir = (0, path_1.join)(worktree.path, `.sub-${st.id}`);
+                (0, fs_1.mkdirSync)(subDir, { recursive: true });
+                const child = await runSubAgent({
+                    worktree: { path: subDir, branch: `${worktree.branch}/${st.id}` },
+                    goal: st.goal,
+                    router,
+                    offline,
+                    security,
+                    approve,
+                    mockSteps,
+                    tags,
+                    depth: depth + 1,
+                    maxDepth,
+                });
+                iterations += child.iterations;
+                okAll = okAll && child.ok;
+                // 逐层摘要：只把子代理的摘要结果带回上层上下文，隔离中间大输出
+                const s = (0, subagent_summary_1.summarizeSubTaskAnswer)(child.finalAnswer);
+                parts.push(`[${st.id}] ${s.text}`);
+            }
+            const finalAnswer = parts.join('\n');
+            const result = {
+                ok: okAll,
+                finalAnswer,
+                iterations,
+                costUsd: 0,
+                logFile: '',
+                runId,
+            };
+            return { ...result, worktree, subGoal: goal };
+        }
+    }
     const effectiveRouter = offline
         ? new model_router_1.ModelRouter([new mock_provider_1.ScriptedMockProvider(mockSteps ?? defaultSubMock(goal))], 'cost', 0)
         : router;
@@ -40,8 +89,9 @@ async function runSubAgent(deps) {
         cwd: worktree.path,
         security: sec,
         approve,
+        tags,
     });
-    logger_1.logger.info('subagent start', { runId, worktree: worktree.path, goal });
+    logger_1.logger.info('subagent start', { runId, worktree: worktree.path, goal, depth });
     const result = await orch.run(goal);
     return { ...result, worktree, subGoal: goal };
 }

package/dist/agent/subagent.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../src/agent/subagent.ts"],"names":[],"mappings":";;AAoCA,kCA8BC;AAlED;;;;;;;GAOG;AACH,mCAAoC;AACpC,+BAA4B;AAC5B,6CAAoD;AACpD,yDAAqD;AACrD,qEAAwF;AACxF,oCAAiD;AACjD,oDAAgD;AAChD,4DAAwD;AACxD,iDAAyF;AAoBlF,KAAK,UAAU,WAAW,CAAC,IAAkB;IAClD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC/E,MAAM,KAAK,GAAG,IAAA,mBAAU,GAAE,CAAC;IAC3B,IAAA,iBAAQ,EAAC,KAAK,CAAC,CAAC;IAEhB,MAAM,eAAe,GAAG,OAAO;QAC7B,CAAC,CAAC,IAAI,0BAAW,CAAC,CAAC,IAAI,oCAAoB,CAAC,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3F,CAAC,CAAC,MAAM,CAAC;IAEX,MAAM,GAAG,GAAyB,QAAQ,IAAI;QAC5C,cAAc,EAAE,EAAE;QAClB,eAAe,EAAE,IAAI;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,IAAA,6BAAqB,GAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAAC,KAAK,EAAE,IAAA,WAAI,EAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAI,4BAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEvD,MAAM,IAAI,GAAG,IAAI,2BAAY,CAAC;QAC5B,MAAM,EAAE,eAAe;QACvB,KAAK;QACL,QAAQ;QACR,OAAO;QACP,GAAG,EAAE,QAAQ,CAAC,IAAI;QAClB,QAAQ,EAAE,GAAG;QACb,OAAO;KACR,CAAC,CAAC;IAEH,eAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,wCAAwC;AACxC,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAClC,OAAO;QACL;YACE,OAAO,EAAE;gBACP,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE;oBACT;wBACE,EAAE,EAAE,IAAI;wBACR,IAAI,EAAE,YAAY;wBAClB,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE;qBACvD;iBACF;aACF;SACF;QACD,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE,EAAE,EAAE;KACzE,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,CAAS;IACrB,OAAO,CACL,CAAC;SACE,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAC1B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../src/agent/subagent.ts"],"names":[],"mappings":"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"}

package/dist/agent/symbol-index.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSymbols = extractSymbols;
+exports.scanDirectory = scanDirectory;
+exports.buildSymbolIndex = buildSymbolIndex;
+exports.cacheFile = cacheFile;
+exports.cacheSymbolIndex = cacheSymbolIndex;
+exports.loadCachedSymbolIndex = loadCachedSymbolIndex;
+exports.findSymbol = findSymbol;
+exports.symbolsForFile = symbolsForFile;
+exports.indexStats = indexStats;
+/**
+ * 飞虹 Code (Muse Code 参照复刻)
+ * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+ *
+ * P5-5 轻量语义索引（对齐 Cursor 项目级索引的轻量实现）：
+ *  - 正则级符号提取（函数/类/接口/const/type），零依赖、跨语言
+ *  - 磁盘缓存（FH_HOME/symbol-index.json），重复扫描免开销
+ *  - 查询：按符号名 / 按文件定位定义位置
+ *  - 用途：/grill 审查聚焦、swe 规划定位目标文件、refactor 影响面
+ *
+ * 注意：这是"轻量"索引（正则近似），非完整 AST 语义；但足以支撑
+ * 符号定位与影响面估算，性价比远高于全量解析。
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+/** 支持的语言扩展（正则近似） */
+const SUPPORTED_EXT = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs']);
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'out', 'coverage', '.workbuddy']);
+/** 从单文件内容提取符号（多行正则逐行扫描） */
+function extractSymbols(content, file) {
+    const out = [];
+    const lines = content.split('\n');
+    // 顺序敏感：先 interface/class 再 function/const，避免误吞
+    const patterns = [
+        { kind: 'interface', re: /^(?:export\s+)?(?:declare\s+)?interface\s+([A-Za-z_$][\w$]*)/ },
+        { kind: 'class', re: /^(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/ },
+        { kind: 'function', re: /^(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/ },
+        { kind: 'const', re: /^(?:export\s+)?const\s+([A-Za-z_$][\w$]*)\s*=/ },
+        { kind: 'type', re: /^(?:export\s+)?type\s+([A-Za-z_$][\w$]*)\s*=/ },
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        // 跳过注释与字符串行（近似）
+        if (line.startsWith('//') || line.startsWith('*') || line.startsWith('/*'))
+            continue;
+        for (const { kind, re } of patterns) {
+            const m = re.exec(line);
+            if (m) {
+                out.push({ name: m[1], kind, file, line: i + 1 });
+                break; // 每行只记一个符号
+            }
+        }
+    }
+    return out;
+}
+/** 递归扫描目录并提取全部符号（跳过 node_modules/.git 等） */
+function scanDirectory(root, maxFiles = 2000) {
+    const symbols = [];
+    let count = 0;
+    const walk = (d) => {
+        if (count >= maxFiles)
+            return;
+        let entries;
+        try {
+            entries = (0, fs_1.readdirSync)(d);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (count >= maxFiles)
+                return;
+            const abs = (0, path_1.join)(d, entry);
+            let stat;
+            try {
+                stat = (0, fs_1.statSync)(abs);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                if (SKIP_DIRS.has(entry))
+                    continue;
+                walk(abs);
+            }
+            else if (SUPPORTED_EXT.has((0, path_1.extname)(entry).toLowerCase()) && !entry.endsWith('.d.ts')) {
+                count++;
+                try {
+                    const content = (0, fs_1.readFileSync)(abs, 'utf8');
+                    const rel = (0, path_1.relative)(root, abs).replace(/\\/g, '/');
+                    symbols.push(...extractSymbols(content, rel));
+                }
+                catch {
+                    /* 二进制/不可读跳过 */
+                }
+            }
+        }
+    };
+    walk(root);
+    return symbols;
+}
+/** 构建符号索引 */
+function buildSymbolIndex(root, opts = {}) {
+    return {
+        root: (0, path_1.resolve)(root),
+        builtAt: new Date().toISOString(),
+        symbols: scanDirectory((0, path_1.resolve)(root), opts.maxFiles),
+    };
+}
+/** 缓存文件路径（固定放用户主目录，避免仓库内写缓存；尊重 FH_HOME） */
+function cacheFile() {
+    const base = process.env.FH_HOME?.trim() || (0, path_1.join)((0, os_1.homedir)(), '.feihong-code');
+    return (0, path_1.join)(base, 'symbol-index.json');
+}
+/** 写缓存 */
+function cacheSymbolIndex(index) {
+    try {
+        const file = cacheFile();
+        (0, fs_1.mkdirSync)((0, path_1.join)(file, '..'), { recursive: true });
+        (0, fs_1.writeFileSync)(file, JSON.stringify(index), 'utf8');
+    }
+    catch {
+        /* 缓存失败不影响使用 */
+    }
+}
+/** 读缓存（根路径匹配才返回） */
+function loadCachedSymbolIndex(root) {
+    try {
+        const file = cacheFile();
+        if (!(0, fs_1.existsSync)(file))
+            return null;
+        const parsed = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+        return parsed && parsed.root === (0, path_1.resolve)(root) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 按符号名精确查找（全索引） */
+function findSymbol(index, name) {
+    return index.symbols.filter((s) => s.name === name);
+}
+/** 按文件列出符号 */
+function symbolsForFile(index, file) {
+    const f = file.replace(/\\/g, '/');
+    return index.symbols.filter((s) => s.file === f);
+}
+/** 文件数量与符号数量（诊断/展示用） */
+function indexStats(index) {
+    const byKind = {};
+    const files = new Set();
+    for (const s of index.symbols) {
+        files.add(s.file);
+        byKind[s.kind] = (byKind[s.kind] ?? 0) + 1;
+    }
+    return { files: files.size, symbols: index.symbols.length, byKind };
+}
+//# sourceMappingURL=symbol-index.js.map

package/dist/agent/symbol-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-index.js","sourceRoot":"","sources":["../../src/agent/symbol-index.ts"],"names":[],"mappings":";;AAsCA,wCAwBC;AAGD,sCAuCC;AAGD,4CAMC;AAGD,8BAGC;AAGD,4CAQC;AAGD,sDASC;AAGD,gCAEC;AAGD,wCAGC;AAGD,gCAQC;AApKD;;;;;;;;;;;;GAYG;AACH,2BAA+F;AAC/F,+BAAwD;AACxD,2BAA6B;AAkB7B,oBAAoB;AACpB,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;AAEtG,2BAA2B;AAC3B,SAAgB,cAAc,CAAC,OAAe,EAAE,IAAY;IAC1D,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,+CAA+C;IAC/C,MAAM,QAAQ,GAA4C;QACxD,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,8DAA8D,EAAE;QACzF,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,2DAA2D,EAAE;QAClF,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,2DAA2D,EAAE;QACrF,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,+CAA+C,EAAE;QACtE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,8CAA8C,EAAE;KACrE,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,gBAAgB;QAChB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACrF,KAAK,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,QAAQ,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,EAAE,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAClD,MAAM,CAAC,WAAW;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4CAA4C;AAC5C,SAAgB,aAAa,CAAC,IAAY,EAAE,QAAQ,GAAG,IAAI;IACzD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,CAAC,CAAS,EAAQ,EAAE;QAC/B,IAAI,KAAK,IAAI,QAAQ;YAAE,OAAO;QAC9B,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,IAAA,gBAAW,EAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,IAAI,QAAQ;gBAAE,OAAO;YAC9B,MAAM,GAAG,GAAG,IAAA,WAAI,EAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,IAAI,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,GAAG,IAAA,aAAQ,EAAC,GAAG,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACnC,IAAI,CAAC,GAAG,CAAC,CAAC;YACZ,CAAC;iBAAM,IAAI,aAAa,CAAC,GAAG,CAAC,IAAA,cAAO,EAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvF,KAAK,EAAE,CAAC;gBACR,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC1C,MAAM,GAAG,GAAG,IAAA,eAAQ,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBACpD,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;gBAChD,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,aAAa;AACb,SAAgB,gBAAgB,CAAC,IAAY,EAAE,OAA8B,EAAE;IAC7E,OAAO;QACL,IAAI,EAAE,IAAA,cAAO,EAAC,IAAI,CAAC;QACnB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACjC,OAAO,EAAE,aAAa,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,SAAgB,SAAS;IACvB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,eAAe,CAAC,CAAC;IAC7E,OAAO,IAAA,WAAI,EAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AACzC,CAAC;AAED,UAAU;AACV,SAAgB,gBAAgB,CAAC,KAAkB;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;QACzB,IAAA,cAAS,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IAAA,kBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC;AAED,oBAAoB;AACpB,SAAgB,qBAAqB,CAAC,IAAY;IAChD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAgB,CAAC;QACrE,OAAO,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,oBAAoB;AACpB,SAAgB,UAAU,CAAC,KAAkB,EAAE,IAAY;IACzD,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,cAAc;AACd,SAAgB,cAAc,CAAC,KAAkB,EAAE,IAAY;IAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,wBAAwB;AACxB,SAAgB,UAAU,CAAC,KAAkB;IAC3C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;AACtE,CAAC"}