# keymem

**Repository Path**: caidongyun/keymem

## Basic Information

- **Project Name**: keymem
- **Description**: Key Memory Extractor Skill
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Key Memory Extractor - 关键记忆提取器

**功能**: 从记忆文件中提取关键项目习惯，定时检查并生成摘要

---

## 🚀 快速开始

### 安装

```bash
cd ~/.openclaw/workspace/skills/key-memory-extractor
pip install pyyaml  # 如果需要
```

### 使用

```bash
# 提取昨天记忆
python3 extract_key_memory.py --date yesterday

# 生成记忆卡片
python3 extract_key_memory.py --date yesterday --card

# 每日模式 (自动提取昨天)
python3 extract_key_memory.py --daily

# 查看状态
python3 extract_key_memory.py --status

# 手动清理旧卡片
python3 extract_key_memory.py --cleanup

# 🆕 分析记忆质量 (昨天到今天)
python3 extract_key_memory.py --analyze

# 分析指定日期范围
python3 extract_key_memory.py --analyze --start 2026-04-10 --end 2026-04-13

# 🆕 验证上下文完整性
python3 extract_key_memory.py --validate --date yesterday

# 验证指定日期
python3 extract_key_memory.py --validate --date 2026-04-12
```

---

## 📋 输出示例

### 记忆卡片

```markdown
# 关键记忆卡片 - 2026-04-12

## 📁 活跃项目

| 项目 | Gitee | GitHub | 本地路径 |
|------|-------|--------|---------|
| agent-security-skill-scanner | caidongyun/... | caidongyun/... | ~/.openclaw/... |

## ✅ 完成事项

- v5.7.0 准备就绪
- 基准测试通过

## 🔴 进行中

- 全量样本扫描

## 💡 关键决策

- 性能目标：≥250 files/s

## 📝 习惯偏好

- 喜欢简洁报告
```

---

## ⏰ 定时任务

### Crontab (推荐)

```bash
# 每天 09:00 运行
crontab -e

# 添加以下行
0 9 * * * cd ~/.openclaw/workspace/skills/key-memory-extractor && python3 extract_key_memory.py --daily
```

### systemd Timer

```ini
# /etc/systemd/system/key-memory.timer
[Timer]
OnCalendar=*-*-* 09:00:00
Persistent=true

[Install]
WantedBy=timers.target
```

---

## 📁 文件结构

```
key-memory-extractor/
├── SKILL.md              # 技能说明
├── extract_key_memory.py # 主脚本
├── config.yaml           # 配置
├── README.md             # 本文档
├── memory_cards/         # 生成的卡片
│   └── 2026-04-12.md
├── stats/                # 统计
│   └── habits.json
└── memory/               # 定时状态 (工作区根目录)
    └── key-memory-state.json
```

---

## 🔧 配置

编辑 `config.yaml`:

```yaml
projects:
  - name: "你的项目"
    gitee: "caidongyun/repo"
    github: "caidongyun/repo"
    local: "~/path/to/project/"

schedule:
  daily_time: "09:00"  # 每日运行时间
  enabled: true        # 是否启用

# 条数限制
limits:
  max_cards: 30          # 最多保留 30 张 (约 1 个月)
  cleanup_threshold: 35  # 超过 35 张时清理
```

### 条数限制说明

| 参数 | 默认值 | 说明 |
|------|--------|------|
| `max_cards` | 30 | 最多保留 30 张卡片 |
| `min_cards` | 7 | 最少保留 7 张 |
| `cleanup_threshold` | 35 | 超过此值触发清理 |

**清理策略**: 超过阈值时，删除最久远的卡片，保留最近的 30 张。

### 定时状态位置

**文件**: `~/.openclaw/workspace/memory/key-memory-state.json`

**内容**:
```json
{
  "last_run": "2026-04-13T09:18:34",
  "total_runs": 1,
  "cards_created": 1,
  "cards_cleaned": 0,
  "last_cleanup": null
}
```

---

## 📊 统计

查看习惯统计：

```bash
cat stats/habits.json
```

---

## 🤝 集成

### HEARTBEAT.md

```markdown
# 每日检查

- [ ] 运行关键记忆提取
  ```bash
  python3 extract_key_memory.py --daily
  ```
```

### OpenClaw 定时任务

在 `HEARTBEAT.md` 中添加：

```markdown
## 09:00 检查

- 提取昨天记忆
- 查看完成事项
- 确认今天优先级
```

---

## 📝 更新日志

### v0.1.0 (2026-04-13)

- ✅ 初始版本
- ✅ 记忆提取
- ✅ 卡片生成
- ✅ 统计功能

---

## 📞 支持

- **Issue**: GitHub Issues
- **文档**: README.md