IHMT-MEMORY Skill 技能

技能简介

IHMT-MEMORY 是一个开源的长期记忆 MCP 服务器，为 AI 编程助手（Claude Code、Codex、opencode 等）提供跨会话、跨项目、跨模型的持久记忆能力。你只需告诉助手一次——一个技术决策、一套环境配置、一次纠错——它就会在未来所有会话、所有项目、所有助手里记住这件事。记忆以纯文本文件树的形式保存在本地磁盘，不依赖云服务、数据库或账号，可复制、可备份、可进版本库。

核心能力

• 跨会话记忆：决策及其原因、环境信息、个人偏好、人物与项目上下文、纠错记录都会保留；助手回答前先检索记忆，把值得长期保存的内容自动写入，用户不再每次重复交代
• 多助手共享一份记忆：Claude Code、Codex、opencode 读写同一份记忆树，一个助手保存的内容另一个能找到；已在 Anthropic、OpenAI、Google、Meta 的模型上实测
• 省 token 的树式检索：按问题只取所需片段，典型检索 200~900 token，无论记忆里是 50 条还是 50,000 条，因为搜索沿树行走而非通读全部
• 时间感知：当事实变化（如"我搬到 Valencia 了"），旧事实保留为历史并标记 OUTDATED，再次被问及时自动提示；遇到歧义（如"Luis 是哪位？"）宁可追问也不猜测
• 本地私有可迁移：全部数据落在本机，每条记忆都是可直接打开阅读的文本文件，整个记忆就是一个文件夹，换电脑、做备份、纳入 git 都能直接工作

安装配置

• 环境要求：Python 3.10+、git、一个能执行命令的 AI 助手（纯聊天助手无法安装）；macOS 自带 python3 为 3.9 需注意
• 一键安装：把"Install the IHMT memory MCP server for me from https://github.com/gonzaroman/IHMT-MEMORY — follow the instructions in its INSTALL.md."粘贴给助手，由助手按 INSTALL.md 下载到 ~/IHMT-MEMORY、记忆存 ~/.ihmt 并注册为自身 MCP 服务器
• 手动安装：git clone 后创建 venv、pip install -r requirements-mcp.txt，再用 claude mcp add ihmt-memory -s user -e IHMT_HOME="$HOME/.ihmt" -- ... 注册（服务器名须在 -e 之前），最后把 templates/memory-instructions.md 追加进 ~/.claude/CLAUDE.md
• 兼容性：官方支持 Claude Code，已实测 Codex（CLI 与 ChatGPT 桌面端）与 opencode；作为标准 stdio MCP 服务器，Copilot、Cursor、Windsurf、Gemini CLI、Claude Desktop 等客户端理论上均可接入并共享同一份记忆

使用步骤

1. 安装：将安装提示粘贴给目标助手，或按 INSTALL.md 手动克隆并注册 MCP 服务器
2. 重启会话：开新会话让记忆工具完成加载
3. 写入记忆：正常对话中让助手记住决策、偏好与环境信息，助手判断值得长期保存的内容会存入记忆树
4. 检索复用：之后任何会话提问时，助手先沿记忆树检索相关内容（典型 200~900 token）再作答
5. 多端接入：在其他助手里粘贴同一条安装提示，即可连上同一份记忆

适用场景

• 长期结对编程：把架构决策、代码规范、历史踩坑记住，新会话不再从零解释
• 多工具并用：Claude Code 写码、Codex 补测试、opencode 改文档，三者共享同一份项目认知
• 个人环境固化：本机路径、部署方式、账号结构讲一次即可，换项目依然生效
• 团队知识传承：记忆文件夹随仓库或网盘流转，新人接手直接读到前任的决策脉络

适用人群

重度使用 AI 编程助手的开发者、在多个助手/多个模型间切换的效率型用户、需要长期维护同一项目的独立开发者与小团队，以及重视数据本地化与隐私、不愿把记忆存到云端的工程师。

工作原理

IHMT 以标准 stdio MCP 协议接入助手，记忆按主题组织成目录树，每条记忆是一条带元数据的纯文本文件。检索时服务端沿树逐层定位候选分支，只把命中的少量条目返回给模型，因此上下文占用与记忆总量基本无关；写入时由助手调用记忆工具完成归档与更新，事实变更通过追加历史并标记过期状态来实现时间感知。整个过程无云端依赖，模型只看到被检索出的那部分记忆。

官方链接

GitHub 仓库：https://github.com/gonzaroman/IHMT-MEMORY （开源，含 INSTALL.md 与 GUIDE.md 完整文档）