Basic Memory: 决策与认知对齐保险库
Basic Memory 是一套由你和你的 AI 助手共享的“长期记忆系统”。它能确保你的战略决定、不准触碰的红线以及敲定的设计方案,在开启新对话、或者在不同电脑之间切换时,永远不会遗失。
贴在显示器旁的便签纸:为什么需要 Basic Memory?
想象你招来了一位极其聪明、但每次离开房间就会失忆一次的实习生助理:
- 如果他只依赖刚才在走廊里听到的几句闲聊(聊天窗口里的上下文),干着干着就会把大局抛到脑后。干了两个小时后,他可能突然开始自作主张地大改底层数据库,甚至花三天去搞一个庞大的网页系统,完全忘了你最开始的交代:“我们不需要网页界面,只需要写一个 50 行的独立小脚本。”
- Basic Memory 就是用强力胶死死贴在电脑屏幕旁的‘黄色便签纸’。上面写着老板亲笔签名的家规:
- 第一条:坚决不准动真实的银行账户和生 产环境;
- 第二条:坚决不准做复杂的网页大平台,保持最简命令行脚本;
- 第三条:只要当前这个小功能跑通,立刻停手,绝不搞多余重构。
每次助理准备执行重大任务前,强制必须先抬头看一眼这张便签纸。因为规矩写在聊天窗口之外,助理就永远不会失控走偏,也不会搞出谁也不要的庞大系统。
它是如何保护项目的?
| 核心设计准则 | 具体机制 | 为什么非如此不可 |
|---|---|---|
| 单一真值源 (Single Source of Truth) | 每个项目只维护一页受控的 Markdown 对齐手记 | 杜绝出现两套冲突的规则让 AI 左右为难 |
| 按需懒加载 (Lazy Retrieval) | 启动时绝不加载全库,仅在涉及跨项目边界时查阅 1 篇 | 零上下文噪音,省下宝贵的工作记忆 |
| 人类绝对否决权 (Human Veto Power) | 普通代码工具绝不能私自改写,必须人类明确批准 | 彻底免疫 AI 自作主张和幻觉污染 |
真实历史教训:终结“失控的代偿性过度设计”
当 AI 编程助手在长对话中丢失了原始目标时,它会产生一种心理代偿机制:因为感到不确定,它就会盲目通过建抽象类、加中间层、搭大系统来“自保”。Basic Memory 用硬性文本把项目范围彻底冻结,让 AI 永远只做具体、可撤销的扎实小步。
它与其它工具如何分工?
在一个健康的协作流程中,高层规矩与底层搜索工具紧密配合:
- Basic Memory 负责管住 AI 的心智(回答“做什么与不准做什么”):
“我们在优化测试,但坚决不准动真实用户的数据。” - zvec-grep 负责指路(回答“东西在哪”):
“需要修改的计算代码在文件 A 的第 140 到 180 行。” - AI 动手干活:
只读这 40 行代码,改完测试通过,立刻收工。
关联生态与延伸阅读
- 宏观全景:Agent 记忆与分层检索 — 理解人类裁判、项目记忆与代码检索的四 层认知金字塔。
- 概念档案室:QMD — 负责管理跨项目通用设计原理与历史教训的学术资料馆。
- 底层代码雷达:zvec-grep (zg) — 明确了顶层死命令后,负责精准找出 30 行目标代码的极速雷达。
- 协议底座:Model Context Protocol (MCP) — 让各大主流 AI 助手能够无缝调用 Basic Memory 的通用接口标准。
官方资源与源码仓库
- GitHub 源码仓库:basicmachines-co/basic-memory
- PyPI 官方包发布:basic-memory