Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

记忆与规则

Qoder CLI 的静态记忆(AGENTS.md 与 rules)和 Auto-Memory:位置、加载逻辑、规则 frontmatter。

Qoder CLI 为每个会话重建上下文;需要跨会话保留的知识主要来自两类记忆:静态记忆(你或团队维护的持久指令:AGENTS.md 和规则,适合开发规范、项目结构、常用命令、协作约定)和 Auto-Memory(启用后 Qoder CLI 保存在本地的 Markdown 记忆,适合记录偏好、反馈、项目背景和后续会话仍有用的外部引用)。注意记忆是作为上下文提供给模型的,不是强制策略;要严格阻止某些命令、工具或路径,用权限配置或 Hooks。

静态记忆位置:~/.qoder/AGENTS.md(当前用户跨项目的通用偏好,不提交);<project>/AGENTS.md(团队共享的项目规则、架构说明和常用命令,提交);<project>/AGENTS.local.md(当前机器的项目私有指令,如本地服务地址、个人测试数据,不提交);<project>/.qoder/rules/**/*.md(按主题或文件范围拆分的项目规则,提交)。用 context.fileName 可设置一个或多个别的文件名(默认 AGENTS.md)。加载逻辑:启动或刷新记忆时,用户级从用户配置目录加载 AGENTS.md;项目与本地项目级在受信工作区里从当前目录向上搜索 AGENTS.md、AGENTS.local.md 和 .qoder/rules/**/*.md;规则的 frontmatter 决定加载行为:始终生效的规则随项目记忆一起加载,针对特定文件的规则在 Qoder 访问匹配文件之后才按需加载。AGENTS.md 里可以导入其他文件。/init 分析项目结构并生成 AGENTS.md,/memory 打开记忆总览(启用 Auto-Memory 时可打开自动记忆文件夹)。写作建议:把稳定、明确的指令放静态记忆,把主题或文件范围相近的拆成多条规则。