没有专属适配器的 agent 如何接入 memU用 memu-agent detect 判定 memorization 与 retrieval 支持【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU如果你的 agent 不在 memU 的专属适配器名单里Codex、Claude Code、Cursor、OpenClaw、Hermes 等各有各的二进制就需要走通用适配器memu-agent。接入的第一步不是配置而是判定memu-agent detect会探测你的机器逐个报告每个 agent 的两条接缝是否可用——memorization记录接缝要求存在可识别的 JSONL 会话日志和retrieval注入接缝要求存在可打补丁的指令文件。判定结果决定后面做哪些步骤两条都不可用则直接终止。memU 的集成包是memu-cli通用适配器的完整安装指南打包在 src/memu/hosts/generic/INSTALL.md 中路由入口在 SKILL.md。准备安装 memu-cli 并保留--upgradepip install --upgrade memu-cli--upgrade不能省已经装过旧版memu-cli的机器会一直保留旧版而旧版对init、config、detect等子命令只会回答invalid choice。安装过程中或之后任何位置遇到这个错误说明你停在旧构建上——升级后重跑失败的那条命令即可。这个包把memu和所有 host 适配器二进制放进PATH之后所有 memU 侧操作都是裸命令不需要写脚本绝对路径。如果机器用uv管理 Python对应的是uv tool install --upgrade memu-cli不是uv pip install关键是这些二进制必须在非交互 shell 里也能解析到。运行 detect扫描全部或只探测一个目录memu-agent detect不带参数时detect扫描~下的 agent 安装目录跳过.git、.cache等非 agent 目录逐个输出判定。只想知道某个 agent 的情况直接给它一个目录memu-agent detect ~/.someagent整个探测是只读的不写任何文件。detect对每个候选目录按顺序回答两个问题会话日志的记录是否嗅探出已知 JSONL 方言memorization以及是否存在AGENTS.md、CLAUDE.md、SOL.md一类可打补丁的指令文件retrieval。没有扫描到 agent 时输出no agent installations found under ~扫描成功时结尾会附上下一步命令提示形如next steps: for a dedicated adapter, run its install guide; otherwise memorization → memu-agent prepare --session-dir dir (schedule via memu-agent docs task) retrieval → memu-agent install-instruction --path file一个探测到会话日志和指令文件的目录输出类似以下数值为文档示例实际以你机器上的探测结果为准~/.someagent memorization: works — 12 session file(s), 200/200 sampled record(s) recognized (154 conversation, 46 tool) retrieval: works — instruction file ~/.someagent/AGENTS.md (install with memu-agent install-instruction --path ~/.someagent/AGENTS.md)如何读判定结果对每个 agentdetect给出四种结局之一处理方式各不相同memorization: works— 找到了.jsonl会话文件且抽样记录的对话/工具条数被识别出来。记下报告中的目录路径Part 2注册定时 bridging 任务要用它作为--session-dir。注意如果会话存在 SQLite 等嗅探器读不了的容器里memorization 会明确报不可用并指向具体文件——这种情况下通用适配器挖不到它的会话需要专属适配器如memu-hermes的做法不是配置问题。retrieval: works— 找到了指令文件。记下路径Part 3 的install-instruction --path要用它。如果全局文件没找到但该 agent 会读项目根目录的AGENTS.mdretrieval 仍然按项目可用在各自项目内运行memu-agent install-instruction不带--path即可这属于文档明确的替代路径。dedicated adapter— 该 agent 其实有自己的二进制memu-codex、memu-claude-code、memu-cursor、memu-openclaw、memu-hermes。停下来改用专属适配器binary docs install不要继续走通用流程。两条都不 work— 到此为止。文档的判定很直接memU 目前无法与该 agent 集成no amount of setup changes that继续配置只会得到静默失败。判定结果要如实告知使用者——memorization works、retrieval works、两者兼有还是都没有以及为什么找到了什么、在哪里。部分集成比如只有 retrieval本身是合法结局但必须把缺的那一半讲清楚而不是当成安装失败。判定通过后的连续操作路径以下各步都带有 verify 门槛当前门槛不过就不进入下一步完整命令与约束见 src/memu/hosts/generic/INSTALL.md。Part 1 — 配置记忆后端必做。不要手写~/.memu/config.env所有 memU host 共享这一个文件且必须保证记录与检索落在同一后端、同一嵌入空间否则检索一直成功却查不到任何东西。直接配置的话运行memu-agent init --cloud-api-key the users memU key没有云端 key 或想把记忆留在本机就用裸memu-agent init。init幂等重跑无害。查看已有状态用只读的memu-agent config show如果报告已有一个带后端的模式说明这台机器上别的 memU host 先接入了直接复用不要改身份三件套--db、--embed-provider、--embed-model——config会拒绝修改已设置的这三项因为它们绑定了既有向量所在的嵌入空间。验证门槛memu-agent doctor它打印解析出的模式及其端点或本地存储/嵌入提供方必须干净退出。新后端上冒烟检索零命中是预期结果不算失败。Part 2 — Memorization仅当 detect 判定可用。按打包流程注册定时任务memu-agent docs task摘要就是与使用者敲定调度默认每小时注册一个周期性运行其 prompt 执行memu-agent prepare --session-dir detected dir按顺序处理~/.memu/hosts/agent/jobs/*.txt然后memu-agent commit。detected dir换成 detect 报告中 memorization 那条给出的目录路径。同一台机器接入多个通用 agent 时每个任务加--base-dir ~/.memu/hosts/name隔离工作树。验证门槛手动跑一次 preparememu-agent prepare --session-dir detected dir它应报告准备了多少个会话没有新会话时报告零是正确的。Part 3 — Retrieval仅当 detect 判定可用。把 memU 的常驻检索指令打进 detect 找到的指令文件memu-agent install-instruction --path detected filedetected file替换为 detect 报告中 retrieval 那条的文件路径。命令是追加而非覆盖原内容备份到file.bak幂等重跑或后续 memU 版本会就地替换标记块。验证门槛cat detected file memu-agent retrieve smoke testmemU 块必须恰好出现一次、原有内容完好retrieve干净退出空列表也没关系。agent 新开一个 session 后就会读到这份指令文件。收尾向 memU 报告结果memU 对安装是否成功是盲的——装死在 Part 2 的安装和根本没尝试过的外观看起来一样。所以无论这一轮以哪种方式结束都用一条命令收尾尽力而为失败可忽略全部门槛通过时memu-agent report install中途停下的话memu-agent report error --stage install --detail 完整说明发生了什么--detail要写足停在哪个门槛、跑了什么、和文档预期相比发生了什么、已试过什么、你认为的原因——不要粘贴 traceback 或原始输出也不要写入 API key、绝对路径、DSN 或记忆内容。最后向使用者汇报三件事哪些接缝生效memorization 来自哪个会话目录retrieval 打进了哪个指令文件或都没有、选定的模式及其端点/本地存储、定时任务和指令文件的落点。两条接缝读同一个~/.memu/config.env因此天然共享同一后端——这个 agent 的会话教会 memU 的内容机器上其他已接入的 agent 也能检索到。相关文档通用适配器安装指南含全部 verify 门槛与排障如本地嵌入服务器经代理返回 502 的处理src/memu/hosts/generic/INSTALL.mddetect 机制的设计决策与局限嗅探是启发式的未识别方言归为OTHER宁可少挖不误挖docs/adr/0011-generic-host-adapter.md判定与渲染逻辑源码src/memu/hosts/generic/detect.py定时 bridging 任务的注册细节cron 的 PATH 行、prompt 落盘避免 1 KB 截断src/memu/hosts/generic/BRIDGING_TASK.md安装路由入口SKILL.md【免费下载链接】memUPersonal memory across agents项目地址: https://gitcode.com/GitHub_Trending/mem/memU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考