Pi
为 Pi 安装 Lore 扩展,获得启动记忆、召回和记忆工具。
Pi 接入会为 Pi 安装一个 Lore 扩展。Pi 会在系统提示中获得启动记忆(boot),每条提示词前获得一条召回消息,并能使用 Lore 记忆工具。
安装
在使用 Pi 的机器上运行:
npx @loremem/cli install --channels pi接入 Loremem 云服务时,传入服务器地址和项目令牌:
npx @loremem/cli install --base-url https://api.loremem.com --api-token lm_your_token --channels pi如果 pi 命令不在 PATH 中,安装程序会跳过 Pi。安装完成后,请在 Pi 中运行 /reload,或者重启 Pi。
安装内容
- 来自
lore-pi.zip的扩展文件,位于~/.lore/pi/。 - 一个指向
~/.lore/pi/的链接,位于~/.pi/agent/extensions/lore。Pi 从~/.pi/agent/extensions/加载扩展。 - 九个记忆工具:
lore_status、lore_boot、lore_get_node、lore_search、lore_list_domains、lore_create_node、lore_update_node、lore_delete_node和lore_move_node。在支持技能的服务器上,还会增加七个lore_skill_*工具。 - 会话开始时,启动上下文会追加到 Pi 的系统提示中。Pi 每一轮都会重建系统提示,因此扩展会在每一轮重新追加该上下文。
- 每条提示词之前会加入一条召回消息。该消息在聊天界面中是隐藏的。
- 会话开始时默认执行一次健康检查。如果 Pi 能显示通知,会显示
Lore connected: <服务器地址>。
验证
- 运行
npx @loremem/cli status。pi一行应显示installed。 - 运行
ls -l ~/.pi/agent/extensions/lore。输出应显示一个指向~/.lore/pi的链接。 - 在 Pi 中运行
/reload。Pi 应显示Lore connected: <服务器地址>。 - 让 Pi 调用
lore_status。它应返回服务器的健康状态。 - 发送一条与已有记忆相关的项目提示,然后询问 Pi,这条提示收到了哪些记忆节点。
注意事项
- 修改后重载。 安装或修改配置后,请在 Pi 中运行
/reload,或者重启 Pi。 - 已有目录。 如果
~/.pi/agent/extensions/lore是一个真实目录,而不是链接,安装程序会停止,并保持该目录不变。请先把该目录移走,再重新运行安装。 - 服务器配置。 Pi 从
~/.lore/config.json读取服务器地址和令牌。如果设置了LORE_HOME,Pi 会读取该目录下的config.json。LORE_BASE_URL和LORE_API_TOKEN是备用来源。 - 技能列表。 Lore 同步过去的技能要等到下一次会话,或运行
/reload之后才会出现在 Pi 里,因为 Pi 在会话开始时构建自己的技能列表。
手动安装(备用方案)
只有当安装程序无法运行时,才使用以下步骤。它们会设置相同的链接和文件。
mkdir -p ~/.lore/pi ~/.pi/agent/extensions
curl -fsSL -o lore-pi.zip https://github.com/FFatTiger/lore/releases/latest/download/lore-pi.zip
unzip -qo lore-pi.zip -d ~/.lore/pi
rm lore-pi.zip
ln -s ~/.lore/pi ~/.pi/agent/extensions/lore如果 ~/.pi/agent/extensions/lore 已经存在,ln 命令会失败。请先删除旧的条目。然后把服务器配置写入 ~/.lore/config.json,并在 Pi 中运行 /reload:
{
"base_url": "https://api.loremem.com",
"api_token": "lm_your_token"
}卸载
npx @loremem/cli uninstall --channels pi -y这条命令会移除 ~/.pi/agent/extensions/lore 处的链接,并删除 ~/.lore/pi。如果该路径是真实目录,则保持不变。卸载后,请在 Pi 中运行 /reload。
如果 Pi 无法加载 Lore,请参见Agent 接入问题。