【免费下载链接】OrbitalContext is yours. Agents are replaceable.项目地址https://gitcode.com/gh_mirrors/orbital10/Orbital点击查看免费下载Orbital 是一款面向 AI Agent 的操作系统它的核心设计哲学是 Context is yours, Agents are replaceable——Agent 可以换但项目上下文必须留得住。本文带你完整拆解 Orbital 的记忆系统每个项目工作区里的orbital/目录下Agent 会自主维护 PROJECT_STATE、DECISIONS、LESSONS 三个记忆文件它们每轮对话自动注入上下文配合后台记忆编辑器自动归档整理让 Agent 跨会话、跨模型都永不失忆。 记忆长什么样4个主文件 3个归档文件Orbital 的记忆不是数据库而是一组人类可读的 Markdown 文件统一存放在项目的orbital/目录中。所有路径的唯一事实来源定义在 agent_os/agent/project_paths.py文件角色特性PROJECT_STATE.md当前状态草稿板易失volatile只写现在覆盖式更新DECISIONS.md决策日志持久durable带 Chose / Reason / RejectedLESSONS.md踩坑经验手册持久durable编号条目INDEX.md导航地图每个重要文件一句话*_ARCHIVE.md× 3归档文件按需读取永不自动注入这种文件系统即记忆的设计意味着你可以随时用编辑器打开这些文件直接阅读甚至手动修正 Agent 记错的内容。 每轮自动注入记忆如何进入上下文记忆不会过期在磁盘上。在 agent_os/agent/context.py 中ContextManager每次组装发给大模型的提示词时都会从磁盘重新读取这 4 个 Layer-1 文件以[PROJECT_STATE.md]这样的前缀注入为系统消息。新会话、新模型、冷启动恢复拿到的都是最新记忆——这正是跨会话不失忆的第一支柱。为防止记忆无限膨胀每个文件都有独立的 token 预算见 agent_os/agent/memory_entries.pyDECISIONSsoft 7000 / hard 9000 tokenLESSONSsoft 5000 / hard 6000 tokenPROJECT_STATEsoft 1800 / hard 2000 tokenINDEXsoft 1500 / hard 2000 token超预算时注入视图inject_view会优先保留最新条目 最老的 3 条奠基性条目——既保证新信息在场又不丢失项目最初的关键设定并在视图中标注部分旧条目已省略可读磁盘文件。 三大记忆文件各司其职PROJECT_STATE.md只记录现在不是变更日志它回答项目此刻什么状态当前焦点、进行中的工作、阻塞项、下一步。系统契约见 agent_os/agent/prompt_builder.py明确要求覆盖过时行而不是追加带日期的历史。比如上图中 Agent 把已完成的 spec written 任务标注清楚让下一轮对话一眼看懂进展到哪。DECISIONS.md为什么这么做的决策档案每条决策包含 Chose选了什么、Reason为什么、Rejected否掉了什么。截图里可以看到一条经典条目此 Agent 只管理 BACKLOG.md不碰生产代码——新会话继承后绝不会越权改代码。契约要求新决策推翻旧决策时必须替换旧条目绝不让两条互相矛盾的决策并排存在。LESSONS.md错误恢复与经验手册内置的 learning-capture 技能 定义了三种触发时机 用户纠正、️ 工具失败后找到替代方案、 非显而易见的发现。每条经验包含发生了什么 / 下次怎么做 / 关键词标签截图中的 PyInstaller 路径问题教训就是一个完整范例。契约还特别强调不要把真正的 playbook 压缩省空间——教训的价值在于细节。 后台记忆编辑器超预算自动整理永不删除文件长大了怎么办Orbital 的答案是后台记忆编辑器agent_os/agent/memory_editor.py而非粗暴截断触发任何文件超过 soft 预算调度器自动在后台启动整理每项目最多每 30 分钟一次完全不打断对话。按 id 操作编辑器只返回选择——archive归档、merge合并、index重写导航图。归档是字节级精确移动到*_ARCHIVE.md原地留一条指针行[archived 2026-09-28 id:entity-pages-memory] 旧条目摘要 → DECISIONS_ARCHIVE.md未来会话想追溯时按指针 grep 归档文件即可无需整读。安全网动手前自动滚动备份最近 5 份快照写入采用 OCC 乐观并发控制文件被用户改动则跳过永远只移动、不删除。确定性兜底若达到 hard 预算系统按最久未触碰优先降级条目但永远保护最老 3 条奠基条目和pinned标记条目——记忆会瘦身但项目根基不会丢。⚡ 手动检查点与日常使用建议手动触发Agent 可用 checkpoint_state 工具 请求立即整理异步执行立即返回适合大任务收尾时主动存档。UI 查看在 Orbital 桌面端的 Files 标签页可直接浏览、复制、在资源管理器中定位这些记忆文件见上文三张截图无需翻命令行。使用技巧告诉 Agent 记住 X / 永远做 X / 别做 X 时它会自动写入对应记忆文件或项目指令下一轮对话即刻生效你也可定期打开LESSONS.md查看 Agent 从错误中学到了什么。✅ 小结Orbital 的记忆系统用三个记忆文件 每轮注入 后台自动归档回答了 Agent 长期协作中最常见的问题换会话、换模型、甚至隔天回来项目上下文依然完整且自洽。对新手来说最好的上手方式是打开你项目的orbital/目录读一遍这三个文件——那就是 Agent 眼中的项目人格而它完全属于你。赞分享【免费下载链接】OrbitalContext is yours. Agents are replaceable.项目地址https://gitcode.com/gh_mirrors/orbital10/Orbital点击查看免费下载相关推荐从三秒失忆到永久记忆四层记忆模型如何让 Agent 跨会话长记性从三秒失忆到永久记忆四层记忆模型如何让 Agent 跨会话长记性 和 AI 把架构聊得明明白白第二天打开新会话它又从头开始问 这个项目是干什么人工智能AI 应用MCP 服务知识图谱本地部署开发工具RAGDeepTide记忆系统深度解析MEMORY.md如何让AI跨会话记住你的项目DeepTide记忆系统深度解析MEMORY.md如何让AI跨会话记住你的项目 DeepTide 记忆系统深度解析作为一款由 DeepSeek 打造、面向深度解析Chatbox构建永不丢失的AI对话记忆系统深度解析Chatbox构建永不丢失的AI对话记忆系统 你是否曾经与AI进行深度交流后第二天打开应用却发现所有对话记录都消失了这种令人沮丧的经历在AI工具使AI 应用交互助手桌面应用上一篇IcemacOS菜单栏管理的革命性开源解决方案让刘海屏MacBook Pro重获整洁工作区下一篇Windows Subsystem for Android实战指南从环境搭建到深度应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/23 2:17:05 · 阅读 1.2k Orbital 记忆系统深度解析：PROJECT_STATE、DECISIONS、LESSONS如何让Agent跨会话永不失忆
【免费下载链接】OrbitalContext is yours. Agents are replaceable.项目地址https://gitcode.com/gh_mirrors/orbital10/Orbital点击查看免费下载Orbital 是一款面向 AI Agent 的操作系统它的核心设计哲学是 Context is yours, Agents are replaceable——Agent 可以换但项目上下文必须留得住。本文带你完整拆解 Orbital 的记忆系统每个项目工作区里的orbital/目录下Agent 会自主维护 PROJECT_STATE、DECISIONS、LESSONS 三个记忆文件它们每轮对话自动注入上下文配合后台记忆编辑器自动归档整理让 Agent 跨会话、跨模型都永不失忆。 记忆长什么样4个主文件 3个归档文件Orbital 的记忆不是数据库而是一组人类可读的 Markdown 文件统一存放在项目的orbital/目录中。所有路径的唯一事实来源定义在 agent_os/agent/project_paths.py文件角色特性PROJECT_STATE.md当前状态草稿板易失volatile只写现在覆盖式更新DECISIONS.md决策日志持久durable带 Chose / Reason / RejectedLESSONS.md踩坑经验手册持久durable编号条目INDEX.md导航地图每个重要文件一句话*_ARCHIVE.md× 3归档文件按需读取永不自动注入这种文件系统即记忆的设计意味着你可以随时用编辑器打开这些文件直接阅读甚至手动修正 Agent 记错的内容。 每轮自动注入记忆如何进入上下文记忆不会过期在磁盘上。在 agent_os/agent/context.py 中ContextManager每次组装发给大模型的提示词时都会从磁盘重新读取这 4 个 Layer-1 文件以[PROJECT_STATE.md]这样的前缀注入为系统消息。新会话、新模型、冷启动恢复拿到的都是最新记忆——这正是跨会话不失忆的第一支柱。为防止记忆无限膨胀每个文件都有独立的 token 预算见 agent_os/agent/memory_entries.pyDECISIONSsoft 7000 / hard 9000 tokenLESSONSsoft 5000 / hard 6000 tokenPROJECT_STATEsoft 1800 / hard 2000 tokenINDEXsoft 1500 / hard 2000 token超预算时注入视图inject_view会优先保留最新条目 最老的 3 条奠基性条目——既保证新信息在场又不丢失项目最初的关键设定并在视图中标注部分旧条目已省略可读磁盘文件。 三大记忆文件各司其职PROJECT_STATE.md只记录现在不是变更日志它回答项目此刻什么状态当前焦点、进行中的工作、阻塞项、下一步。系统契约见 agent_os/agent/prompt_builder.py明确要求覆盖过时行而不是追加带日期的历史。比如上图中 Agent 把已完成的 spec written 任务标注清楚让下一轮对话一眼看懂进展到哪。DECISIONS.md为什么这么做的决策档案每条决策包含 Chose选了什么、Reason为什么、Rejected否掉了什么。截图里可以看到一条经典条目此 Agent 只管理 BACKLOG.md不碰生产代码——新会话继承后绝不会越权改代码。契约要求新决策推翻旧决策时必须替换旧条目绝不让两条互相矛盾的决策并排存在。LESSONS.md错误恢复与经验手册内置的 learning-capture 技能 定义了三种触发时机 用户纠正、️ 工具失败后找到替代方案、 非显而易见的发现。每条经验包含发生了什么 / 下次怎么做 / 关键词标签截图中的 PyInstaller 路径问题教训就是一个完整范例。契约还特别强调不要把真正的 playbook 压缩省空间——教训的价值在于细节。 后台记忆编辑器超预算自动整理永不删除文件长大了怎么办Orbital 的答案是后台记忆编辑器agent_os/agent/memory_editor.py而非粗暴截断触发任何文件超过 soft 预算调度器自动在后台启动整理每项目最多每 30 分钟一次完全不打断对话。按 id 操作编辑器只返回选择——archive归档、merge合并、index重写导航图。归档是字节级精确移动到*_ARCHIVE.md原地留一条指针行[archived 2026-09-28 id:entity-pages-memory] 旧条目摘要 → DECISIONS_ARCHIVE.md未来会话想追溯时按指针 grep 归档文件即可无需整读。安全网动手前自动滚动备份最近 5 份快照写入采用 OCC 乐观并发控制文件被用户改动则跳过永远只移动、不删除。确定性兜底若达到 hard 预算系统按最久未触碰优先降级条目但永远保护最老 3 条奠基条目和pinned标记条目——记忆会瘦身但项目根基不会丢。⚡ 手动检查点与日常使用建议手动触发Agent 可用 checkpoint_state 工具 请求立即整理异步执行立即返回适合大任务收尾时主动存档。UI 查看在 Orbital 桌面端的 Files 标签页可直接浏览、复制、在资源管理器中定位这些记忆文件见上文三张截图无需翻命令行。使用技巧告诉 Agent 记住 X / 永远做 X / 别做 X 时它会自动写入对应记忆文件或项目指令下一轮对话即刻生效你也可定期打开LESSONS.md查看 Agent 从错误中学到了什么。✅ 小结Orbital 的记忆系统用三个记忆文件 每轮注入 后台自动归档回答了 Agent 长期协作中最常见的问题换会话、换模型、甚至隔天回来项目上下文依然完整且自洽。对新手来说最好的上手方式是打开你项目的orbital/目录读一遍这三个文件——那就是 Agent 眼中的项目人格而它完全属于你。赞分享【免费下载链接】OrbitalContext is yours. Agents are replaceable.项目地址https://gitcode.com/gh_mirrors/orbital10/Orbital点击查看免费下载相关推荐从三秒失忆到永久记忆四层记忆模型如何让 Agent 跨会话长记性从三秒失忆到永久记忆四层记忆模型如何让 Agent 跨会话长记性 和 AI 把架构聊得明明白白第二天打开新会话它又从头开始问 这个项目是干什么人工智能AI 应用MCP 服务知识图谱本地部署开发工具RAGDeepTide记忆系统深度解析MEMORY.md如何让AI跨会话记住你的项目DeepTide记忆系统深度解析MEMORY.md如何让AI跨会话记住你的项目 DeepTide 记忆系统深度解析作为一款由 DeepSeek 打造、面向深度解析Chatbox构建永不丢失的AI对话记忆系统深度解析Chatbox构建永不丢失的AI对话记忆系统 你是否曾经与AI进行深度交流后第二天打开应用却发现所有对话记录都消失了这种令人沮丧的经历在AI工具使AI 应用交互助手桌面应用上一篇IcemacOS菜单栏管理的革命性开源解决方案让刘海屏MacBook Pro重获整洁工作区下一篇Windows Subsystem for Android实战指南从环境搭建到深度应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考