会话记忆 🧠 v2.0

为AI智能体提供的持久化记忆。保存重要内容，回忆相关信息，整合所学知识。

v2.0版本特性：相关性评分搜索、重要性分级、会话上下文加载器、整合、导出/导入、统计信息、编辑/删除。

快速开始

# Save a memory (with optional importance)
MEMORY_IMPORTANCE=high ./scripts/save.sh "decision" "Chose Postgres over SQLite for scale"

# Recall with relevance scoring
./scripts/recall.sh "database" --limit 5

# Load session context (startup)
./scripts/context.sh --days 3

# Consolidate by topic
./scripts/consolidate.sh --since 2026-01-01

# Stats
./scripts/stats.sh

命令

save.sh — 保存记忆

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

# Basic save
./scripts/save.sh "insight" "Users prefer dark mode 3:1" ui design

# High importance
MEMORY_IMPORTANCE=high ./scripts/save.sh "decision" "Migrated to TypeScript" refactor

# Critical (always surfaces in 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]

功能特性：

• 多关键词"与"搜索— 所有词语必须匹配
• 相关性评分— 基于词语匹配率 + 重要性 + 时效性
• 过滤器— 按主题、重要级别、日期范围

./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 天）
• 无论时间长短的高/关键重要性项目
• 按重要性排序，再按时间远近排序
• 按日期分组

# Quick context
./scripts/context.sh

# Wider window
./scripts/context.sh --days 7 --limit 30

# For programmatic use
./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 <timestamp_ms> --content "new content"
./scripts/edit.sh <timestamp_ms> --topic "new topic"
./scripts/edit.sh <timestamp_ms> --importance critical
./scripts/edit.sh <timestamp_ms> --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天）的记忆移至归档目录/。

存储格式

~/.agent-memory/
├── 2026/
│   ├── 01/
│   │   ├── 15.jsonl
│   │   └── 16.jsonl
│   └── 02/
│       └── 01.jsonl
└── archive/          # Pruned memories

每行为一个JSON对象：

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

重要性级别

推荐工作流程

# Session start
./scripts/context.sh

# During work — save important things
./scripts/save.sh "decision" "..."
MEMORY_IMPORTANCE=high ./scripts/save.sh "insight" "..."

# End of session
./scripts/save.sh "summary" "Today: did X, decided Y, next step Z"

# Weekly review
./scripts/consolidate.sh --since $(date -u -d '7 days ago' +%Y-%m-%d)
./scripts/stats.sh

# Monthly maintenance
./scripts/prune.sh 60
./scripts/export.sh -o backup-$(date +%Y%m).json

创建者Voidborne🔹