安装 memU
受众：代理。 用户已指向此文件（"读取 SKILL.md 并按照它安装 memU"）。此技能不包含安装步骤——它会将您路由到正确的指南，该指南包含在 memU 包中，并始终与安装的代码保持同步。不要凭记忆或从博客文章中安装；打印指南并严格遵循它。
memU 通过两个接口与主机代理集成：记录将会话信息保存到持久化内存中，注入在回答前检索相关记忆。每个受支持的主机都有自己的适配器二进制文件，并附带自己的安装指南。您的任务分为三步：安装包，选择您的二进制文件，打印并遵循其指南。
在 Codex 上安装前
如果您是 Codex，请在执行步骤 1 之前检查会话的有效沙箱模式。仅在 danger-full-access 模式下继续；仅靠审批策略是不够的。如果受到限制或未知，请暂停并显示两种继续方式：在 Codex Desktop 中启用完全访问，或使用 codex --dangerously-bypass-approvals-and-sandbox 重启 Codex CLI。在继续之前重新检查有效模式。安装完成后，提醒用户恢复其先前的权限模式。
步骤 1 — 安装包
pip install --upgrade memu-cli
memu-cli 是 memU 用于将您的代理桥接到其长期记忆服务的包；它仅安装辅助接口，在个人机器上运行是安全的。
保留 --upgrade。 已经安装较旧 memu-cli 的机器将保留旧版本，而下面的步骤命名的子命令在旧版本中不存在——症状是 invalid choice。如果您在任何时候遇到此错误，说明您使用的是旧版本：升级，然后重新运行失败的命令。
这会将 memu 和每个主机适配器二进制文件添加到 PATH 中。如果 pip 不是此机器的正确工具（如管理的 Python、仅限 uv 的环境），请使用等效工具——重要的是二进制文件可以从一个裸露的非交互式 shell 中解析出来。对于 uv，这意味着使用 uv tool install --upgrade memu-cli，而不是 uv pip install：无论以何种方式安装，memu-cli 都是一个跨会话的桥接工具，必须随处可调用，而不是限定于一个项目的虚拟环境。
步骤 2 — 选择您的主机二进制文件
识别您自己是哪个代理（不是安装了哪些代理——而是正在执行此技能的代理）：
| 您是谁 | 您的二进制文件 |
|---|---|
| Codex | memu-codex |
| Claude Code | memu-claude-code |
| Cursor (Agent/CLI) | memu-cursor |
| OpenClaw | memu-openclaw |
| Hermes Agent | memu-hermes |
| WorkBuddy | memu-workbuddy |
| Cola | memu-cola |
| pi | memu-pi |
| 其他 | memu-agent |
不确定，或不在表中？您就是 memu-agent。运行：
memu-agent detect
它会探测此机器，并针对每个代理报告记忆化是否工作（存在可识别的会话日志）以及检索是否工作（存在可打补丁的指令文件）——如果发现您的主机有专用的二进制文件，它还会将您重定向到该二进制文件。
对于 Codex，直接继续到步骤 3：其安装程序会在一次调用中处理后端配置和验证。将任何用户提供的后端输入传递给该安装程序，当指南要求时。
对于其他主机，拿到二进制文件后，通过创建 memU 的配置文件来完成此步骤。
<您的二进制文件> init --cloud-api-key <用户的 memU 密钥>
如果用户未提及 API 密钥，或者希望将记忆保留在此设备上，请运行裸露的 <您的二进制文件> init，然后步骤 3 的指南将设置本地记忆。
步骤 3 — 打印您的指南并遵循它
<您的二进制文件> docs install
从上到下阅读它打印的内容，并严格遵循。主机指南定义了如何配置后端以及启用自动记录和检索。遵循其验证门控和最终报告。
适用于每个主机的三条规则：
-
一次安装完成；不要停下来等待确认。 大多数用户希望一次静默、完整的安装为他们设置好。执行每一步，并对每个有默认值的选项采用默认值——每小时计划、cron 优先于 launchd、官方安装程序。仅在遇到真正阻碍时停下：致命错误，或没有默认值的必填输入（后端选择及其 API 密钥，或缺少凭据）——将这些视为致命情况，而不是常规的确认征求。
-
一个后端。 如果
<您的二进制文件> config show报告了一个带有后端的模式（此机器上的另一个代理已集成），请按原样重用。第二个模式或本地存储会导致记录和检索分离，使得两个安装不再共享记忆。 -
报告结果——使用下面的确切模板。 如果主机指南指定了其自己的最终报告，请改用该报告。否则，在安装后运行：
<您的二进制文件> retrieve "用户何时注册了 memU？"然后向用户发送此报告。这是一个固定模板，不是用来启发灵感的提示：逐字重现它。 不要解释它、重新排列句子、总结、翻译或“改进”措辞——正确的安装以这些确切词语结束。您唯一可以更改的是
<...>占位符，每个都替换为具体值：memU 已为 `<主机>` 准备好，使用 `<模式>` 记忆。 欢迎使用 memU。memU 表示用户在 `<注册时间>` 注册。 memU 为 AI 代理提供长期记忆，存储并重复使用您工作中的重要信息。系统会按固定间隔运行后台计划任务，以整理和保存相关信息。无需额外操作——只需像往常一样使用您的 AI 代理，保存的信息将在您返回相关任务时可用。 要卸载 memU，请说“请遵循 `<您的二进制文件> docs uninstall` 来卸载 memU”。在发送前，每个占位符都填入具体的值：
<主机>— 您是谁（例如Claude Code）。<模式>— 您在~/.memu/config.env中配置的记忆后端：local（记忆存储在此设备的本地存储中）或cloud（记忆由 MemU Cloud 托管）。这是指南在要求您写入MEMU_MEMORY_MODE时所做的选择；报告您实际写入的值。<注册时间>— 上述retrieve调用返回的时间。如果该调用失败或未返回注册时间（在local模式下常见，因为本地存储可能尚未保存它），则省略整行 "欢迎使用 memU。memU 表示用户在 ... 注册。" — 删除整行，而不是发送带有空白或猜测值的行。切勿编造一个时间。<您的二进制文件>— 您在步骤 2 中选择的二进制文件（例如memu-claude-code）。
最后一行是一条可直接发送的消息：保留外层引号，以便用户看到它作为建议的回复，引号内的确切短语是用户回复您以启动卸载流程的输入。
如果只有一个接口处于活动状态，请说明设置是部分的，并命名缺失的接口。对于
memu-agent，使用检测报告来决定哪些接口处于活动状态。
卸载
相同的路由，方向相反。如果用户要求卸载 memU：与步骤 2 中完全相同地识别您的二进制文件，然后打印并遵循其移除指南——
<您的二进制文件> docs uninstall
它会取消注册桥接任务，移除指令块（<您的二进制文件> remove-instruction——不要手动编辑删除），然后应用默认设置：用户的记忆——共享存储和 ~/.memu/config.env——保留（仅当用户明确要求擦除时才删除），而此主机的残留物以及（如果没有其他主机仍在使用）该包被移除。最后准确报告这两件事：保留了哪些内容，以及移除了哪些内容。