核心用法
Session Memory 是一款专为 AI 代理设计的持久化记忆管理工具，采用纯 Bash + Node.js 实现，无需外部依赖。核心功能围绕三类操作展开：
保存与组织：通过 save.sh 将关键信息按主题存储，支持四级重要性分级（low/normal/high/critical），高/关键级记忆会自动注入新会话上下文。数据以 JSONL 格式按日期分层存储于 ~/.agent-memory/，便于版本控制与备份。
检索与唤醒：recall.sh 提供多关键词 AND 搜索与相关性评分算法（匹配率+重要性+时效性），context.sh 则在会话启动时自动加载近期记忆与关键事项，解决 AI 上下文断裂痛点。
维护与演进：consolidate.sh 支持按主题聚合回顾，stats.sh 提供数据健康度仪表板，export/import 与 prune.sh 实现生命周期管理与迁移安全。
显著优点
1. 架构轻量：仅依赖系统 bash 与 node，无 npm 包、无数据库，部署成本极低
2. 协议友好：JSONL 明文存储，人工可读、git 友好、审计透明
3. 算法实用：相关性评分与重要性分层机制，平衡了检索精度与上下文噪音控制
4. 工作流闭环：从 session 启动 → 工作记录 → 日/周回顾 → 归档清理，覆盖完整记忆生命周期
潜在局限
- 并发安全：文档未提及文件锁机制，多进程同时写入存在数据竞争风险
- 规模瓶颈：纯文件系统架构，当条目数万级以上时检索性能可能下降
- 无向量语义：关键词匹配无法实现同义/近义检索，依赖精确词形
- 跨机同步：需自行解决
~/.agent-memory目录的同步或集中存储
适合人群
- 长期运行、需要跨会话保持上下文的 AI 代理开发者
- 重视数据主权、偏好本地优先存储的技术用户
- 需要可审计、可版本控制记忆记录的合规场景
常规风险
- 数据持久化：虽提供 export，但无自动备份策略，误删或磁盘故障可导致记忆丢失
- 敏感信息：critical 级记忆明文存储，若包含密钥等需配合磁盘加密或权限管控
- 隐私边界：记忆内容可能累积用户敏感对话，需明确数据保留策略与清理周期