CodeBuddy通过三步建立对代码库的全局感知：首先解析工程配置文件以确定索引范围，其次进行分层切片并生成多级向量表示，最后构建包含隐式依赖的跨文件关系图谱；在日志处理场景中，它会基于时间戳进行事件重排序，并借助状态机完成上下文锚定；对于Excel表格，则通过空间拓扑识别语义区块、推断逻辑关系，并将单元格角色绑定到执行约束。

如果你想真正弄清楚CodeBuddy在面对一段程序代码、一个日志文件，或一份Excel表格时，究竟是如何“理解”内容、如何判断下一步执行策略、又如何把分散的信息整合为完整结论，那么重点就不只是“AI很智能”这种泛化说法，而是要还原它内部真实的数据处理链路与决策触发机制。

CodeBuddy如何建立对代码库的“全局感知”

第一步：启动Codebase索引流程。当你首次在VS Code中启用CodeBuddy并打开项目时，它不会马上扫描所有文件，而是优先读取package.json、pyproject.toml或pom.xml等工程配置文件，用来识别语言栈、依赖结构和入口点——这一步直接决定后续语义索引与向量化的覆盖范围。默认情况下，它会跳过node_modules或__pycache__目录；但【如果项目根目录缺少任何工程配置文件，Codebase会退化为基于文件名+扩展名的粗粒度筛选，语义理解能力将下降70%以上】。

第二步：执行分层切片与向量化建模。CodeBuddy会按照函数→类→模块→包四级结构对代码库进行切片，每个函数先提取AST节点序列，再通过轻量级编码器转换为512维向量；模块级向量则融合全部子函数向量以及调用图邻接矩阵特征，形成1024维表示；最终，整个包会聚合为2048维的架构级向量。这一过程并非一次性完成，而是通过后台异步、分批加载的方式持续构建，从而将内存占用峰值稳定控制在8GB以内。

第三步：构建跨文件依赖图谱。CodeBuddy并不依赖IDE自带的LSP服务完成符号解析，而是通过自研的SymbolLinker工具遍历所有import语句、反射调用，以及字符串拼接式路径引用（例如require(path + '/utils')），把隐式依赖同样纳入分析图谱之中。当你在聊天窗口提问“哪个服务调用了PaymentService.refund()”时，它就能够基于这张图谱反向追踪全部显式与隐式调用链，并进一步高亮展示调用深度和潜在风险等级。

日志与结构化数据的动态推理路径

方法一：基于时间戳的事件流重排序

当CodeBuddy接收到一段顺序混乱的日志文本时——例如你提供的流程引擎输出——它会先利用正则表达式逐一匹配所有符合ISO 8601格式的时间戳，并提取event_id、triggered_by、start_time、end_time这四个关键字段；随后进一步校验end_time是否严格晚于start_time，如果不满足条件，就会将该事件标记为“时间逻辑异常”；最后，它再按照start_time从早到晚重排全部事件，同时完整保留原始triggered_by关系链，为后续因果分析与问题定位打下基础。

方法二：状态机驱动的上下文锚定

它会自动识别日志中的状态关键词（如“INIT”“RUNNING”“COMPLETED”“FAILED”），并结合前后行的缩进、空行以及分隔符信息，构建临时状态转移图。例如，当连续三行都出现“COMPLETED”，但第四行突然切回“INIT”时，就会触发“状态回滚检测”——此时系统不再单纯依赖时间戳，而会转向分析事件ID的哈希前缀一致性、线程ID复用模式，以及父事件ID是否存在重复引用。

【注意：该模式仅在日志行数＞500且缺乏明确结构化Schema时启用；如果你已经提供JSON或CSV格式数据，它会跳过状态机分析，直接进入Schema Infer阶段】

Excel表格的语义解构机制

第一步：识别空间拓扑结构。CodeBuddy会把Excel表格视为一个二维坐标系，先定位所有合并单元格区域，并将其视作“语义区块”；随后扫描边框线型（实线/虚线）、填充色RGB值、字体加粗或斜体状态，生成每个区块的视觉特征向量。例如，一个带蓝色实线边框并配有浅灰填充的表头区块，会被标记为“主维度定义区”；而右侧没有边框、仅通过颜色区分的列，则会被归类为“动态属性扩展区”。

第二步：判断逻辑关系属于哪一种类型。这里关注的并不是单个单元格本身，而是单元格之间的相对位置关系，再结合内容呈现出的模式完成识别：如果同一行中左侧为名词、右侧为数值，就会被判定为“属性赋值”；如果连续多行的首列内容相同，而次列呈递增变化，则会被识别为“时间序列”；如果某一列中大量出现“→”或“⇒”这类符号，就会直接触发“因果链解析器”。你提供的“整体设计相关表格和内容.xlsx”中那个菱形六边形结构，本质上也是依赖这种空间关系识别，最终才被建模为“六粗拓扑模型”。

第三步：将表述习惯绑定到执行动作。当你在交互界面中点击某个单元格并输入“这是触发条件”时，CodeBuddy会把这次操作记录为cell:R3C5 → role:trigger_condition，并同步更新本地schema_rules.json。在此之后，所有针对该单元格的读写操作，都会被强制校验是否符合对应角色约束——例如不允许在该单元格中填入非布尔值，也不允许删除其所在的整行。