📦 Memory Auto Index — 自动记忆索引

自动为记忆系统添加索引条目，实现 MEMORY.md 索引与 memory/ 目录内容的同步。

核心功能

使用方式

方式一：脚本调用

./scripts/auto-index-memory.sh <文件路径> <主题> <标签列表>

示例：

./scripts/auto-index-memory.sh memory/2026-04-12.md '天气预报格式优化' '天气，定时任务，偏好'

方式二：自动触发（推荐）

在写入记忆文件后自动调用：

// 伪代码示例
async function writeMemory(entry: MemoryEntry) {
  // 1. 写入记忆文件
  await writeFile(memory/${entry.date}.md, entry.content);
  // 2. 自动添加索引
  const tags = extractTags(entry.content);
  const subject = extractSubject(entry.content);
  await exec(./scripts/auto-index-memory.sh memory/${entry.date}.md '${subject}' '${tags}');
}

标签体系

预定义标签

标签提取规则

从记忆内容中自动识别：

• 标题关键词 → 映射到预定义标签
• 用户明确标注 → 使用 ## 标签：天气，定时任务 格式
• 文件名 → 2026-04-12-weather.md → #天气

索引格式

MEMORY.md 索引区结构

## 📑 索引
按主题
#天气 预报格式标准化 → memory/2026-04-06.md#L15
#定时任务 每日天气预报配置 → memory/2026-04-06.md#L28
按项目
OpenClaw 配置 → memory/2026-04-03.md, memory/2026-04-06.md
天气预报服务 → memory/preferences.md, memory/2026-04-06.md
关键决策
日期
决策
位置
2026-04-06
天气预报格式标准化
memory/2026-04-06.md#L15

条目格式

- #主标签 主题描述 → 文件路径#L 行号

自动化流程

记忆写入流程

用户指令/事件
↓
写入 memory/YYYY-MM-DD.md
↓
提取标签和主题
↓
调用 auto-index-memory.sh
↓
更新 MEMORY.md 索引
↓
（可选）更新分类文件

触发条件

脚本说明

auto-index-memory.sh

位置： scripts/auto-index-memory.sh

功能：

• 解析参数（文件路径、主题、标签）
• 计算行号
• 检查重复
• 插入索引条目
• （可选）更新决策表

输出：

✅ 索引已更新
主题：天气预报格式优化
标签：#天气
位置：memory/2026-04-06.md#L15

维护指南

定期清理

每周检查一次索引：

# 检查无效引用（文件不存在）
grep -oP 'memory/[^]+' MEMORY.md | while read ref; do
  file=$(echo $ref | tr -d '' | cut -d'#' -f1)
  [ ! -f "$file" ] && echo "❌ 无效引用：$ref"
done

行号更新

文件内容变更后，行号可能失效。建议：

• 使用 章节标题 代替行号：memory/2026-04-06.md#定时任务配置
• 或定期运行脚本重新计算行号

扩展建议

1. 语义搜索增强

# 添加全文索引
./scripts/build-memory-index.sh
# 生成 memory-index.json 供语义搜索使用

2. 标签云可视化

# 统计标签频率
grep -oP '#\w+' MEMORY.md | sort | uniq -c | sort -rn

3. 自动分类文件同步

当索引条目达到一定数量时，自动创建/更新分类文件：

memory/
├── topics/
│   ├── weather.md          # 所有#天气相关
│   ├── tasks.md            # 所有#定时任务相关
│   └── preferences.md      # 所有#偏好相关

故障排除

相关文件

• MEMORY.md - 主索引文件
• memory/ - 每日记忆目录
• scripts/auto-index-memory.sh - 自动索引脚本
• AGENTS.md - 记忆写入流程说明

版本历史