用原生插件把跨工具记忆接入 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
nmem CLI 在 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-key

Amp 插件读取的就是 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 做诊断。

Amp × Nowledge Mem