Atlas记忆策略实战让自定义Agent记住什么、忘掉什么【免费下载链接】atlasSource control for agents. Use multiple coding agents, track their changes and query them in one place项目地址: https://gitcode.com/GitHub_Trending/atlas115/atlasAtlas 是一款面向编码 Agent 的开源记忆与版本控制工具它让 Claude Code、Codex 等多个 Agent 共享同一套项目记忆把决策、计划、文件变更自动沉淀下来并在每一轮对话中把最相关的内容推送给 Agent。而记忆策略正是控制 Agent记住什么、忘掉什么的核心机制——这篇实战指南带你从零读懂它。为什么 Agent 需要一个记忆策略用过多 Agent 写代码的朋友应该都有同感每次会话都从零开始上次踩过的坑、定下的架构新会话的 Agent 一无所知切换 Agent 就丢线索Claude Code 里做的决定Codex 完全看不到记住的越多噪音越大上下文塞满过期信息反而让 Agent 跑偏。Atlas 的思路是记忆不是越多越好而是要有策略地记和忘。它的记忆体系全部在本机运行本地 MiniLM 嵌入模型 HNSW 向量索引代码、笔记、会话都不离开你的机器密钥在落盘前就会被脱敏。一、Atlas 记住了什么共享记忆的四个来源Atlas 的 Agent 记忆由四个部分自动汇入一个统一索引引擎设计详见 README.md注入内容来源时机提及文件、目录、符号、笔记、历史会话本地解析每一轮共享 Agent 记忆活跃计划、决策、文件变更、失败记录每一轮语义匹配本机嵌入你的消息与项目记忆索引做相似度匹配每一轮会话交接精选事实包 上一个会话的尾部哪怕来自另一个 Agent首条消息也就是说任何 Agent 写入的记忆其他 Agent 都能读到——这正是 memory_policy.rs 顶部注释强调的Claude Code 的记忆对 Codex 可见反之亦然。二、记忆策略的蒸馏自动提炼偏好表Atlas 里最实用的功能是 Memory 面板中的Preferences偏好策略表。它不需要你手写规则Atlas 内置了一份 12 项常见偏好的探针目录——版本控制、主题、测试习惯、包管理器、提交信息格式、语言与框架、架构约束、沟通风格等探针定义见 memory_policy.rs然后把探针变成自然语言查询做本机嵌入与CLAUDE.md、AGENTS.md、Claude 的memory/*.md等记忆文件逐句比对相似度达到阈值0.30的语句被提炼成一行可编辑的策略。整个过程不调用任何 LLM纯语义匹配快且免费。你还能按软偏好 / 强规则strong/soft、偏好 / 代码库行为、语义 / 关键词匹配类型进行过滤——视图实现见 memory-policy-view.tsx。三、自定义记住什么直接编辑策略值策略表里每一行的取值都是可编辑的双击 Value 列修改按 Enter 保存Atlas 会把这段文字原位写回到源记忆文件里CLAUDE.md/AGENTS.md/ Claude 记忆目录下次蒸馏时新规则立即生效。写回路径有白名单保护只能改 Agent 记忆文件防止误写其他文件逻辑在 memory_policy_update。实践中推荐三个动作改写模糊偏好把喜欢简洁的代码改成函数不超过 40 行注释用英文——Agent 对可执行规则更敏感提升规则强度含 must / never / always 的语句会被自动标为 strong强规则见 classify关键约束请用这类措辞一键发给 Agent行尾的对话气泡可把整条偏好直接送入 Agent 聊天sendToAgentChat让它立刻按新策略干活。四、自动忘掉什么整合与剪枝机制只记不删记忆迟早变成垃圾场。Atlas 的遗忘机制在 consolidate.rs 中实现遵循空闲时整合的节奏Orient → Gather → Consolidate → Prune置信度剪枝从会话中提炼出的记忆带有置信度低于50%的直接丢弃CONFIDENCE_FLOOR 0.5数量上限按最新优先只保留最多200条提炼记忆MAX_RETAINED 200老的不达标就自动退场相似度地板检索时余弦相似度低于 0.30 的命中不会进入上下文——低相关记忆等于被忽略降权兜底图谱记忆关键词/子串匹配权重被压到 0.1永远盖不过向量命中的强语义结果从架构上保证陈旧内容抢不到 C 位。如果你只想彻底清空一个项目的记忆重来删掉project/.atlas/memory/目录即可下次打开自动重建官方排障建议。五、进阶跨项目晋升全局记忆单个项目里学到的偏好怎么变成全局习惯Atlas 有明确的晋升规则README.md一条UserPreference或Constraint类记忆置信度 ≥ 0.8 且在 ≥ 2 个不同项目中出现才会晋升到~/.atlas/memory/的全局存储并写进人类可读的MEMORY.md控制在 200 行以内。这等于给了记忆一道防过拟合的闸门只在某个项目有效的经验不会污染其他项目真正反复验证过的偏好才会记一辈子。总结把 Agent 的记忆变成可管理的资产你的目标Atlas 对应机制让 Agent 记住偏好记忆文件 偏好策略表自动蒸馏、可编辑写回让规则必须遵守用 must/never 措辞标为 strong 强规则自动忘掉噪音置信度 50% 剪枝、200 条上限、相似度地板 0.30跨项目通用经验≥0.8 置信度 2 项目出现 → 晋升全局记忆隐私安全全部本机嵌入与检索密钥落盘前脱敏Atlas 的记忆策略本质上是一套记什么、多确信才记、何时忘掉的完整闭环。上手只需三步写清楚CLAUDE.md/AGENTS.md里的偏好 → 打开 Memory 面板的 Preferences 检查蒸馏结果 → 用强措辞修正关键规则。你的 Agent 从此不再失忆。【免费下载链接】atlasSource control for agents. Use multiple coding agents, track their changes and query them in one place项目地址: https://gitcode.com/GitHub_Trending/atlas115/atlas创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考