Persist OS：为AI代码提供持久化决策记忆

Persist OS 是一款创新型的开源命令行工具，旨在解决AI辅助编程中一个长期被忽视的核心问题：临时上下文导致的决策遗忘与意图偏移。在传统的版本控制系统中，Git等工具只记录了“什么内容发生了变更”，却从未回答“为什么这样变更”。而Persist OS的出现，正是为了填补这一空白，它将架构决策、产品意图、模块归属、测试和安全期望以及AI代理的规则，以结构化的、可审查的文件形式持久化存储在仓库中，使之成为仓库真正的“源代码”。

该工具的核心组件是“persist doctor”，一个确定性的记忆健康检查器。医生会从多个维度对记忆文件进行验证，包括结构完整性、完成证据、ADR（架构决策记录）质量、安全影响、过时引用以及上下文预算等。它返回明确的退出码：0表示健康，1表示警告，2表示错误。这意味着开发人员可以轻松地将它集成到Git钩子或CI/CD流水线中，作为一个“工作是否真正完成”的强制检查关卡。

Persist OS的设计哲学强调本地优先和隐私保护。它完全在本地运行，没有任何网络调用、遥测数据收集或AI API请求。它也不会远程加载模板，无需连接MCP服务器。默认情况下，它拒绝覆盖现有文件，并提供了路径遍历和符号链接的安全保护。它不生成生产代码，也不在你的仓库中安装任何新依赖。这些特性使其成为一个可信任的工程工具。

对于AI工具的集成，Persist OS利用了各个平台的原生机制。Claude Code会自动加载CLAUDE.md文件，并在每次会话开始时通过SessionStart钩子注入一个实时的ADR/模块地图。Cursor则通过一个always-apply规则（persist-memory.mdc）在每个请求中加载记忆规则。Codex则会自动发现并加载AGENTS.md。这些机制确保了AI代理在开始工作前就能读取并遵守仓库中的记忆和约定。

AGENTS.md文件包含了简短的命令规则块，指导AI代理优先阅读记忆、复用已有约定、记录新的教训、不违背已接受的ADR，并在任务完成前运行“persist doctor”。这赋予了AI代理自我维护记忆的能力，使其能够自动更新CONVENTIONS.md和LESSONS.md文件，从而保持记忆的鲜活。人类开发者只需在拉取请求中审查代理的编辑即可。

Persist OS还提供了丰富的预设（presets），覆盖了从Laravel+React到Flutter、Next.js等多种技术栈。这些预设包含了特定技术栈的指导建议和提案性的ADR，但所有预设决策都默认为“建议”状态，不会静默替用户做出选择。这种设计既提供了便利，又保持了开发者的自主权。

此外，Persist OS的设备命令体系也非常完整。除了基本的init、doctor命令外，还包括adr create/accept/supersede、feature create、module create、skill create、mcp add等一系列命令，全面覆盖了从捕获意图到验证记忆的完整流程。通过git config core.hooksPath .persist/hooks命令，可以轻松启用预提交和预推送钩子，确保护代码在任何时候都保持健康。

总而言之，Persist OS为AI辅助开发提供了一种优雅且强大的认知持久化方案。它将决策从AI的易失性上下文中迁移到仓库中，确保了记忆的长期可靠性、可审计性和可验证性。这不仅有助于减少AI犯错的概率，也为团队协作提供了清晰的决策轨迹。对于正在探索AI编程工具落地实践的团队来说，Persist OS无疑是一个值得关注的创新项目。