codebuddy 的长期记忆需手动初始化并维护，通过 /init 生成 codebuddy.md 和 .codebuddy/memory.md 文件，以 # 前缀标记规则，支持 git 版本控制与 /status 验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 的长期记忆不是自动开启的开关，而是通过特定文件和指令主动写入、加载并持续维护的一套机制。它不依赖后台服务或云端同步，而是基于本地 Markdown 文件系统实现隐私可控的记忆沉淀。
初始化项目上下文
首次使用前需执行 /init 命令，这会触发 CodeBuddy 在当前项目根目录生成关键记忆文件（如 CODEBUDDY.md 和 .codebuddy/MEMORY.md），并自动将当前工作区路径、Git 仓库状态、package.json 中的项目名等基础信息写入。此步骤是后续所有记忆生效的前提。
写入项目级规则与偏好
在 CODEBUDDY.md 或 .codebuddy/MEMORY.md 中，用 # 前缀 标记需要长期生效的关键信息，AI 会在后续对话中自动识别并遵循：
-
技术栈声明：例如
# 技术栈: Next.js 14 + TypeScript + Tailwind CSS -
当前任务聚焦：例如
# 当前任务: 实现订单导出为 Excel 功能 -
安全与规范要求：例如
# 安全策略: 所有 API 调用必须携带 X-Request-ID、# 代码规范: 禁止使用 any 类型，接口字段必须显式声明 -
数据库结构定义：若需 AI 生成 Model，应以表格形式列出表名、字段、类型、主键/外键等，例如：
| 字段 | 类型 | 是否主键 | 说明 |<br>|------|------|----------|------|<br>| id | UUID | 是 | 唯一标识 |
启用 Git 版本化记忆管理
长期记忆文件本身是纯文本，天然支持 Git 管理。建议将 CODEBUDDY.md 和 .codebuddy/MEMORY.md 纳入版本控制：
- 团队协作时，这些文件随代码一起提交，确保每位成员调用 AI 时获得一致上下文
- 避免将
.codebuddy/memory/YYYY-MM-DD.md（日志类临时记忆）加入 Git，可将其添加至.gitignore - 修改后无需额外操作，AI 在每次启动或执行指令时自动读取最新内容
验证记忆是否生效
完成上述配置后，可通过以下方式确认长期记忆已就位：
- 输入 /status 查看当前加载的记忆摘要，包括识别到的项目名、技术栈、最近写入的规则条目
- 尝试提问：“按项目规范，API 错误响应应该返回什么结构？” 若 AI 引用你写入的
# API 规范: 统一返回 { code, message, data }，说明记忆已激活 - 新建会话后直接描述任务（如“为 user 表生成 TypeORM Entity”），AI 应能自动关联之前定义的表结构和 ORM 框架，无需重复说明
