调试codebuddy接口时需彻底清空对话历史以清除残留@引用，精准注入当前接口定义或终端响应，并禁用自动加载过时配置文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调试CodeBuddy接口时，若AI反复引用旧日志、已删除的测试文件或过期配置，导致生成错误请求体或忽略当前API规范，说明无关上下文正在干扰推理过程。
清理对话层残留引用
每次调试新接口前，必须清空上一轮手动注入的上下文，否则@符号带入的废弃文件会持续污染后续请求。
在CodeBuddy侧边栏对话框顶部，点击「清除对话」按钮（垃圾桶图标）→ 确认清空全部历史消息。
【注意：此操作不可逆，所有对话记录与缓存上下文将被彻底删除】
不要仅靠滚动删除单条消息——残留的@引用仍保留在底层上下文窗口中，只有全量清除才能释放Token并重置引用状态。
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 问题
精准注入当前接口上下文
避免把整个src/api目录拖进对话框。CodeBuddy会无差别加载所有文件，导致关键信息被淹没。
方法一：只引用目标接口定义文件
打开你正在调试的API所在文件（如src/api/user.ts），选中export const getUser = ...整段函数声明 → 右键选择「@引用当前代码块」。
方法二：用@terminal注入实时响应
在终端执行curl -v http://localhost:3000/api/user → 复制完整输出（含HTTP头与body）→ 在CodeBuddy输入框中粘贴@terminal + 换行 + 粘贴内容。
这一步必须做：删掉@terminal后面自动生成的多余空行和换行符，否则CodeBuddy会把空白行识别为有效上下文，触发无效解析。
锁定项目层规则防止自动带入
CodeBuddy默认在对话启动时自动加载CODEBUDDY.md和package.json，但这两个文件若包含过时的API网关地址或废弃鉴权方式，会直接覆盖你手动注入的正确上下文。
第一步：检查项目根目录是否存在CODEBUDDY.md
第二步：若存在，打开它，确认其中baseURL、authType等字段与当前调试环境一致；不一致则临时重命名该文件为CODEBUDDY.md.bak。
第三步：进入CodeBuddy设置 → 「上下文管理」→ 关闭「自动加载项目配置文件」选项。
关闭后，CodeBuddy不再读取任何静态配置文件，所有上下文均由你主动控制，调试时不会突然冒出一个三个月前的mock服务地址。
