Agent 问题
修复启动上下文、召回 hooks、MCP 工具和过期 Agent 记忆。
Agent 问题通常是本地配置问题,而不是服务器记忆问题。
检查什么
检查:
| 运行时 | 重要文件/设置 |
|---|---|
| Claude Code | ~/.lore/config.json、MCP server、插件 hooks,以及残留的旧版 CLAUDE.md 导入 |
| Codex | ~/.lore/config.json、~/.codex/config.toml、~/.codex/hooks.json、MCP server、插件启用状态 |
| OpenClaw | ~/.lore/config.json、~/.openclaw/openclaw.json 插件 entry,以及可选 baseUrl / apiToken 覆盖 |
| Pi | ~/.lore/config.json、${PI_CODING_AGENT_DIR:-~/.pi/agent}/extensions/lore 下的扩展 symlink,以及可选插件配置覆盖 |
| Hermes | ~/.lore/config.json、插件 symlink,以及可选环境变量兜底 |
| OpenCode | OpenCode 1.18.3 或更新版本、共享 ~/.lore/config.json,以及来自预发布 v1.3.15-pre.4 / lore-opencode.zip 的 ~/.config/opencode/plugins/lore-memory.js |
修改这些内容后,重启运行时。Hooks 和 MCP 配置通常在进程启动时加载。
OpenCode 检查
- 如果没有原生 Lore 工具,确认插件文件包含
@lore-managed-opencode-plugin,并确认 CLI 达到已验证的 OpenCode 1.18.3 基线。 - 如果工具已出现,确认精确名称包含
lore_guidance、lore_status和lore_move_node。lore_lore_search这类名称说明配置的是 MCP,而不是标准原生插件。 - 如果 Boot 缺失,但工具和 prompt Recall 正常,可能是
experimental.chat.system.transform不可用。这是预期的 fail-open 模式:插件只警告一次,不修改用户消息,chat.messageRecall 仍会继续。 - 如果所有 Lore 调用失败,检查
~/.lore/config.json、服务器健康、token 和网络。除了健康检查,插件 REST 请求都会标记client_type=opencode。 - 如果
~/.config/opencode/plugins/lore-memory.js已有未标记文件,安装器会有意保留它。若要让 Lore 管理该路径,请自行移走旧文件后重试。 - 如果 OpenCode 同时显示
lore和lore:lore、其中一个报告 SSE 错误,或者 SaaS 面板对一次 prompt 记录了多个 client type,说明其他插件导入了 Claude Code 的 Lore 兼容数据。原生插件会在配置合并后删除重复 Lore MCP。安装器会单独阻止更早发生的 Claude Lore 生命周期 hook 导入:仅对已有且可安全解析的用户级oh-my-openagent.json[c]或旧版oh-my-opencode.json[c]设置claude_code.plugins_override["lore@lore"] = false。该修改保留无关设置和 JSONC 注释,不会修改 Claude Code 文件;若兼容配置不安全或无法解析,安装器会警告并跳过。重新安装后重启 OpenCode。 - 卸载 OpenCode 集成会恢复 Lore 记录的
lore@lore原值。如果安装后你自行修改了这个值,卸载器会保留你的新值。 - OpenCode 标准安装不得创建 MCP entry。只有原生插件无法加载时,才使用
/api/mcp?client_type=opencode作为手动兜底。若明确需要让旧版 MCP 与原生插件并存,请在运行安装器和启动 OpenCode 时都设置LORE_OPENCODE_ALLOW_MCP=1;使用逃生开关重新安装会恢复原兼容值。
重新安装预发布版:
Shell
其他运行时如果 MCP 可用但没有 recall,检查 hook 配置。OpenCode 则检查原生插件加载和 chat.message。如果 recall 出现但 Agent 不使用它,改善本地 guidance,并验证 Agent 会先打开召回节点再依赖内容。