ZCode
通过 Lore 插件接入 ZCode:生命周期钩子加本地 MCP 桥接。
ZCode 接入会为 ZCode 安装 Lore 插件。ZCode 从其运行时的启动记忆(boot)节点获得启动记忆,每条提示词前获得召回,并通过本地 MCP 桥接获得 Lore 记忆工具。
安装
在使用 ZCode 的机器上运行:
npx @loremem/cli install --channels zcode接入 Loremem 云服务时,传入服务器地址和项目令牌:
npx @loremem/cli install --base-url https://api.loremem.com --api-token lm_your_token --channels zcode如果 zcode 命令不在 PATH 中,安装程序会跳过 ZCode。安装完成后,请重启 ZCode。
安装内容
- 来自
lore-zcode.zip的插件文件,位于~/.lore/zcode/。安装程序会把该目录注册为lore插件市场,如果列表中没有lore@lore,则安装它,并通过zcode plugins enable lore@lore启用。每次安装时,插件市场都会先移除再重新添加。 - 名为
lore的本地 MCP 桥接。它把 MCP 请求转发到<server>/api/mcp?client_type=zcode。ZCode 中的工具带有mcp__plugin_lore_lore__前缀。 - 两个钩子。
SessionStart在startup、resume和clear时运行,加载启动记忆,超时时间为 8 秒。UserPromptSubmit为每条提示词添加召回,超时时间为 10 秒。 - 技能工具,仅在服务器声明支持技能时出现。
验证
- 运行
npx @loremem/cli status。zcode一行应显示installed。 - 运行
zcode plugins list。输出中应包含lore@lore。 - 检查
core://agent/zcode是否有内容。参见下方的注意事项。 - 开始一个新的 ZCode 会话,让它调用
lore_status。该工具名为mcp__plugin_lore_lore__lore_status。 - 发送一条与已有记忆相关的项目提示,然后询问 ZCode,这条提示收到了哪些记忆节点。
注意事项
- ZCode 启动记忆节点。 ZCode 从
core://agent/zcode加载启动记忆。如果该节点为空,请用你希望 ZCode Agent 开始工作时遵循的规则创建它。请使用控制台中的记忆页面;自托管服务器上,该页面为/memory。 - 失败放行。 如果无法访问 Lore,钩子会在没有输出的情况下退出,ZCode 继续工作。
- 配置。 桥接和钩子读取
${LORE_HOME:-~/.lore}/config.json。环境变量LORE_BASE_URL、LORE_API_TOKEN和API_TOKEN是备用来源。令牌不会出现在插件清单或命令参数中。 - 技能。 除非服务器声明支持技能,否则技能保持关闭。设置
LORE_SKILLS_ENABLED=0可以强制关闭技能。 - 修改后重启。 修改配置或令牌后,请重启 ZCode。
手动安装(备用方案)
只有当安装程序无法运行时,才使用以下步骤。它们通过 ZCode 命令安装相同的插件。
mkdir -p ~/.lore/zcode
curl -fsSL -o lore-zcode.zip https://github.com/FFatTiger/lore/releases/latest/download/lore-zcode.zip
unzip -qo lore-zcode.zip -d ~/.lore/zcode
rm lore-zcode.zip
zcode plugins marketplace add ~/.lore/zcode
zcode plugins install lore@lore
zcode plugins enable lore@lore把服务器配置写入 ~/.lore/config.json,然后重启 ZCode:
{
"base_url": "https://api.loremem.com",
"api_token": "lm_your_token"
}卸载
npx @loremem/cli uninstall --channels zcode -y如果 zcode 在你的 PATH 中,这条命令会卸载 lore@lore 并移除 lore 插件市场,然后删除 ~/.lore/zcode。卸载后请重启 ZCode。
如果 ZCode 无法加载 Lore,请参见Agent 接入问题。