企业官网建设流程全解析

Pilot Shell 持久记忆完整指南：AI 编程决策如何跨会话自动保留

【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shell

Pilot Shell 是一款面向 Claude Code 和 OpenAI Codex 的上下文工程工具，它的持久记忆（Persistent Memory）系统能在你关闭会话后自动保留关键决策与技术发现，让 AI 在下次启动时"想起"项目历史，避免重复踩坑。本文带你快速了解它的捕获机制、存储结构与查看方式。

为什么 AI 编程需要跨会话记忆？

使用 Claude Code 或 Codex 时，每个会话都是"失忆"的：你上周确认的架构决策、调试中发现的坑、踩过的依赖问题，新会话里的 AI 一概不知。这会导致：

• ⚠️ 重复探索已确认的方案，浪费时间
• ⚠️ 做出与历史决策矛盾的修改
• ⚠️ 项目约束条件反复丢失

Pilot Shell 的持久记忆系统专门解决这些问题——它像一个后台记忆管家，在你工作时自动捕获有价值的发现，并在需要时供 AI 检索。

自动捕获：决策与发现如何被记住

Pilot 的记忆捕获在后台静默运行，不干扰你当前的编码流程：

1. 观察会话证据— 背景进程扫描会话中的决策、修复方案、技术发现
2. 过滤日常噪音— 只保留真正有价值的项目证据，排除例行维护记录
3. 沉淀为持久记忆— 将证据提炼为可检索的观察记录（Observations）

💡 记忆系统与 Claude Code / Codex 的原生记忆互补：原生记忆负责当前会话的精简上下文，Pilot 提供跨会话、跨工具的完整历史视图。

相关捕获与过滤逻辑可查看：

• 记忆捕获过滤：memory-capture-filter.ts
• 会话结束钩子（触发记忆捕获）：session_end.py
• 压缩前保存：pre_compact.py

存储结构：记忆保存在哪里？

Pilot 采用双层存储，本地零依赖、无需向量数据库：

核心存储模块位于 console/src/services/sqlite/observations/，包括观察记录的写入（store.ts）、读取（get.ts）与最近记录查询（recent.ts）。

这种设计有两个好处：

• 本地全文搜索独立可用— 即使后台模型不可用，已有记忆照常检索
• JSONL 人类可读— 共享记忆是纯文本文件，可以直接用 Git 审查和回滚

检索机制：AI 如何"想起"过去

检索不是自动灌入上下文，而是按需召回，这是保持上下文窗口精简的关键：

• 会话启动、恢复或压缩时，Pilot 静默同步记忆存储
• AI 通过mem-search工具主动搜索历史决策，再调用get_observations/get_knowledge读取详情
• 本地全文搜索不依赖向量服务，也不隐藏旧记录

也就是说，AI 会像查阅项目文档一样"想起"历史——需要时才查，且来源、时间、状态都可供判断。

团队协作：记忆随代码一起流动

只需在 Console 的 Memories 页面打开Team sharing一个开关：

• 新的有用发现自动写入项目共享记忆目录
• 同事git pull后即可自动获得这些知识
• 原始提示词、会话转录等私有内容始终留在本地，不会外泄

更多细节可参考官方文档：team-memories.md 与 knowledge.md。

快速上手：3 步体验持久记忆

1. 安装 Pilot Shell：按 安装指南 完成安装
2. 正常编码— 记忆捕获全程后台运行，无需手动操作
3. 打开 Console 查看— 在 Memories 页面浏览已记住的发现及其来源；跨会话恢复相关机制可看 context-optimization.md

总结

Pilot Shell 的持久记忆让 AI 编程助手第一次真正拥有了"长期记忆"：

• ✅ 决策与发现自动捕获，零手动维护
• ✅ SQLite + JSONL 双层存储，本地可靠、团队可共享
• ✅ 按需检索，不膨胀上下文窗口
• ✅ 私有数据本地化，共享记忆走 Git 标准流程

无论是单人开发还是团队协作，这套机制都能让每一次会话都站在之前所有会话的肩膀上。

【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shell