- name
- long-memory
- description
- 全量对话记忆系统，自动保存每次对话的完整内容（用户消息、助手回复、思考过程）并支持按语义检索任意历史对话。当用户提到"记下来""别忘了""回忆一下""之前聊过""什么时候说的"、要求回顾历史对话、或需要跨 session 记忆连续性时触发。也适用于 session 结束时的自动记忆归档。不适用于简单的短期记事（用 memory 文件即可）。
Long Memory
文件系统 = 无限外存，上下文窗口 = 有限内存。所有对话全量落盘，按需检索，永不遗忘。
企业级特性
- 并发安全：文件锁机制，多进程写入不冲突
- 三级搜索引擎：关键词 → TF-IDF + 近义词 → Embedding 向量（零依赖到深度语义）
- SQLite 引擎：结构化存储，查询比纯文件快 100 倍
- 自记忆引擎：系统记住自己的版本演变和决策历史
- 完整性校验：SHA256 校验和，自动检测修复损坏文件
- 自动备份：Git commit + push，支持定时自动执行
- 质量评分：0-100 分量化评估（7 条规则）
- 遗忘曲线：艾宾浩斯遗忘曲线检索权重
- 情感分析：对话情绪变化追踪
- 人物图谱：自动提取人脉关系
- 智能推荐：基于当前对话推荐相关历史
- 隐私加密：AES-256 加密敏感记忆
- 结构化模板：会议纪要/项目决策/学习笔记/周报
- 定时调度：内置蒸馏/备份/清理调度器
- 多用户隔离：独立记忆空间
- REST API：7 个 HTTP 接口，支持外部集成
- HTML 报告：暗色主题可视化分析面板
- 操作审计：JSONL 完整操作日志
- 配置管理：JSON 配置 + 版本自动迁移
- 性能基准：365 天数据模拟，多维度测量
- 统一 CLI：35 个子命令
- 37 个测试：pytest 全通过
- 零核心依赖：搜索引擎、SQLite 全部 Python 标准库
CLI 速查
所有命令支持 --memory-dir 自定义路径，多数命令支持 --json JSON 输出。
📝 记录
cli.py archive --session webchat --topic "话题" # 归档对话
cli.py capture [-s <id>] # 捕获 session 历史
cli.py import <file> # 批量导入 MD/JSON/文本
cli.py template list # 列出模板
cli.py template create meeting -f participants "张三" # 创建结构化记录🔍 搜索（三级引擎）
cli.py search -q "关键词" --tag 标签 --days 30 # 组合搜索（标签+话题+时间）
cli.py semantic "怎么优化性能" # 语义搜索（TF-IDF+近义词，零依赖，推荐）
cli.py tfidf "查询" --rebuild # TF-IDF 向量搜索
cli.py embedding search "查询" --top 10 # 深度语义搜索（需 sentence-transformers）
cli.py sqlite search -q "查询" # SQLite 高性能查询
cli.py recommend "当前对话内容" # 智能推荐相关历史
cli.py timeline [-t 话题] [-v] # 话题时间线📊 分析
cli.py stats [-v] # 统计
cli.py graph [-v] # 记忆关联图谱
cli.py persons [-v] # 人物关系
cli.py emotion [-v] # 情感分析
cli.py health # 健康仪表盘
cli.py report -o report.html # HTML 可视化报告✅ 质量
cli.py quality # 质量评分（0-100）
cli.py contradictions # 矛盾检测
cli.py integrity [--fix] # 完整性校验
cli.py forgetting # 遗忘曲线🔧 维护
cli.py summary # 每日摘要
cli.py distill # 周蒸馏
cli.py tags [--execute] # 标签优化
cli.py clean --days 90 [--execute] # 清理旧记忆
cli.py index [--rebuild] # 索引管理
cli.py backup [--status|--setup] # Git 备份
cli.py scheduler [--list|--run|--force] # 定时任务
cli.py self [--summary] # 自记忆引擎
cli.py config [--migrate] # 配置验证与迁移
cli.py benchmark # 性能基准测试🔒 安全与审计
cli.py privacy encrypt "内容" -p 密码 # AES-256 加密
cli.py privacy decrypt "密文" -p 密码 # 解密
cli.py privacy scan -f <file> # 敏感内容扫描
cli.py users list # 多用户管理
cli.py users switch <name> # 切换用户
cli.py export -f json -o backup.json # 导出 JSON/MD/TXT
cli.py log # 操作审计日志🌐 API
cli.py api --port 8765 # 启动 REST API 服务
# GET /api/health /api/stats /api/search?q= /api/topics /api/tags /api/conversations
# POST /api/conversations测试
cd long-memory && python3 -m pytest tests/ -v # 37 passed