AI 档案

AI 档案，是一个长期替你工作的 Agent 在 Mem 里的稳定身份。

当某个 Agent 不只是一次性聊天，而是会反复回来工作时，就适合给它建档案：代码 reviewer、研究 Agent、发版助手、写作搭档，或者多 Agent 工具里启动的某个 worker。档案告诉 Mem：这个 Agent 是谁，通常在哪个记忆空间里工作，开始前应该带上哪些规则。

为什么需要它

AI 工具已经有很多地方可以放行为设置：AGENTS.md、CLAUDE.md、Cursor rules、Codex profile、Hermes soul，以及各个宿主自己的设置。一个 Agent、一个工具时还好；多个 Agent、多个宿主一起用时，光知道“这是 Codex”就不够了。今天 Codex 里跑的可能是 reviewer，明天可能是 release helper。

Mem 把两件事分开：

来源应用只表示出处，不表示身份。

第一个有用动作

只给一个真实会反复出现的角色建档案。

例如：

• 名字：Cindy
• ID：cindy
• 默认空间：product
• 角色：负责审查面向产品的改动；回答简洁；确认测试后再说可以合并。

然后用 NMEM_AGENT_ID=cindy 启动这个 worker，或者在支持的 MCP / API 调用里传 agent_id="cindy"。下一次 Context Bundle 里，应该能看到选中的 AI 档案是 Cindy。

AI 档案里可以有什么

一个 AI 档案可以包含：

• 显示名称和稳定 ID
• 对这个 Agent 角色的简短描述
• 默认读写的空间
• 只对这个档案生效的规则
• 可选的宿主本地别名；只有集成需要把宿主里的稳定 ID 映射到 Mem 档案时才用

保持简短。档案应该回答“谁在工作”和“通常在哪个范围里工作”，不要把所有可能的指令都塞进去。

它和相近概念的区别

如果同一个 Agent 在另一份工作里应该表现得不同，建一个新的档案。不要因为宿主很方便复用名字，就把互相冲突的工作塞进同一个身份里。

接入工具如何选择它

Mem 只会从明确的身份信号里选择 AI 档案：

• NMEM_AGENT_ID
• agent_id
• NMEM_HOST_AGENT_ID，用于集成把宿主里的稳定本地 ID 映射到 Mem 档案
• host_agent_id，同样用于 API 或 MCP 里的高级映射

它不会从 source_app 里选择档案。一个普通 Codex 会话，不应该因为来源应用是 codex 就自动变成 Cindy。

暂时不用担心什么

不需要给每个聊天窗口都建档案。普通使用时，默认档案已经够用。

不需要给每个工具都建档案。档案对应的是稳定角色，不是运行时。

也不需要一开始就设计完整团队层级。先从一个真的会反复回来的 Agent 开始。

接下来读哪里

• 上下文：预览某个档案开始前会收到什么。
• 规则：为所有 Agent、某个档案或某个空间设置行为规则。
• 空间：如果不同档案需要不同记忆范围。