在 Pi 中使用跨工具知识库，让 Pi 的每次会话都能调用你在其他工具中积累的决策、经验和上下文。

给你的智能体

把这行交给你的智能体。它应该先使用统一安装指南；这一页保留为行为说明和排障参考：

读取 https://mem.nowledge.co/SKILL.md，按其中说明为 Pi 安装或更新 Nowledge Mem。用 nmem status 和 Context Bundle 或 Working Memory 检查验证结果，并总结你改了什么。

一键安装

pi install npm:nowledge-mem-pi

Pi 是一款精简的终端编程智能体。Nowledge Mem 为它补充跨工具知识：来自 Claude Code、Cursor、Codex 等工具的决策和经验，在 Pi 中即刻可用。安装插件包之后，Pi 中完成的会话也会同步回 Nowledge Mem，之后你可以在其他工具里搜索到这些对话。

插件包现在有两条自动路径：Pi 会在会话启动时收到 Context Bundle 或 Working Memory，完成后的 Pi 对话也会同步成可搜索的 Threads。Skills 仍然用于会话中的检索、保存决策和显式交接。

准备工作

Nowledge Mem 已在本地运行（安装指南）
Pi 已安装
nmem CLI 已在 PATH 中。在 Nowledge Mem 中前往 设置 → 偏好设置 → 开发者工具 → 安装 CLI，或执行 pip install nmem-cli

nmem status   # 确认 Nowledge Mem 正在运行
pi --version  # 确认 Pi 可用

安装

安装插件包

pi install npm:nowledge-mem-pi

验证集成

让 Pi 检查与 Nowledge Mem 的连接：

Nowledge Mem 连上了吗？运行一下 status 技能。

你应该会看到连接信息，以及服务器可达的确认。看到这些就说明通了：Pi 现在能用上你在其他工具里积累的知识。

安装或更新后，重新开启一个 Pi 会话。Pi 应该已经在系统上下文里拿到 Nowledge Mem 的启动上下文，不需要再为了知道今日 Context Bundle 而主动运行 read-working-memory 技能。

更新

pi update

更新后请重启 Pi，让 Nowledge Mem 扩展重新加载。

导入旧会话

自动同步会从安装插件包之后开始。如果你想把更早的 Pi 会话也导入 Nowledge Mem，可以运行一次历史导入。

先预览：

nmem t sync --from pi --limit 20

确认无误后再导入：

nmem t sync --from pi --apply

这个命令会读取本机的 Pi 会话文件，并写入 CLI 或扩展当前配置的 Mem 服务器。它可以重复运行：Pi 会话 ID 会变成稳定的 Thread ID，重复消息会被自动去重。

常用过滤：

nmem t sync --from pi --session-dir ~/.pi/agent/sessions --limit 20
nmem t sync --from pi --space work --apply

传入 --session-dir 时，只扫描这个目录。不传时，命令会使用 Pi 的默认会话目录。

如果你安装的 nmem 还没有 t sync，可以先用插件包自带的备用命令：

npx -p nowledge-mem-pi nowledge-mem-pi-sync --apply

安全地自定义

优先使用项目自己的 AGENTS.md，而不是去改安装后的包缓存。

如果你希望 Pi 在这个仓库里更主动地检索或保存，就把包里的行为指引合并进项目 AGENTS.md
把包文件保留为默认值，这样升级时不会把你的微调冲掉

Pi 目前没有单独的持久 override 文件，最稳妥的入口就是项目级行为指引。完整对照表见安全地自定义连接行为。

你能做什么

让 Pi 对话自动进入 Threads

插件包包含一个原生 Pi 扩展。安装之后，每轮对话完成后、切换会话、压缩上下文或退出时，它会把当前 Pi 会话分支同步成 Nowledge Mem 里的 pi 对话。

在 Pi 中查找其他工具的知识

问一句"数据库方案之前定了什么？"，Pi 就可以去搜索你在 Claude Code 中做过的决策、在 ChatGPT 中获得的洞察、在 Cursor 中留下的笔记，而不仅仅是当前会话。

保存知识，全局可用

当你在 Pi 中得出结论时，可以让 distill-memory 把它存下来。这样你下次打开 Claude Code、Cursor 或 ChatGPT 时都还能找到。

会话一开始就有上下文

扩展会优先注入 Context Bundle，必要时回退到 Working Memory。只要你的 Mem 服务支持，Pi 启动时就会拿到 owner identity、AI Identity、当前 scope、Rules 和今日重点。

项目 AGENTS.md 仍然有价值，但它负责的是行为偏好，而不是启动上下文：你可以用它让 Pi 在某个仓库里更主动地检索和保存。

创建可恢复的交接

自动同步会保留对话本身。当你明确让 Pi 保存交接时，它还会额外生成一份结构化摘要，方便你到 Claude Code 或其他工具里继续接着做。

技能一览

技能	说明
`read-working-memory`	读取今日 Working Memory：关注领域、优先事项、近期动态。
`search-memory`	跨工具搜索知识，支持标签和日期过滤。
`distill-memory`	保存一个决策、洞察或偏好，让任何工具都能找到。
`save-thread`	在你明确需要时，额外生成一份结构化交接摘要。
`status`	连接状态与配置诊断。

配置

本地使用无需配置。

环境变量	默认值	说明
`NMEM_API_URL`	(本地)	远程 Nowledge Mem 服务器地址
`NMEM_API_KEY`	(无)	远程访问的 API 密钥
`NMEM_SPACE`	(默认空间)	这个 Pi 进程使用的可选记忆空间
`NMEM_AGENT_ID`	(无)	多智能体编排时使用的 Mem AI Identity
`NMEM_HOST_AGENT_ID`	(无)	高级外部别名

如果你想用一套持久化的共享配置，先在这台机器上执行 nmem config client ...。Pi 扩展会读取与 CLI 相同的 ~/.nowledge-mem/config.json。如果只是临时覆盖，环境变量的优先级仍然更高。

远程访问

nmem config client set url https://your-server
nmem config client set api-key your-key

参见随处访问 Mem。

常见问题

**找不到 nmem 命令。**执行 pip install nmem-cli，然后运行 nmem status 确认连接正常。

**服务器无响应。**启动 Nowledge Mem 桌面应用，或用 nmem status 检查诊断信息。

**技能未加载。**用 pi list 确认插件已安装。如果看不到 nowledge-mem-pi，请重新安装：pi install npm:nowledge-mem-pi。

**Pi 对话没有出现在 Threads。**安装或更新后先重启 Pi，然后进行一次包含用户消息和助手回复的短对话，再检查：

nmem t list --source pi -n 5

扩展会刻意跳过只有一条消息的会话，避免 /new 或空会话制造噪音。

**旧 Pi 对话没有出现。**自动同步无法看到安装插件包之前已经发生的会话。请用 nmem t sync --from pi 预览并导入历史 Pi 会话文件。

Pi × Nowledge Mem