Local Memory Manager

把记忆还给本地。不上云，不分心，用自己的文件系统当数据库。

MIT License · Agent Skills Standard · Multi-Runtime

一个轻量、开放、完全本地化的 AI Agent 记忆管理方案。

基于开放的 Agent Skills 协议，可在 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、Gemini CLI、OpenCode 等任何 skills-compatible runtime 中运行。

功能特性 · 快速开始 · 安装 · 目录结构 · 工作原理

其他语言 / Other Languages: English

---

为什么需要这个？

AI Agent 越来越强大，但记忆管理是个问题：

• 云端记忆有隐私风险 — 你的对话数据存在别人的服务器上
• API 调用有成本 — 每次对话都要调用外部记忆 API
• vendor lock-in — 换了 agent runtime，记忆就没了
• 你无法直接编辑 — 记忆存在黑盒里，想改一条还得通过 API

解决方案：用本地 Markdown 文件当记忆。

• 📁 你的记忆你拥有 — 就是普通文件，随时编辑
• 🔒 完全不上云 — 不依赖任何外部服务
• 🔄 跨 runtime 通用 — 同样的结构，换个 agent 一样能用
• 🤖 自动管理 — agent 自动读取、写入、整理

---

功能特性

特性	说明
完全本地化	不使用任何云端 Memory Provider
三层结构	MEMORY.md（索引）+ local-memory（知识库）+ archive（归档）
多 runtime	Hermes / Claude Code / Codex / Cursor / OpenClaw / OpenCode / Gemini CLI
自动初始化	告诉 agent "帮我搭建本地记忆系统"，自动完成所有配置
信息分类	7 个分类文件，不同类型的信息写入不同文件
自动整理	每周压缩、去重、归档，保持记忆文件精简
模板自带	包含所有模板文件，开箱即用
工具脚本	提供 Python 脚本辅助记忆整理和验证

---

快速开始

1. 安装

打开你正在用的 agent（Claude Code、Codex、Cursor、Hermes 等），告诉它：

帮我安装这个 skill：https://github.com/yaoxiao99/local-memory-skill

或手动 clone：

git clone https://github.com/yaoxiao99/local-memory-skill ~/.claude/skills/local-memory-skill

2. 初始化

告诉 agent：

帮我搭建本地记忆系统

Agent 会自动：

1. 创建完整目录结构
2. 填充所有模板文件
3. 禁用云端 Memory
4. 输出验证清单

3. 使用

之后每次对话，agent 会自动读取相关记忆文件。

你也可以主动说：

记住这个：这个项目使用 pnpm 管理依赖

Agent 会自动写入对应文件。

---

安装

方式一：npx（推荐，跨 runtime）

npx skills add yaoxiao99/local-memory-skill

自动识别当前 runtime 并放到正确目录。

方式二：手动安装

Runtime	安装路径
Claude Code	~/.claude/skills/local-memory-skill/
Codex CLI	~/.codex/skills/local-memory-skill/
Cursor	~/.cursor/skills/local-memory-skill/
OpenClaw	~/.openclaw/workspace/skills/local-memory-skill/
Hermes Agent	~/.hermes/profiles/<profile>/skills/note-taking/local-memory-skill/
其他 runtime	clone 到对应 runtime 的 skills/ 目录

方式三：直接使用（无需安装）

即使 runtime 不支持 Agent Skills 自动加载，你也可以直接把 SKILL.md 的内容粘贴进对话。

---

目录结构

<workspace>/
├── MEMORY.md                    ← 启动索引（<1000字，agent 自动读取）
├── USER.md                      ← 用户偏好（<1000字，agent 自动读取）
└── local-memory/
    ├── index.md                 ← 文件说明 + 读写规则 + 主题映射表
    ├── user-profile.md          ← 用户长期稳定信息（偏好/习惯/沟通风格）
    ├── nas-docker.md            ← NAS/Docker/VPS/网络/服务器部署
    ├── projects.md              ← 项目入口、域名、部署环境、排查索引
    ├── ai-tools.md              ← AI 工具使用习惯和规则
    ├── troubleshooting.md       ← 历史故障记录（按日期/主题格式）
    └── archive.md               ← 归档旧信息（默认不主动加载）

---

工作原理

三层记忆结构

MEMORY.md（<1000字）
  ↑ 启动时自动读取（agent 内置机制）
  ↑ 只放索引，不放详细内容

local-memory/*.md（按需读取）
  ↑ 回答问题时根据主题读取对应文件
  ↑ 详细内容放在这里

archive.md（手动读取）
  ↑ 过期信息、历史记录
  ↑ 默认不主动加载

信息流向

用户说"记住这个"
    ↓
判断是否值得保存（长期稳定？）
    ↓
判断保存位置（7 个分类之一）
    ↓
追加到对应文件末尾（带日期标记）
    ↓
每周整理时压缩/归档

什么该记，什么不该记

应该记：

• 用户偏好、习惯、沟通风格
• 服务器配置、Docker 部署信息
• 项目域名、环境变量模板
• 历史故障和解决方案
• 长期稳定的工具使用规则

不应该记：

• 一次性任务
• 当天计划
• 临时排错过程
• 对话流水账
• 已经过期的信息

---

工具脚本

脚本	功能
scripts/compact_memory.py	压缩整理 memory 文件，去重、归档过期内容
scripts/verify_setup.py	验证记忆系统初始化是否完整
scripts/import_memory.py	从 CSV/JSON 批量导入记忆

---

更新日志

版本	日期	说明
v3.0.0	2026	符合 agentskills.io 规范，多 runtime 支持，重写所有模板
v2.0.0	2026	Hermes 专用版本

---

License

MIT © 2026