codebuddy长期记忆机制通过codebuddy.md和memory.md文件实现上下文自动加载与动态更新；需用yaml语法规范书写，依赖/init或自动加载触发，并通过/sync-memory同步新记录以避免重复解释。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在CodeBuddy中调试接口时反复解释请求头、鉴权方式、Mock规则或历史错误原因，本质是AI没记住你上一次会话里已经确认过的上下文——长期记忆机制正是为解决这个问题而存在，它让AI在新会话中自动加载项目级配置和调试经验，避免重复输入。
初始化项目记忆文件
第一步：在项目根目录下创建 【CodeBuddy.md】 文件，这是AI启动时自动读取的全局配置入口。没有这个文件，长期记忆就无法被触发。
第二步：往 CodeBuddy.md 中写入接口调试必需的上下文信息，例如：
```yaml
project: 订单中心微服务
tech_stack: Spring Cloud Gateway + Feign + JWT
auth_header: Authorization: Bearer {token}
mock_strategy: 本地启用 WireMock，/api/v1/order/** 路径走 mock，其余直连 dev 环境
common_errors:
- 401: token 过期 → 检查 token 有效期是否超 2h
- 403: 权限不足 → 验证角色 claim 是否含 ORDER_WRITE
```
这段内容不是注释，而是AI可解析的结构化记忆，必须用YAML语法，缩进错误会导致整个记忆加载失败。
让AI自动继承调试上下文
方法一：使用 /init 命令显式加载
在CodeBuddy聊天窗口输入 【/init】，AI会立即扫描当前项目下的 CodeBuddy.md 和 .codebuddy/MEMORY.md，并将其中定义的 auth_header、mock_strategy 等字段注入本次会话上下文。此后你只需说“调用 /api/v1/order/create”，AI就能自动带上正确的 Authorization 头和 mock 路由策略。
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 问题
方法二：依赖会话自动加载机制
只要当前工作目录包含 CodeBuddy.md，且你在CodeBuddy IDE中打开的是该项目的文件（如 OrderController.java），AI会在你首次发送消息时静默加载记忆——无需手动触发 /init，但前提是项目路径不能错，【绝对路径中不能含中文或空格】，否则记忆加载静默失败且无提示。
动态更新调试记忆
第一步：发现新错误模式后，立刻在 .codebuddy/MEMORY.md 中追加记录
比如刚遇到一次 504 网关超时，查明是下游库存服务响应 >3s 导致，就在 MEMORY.md 底部新增一行：
`2026-06-30: /api/v1/inventory/check 返回 504 → 添加 timeout=5000ms 到 FeignClient 配置`
第二步：执行 【/sync-memory】 命令强制刷新
AI不会实时监听文件变更，必须手动触发同步，否则新写的这条记忆要等到下次重启IDE才生效。这一步漏掉，你刚总结的踩坑经验就白写了。
第三步：验证记忆是否生效
直接问“上次遇到 /api/v1/inventory/check 的 504 是什么原因”，AI应准确复述你刚写入的 timeout 问题。如果回答模糊或错误，说明 .codebuddy/MEMORY.md 路径不对，或者文件编码不是 UTF-8 —— Windows 记事本默认保存为 ANSI，会破坏 YAML 解析。
