Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

记忆与规则

CODEBUDDY.md 的五种位置与加载顺序、@ 导入、/init、/memory,以及 .codebuddy/rules 的 frontmatter。

CodeBuddy Code 可以跨会话记住偏好,如代码风格指南和常用命令。五种分层的记忆位置:

类型位置共享范围
用户记忆~/.codebuddy/CODEBUDDY.md仅本人(所有项目)
用户规则~/.codebuddy/rules/*.md仅本人(所有项目)
项目记忆./CODEBUDDY.md 或 ./.codebuddy/CODEBUDDY.md通过源代码管理与团队共享
项目规则./.codebuddy/rules/*.md通过源代码管理与团队共享
项目记忆(本地)./CODEBUDDY.local.md仅本人(当前项目),自动加入 .gitignore

启动时加载:用户级主文件和 rules;从当前工作目录向上递归的所有 CODEBUDDY.md 和 CODEBUDDY.local.md;项目级规则只加载当前工作目录的 .codebuddy/rules/(不加载父目录的);子目录里的 CODEBUDDY.md 在 CodeBuddy 读取该子树文件时动态加载。CODEBUDDY.md 可用 @path/to/import 导入其他文件(相对或绝对路径,可导入主目录里的个人文件;代码块和代码范围内的不解析;最多递归 5 层)。/init 为代码库引导生成 CODEBUDDY.md;/memory 打开记忆管理面板(打开 Auto Memory 目录、MEMORY.md 索引、切换 Auto Memory 开关);输入框开头 # 可快速添加记忆。建议在里面写常用命令(构建/测试/lint)、代码风格与命名约定、项目特有的架构模式。

模块化规则:.codebuddy/rules/ 里的所有 .md 自动作为项目记忆加载,优先级与 .codebuddy/CODEBUDDY.md 相同。frontmatter 字段:enabled(默认 true,false 则完全不加载)、alwaysApply(默认 true)、paths(触发规则的文件路径 glob)。alwaysApply: true 时始终注入上下文;alwaysApply: false 且有 paths 时,只在操作匹配文件时触发;false 且无 paths 的规则不被支持、不会加载。