riponcm/projectmem

解决的问题

AI 编码代理通常每次会话都从零开始，忘记之前的决策，重复失败的调试尝试，并因重新读取源文件以重建上下文而浪费 token。projectmem 提供了一个持久化、本地优先的内存和判断层，记录变更背后的「为什么」，防止 AI 代理重复错误。

工作原理

该工具在仓库内创建一个 .projectmem/ 目录，将类型化的事件（问题、尝试、修复、决策和笔记）以纯文本格式存储在 events.jsonl 文件中。它使用原生 Model Context Protocol (MCP) 服务器，暴露 15 个工具，允许 AI 代理（如 Claude、Cursor 或 Codex）自动读写内存。它还通过 Git 钩子与 Git 集成，支持预提交警告和提交后分类。

适用人群

希望减少 token 使用、停止重复失败的技术方法，并在会话间保持架构决策持久记录的 AI 编码代理使用者。

特色亮点

• 预提交警告：如果用户即将重复失败的方法或修改高变动文件，会在提交前发出警告。
• 本地优先架构：无云服务、无账户、无遥测；所有内存都保存在仓库中。
• 过期内存检测：标记那些早于文件重大变更的内存，而不是直接删除，让人类决定是否应被取代。
• 可视化套件：包含所有项目的全局仪表板、带有失败热力图的项目地图，以及「时间脊柱」时间线。
• 意图追踪：使用单独的 plan.md 文件记录想法和计划，与仅追加的事件日志明确区分。
• MCP 集成：原生支持 MCP 兼容工具，实现上下文注入和日志记录的自动化。