与 Agent 内置记忆并行的无限组织化记忆系统。你的 Agent 有基础内置记忆，本 Skill 为它添加无限、完美组织的并行记忆系统——互补而非替代，永不冲突。

痛点与对策速查

架构

详细代码示例已移至 references/detail.md

核心原则：不是替代，是并行。Agent 内置记忆继续工作，本系统添加无限组织化存储。

目录结构

记忆存储在 ~/memory/ —— 与 Agent 内置记忆完全分离的专用目录。

~/memory/
├── config.md              # 系统配置
├── INDEX.md               # 总索引：存了什么、去哪找
│
├── [用户自定义]/           # 按需创建的分类目录
│   ├── INDEX.md           # 分类索引
│   └── {条目}.md          # 单个条目
│
└── sync/                  # 可选：从内置记忆同步（免费版手动）
    └── ...

用户自定义分类，常见示例：

使用流程

本工具属简单工具，基础上手 < 60 秒，完整配置 < 120 秒。

30 秒极速体验

mkdir -p ~/memory

cat > ~/memory/INDEX.md << 'EOF'
| 分类 | 用途 | 条目数 |
|:---|:---|:---|
| projects | 项目历史 | 0 |
| people | 联系人 | 0 |
| decisions | 决策日志 | 0 |

最后更新：2026-07-18
EOF

mkdir -p ~/memory/projects
echo "# 项目索引\n\n| 名称 | 状态 | 更新 | 文件 |\n|:---|:---|:---|:---|\n\n总计：0 条" > ~/memory/projects/INDEX.md

60 秒基础上手

详细代码示例已移至 references/detail.md

120 秒完整配置（含 Agent 集成）

在 Agent 的配置文件（如 AGENTS.md 或 SOUL.md）中添加记忆协议：

1. 读取 ~/memory/INDEX.md — 了解有哪些分类
2. 根据当前任务，读取相关分类的 INDEX.md
3. 检索相关条目获取上下文

- 用户分享项目信息？→ 写入 ~/memory/projects/{name}.md，更新 INDEX.md
- 用户提到联系人？→ 写入 ~/memory/people/{name}.md，更新 INDEX.md
- 用户做出决策？→ 写入 ~/memory/decisions/{date}-{topic}.md，更新 INDEX.md

1. 更新 ~/memory/INDEX.md 总索引
2. 归档已完成/不活跃的条目
3. 检查分类是否需要拆分（>100 条时拆分）

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

场景 1：项目管理员的多项目记忆

角色：同时管理 5+ 个项目的项目经理 痛点：Agent 内置记忆装不下所有项目细节，经常混淆

详细代码示例已移至 references/detail.md

效果：项目信息结构化存储，永不混淆，新会话秒懂全貌。

场景 2：销售人员的客户网络记忆

角色：B2B 销售，维护大量客户关系 痛点：客户信息分散，记不清上次沟通内容

详细代码示例已移至 references/detail.md

效果：客户关系全景记忆，每次沟通有据可查。

场景 3：技术团队决策日志

角色：技术团队 Lead，需要记录和追溯架构决策 痛点：忘了为什么选了某个技术方案，重复讨论

详细代码示例已移至 references/detail.md

效果：决策可追溯，避免重复讨论，团队对齐。

这里存什么 vs 内置记忆存什么

规则：内置记忆用于快速上下文，这里用于深度和规模。

查找信息

小型记忆库（< 50 文件）

grep -r "关键词" ~/memory/

中型记忆库（50+ 文件）

通过索引导航：

1. ~/memory/INDEX.md → 找到分类
2. ~/memory/{分类}/INDEX.md → 找到条目
3. ~/memory/{分类}/{条目}.md → 读取详情

大型记忆库（500+ 文件）

使用层级索引：

~/memory/projects/INDEX.md → "web 项目在 web/"
~/memory/projects/web/INDEX.md → "alpha 项目"
~/memory/projects/web/alpha.md → 详情

