long-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