必须启用长期记忆并完成项目级上下文初始化，否则codebuddy每次新开会话都会重置；需开启「长期记忆」开关、执行/init指令生成codebuddy.md、手动或通过规则管理完善规范，并开启chronicle屏幕记忆以记录操作习惯。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让CodeBuddy在每次新开会话时自动记住你的项目技术栈、编码风格、常用命令和历史决策，必须启用长期记忆功能并完成项目级上下文初始化，否则AI每次都会像第一天入职的实习生一样从零开始问你“用什么框架”“注释写不写”。
确认CodeBuddy已启用长期记忆开关
打开CodeBuddy设置面板 → 点击左侧「记忆管理」→ 找到「长期记忆」开关，确保其状态为开启。这一步是所有后续配置生效的前提，【关闭状态下任何记忆文件都不会被加载】。
若开关灰显不可点，说明当前工作区未识别为有效项目（缺少.git目录或package.json/pyproject.toml），需先在终端执行git init或补全项目元信息文件。
初始化项目级记忆上下文
在CodeBuddy聊天输入框中输入指令：
/init
回车后，AI将自动扫描当前工作区，读取package.json或pyproject.toml中的技术栈信息，并生成初始的CodeBuddy.md配置文件。这个文件会存放在项目根目录，是AI记住你项目习惯的“身份证”。
注意：/init只运行一次，重复执行不会覆盖已有内容，但会补全新发现的模块信息。
手动完善项目记忆文件
方法一：直接编辑CodeBuddy.md
用VS Code或其他编辑器打开项目根目录下的CodeBuddy.md文件，在# 项目规范部分添加具体规则，例如：
```markdown
# 项目规范
- 前端使用Vue3 + Pinia，组件名必须为PascalCase
- 后端Java代码禁止使用Lombok @Data，一律手写getter/setter
- 所有API响应字段统一用snake_case命名
- 单元测试覆盖率阈值为85%
```
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 问题
保存后，下次会话启动时AI会自动加载这些规则。
方法二：通过规则管理界面添加
点击左侧导航栏「规则管理」→「新增规则」→「适用范围」选择「项目规则」→ 在文本框中输入上述规范 → 勾选「开启生效」→ 保存。这种方式生成的规则会自动写入CodeBuddy.md的# Rules区块，与手动编辑等效。
让AI记住你的操作习惯
第一步：开启Chronicle屏幕记忆
进入设置 → 「记忆管理」→ 开启「Chronicle屏幕记忆」。该功能会在后台静默录制你的开发操作，包括终端报错、IDE弹窗、调试断点位置等。
第二步：触发记忆写入
当出现典型场景时，AI会自动提炼记忆：比如你连续三次在终端执行mvn clean compile -DskipTests，它就会把这条命令记入.memory/daily-memories/2026-07-01.md；当你修复一个NullPointerException后反复强调“这里永远要判空”，AI会将该判断逻辑存入MEMORY.md的「常见防御模式」章节。
【关键提醒：屏幕记忆仅对当前工作树生效，切换项目目录后需重新开启】
第三步：验证记忆是否生效
重启CodeBuddy → 新建会话 → 输入“帮我写个登录接口”，观察AI输出是否自动采用你定义的snake_case字段命名、是否主动添加判空逻辑、是否调用Pinia而非Vuex——全部匹配即表示长期记忆已就位。