维护指南

每周（5 分钟）

• 更新 INDEX.md 文件（如有新增条目）
• 归档已完成/不活跃条目

for dir in ~/memory/*/; do
  echo "=== $dir ==="
  cat "${dir}INDEX.md" 2>/dev/null || echo "无索引"
done

每月（15 分钟）

• 检查分类大小
• 拆分过大的分类
• 清理过期条目

for dir in ~/memory/*/; do
  count=$(find "$dir" -name "*.md" | wc -l)
  echo "$dir: $count 文件"
done

记忆变慢时

• 检查 INDEX.md 大小（保持 < 100 行）
• 拆分大分类为子分类
• 归档旧内容

错误处理

• 边界输入处理: 空输入返回提示信息, 超长输入自动截断
• 降级策略: 异常时返回默认值, 确保流程不中断
• 执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令机制: 失败时自动执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令, 最多3次 | 序号 | 问题 | 可能原因 | 解决方案 | 优先级 | |:---|:---|:---|:---|:---| | 1 | 找不到信息 | 没有建立索引 | 为每个分类创建 INDEX.md；运行维护脚本检查 | 高 | | 2 | 记忆与内置冲突 | 修改了内置 MEMORY.md | 严格遵循"只写 ~/memory/"原则；恢复内置记忆 | 高 | | 3 | grep 检索太慢 | 文件过多（500+） | 拆分子分类；使用层级索引导航而非全量 grep | 中 | | 4 | 索引过期 | 新增条目未更新索引 | 每周维护检查；遵循"即写即存+更新索引"协议 | 中 | | 5 | 分类太大 | 单分类 > 100 条 | 拆分为子分类（如 active/、archived/）；创建子索引 | 中 | | 6 | 重复存储 | 同一信息存多份 | 去重检查：grep -r "关键词" ~/memory/ 查找重复；合并 | 低 | | 7 | 信息丢失 | 写入延迟导致遗忘 | 严格遵循"即写即存"协议：先写文件，再回复 | 高 | | 8 | 目录权限错误 | ~/memory/ 无写权限 | chmod -R 755 ~/memory/；确认用户有写权限 | 中 |

常见问题

Q1: 免费版和 Agent 内置记忆会冲突吗？

A: 不会。本系统存储在 ~/memory/，与 Agent 内置的 MEMORY.md 和 memory/ 完全分离。严格遵循"并行不替代"原则，绝不修改内置记忆。两套系统协同工作：内置记忆用于快速上下文，本系统用于深度和规模。

Q2: 免费版能存储多少条记忆？

A: 免费版不限制存储数量。基于文件系统存储，容量取决于磁盘空间。建议单分类不超过 100 条（超过时拆分子分类），总记忆库不超过 500 文件（超过时检索变慢，建议升级专业版使用语义搜索）。

Q3: 免费版如何检索信息？

A: 免费版支持 grep 关键词检索和 INDEX.md 索引导航两种方式。对于 < 50 文件的小型记忆库，grep 足够；对于 50+ 文件的中型记忆库，建议通过索引导航查找。500+ 文件时建议升级专业版使用语义搜索。

Q4: 免费版和专业版的核心区别是什么？

A: 免费版提供核心存储、分类管理、索引导航、grep 检索、即写即存。专业版新增三项高级能力：(1) 语义搜索（基于 embedding 的语义检索，无需关键词匹配）；(2) 自动同步（从内置记忆自动同步指定信息）；(3) 大规模索引（支持 500+ 文件的高效检索与层级索引自动化）。

Q5: 如何从免费版升级到专业版？

A: 专业版使用相同的目录结构和文件格式，升级时只需替换 SKILL.md 并运行初始化脚本生成语义索引。已有记忆数据无需迁移，无缝继承。

Q6: 需要联网吗？

