记忆管理器免费版

基础分类长期记忆系统，与 Agent 内置记忆并行扩展.

输入格式

参数名	类型	必填	说明
input	string	是	记忆管理器免费版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

核心能力

1. 预设分类存储

提供三个预设类别目录，满足基础存储需求.

• 参数：类别名称固定为 projects、people、knowledge
• 用法：在 ./memory/ 下创建预设类别文件夹
• 输出：每个类别目录下生成对应的条目文件（.md 格式）

预设类别：

类别	路径	适用内容
项目	./memory/projects/	项目背景、进展、待办
人脉	./memory/people/	联系人信息、互动记录
知识	./memory/knowledge/	领域知识、学习笔记

2. 自动索引维护

每个类别目录自动维护 INDEX.md，列出所有条目.

• 参数：无额外参数，写入条目时自动更新
• 用法：条目写入后同步更新对应类别的 INDEX.md
• 输出：包含名称、状态、更新时间、文件名的表格

3. 即时写入机制

用户分享重要信息时立即写入对应文件，不等待、不批处理.

• 参数：信息内容、目标类别（仅限三个预设类别）
• 用法：识别信息归属类别 → 写入条目文件 → 更新索引 → 回复用户
• 输出：已写入的文件路径与更新后的索引

4. 关键词检索

通过 grep 命令在记忆目录中搜索关键词.

• 参数：检索关键词

• 用法：grep -r "关键词" ./memory/

• 输出：匹配的文件内容

• 参考关键词检索的配置文档进行参数调优

快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

使用流程

领先步：创建目录结构

在 ./memory/ 下创建三个预设类别目录（projects、people、knowledge）与对应的 INDEX.md 文件.

第二步：即时写入记忆

用户分享信息时，识别归属类别，写入对应条目文件，同步更新类别 INDEX.md，然后回复用户.

第三步：检索记忆

使用 grep -r "关键词" ./memory/ 搜索记忆内容，或直接查看类别 INDEX.md 浏览条目列表. 结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.

错误处理

错误类型	原因	处理方式
误改内置记忆	操作了 Agent 的 MEMORY.md 或工作区 memory/ 文件夹	严格隔离 ./memory/ 与内置记忆路径，本系统仅在 ./memory/ 下操作
索引缺失	写入条目后未更新 INDEX.md	每次写入条目后立即更新对应类别的 INDEX.md
延迟写入丢失信息	用户分享信息后攒着批量写导致遗忘	用户分享即写入，不等待不批处理

示例

示例一：项目记忆管理

用户有一个活跃项目，需要记录背景与进展.

用户："我有个电商平台项目 Alpha，帮我记录"
# ...
执行：
1. 创建 ./memory/projects/ 目录
2. 创建 ./memory/projects/INDEX.md
3. 创建 ./memory/projects/alpha.md（电商平台，状态：活跃）
# ...
alpha.md 内容结构：
  # Alpha 电商平台
  ## 项目背景
  - 启动时间：2026-03
  - 技术栈：React + Node.js + PostgreSQL数据库
  ## 当前进展
  - 支付模块已完成联调

FAQ

Q1：免费版支持几个类别？

免费版提供三个预设类别：projects（项目）、people（人脉）、knowledge（知识）。如需自定义类别（如 decisions、collections 等），请升级到付费版.

Q2：能从内置记忆同步信息吗？

免费版不支持内置记忆同步功能。如需将内置记忆中的特定信息同步到本系统，请升级到付费版.

Q3：记忆积累多了怎么检索？

免费版支持关键词检索（grep -r "关键词" ./memory/）和查看类别 INDEX.md。如需层级导航、分层扩展等高级检索能力，请升级到付费版.

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• 文件系统：需要用户主目录的读写权限

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由 Agent 内置 LLM 提供
文件系统读写	运行时	必需	操作系统原生支持

API Key 配置

本技能基于 Markdown 指令驱动 Agent 操作本地文件系统，无需额外 API Key.

可用性分类

• 分类：MD+EXEC（Markdown 指令驱动，需 exec 执行文件读写操作）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 在本地文件系统中管理分类记忆

已知限制

• 仅提供三个预设类别，不支持自定义类别
• 不支持内置记忆单向同步
• 不支持分层扩展（类别超 100 条目无法自动拆分子类别）
• 检索仅支持关键词匹配，不支持层级导航
• 跨设备同步需用户自行处理

升级提示

本免费版提供基础分类记忆能力。升级到付费版可获得以下增强：

• 无限自定义类别：按需创建任意类别（决策、收藏、领域知识等），不受三个预设限制
• 内置记忆单向同步：将内置记忆中需要深度组织的信息自动同步到本系统
• 分层扩展机制：类别超 100 条目时自动拆分子类别，保持检索效率不随规模下降
• 双模式检索：关键词搜索与层级导航双模式，大规模记忆也能快速定位
• 隐私安全增强：完整的本地存储与隔离策略，确保数据安全

如需这些高级能力，请升级到记忆管理器付费版.

输出格式

{
  "success": true,
  "data": {
    "result": "记忆管理器免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "memory"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}