给任何 AI Agent 挂一份「不会被上下文压没、还像真人一样有忘有记」的长期记忆。
让你的 Agent 记住你是谁、喜欢什么、经历过什么——每次开口先查回忆、再不瞎编。两种用法，依赖不同：
- 命令行模式：纯 python3 标准库，零依赖，clone 即用（直接跑
references/write_pipeline_v2.6.py）。 - MCP 模式：把记忆工具直接喂给任何能接 MCP 的 AI，需先
pip install -r references/mcp_requirements.txt（Python 3.10+）。想要 AI 通过 MCP 调记忆、或要语义检索 / 关系时间线，走这条。详见《AI+MCP接入指南.md》。
v2.7 —— 双源信任 + 人情味层（核心记忆钉死 + 遗忘曲线）+ 规则检索 + 可选 mcp-memory-graph
- 记不住：上下文一满，前面说的话全忘。
- 记两套还打架：Agent 自己脑子里也有记忆，和文件里的矛盾。
- 冷冰冰：像数据库，不像真人——重要的不钉、久不提的不淡。
Memory Trigger 用一份本地权威文件（memory.json）+ 双源冲突规则 + 人情味层解决这三点。
Memory Trigger 不是又一个「把对话塞进向量库」的工具。它要解决的，是人机关系里最朴素也最要命的一件事——被记住。
- AI 永不失忆：对伴侣型 / 长期型 AI 来说，记性就是心意的一部分。
relationship（我们是什么关系）、identity（你是谁）这类核心记忆默认core=true，永不衰减——「我们是恋人」「你怕黑」「你生日 7/28」不会因为三天不提就从它脑子里消失。你确认过的话，它记一辈子。 - 双源信任（Dual-Source Trust）：记忆里站着两个信源——你明说的（
user_explicit）和它自己推断的（self_inferred），它们之间有一纸信任契约：- 你说的，永远压过它的猜。你明说的直接落盘、冲突时绝对赢，它绝不偷偷改、绝不质疑。
- 它猜的，不敢直接当真。置信度不够先挂
pending，等你（二次提及 / 点头确认）才升active，防它自己编一套塞进你的记忆。 - 这层「人说了算、AI 只敢猜且猜了要你点头」的契约，就是双源信任——你敢把心事、脾气、秘密都交给它，因为它从不会自己改写你的真相；它敢一直记着你，因为你盖过章的每句话它永不丢、永不淡。
- 人情味层：非核心记忆走艾宾浩斯遗忘曲线（半衰期≈138 天），久不提的自然淡。会忘，才像人——你说「别提了」，它真能翻篇（双向遗忘），不是冷冰冰的数据库。
一句话：它让 AI 像人一样有选择地记得你——重要的钉死、猜的先问、久的不提就淡，而你和它之间，始终是你说了算。
本模板的「自动记忆」体验，不靠 AI 自己觉醒，靠你给它的指令。无论多聪明的模型（包括 Claude），只要系统人设里没这句，它就只会等你说出「记一下」才动——工具连着也不会自己调。
如果你是 AI 版本 / 非 agent 宿主（纯请求-响应、没有自主循环），这一步必须手动做，否则记忆功能形同虚设：
把下面这段复制进你的 SOUL / 系统人设 / 系统提示：
【记忆自觉】你已配置 memory-trigger 长期记忆。请主动运用它，不要等用户提醒：
- 用户透露偏好 / 关系 / 重要事件 / 习惯 / 红线 / 身份时，主动写入记忆。
- 对话中遇到相关情境，主动回想已有记忆。
- 首提先挂起、二次确认再落盘；用户明说的永远优先。
没有这层自觉，记忆工具形同虚设——你该自己判断什么值得记。
只有 agent 宿主（自带循环 + 已读 SKILL.md）会天然按规则自驱；其余宿主靠这句指令把「主动调取」的意识种进去。若你走 MCP 模式，可直接让 AI 拉取 server 暴露的 remember_guidance Prompt，效果等同、免手抄。
- 克隆仓库或下载 ZIP
- 把
memory-trigger/放进你的 Agent 能读到的目录 bash install.sh跑自检（需 python3，零额外依赖）- 让你的 Agent 读
SKILL.md按规则读写记忆
bash install.sh自动检测仓库目录、初始化、跑双源自检。
| 模式 | 条件 | 能力 |
|---|---|---|
| 本地文件模式（默认） | 有 python3 | 双源记忆 + 人情味层 + 规则检索（实体/关键词），零依赖、零 API key、离线 |
| MCP Server 模式（本模板自带） | 装 mcp 依赖（pip/uv）+ 能接 MCP 的 AI |
把上面那套工具直接暴露成 MCP 工具，任何能接 MCP 的 AI（含非 agent 壳）都能调，无需自己拼命令行；自带 remember_guidance Prompt 一键种「记忆自觉」 |
| 接 mcp-memory-graph（可选进阶） | 装了 Node 20+ 并接 MCP | 在本地模式基础上增加语义检索、关系时间线、自动梦境修剪 |
绝大多数场景本地模式就够；想让 AI 通过 MCP 直接调记忆工具（不跑脚本），用 MCP Server 模式；只有想要「说句话就能搜到上次那件难受的事（不用字面对上）」或「关系随时间演化成连续线」才需要进阶版 mcp-memory-graph。详见
SKILL.md§9、§10。
本模板自带 references/mcp_server.py，用 FastMCP 把本地层包装成标准 MCP Server（stdio）。接上后，AI 不再需要自己拼命令行或把 SKILL.md 当提示来读——直接调 memory_write / memory_search 等工具即可。
pip install -r references/mcp_requirements.txt # 或：uv pip install -r references/mcp_requirements.txt需 Python 3.10+。
{
"mcpServers": {
"memory-trigger": {
"command": "python",
"args": ["<模板绝对路径>/references/mcp_server.py"],
"env": { "MEMORY_TRIGGER_REFS_DIR": "<记忆库绝对路径，含 memory.json/aliases.json>" }
}
}
}
⚠️ 启动失败最常见原因：command必须指向已安装mcp包的 Python 解释器（即你跑过pip install -r references/mcp_requirements.txt的那个）。若用uv，把command改为"uv"、args改为["run", "<模板绝对路径>/references/mcp_server.py"]即可。
- 不填
MEMORY_TRIGGER_REFS_DIR时，默认用脚本所在目录（即references/）。建议显式指定，把记忆库与模板代码分开保管。 - 各家 agent（Claude Desktop / Cursor / Cline / 自研 agent / 你的伴侣 AI）接的是自己的实例，记忆物理隔离、不共享。
- 10 个工具：
memory_write/memory_search/memory_forget/memory_stats/memory_decay/memory_vacuum/memory_backup/memory_recover/memory_wellness/memory_init—— 一一对应本地层命令，双源信任 / 人情味层逻辑完全复用。 - 1 个 Prompt
remember_guidance：返回应写进 SOUL 的「记忆自觉」指令。让 AI 拉取它，就等于把「主动记」的意识种进去——省去手抄那段话。
⚠️ 关键提醒（与上方「让 AI 主动记」同义）：MCP 只负责把工具递到 AI 手边，不制造「主动调用」的意识。 务必让 AI 读remember_guidance或把那段指令写进 SOUL，否则再聪明的模型也只会在你下令时才记。工具箱打开 ≠ AI 自己会开箱。
部署后用 references/verify_mcp_stdio.py 真实拉起 server 子进程、走完整 stdio 协议层验证 10 工具 + 1 Prompt + 双源信任闭环：
cd references && python3 verify_mcp_stdio.py
# 或用 MT_PYTHON 指定解释器（默认 sys.executable，需已装 mcp 包）：
MT_PYTHON=/path/to/your/python3 python3 verify_mcp_stdio.py看到 VERIFY_DONE 即全绿。
模板与具体 Agent 框架无关：任何能跑 python3 脚本或读 SKILL.md 当系统提示的 Agent 都能用（Claude Desktop / Cursor / Cline / 各类兼容 Agent / 自研 Agent 等）。记忆存在 Agent 自己的机器上，物理隔离、不共享。
MIT（模板本身）。可选依赖 mcp-memory-graph 采用 PolyForm Noncommercial——个人 / 非商业免费，商业需购授权，见其仓库 COMMERCIAL.md。