AI代理持久化记忆工具包，支持上下文保存、关联性检索、重要性分级与会话延续，纯bash+node零依赖实现。
说明：
## 核心用法
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 级记忆明文存储，若包含密钥等需配合磁盘加密或权限管控
– **隐私边界**：记忆内容可能累积用户敏感对话，需明确数据保留策略与清理周期
