memini 是一个为 AI 编程代理设计的本地优先、以护栏方式强制执行的持久项目记忆系统，核心目标是让代理“不重复同样的错误”。地址：https://github.com/lumayapartners/memini。
【用途】AI 编程代理是无状态的：每次会话都像失忆一样重新开始。周一弄坏构建的代理，周四可能还会尝试完全相同的编辑。memini 为每个仓库建立持久记忆，记录失败尝试、脆弱文件、决策和部署规则，并代理即将重蹈覆辙时强制推送相关警告。它不是一个代理可以选择阅读的笔记本，而是一条无法跳过的护栏。
【记忆存储与可审查性】记忆存放在仓库内的 .memini/ 文件夹中，包含本地 SQLite 索引和人类可读、可提交 PR 审查的 Markdown 视图。本地优先：任何内容都不离开你的机器。
【护栏执行机制】当代理尝试编辑有记录风险的文件时，编辑会在发生前被拦截，并注入记录的教训。示例警告：[WARNING] Editing vercel.json broke the build (recorded 2026-07-03) — Tried changing buildCommand; deploy failed. Actual fix: move checkout server-side and set VITE_STRIPE_USE_SERVER=true。严重级别：warn 级别下，代理每次会话得到一次警告，之后可以继续；block 级别下，编辑始终被拒绝，直到人工归档该记忆。会话启动时会注入最重要记忆的摘要（按严重级别优先，受令牌预算限制）。
【MCP 工具】让代理记录所学，包括：remember_failed_attempt、remember_fragile_file、remember_decision、end_session_summary，以及 recall_project_context 和 check_before_editing。
【Git 感知的过期】记忆会对其引用的文件做哈希；pm stale 会标记证据已改变的记忆，过期记忆在重新验证前停止触发护栏。
【快速开始】资料仅给出“Quickstart (90 seconds)”，未提供具体命令内容。对于 Cursor、Windsurf 和其他 MCP 客户端：资料提到 pm install-mcp --write cursor 用于 Cursor。
【执行链条】memini 覆盖多个环节：编辑前——对受护栏文件的编辑在发生前被阻止，block 拒绝、warn 提示用户并附带记录历史；支持的平台包括 Claude Code（pm init 安装）、Cursor 1.7+（pm install-mcp --write cursor）、GitHub Copilot（CLI、云端编程代理和 VS Code 代理模式预览版，pm install-copilot）。提交前——通过 pm init（或 pm install-hooks --git）安装 git pre-commit 护栏，阻止任何触碰 block 严重级文件的提交，无论哪个 IDE 或代理做的编辑；失败开放，可用 git commit --no-verify 绕过。咨询式——任何 MCP 客户端可通过 check_before_editing / recall_project_context 工具，加上始终生效的 Cursor 规则引导代理使用它们。
【保持记忆长期有用】自动捕获：Claude Code 会话结束钩子会在会话确实改动文件时提示代理记录持久教训，闲置会话保持沉默。有用性跟踪：每次护栏触发都会被计数，pm stats 显示哪些记忆在发挥作用、哪些从未触发。pm review：标记近乎重复的内容、同一文件上相互矛盾的护栏、以及创建很久却从未触发的休眠护栏；全部为本地启发式，不使用 LLM，由你决定保留、合并或归档。Git 感知的过期：记忆哈希其引用的文件，代码变化时记忆被标记并停止触发，直至重新验证（pm stale / pm verify）。记忆类型包括：decision、failed_attempt、fragile_file、architecture、deployment、client_preference、session_summary。
【作用域与跨仓库共享】部分教训是项目特定的，另一些适用于机器上同一组织或客户的所有仓库。memini 提供三种作用域。工作区文件夹下的每个仓库（包括之后新建的）自动获得这些护栏。解析方式沿目录树向上查找，类似 .gitconfig 或 ESLint 配置。工作区/用户级文件护栏通过 glob 匹配（vercel.json 匹配任意仓库的 vercel.json，config/**/*.yml 也有效），更宽作用域的记忆仅在人工验证后才触发；代理只能向项目作用域提议记忆，因此被提示注入的代理无法植入跨仓库传播的规则。pm doctor 显示当前激活的作用域。
【设计原则】强制执行而非建议：MCP 记忆工具对代理是可选的，钩子不是；即使代理从未想到检查记忆，护栏路径也能工作。人类可读、可 PR：每条记忆渲染为 .memini/ 下的 Markdown，团队像审查其他变更一样审查它。Git 关联证据：记忆记录其诞生时的分支、提交和文件哈希，因此声明可验证、过期可检测。本地优先：仓库内 SQLite + Markdown，无账号、无云端、无遥测，密钥在存储前自动从记忆正文中脱敏。跨工具：核心是 CLI + 文件，Claude Code 钩子和 MCP 是轻量适配器。
【安全与限制】设计上本地优先：无服务器、无账号、无遥测；密钥在存储前自动脱敏，文件引用限定在仓库内，注入的记忆文本有大小上限并被框定为数据。完整威胁模型见 SECURITY.md，其中包含诚实的限制说明（护栏拦截编辑工具，而非任意 shell；warn 是建议性的，block 不是）。
【版本状态】处于早期 v0.1。团队同步（跨整个团队的共享记忆及审查工作流）在路线图中。资料未提供具体收费标准、价格或平台支持范围等更多信息，这些暂未提供。
