codebuddy跨文件重构需手动@引用关键文件并分阶段固化上下文。每条指令开头必须显式注入@/src/service/vesselrouteservice.java等路径，多文件用空格分隔；子阶段结束执行codebuddy context save --as tide-module固化快照，后续用@tide-module调用；启用session start --timeout 3600或attach --editor vscode保持上下文连续，禁用--no-prune防自动清理；通过context status和dump验证上下文有效性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在执行跨文件、多步骤、带事务约束的复杂重构任务时，CodeBuddy会因上下文缓存失效、语义漂移或交互中断导致AI“忘记”你刚确认的接口签名、事务边界或模块职责划分，最终生成断裂引用、破坏事务传播或遗漏依赖更新的代码。
用对话层@引用锁定关键上下文
每次发送新指令前，必须显式注入当前任务最核心的上下文单元，不能依赖历史消息自动延续。
输入@/src/service/VesselRouteService.java，CodeBuddy立即读取该文件全文并序列化为文本追加进本次请求上下文。
若需同时锁定事务配置与数据源定义，追加输入@/src/main/resources/application.yml @/build.gradle——多个@引用用空格分隔，系统按顺序加载。
【务必在每条重构指令开头都重新@关键文件】，因为@引用仅对当前消息生效，下一条指令若未重复，AI将完全丢失此前所有文件内容。
分阶段固化上下文边界
将一个大重构任务拆解为逻辑闭环的子阶段，每个阶段结束时主动固化成果，防止后续步骤污染前期上下文。
第一步：运行codebuddy code --refactor "提取VesselRouteService中潮汐校验逻辑为独立TideSafetyService"。
第二步：确认diff预览无误后，立刻执行codebuddy context save --as tide-module，将本次重构产生的新模块结构、接口签名、Spring Bean声明全部打包为命名上下文快照。
第三步：后续执行调度逻辑拆分时，直接输入@tide-module调用已固化结构，避免重复解析或误读旧代码。
这一步不可跳过——未固化的上下文在90秒无操作后自动蒸发，且无法跨CLI进程复用。
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 问题
用CLI参数强制保持上下文连续性
方法一：启用长会话模式
在项目根目录执行codebuddy session start --timeout 3600，将上下文TTL从默认90秒延长至1小时，适用于需人工逐行确认的高风险重构。
方法二：绑定当前编辑状态
在VS Code中安装CodeBuddy插件后，执行codebuddy attach --editor vscode，CLI自动同步编辑器光标位置、打开文件及选中代码块，实现IDE与CLI上下文双向锁定。
【禁用自动清理】启动会话时务必添加--no-prune参数，否则CLI会在每次命令后自动剔除未被@引用的旧上下文，导致跨步骤依赖断裂。
实时验证上下文有效性
任何时候怀疑上下文已丢失，立即运行codebuddy context status。
查看输出中的Cache Hit Rate值——若低于85%，说明缓存失效严重，需重新注入核心文件。
检查Active Context Files列表是否包含你刚刚@过的文件路径，缺失即表示注入失败，常见原因是路径拼写错误或文件权限不足。
运行codebuddy context dump --last可导出最近一次请求的实际上下文文本，直接验证AI“看到”的内容是否与你预期一致。
