---
slug: "memory-free"
name: "memory-free"
version: "1.0.0"
displayName: "记忆管理器免费版"
summary: "基础分类长期记忆系统，支持预设类别与关键词检索，本地隐私存储。记忆管理器免费版提供基础分类长期记忆能力，与 Agent 内置记忆并行运行. 核心能力包括：预设三类分类存储（项目/人脉/知识）"
summary_zh: "基础分类长期记忆系统，支持预设类别与关键词检索，本地隐私存储。记忆管理器免费版提供基础分类长期记忆能力，与 Agent 内置记忆并行运行. 核心能力包括：预设三类分类存储（项目/人脉/知识）"
license: "MIT"
description: |-
  记忆管理器免费版提供基础分类长期记忆能力，与 Agent 内置记忆并行运行.
  核心能力包括：预设三类分类存储（项目/人脉/知识）、自动索引维护、即时写入机制、关键词检索.
  适用于需要简单组织化存储的场景：项目背景记录、联系人信息、领域知识笔记等.
  所有数据存储在用户主目录下的独立文件夹中，不依赖外部服务，不发送网络请求.
  如需无限自定义类别、内置记忆同步、分层扩展等高级能力，请升级到付费版.
tools:
  - read
  - exec
  - write
homepage: ""
tags:
  - 智能助手
  - 记忆管理
  - 上下文
  - AI
  - memory
  - index
  - agent
  - projects
category: "Agents"
---
# 记忆管理器免费版

基础分类长期记忆系统，与 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 |
| 延迟写入丢失信息 | 用户分享信息后攒着批量写导致遗忘 | 用户分享即写入，不等待不批处理 |

## 示例

### 示例一：项目记忆管理

用户有一个活跃项目，需要记录背景与进展.
```text
用户："我有个电商平台项目 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 条目时自动拆分子类别，保持检索效率不随规模下降
- **双模式检索**：关键词搜索与层级导航双模式，大规模记忆也能快速定位
- **隐私安全增强**：完整的本地存储与隔离策略，确保数据安全

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

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