CodeBuddy通过三步建立代码库全局感知：先解析工程配置文件确定索引范围，再分层切片并生成多级向量表示，最后构建含隐式依赖的跨文件图谱；日志处理依时间戳重排序并启用状态机锚定上下文；Excel解构则基于空间拓扑识别语义区块、推断逻辑关系、绑定单元格角色到执行约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想搞清楚CodeBuddy在面对一段代码、一个日志文件或一份Excel表格时，到底怎么“看懂”它、怎么决定下一步该做什么、又怎么把零散信息拼成完整结论——不是泛泛而谈AI很聪明，而是要还原它内部真实的数据流动路径与决策触发条件。
CodeBuddy如何建立对代码库的“全局感知”
第一步：启动Codebase索引进程。当你首次在VS Code中启用CodeBuddy并打开一个项目时，它不会立刻扫描全部文件，而是先读取package.json、pyproject.toml或pom.xml等工程描述文件，识别语言栈、依赖关系和入口点——这一步决定了后续向量化范围，跳过node_modules或__pycache__目录是默认行为，但【若项目根目录下缺少任何工程配置文件，Codebase将退化为纯文件名+扩展名粗筛，语义理解能力下降70%以上】。
第二步：分层切片与向量化。它把代码库按函数→类→模块→包四级结构切片，每个函数被提取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关系链用于后续因果推演。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二：状态机驱动的上下文锚定
它会自动识别日志中的状态关键词（如“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。后续所有对该单元格的读写操作，都会强制校验是否符合该角色约束——比如不允许在此单元格填入非布尔值，也不允许删除其所在整行。
