# ai-memory

**Repository Path**: xdgame/ai-memory

## Basic Information

- **Project Name**: ai-memory
- **Description**: AI 记忆系统技能
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 记忆系统技能

基于 Git 的 AI 记忆管理系统，实现持久化、版本化的智能记忆存储与检索。

## 功能特性

✅ **持久化记忆** - 所有学习内容永久保存  
✅ **版本追溯** - 可以回溯到任何历史记忆状态  
✅ **分支管理** - 不同类型的记忆独立管理  
✅ **远程备份** - 支持多设备同步  
✅ **智能检索** - 通过 Git 命令快速查找记忆

## 使用示例

### 保存问题解决方案

```
用户：记住这个：OpenClaw 消息路由问题已经解决了，
      问题是 to 参数被错误处理，解决方案是智能识别参数类型
```

AI 会自动：
1. 创建 problem/openclaw-routing 分支
2. 保存记忆到 memories/problems/openclaw-routing.md
3. 提交并合并到 main 分支
4. 更新主索引

### 检索记忆

```
用户：你还记得我们怎么解决 OpenClaw 的问题吗？
```

AI 会：
1. 在 D:\Pandora 中搜索相关记忆
2. 找到并读取记忆文件
3. 回答问题

### 保存学习知识

```
用户：我刚学了 TypeScript 泛型，帮我记住这个知识
```

AI 会：
1. 创建 knowledge/typescript-generics 分支
2. 保存知识记忆
3. 提交并合并

## 触发条件

### 明确触发
- "记住这个"
- "更新记忆"
- "问题解决了"
- "你还记得...吗"
- "查找记忆"

### 隐式触发
- 安装新技能后
- 解决重要问题后
- 学习新知识后

## 记忆存储位置

默认：`D:\Pandora`

首次使用时如果目录不存在会询问是否创建。

## 目录结构

```
D:\Pandora\
├── memory.md                    # 主记忆索引
├── memories/
│   ├── skills/                  # 技能记忆
│   ├── problems/                # 问题记忆
│   ├── knowledge/               # 知识记忆
│   └── context/                 # 上下文记忆
└── scripts/                     # 辅助脚本
```

## 分支策略

- `skill/技能名` - 技能相关记忆
- `problem/问题名` - 问题解决记忆
- `knowledge/主题名` - 知识学习记忆
- `experiment/实验名` - 实验性想法

## 提交规范

- `feat(skill): 安装新技能`
- `fix(problem): 解决问题`
- `docs(knowledge): 学习新知识`
- `chore: 日常维护`

## 远程备份

可选配置 GitHub 私有仓库进行备份：

```bash
cd D:/Pandora
gh repo create ai-memory --private
git remote add origin <url>
git push -u origin main
```

## 隐私保护

敏感信息会被 .gitignore 排除：
- API keys
- 密码
- 个人隐私信息

## 测试用例

技能包含 3 个测试用例：
1. 保存问题解决方案
2. 检索历史记忆
3. 保存学习知识

运行测试：参见 `evals/evals.json`

## 依赖

- Git - 版本控制
- GitHub CLI (可选) - 远程备份

## 参考文档

完整设计文档：`AI记忆系统技能设计文档.md`
完整设计文档：`AGENTS.md`