A: 免费版完全不需要联网。所有数据存储在本地 ~/memory/，使用 grep 和文件系统操作，零网络依赖。专业版的语义搜索功能需要本地 Ollama 服务（离线可用），但同样不需要联网。

Q7: 如何备份记忆库？

A: 记忆库就是普通的文件目录，备份直接复制即可：

cp -r ~/memory/ ~/backups/memory-$(date +%Y%m%d)/
tar -czf ~/backups/memory-$(date +%Y%m%d).tar.gz -C ~/ memory/

已知限制

本免费体验版限制以下高级功能：

• ❌ 语义搜索：不支持基于 embedding 的语义检索，仅支持 grep 关键词匹配。500+ 文件时检索效率下降
• ❌ 自动同步：不支持从 Agent 内置记忆自动同步信息，需手动复制到 ~/memory/sync/
• ❌ 大规模索引：不支持 500+ 文件的层级索引自动化与高效检索，需手动拆分子分类

解锁全部高级功能请使用专业版：infinite-memory-vault-pro

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统: Windows / macOS / Linux
• 文件系统: 需对 ~/memory/ 有读写权限

依赖详情

API Key 配置

• 本 Skill 基于文件系统，无需任何 API Key
• 免费版完全离线运行，零网络依赖

可用性分类

• 分类: MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行记忆管理任务

License 与版权声明

本 skill 基于原始作品改进，保留原始版权声明：

• 原始作品：memory
• 原始 license：MIT
• 改进作品：© 2026 Infinite Memory Vault Team
• 改进 license：MIT

本改进作品在原始作品基础上进行了深度差异化改造，包括但不限于：

• 重构 frontmatter 元数据，新增 edition 字段区分免费/专业版
• 删除空 backtick 反馈链接和外部 Skill 引用（decide/escalate/learn）
• 移除 SkillHub 平台引用，改为通用的 Agent 平台描述
• 新增痛点对策速查表
• 新增 3 个真实场景示例（项目管理、客户网络、决策日志）
• 新增 FAQ（7 问）和故障排查表（8 项）
• 新增分级时间快速开始（30s/60s/120s）
• 新增免费版限制说明与专业版引导
• 优化架构图与目录结构说明
• 新增依赖说明章节
• 新增维护指南的具体命令示例

无限记忆，完美组织。免费体验，专业解锁。

核心能力

• 面向需要超越 Agent 内置记忆的长期结构化存储场景的无限记忆库免费体验版
• 与 Agent 内置记忆并行工作，互不冲突，提供无限分类、索引导航、即写即存能力
• 免费版提供核心存储、分类管理、索引维护、基础检索等能力，适合个人开发者快速体验组织化记忆的价值
• 核心能力包括无限分类存储（用户自定义目录结构）、INDEX
• md 索引导航（每类别独立索引）、即写即存协议（用户分享信息时立即写入）、与内置记忆并行工作（不修改 Agent 原生 MEMORY

核心功能执行

执行核心功能执行操作,使用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

执行参数配置与调用操作,使用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

扩展能力3

执行扩展能力3操作,使用param_3参数进行配置。

输入: 用户提供扩展能力3所需的指令和必要参数。 处理: 按照skill规范执行扩展能力3操作,遵循单一意图原则。 输出: 返回扩展能力3的执行结果,包含操作状态和输出数据。

• 执行此能力时使用param_3参数,支持创建/查询/修改操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：内置记忆并行的无、限组织化记忆免费、自定义分类、Use、when、需要数据库操作、SQL、数据存储管理时使、不适用于数据库架、构设计决策、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

适用场景

角色：同时管理 5+ 个项目的项目经理 痛点：Agent 内置记忆装不下所有项目细节，经常混淆

<!-- 触发条件: 用户明确请求时激活 -->

## 案例展示

```json
{
  "input": "示例输入",
  "output": "处理结果"
}

输出格式

处理结果以结构化格式返回, 包含状态码、消息和数据字段。