内容
# 内存映射
**适用于Claude的完整内存循环。快照、回忆和修剪项目上下文，跨会话。**
[](https://opensource.org/licenses/MIT)
[](https://github.com/shandar/memory-map/releases)
[](#install)
[](https://docs.claude.com)
三个技能，捆绑为一个插件。在claude.ai、Claude Code、Cursor、Windsurf和Codex CLI中均可使用。
---
## 问题
每次新的Claude对话都从空白开始。
您需要重新解释您的项目。您需要重新描述您正在构建的内容。您需要重新陈述您已经做出的决定。每次。每个。时间。
这对每个会话都是一个负担。而且随着您的项目运行时间越长，问题越严重。
## 解决方案
三个技能，使Claude在会话之间具有工作内存：
| 技能 | 功能 | 触发时机 |
|-------|--------------|------------------|
| **内存映射** | 将您的会话快照 — 已经构建、决定、待处理 — 到持久内存 | 在会话结束时，或当您说“保存此内容” |
| **内存回忆** | 加载存储的内存并显示当前相关的信息 | 在会话开始时，或当您询问“您还记得什么？” |
| **内存修剪** | 确定过时的条目并提出清理建议，确认后执行 | 当内存杂乱时，或根据请求 |
循环：**写入 → 回忆 → 修剪**。它们一起使Claude感觉像它真正记得您的工作。
---
## 兼容所有环境
相同的协议，两种存储后端，自动检测：
| 环境 | 存储 |
|-------------|---------|
| **claude.ai** | 持久内存API (`memory_user_edits`) |
| **Claude Code** | 本地文件 `~/.claude/memory.md` |
与开放的SKILL.md格式兼容，也适用于Cursor、Windsurf、Codex CLI和任何支持Anthropic的Agent Skills规范的工具。
---
## 安装
### Claude Code（一行命令）
```bash
curl -fsSL https://raw.githubusercontent.com/shandar/memory-map/main/install.sh | bash
```
安装程序克隆仓库，复制所有三个技能到 `~/.claude/skills/`，初始化 `~/.claude/memory.md`，并备份任何预先存在的技能文件夹。
### Claude Code（手动）
```bash
git clone https://github.com/shandar/memory-map.git
cd memory-map
cp -r skills/* ~/.claude/skills/
```
重启Claude Code。技能会自动加载。
### claude.ai
每个技能都在claude.ai上单独安装：
1. 下载 [最新版本](https://github.com/shandar/memory-map/releases)
2. 解压存档
3. 打开设置 → 技能 → 从文件安装
4. 上传 `skills/memory-map/SKILL.md`，然后 `memory-recall/SKILL.md`，然后 `memory-prune/SKILL.md`
所有三个技能安装完成后，它们将根据您的指令自动触发。
---
## 使用
安装后，只需正常对话。技能将自行触发。
### 会话开始时
```
您： “您还记得我的仪表盘项目吗？”
Claude: 接着上次的内容：
当前状态 — 身份验证流程已部署到预发布环境。 API速率限制已使用Redis后端实现。仪表盘重构正在进行中。
待处理事项：
→ 完成分析小部件重构
→ 审查Sarah的PR #142
→ 将计费服务迁移到新端点
活跃项目：仪表盘重构、身份验证流程、计费迁移。
```
### 会话结束时
```
您： “保存此对话”
Claude: 内存映射 — 2026年4月27日更新
更新 → 身份验证流程状态（现在在预发布环境中）
更新 → 当前状态快照
新增 → API速率限制决策（Redis后端）
──────────────────────────────────────────────────
未变更：8个条目
```
### 当内存杂乱时
```
您： “清理内存”
Claude: 内存修剪 — 建议的更改
移除（过时）
→ 条目7： “旧身份验证设计（v1）” — 被条目11中的v3取代
→ 条目14： “Q1冲刺计划” — 季度已关闭
合并
→ 条目3 + 9 → 单个“ API约定”条目
保留所有6个操作首选项条目
应用这些更改？ [是 / 修改 / 取消]
```
---
## 触发短语
技能根据自然语言激活，无需记忆命令。
| 技能 | 触发短语 |
|-------|----------------|
| **内存映射** | 保存此内容 · 快照此内容 · 记住此对话 · 更新您的内存 · 存储此会话 · 不要丢失此上下文 |
| **内存回忆** | 您还记得什么 · 上下文是什么 · 我们在哪里结束 · 让我了解情况 · 显示内存映射 |
| **内存修剪** | 清理内存 · 修剪内存 · 合并内存 · 修剪内存映射 |
所有三个技能也会**主动**触发，当条件合适时 — 在高效会话结束时，在新会话开始时，或当内存接近其限制时。
---
## 内存存储方式
### Claude Code： `~/.claude/memory.md`
纯Markdown，可读，可编辑，可版本控制：
```markdown
# Claude 内存映射
最后更新： 2026年4月27日
## 1. 当前状态快照（2026年4月）
身份验证流程在预发布环境中。 API速率限制已使用Redis部署。仪表盘重构正在进行中。下一步：分析小部件、PR #142审查、计费迁移。
## 2. 身份验证服务
JWT带有刷新令牌。 Redis会话存储。 15分钟访问，7天刷新。
PR： github.com/team/repo/pull/127. 所有者：后端团队。
## 3. 编码约定
TypeScript严格模式。 Vitest用于测试。 传统的提交。 基于主干的开发。
```
您可以直接编辑此文件。 `memory-prune` 将尊重您的编辑。
### claude.ai： 持久内存API
通过Anthropic的 `memory_user_edits` 工具存储。 在设置 → 内存中可见。 功能上与文件存储相同 — 相同的类别标签，相同的密度规则，只是通过API管理。
---
## 设计原则
- **主动而非被动** — 技能在需要时运行，无需请求
- **替换而非累积** — 过时条目被替换，而非堆叠
- **密度而非冗余** — 每个条目都是可扫描的、事实密集的、无填充的
- **单一真相源** — `当前状态快照` 始终是唯一条目
- **确认后再销毁** — `memory-prune` 始终建议，而非自主删除
- **环境感知** — 相同的技能，正确的存储适用于正确的工具
---
## 仓库结构
```
memory-map/
├── README.md ← 你在这里
├── LICENSE ← MIT
├── CHANGELOG.md ← 版本历史
├── CONTRIBUTING.md ← 如何贡献
├── marketplace.json ← 插件清单
├── install.sh ← 一行安装程序
└── skills/
├── memory-map/
│ ├── SKILL.md
│ └── references/
│ ├── claude-ai.md ← memory_user_edits API
│ └── claude-code.md ← ~/.claude/memory.md 文件
├── memory-recall/
│ ├── SKILL.md
│ └── references/
│ ├── claude-ai.md
│ └── claude-code.md
└── memory-prune/
├── SKILL.md
└── references/
├── claude-ai.md
└── claude-code.md
```
每个技能都是独立的，可以单独使用。插件将它们捆绑在一起，提供一键安装。
---
## 路线图
- [x] **v0.1** — 内存映射、内存回忆、内存修剪
- [ ] **v0.2** — 多项目内存（每个仓库或工作空间的独立存储）
- [ ] **v0.3** — 内存导出/导入，用于跨团队共享项目上下文
- [ ] **v0.4** — 会话间内存差异（“自上周以来发生了什么变化？”）
在 [问题](https://github.com/shandar/memory-map/issues) 和 [讨论](https://github.com/shandar/memory-map/discussions) 中跟踪进度。
---
## 构建者
[Shandar Junaid](https://shandarjunaid.com) — 创始人， [Affordance 设计工作室](https://affordance.design)
如果您在此基础上进行构建，我很乐意看到您的作品。在 [LinkedIn](https://www.linkedin.com/in/shandarjunaid/) 或 [X](https://x.com/pixel8d) 上标记我。
---
## 许可证
MIT — 使用、 fork、扩展。请参阅 [LICENSE](LICENSE)。
---
## 致谢
SKILL.md格式和Agent Skills规范来自Anthropic。本插件是一个独立的开源项目，与Anthropic无关。
MCP 市场