会话记忆 🧠 v2.0

面向 AI 代理的持久化记忆系统。保存关键信息，召回相关内容，整合已学知识。

v2.0 新特性： 基于相关性的搜索、重要性分级、会话上下文加载器、内容整合、导出/导入功能、统计信息、编辑与删除支持。

快速上手

# 保存一条记忆（可选指定重要性）
MEMORY_IMPORTANCE=high ./scripts/save.sh "decision" "Chose Postgres over SQLite for scale"

# 带相关性评分的召回
./scripts/recall.sh "database" --limit 5

# 加载会话上下文（启动时调用）
./scripts/context.sh --days 3

# 按主题整合记忆
./scripts/consolidate.sh --since 2026-01-01

# 查看统计信息
./scripts/stats.sh

命令说明

save.sh — 保存一条记忆

./scripts/save.sh "topic" "content" [tags...]

# 基础保存
./scripts/save.sh "insight" "Users prefer dark mode 3:1" ui design

# 高重要性
MEMORY_IMPORTANCE=high ./scripts/save.sh "decision" "Migrated to TypeScript" refactor

# 关键级（始终出现在 context.sh 输出中）
MEMORY_IMPORTANCE=critical ./scripts/save.sh "credential" "API key rotated, new one in vault"

recall.sh — 搜索记忆

./scripts/recall.sh "query" [--json] [--limit N] [--topic T] [--importance I] [--since YYYY-MM-DD]

功能特性：

• 多关键词 AND 搜索 — 所有关键词必须同时匹配
• 相关性评分 — 综合词匹配比例、重要性等级与时间新鲜度计算
• 过滤能力 — 支持按主题、重要性等级、日期范围筛选

./scripts/recall.sh "database migration"
./scripts/recall.sh "API" --topic decision --limit 20
./scripts/recall.sh "deploy" --since 2026-03-01 --json
./scripts/recall.sh "error" --importance high

context.sh — 会话启动上下文加载器

./scripts/context.sh [--days N] [--limit N] [--json]

为新会话加载最相关的记忆项：

• 近期记忆（最近 N 天，默认为 3 天）
• 高重要性或关键级记忆（无视时间，始终包含）
• 排序规则：先按重要性降序，再按时间倒序
• 按日期分组输出

# 快速加载上下文
./scripts/context.sh

# 扩展时间窗口
./scripts/context.sh --days 7 --limit 30

# 程序化调用（JSON 格式）
./scripts/context.sh --json

daily.sh — 日视图

./scripts/daily.sh [YYYY-MM-DD] [--json]

topics.sh — 主题索引

./scripts/topics.sh [--json]

consolidate.sh — 主题整合

./scripts/consolidate.sh [--since YYYY-MM-DD] [--topic T] [--json]

按主题聚合所有记忆，展示各主题的记忆数量、时间跨度、高频标签及最新条目。适用于周期性复盘。

stats.sh — 记忆统计

./scripts/stats.sh [--json]

输出内容包括：总条目数、时间跨度、日均条目数、存储占用大小、主题分布、重要性等级分布。

edit.sh — 编辑或删除记忆

./scripts/edit.sh  --content "new content"
./scripts/edit.sh  --topic "new topic"
./scripts/edit.sh  --importance critical
./scripts/edit.sh  --delete

export.sh — 导出记忆

./scripts/export.sh [-o backup.json] [--since YYYY-MM-DD] [--topic T]

import.sh — 导入记忆

./scripts/import.sh backup.json [--dry-run]

依据时间戳去重 — 可安全重复执行。

prune.sh — 归档旧记忆

./scripts/prune.sh [days]

将早于 N 天（默认为 30 天）的记忆移至 archive/ 目录。

存储结构

~/.agent-memory/
├── 2026/
│   ├── 01/
│   │   ├── 15.jsonl
│   │   └── 16.jsonl
│   └── 02/
│       └── 01.jsonl
└── archive/          # 已归档的记忆

每行是一个 JSON 对象：

{"ts":1706793600000,"topic":"decision","content":"Chose X because Y","tags":["project"],"importance":"high"}

重要性等级说明

推荐工作流

# 会话启动
./scripts/context.sh

# 工作过程中 — 保存重要内容
./scripts/save.sh "decision" "..."
MEMORY_IMPORTANCE=high ./scripts/save.sh "insight" "..."

# 会话结束时
./scripts/save.sh "summary" "Today: did X, decided Y, next step Z"

# 周度复盘
./scripts/consolidate.sh --since $(date -u -d '7 days ago' +%Y-%m-%d)
./scripts/stats.sh

# 月度维护
./scripts/prune.sh 60
./scripts/export.sh -o backup-$(date +%Y%m).json

由 Voidborne 🔹 创建