MemoryHamster 🤖

Agent 记忆进化系统

合并记忆管理与自我进化，让 AI 每天变得更聪明。

核心功能

1. 温度模型 🌡️

温度	时间范围	存储位置	说明
🔥 热	< 7 天	memory/.md	活跃数据，高频访问
🟡 温

7-30 天 | memory/.md | 近期数据，偶尔访问 | | ❄️ 冷 | > 30 天 | memory/.archive/ | 归档数据，低频访问 |

2. 学习记录系统 📝

类型	文件	触发条件
教训	.learnings/LEARNINGS.md	被纠正、发现更好方法、知识缺口
错误

.learnings/ERRORS.md | 命令失败、API 错误、异常 | | 功能请求 | .learnings/FEATURE_REQUESTS.md | 用户想要新能力 |

3. 自动 GC（每周日 00:00）

bash
./skills/memory-hamster/scripts/memory-gc.sh

功能：

• - 扫描超过 30 天的日志文件
• 移动到 memory/.archive/YYYY-MM/ 目录
• 生成 GC 报告

4. 夜间反思（每日 23:45）

bash
./skills/memory-hamster/scripts/nightly-reflection.sh

功能：

• - 验证记忆 CRUD
• 创建反思记录
• 更新健康度统计
• 检查待归档数据

5. 技能提炼 🏗️

bash
./skills/memory-hamster/scripts/extract-skill.sh [skill-name]

功能：

• - 从 .learnings/LEARNINGS.md 读取教训
• 生成 skills//SKILL.md
• 自动创建技能模板

6. 语义搜索 🔍

优势： 基于关键词的语义匹配，支持范围过滤和相关性排序

bash

搜索记忆（Node.js 脚本）

node ${CLAUDEPLUGINROOT}/scripts/search-memory.cjs [--user|--repo|--both] USERQUERYHERE

范围	说明
--user	搜索个人/用户记忆（跨会话）
--repo

搜索项目/代码记忆 | | --both | 同时搜索（默认） |

示例：

• - 昨天做了什么 → node search-memory.cjs work yesterday recent activity
• 如何实现认证 → node search-memory.cjs --repo authentication implementation
• 编码偏好 → node search-memory.cjs --user coding preferences style

7. Promotion 机制 📈

学习类型	提升到	示例
行为模式	SOUL.md	简洁回复，不说废话
工作流改进

AGENTS.md | 长任务 spawning 子代理 | | 工具技巧 | TOOLS.md | Git push 需要先配置 auth |

目录结构

workspace/
├── MEMORY.md # 核心长期记忆（<5KB）
├── SOUL.md # 行为准则
├── AGENTS.md # 工作流
├── TOOLS.md # 工具技巧
├── memory/ # 每日记忆（温度模型）
│ ├── INDEX.md
│ ├── YYYY-MM-DD.md # 每日日志
│ ├── lessons/README.md # 教训索引
│ ├── decisions/README.md # 决策索引
│ ├── people/ # 人物档案
│ ├── reflections/ # 反思记录
│ └── .archive/ # 冷数据归档（>30 天）
├── .learnings/ # 学习记录（进化核心）
│ ├── LEARNINGS.md # 教训/纠正/最佳实践
│ ├── ERRORS.md # 错误记录
│ └── FEATURE_REQUESTS.md # 功能请求
└── skills/memory-hamster/
├── SKILL.md # 本文件
└── scripts/
├── memory-gc.sh # GC 归档脚本
├── nightly-reflection.sh # 夜间反思脚本
├── extract-skill.sh # 技能提取脚本
└── search-memory.cjs # 语义搜索脚本（新增）

🚀 快速开始

1. 安装技能

bash

从 ClawHub 安装

clawhub install memory-hamster

2. 初始化（已完成）

bash

目录结构已创建

文件已初始化

2. 配置 Cron 任务

bash

编辑 crontab

crontab -e

添加以下任务（根据实际安装路径调整）

0 0 0 ./skills/memory-hamster/scripts/memory-gc.sh >> ./logs/memory-gc.log 2>&1 45 23 * ./skills/memory-hamster/scripts/nightly-reflection.sh >> ./logs/nightly-reflection.log 2>&1

3. 日常使用

会话开始：

1. 1. 读取 MEMORY.md 获取核心记忆
2. 检查今日日志 memory/YYYY-MM-DD.md

会话中：

• - 重要决策 → memory/decisions/
• 犯错/教训 → .learnings/LEARNINGS.md 或 ERRORS.md
• 用户纠正 → .learnings/LEARNINGS.md (category: correction)
• 发现更好方法 → .learnings/LEARNINGS.md (category: best_practice)

会话结束：

• - 更新每日日志
• 标记完成事项

学习记录格式

教训条目（LEARNINGS.md）

markdown

[LRN-YYYYMMDD-XXX] category

Logged: 2026-03-09T11:00:00+08:00
Priority: low | medium | high | critical
Status: pending | resolved | promoted
Area: workflow | tool | behavior | knowledge

Summary

一句话描述学到了什么

Details

完整上下文：发生了什么，什么错了，什么是对的

Suggested Action

具体的修复或改进建议

Metadata

• - Source: conversation | error | userfeedback
• Related Files: path/to/file.ext
• Tags: tag1, tag2
• See Also: LRN-20260309-001 (如果相关)
• Pattern-Key: simplify.deadcode (可选，用于追踪重复模式)

---

错误条目（ERRORS.md）

markdown

[ERR-YYYYMMDD-XXX] commandorskill

Logged: 2026-03-09T11:00:00+08:00
Priority: high
Status: pending | resolved

Summary

什么失败了

Error

实际错误信息

Context

• - 尝试的命令/操作
• 使用的输入或参数
• 相关环境信息

Suggested Fix

如果可识别，什么可能解决这个问题

---

功能请求条目（FEATURE_REQUESTS.md）

markdown

[FEAT-YYYYMMDD-XXX] capability_name

Logged: 2026-03-09T11:00:00+08:00
Priority: medium
Status: pending | implemented

Requested Capability

用户想要什么功能

User Context

为什么需要，解决什么问题

Suggested Implementation

如何实现

---

ID 生成规则

格式：TYPE-YYYYMMDD-XXX

• - TYPE: LRN (学习), ERR (错误), FEAT (功能)
• YYYYMMDD: 当前日期
• XXX: 序列号 (001, 002, ...)

示例：LRN-20260309-001, ERR-20260309-001, FEAT-20260309-001

解决条目

当问题解决后，更新条目：

1. 1. 改 Status: pending → Status: resolved
2. 添加解决块：

markdown

Resolution

• - Resolved: 2026-03-09T12:00:00+08:00
• Commit/PR: abc123 或 #42
• Notes: 简要描述做了什么

Promotion 流程

当学习具有广泛适用性时，提升到配置文件：

何时 Promotion

• - 学习适用于多个文件/功能
• 任何 AI 贡献者都应该知道的知识
• 防止重复犯错
• 记录项目特定规范

###