Amp × Nowledge Mem
用原生插件把跨工具记忆接入 Amp：Context Bundle、记忆工具、图谱扩展与自动会话捕获。
给你的 Agent
把这段话交给 Amp。它应该先使用通用安装 skill；这一页保留为行为说明和排障参考：
读取 https://mem.nowledge.co/SKILL.md，按其中说明为 Amp 安装或更新 Nowledge Mem。用 nmem status 和 Context Bundle 或 Working Memory 检查验证结果，并总结你改了什么。Amp 是带原生插件 API 的编程 Agent。Nowledge Mem 直接接入这套 API：Amp 可以读取你的 Context Bundle、搜索和保存记忆、展开图谱关系、使用命令面板操作，并在每个 Agent 轮次结束后自动捕获当前 Amp 会话。
这是 Amp 的专属连接路径。优先用它，而不是通用 Agent Plugin，因为 Amp 提供了宿主级生命周期事件和 thread API；这些能力不是 Agent Plugins 标准能通用承诺的。
开始之前
- Nowledge Mem 已在本机运行（安装指南），或有可访问的远程 Mem server
- 已安装 Amp
nmemCLI 在 PATH 中。在 Nowledge Mem 里打开 设置 → 偏好 → Developer Tools → Install CLI，或安装nmem-cli
nmem status # Nowledge Mem 可访问
amp --version # Amp 可用设置
安装插件
在 community 仓库根目录运行：
bash nowledge-mem-amp-plugin/scripts/install.sh安装脚本会写入三个 Amp 入口：
| 路径 | 用途 |
|---|---|
${XDG_CONFIG_HOME:-$HOME/.config}/amp/plugins/nowledge-mem.ts | Amp 可发现的根插件入口 |
${XDG_CONFIG_HOME:-$HOME/.config}/amp/plugins/nowledge-mem/ | 插件 bundle |
${XDG_CONFIG_HOME:-$HOME/.config}/amp/skills/nowledge-mem/ | Amp skill 指引 |
如果设置了 XDG_CONFIG_HOME，安装脚本会使用这个 config root，而不是 ~/.config。
重启 Amp
关闭并重新打开 Amp，让插件和 skill 被加载。
验证连接
运行：
amp plugins list你应该能看到 Nowledge Mem 插件，以及它注册的 events、commands 和 nowledge_mem_* tools。
然后新开一个 Amp 会话，问：
What was I working on recently?Amp 应该在需要完整启动上下文时调用 nowledge_mem_context_bundle，或在只需要轻量简报时调用 nowledge_mem_working_memory，再返回你的当前上下文。
要验证会话捕获，完成一个很短的 Amp turn，然后搜索刚刚用过的一句话：
nmem t search "the phrase you just used" --source amp你应该能看到一条 amp-... thread。如果没有，重新运行安装脚本、重启 Amp，并确认没有用 NMEM_AMP_AUTO_SYNC=0 关闭自动同步。
更新
拉取最新 community 仓库后重新运行：
bash nowledge-mem-amp-plugin/scripts/install.sh更新后重启 Amp。
你可以做什么
从完整上下文开始
Amp 可以在会话开始时读取 Context Bundle：用户身份、AI 身份、当前 Space、Rules、Working Memory 和 KFS 路径。
先检索，再重复工作
当任务依赖旧决策、常用流程或之前的调试上下文时，Amp 可以直接搜索 Mem。
保存长期知识
Amp 可以把决策、偏好、流程和经验保存到 Nowledge Mem，让其他工具以后也能找到。
理解关系
当 Agent 需要看清某条记忆和其他决策的关系时，nowledge_mem_graph_expand 会返回相邻记忆和有标签的边。
让 Amp 会话可搜索
每个 Agent 轮次结束后，插件会通过 Amp 的 thread API 读取当前会话，并把对应 thread 写入或追加到 Mem。
工具
| 工具 | 作用 |
|---|---|
nowledge_mem_context_bundle | 读取启动上下文：用户身份、AI 身份、当前 Space、Rules、Working Memory 和 KFS 路径。 |
nowledge_mem_working_memory | 读取当天的轻量 Working Memory 简报。 |
nowledge_mem_search | 搜索所有工具共享的知识，支持 label、limit 和 deep mode。 |
nowledge_mem_save | 保存决策、洞察、流程或偏好。 |
nowledge_mem_update | 更新已有记忆，避免重复创建。 |
nowledge_mem_thread_search | 搜索来自任何工具的历史对话。 |
nowledge_mem_save_thread | 按需保存当前 Amp 会话的完整 transcript。 |
nowledge_mem_save_handoff | 保存一份可恢复的交接摘要。 |
nowledge_mem_graph_expand | 围绕某条记忆展开相邻记忆和带标签的关系边。 |
nowledge_mem_status | 检查 Nowledge Mem 连接和配置。 |
会话捕获如何工作
Nowledge Mem 用三条互补路径捕获 Amp 会话：
自动实时捕获。 在 Amp 的 agent.end 事件上，插件通过 Amp thread API 读取当前会话，并以 source=amp 保存。每个 thread 的捕获会串行执行，所以手动保存和自动保存不会互相抢写出重复内容。
手动完整捕获。 nowledge_mem_save_thread 按需使用同一条捕获路径。它是幂等的，想立刻保存或排障时很有用。
精选交接。 nowledge_mem_save_handoff 保存结构化摘要，方便换到别的工具继续。它补充完整 transcript，不替代完整记录。
远程 Mem 可以工作，是因为插件运行在 Amp 所在机器上，能读取 Amp 持有的 transcript，然后上传到你配置的 Mem server。远端 Mem server 无法自己扫描你本机的 Amp 会话。
配置
本机使用不需要额外配置。
| 环境变量 | 默认值 | 作用 |
|---|---|---|
NMEM_API_URL | (local) | 远程 Nowledge Mem server URL |
NMEM_API_KEY | (none) | 远程访问 API key |
NMEM_SPACE / NMEM_SPACE_ID | (none) | 当前 Amp 会话的默认 Space |
NMEM_AGENT_ID | (none) | 当前运行使用的稳定 Nowledge AI 身份 |
NMEM_HOST_AGENT_ID | (none) | 高级外部 alias 映射 |
NMEM_AMP_AUTO_SYNC | 1 | 设为 0、false、off 或 no 可关闭自动会话捕获 |
NMEM_AMP_AUTO_SYNC_DEBOUNCE_MS | 1500 | 自动捕获的 debounce 时间 |
如果要持久连接远程 Mem，在运行 Amp 的机器上配置一次：
nmem config client set url https://your-server
nmem config client set api-key your-keyAmp 插件读取的就是 nmem 使用的同一份 Nowledge Mem 客户端配置。
安全自定义
使用 Amp 自己的指令入口，不要改已安装的插件 bundle：
- 项目规则：
AGENTS.md - 个人全局规则：
~/.config/amp/AGENTS.md
不要直接编辑 ~/.config/amp/plugins/nowledge-mem/ 下的文件。需要更新连接器时，重新运行安装脚本。
排障
插件没有加载。 重新运行 bash nowledge-mem-amp-plugin/scripts/install.sh，确认 ~/.config/amp/plugins/nowledge-mem.ts 存在，然后重启 Amp。
工具缺失。 运行 amp plugins list。如果插件不在列表里，说明 Amp 没加载入口；如果插件在但 tools 缺失，更新 Amp 后重新安装插件。
找不到 nmem。 从桌面端 Developer Tools 安装 CLI，或安装 nmem-cli，然后运行 nmem status。
Threads 没出现。 完成一个新的 Amp turn，等 agent.end 捕获运行，再用 nmem t search ... --source amp 搜索。如果仍为空，检查 NMEM_AMP_AUTO_SYNC，并手动运行一次 nowledge_mem_save_thread 做诊断。
相关
- 连接总览
- 通用 Agent Plugin
- OpenCode · Claude Code · Codex
- Amp 文档：Plugin API