SkillMap

Sep 23, 2026

memU 给你的编程 Agent 一份超出会话生命周期的记忆

一个 14k-star 的记忆系统，把 agent 的会话历史蒸馏成共享、可检索的 wiki——上周摸索出的工作流，下个月在任意设备、任意 agent 里都能检索回来。

#tutorial#agent-tools#context-engineering#ai-agents

每个编程 Agent 都在会话结束的那一刻把你忘掉。memU 是一个 14k-star、Apache-2.0 协议的记忆系统，专门解决这个问题：它挖掘 agent 的会话历史，把可复用的部分蒸馏成 Markdown 技能与记忆，并在 agent 回答之前把相关片段注入回去——跨会话、跨 Agent、跨设备。

为什么这个 Skill 重要

上下文窗口会重置，但你的项目知识不应该重置。memU 以 sidecar 形式伴随桌面编程 Agent 运行——README 列出的已测试集成包括 Codex、Claude Code、Cursor、OpenClaw、Hermes、WorkBuddy、Cola 和 pi——并把它们全部指向同一个共享记忆后端。你的 Codex 会话学到的东西，你的 Claude Code 会话可以检索回来。

两个设计选择让它经得起审视。核心记忆逻辑只有 500 行，小到可以读完并按需改造。判断力留在你的 agent 手里：MemoryService 组件不做任何 LLM 或聊天调用——它只存储、嵌入并检索 agent 准备好的 Markdown。

安装

README 的快速上手就是给 agent 发一条消息。先从 memu.so 拿到 API key，然后发送：

Read https://memu.pro/SKILL.md, follow its instructions to install and configure memU, API Key is memu_•••••••••(get Api Key from memu.so).

如果想自托管——私有、单设备、用自己的存储与嵌入提供商——README 给了一条指向仓库 SKILL.md 的平行消息：

Read https://raw.githubusercontent.com/NevaMind-AI/MemU/main/SKILL.md and follow it to install memU.

也可以直接安装 CLI：

pip install memu-cli         # library + memu + memu-codex CLIs
npx memu-cli --help          # CLI via npm launcher (engine: PyPI package memu-cli)
uvx --from memu-cli memu     # CLI via uv, no install

实战：让 Claude Code 记住一次调试突破

  1. 发送快速上手消息。SKILL.md 会引导 agent 完成安装：识别宿主、打印该宿主的安装指南、配置记忆后端、注册定时桥接任务、修改指令文件——每一步都有校验门禁。
  2. 对 Claude Code 来说，memu-claude-code 适配器挖掘 ~/.claude/projects/<project>/<session>.jsonl，并在 ~/.claude/CLAUDE.md 里加一条常驻指令，让 agent 在回答前先执行检索。
  3. 用 doctor 命令验证整条链路：
memu-claude-code doctor
  1. 然后照常干活。定时任务把新的会话日志切成自包含的作业；你的 agent 阅读相关的既有技能，然后自行决定什么都不做、修补某个技能，还是新建一个——把有用的分支、边界情况和坑写成可读的 Markdown。
  2. 几周后，在任何接入了的 agent 里直接问，或者手动检索：
memu-claude-code retrieve "What should I remember about this project?"

常驻指令就位后，检索会在回答前自动发生；手动命令留给你主动查看 memU 知道些什么。

技巧

  • 如果选中的模型拒绝执行安装步骤，README 的 agent 支持说明建议换 Opus 或其他模型重试——Sonnet 5 偶尔会拒绝。
  • 按 README 的说法，云模式跨设备且免费；本地模式需要嵌入提供商（OpenAI、Jina、Voyage、Doubao 或 OpenRouter）和一个 MEMU_DB 存储——默认 SQLite，并发场景用带 pgvector 的 Postgres。
  • MEMU_MEMORY_MODE 选择 Local 或 Cloud；不设置时保持 Local，向后兼容。
  • 改完配置跑一次适配器的 doctor 子命令——它会打印解析出的模式并实测一次真实检索。
  • 默认情况下，卸载会保留你的记忆库和 ~/.memu/config.env，重装可以从原处继续；只有你明确要求时才会清除记忆。

何时不用这个 Skill

集成矩阵把 Claude（Chat 和 Cowork）以及 ChatGPT 的 Chat 模式标记为不支持——memU 面向的是有会话日志可挖的编程 Agent。如果你的工作是一次性的单会话任务，一条 CLAUDE.md 备注更简单。如果你不想让任何第三方看到你的历史记录，用自托管路径而不是云 key。

查看 排行榜 了解更多 skill。