Session Memory

核心用法

Session Memory 是一套基于本地 JSONL 存储的记忆持久化工具，通过命令行脚本实现记忆的保存、检索与管理。核心工作流包含：

• 保存记忆：./save.sh "topic" "content" 按主题存储带时间戳的条目
• 模糊检索：./recall.sh "query" 支持跨主题搜索历史内容
• 会话恢复：./daily.sh 快速回顾当日/近期记忆，实现上下文衔接
• 存储治理：./prune.sh [days] 自动归档超期记忆，默认30天

存储层采用分层目录结构（~/.agent-memory/YYYY/MM/DD.jsonl），配合 index.json 主题索引，兼顾检索效率与文件可读性。

显著优点

1. 架构简洁：纯 Shell + JSONL，无外部依赖（仅需 curl），部署零成本
2. 人机友好：文本格式存储，支持手动审计与版本控制
3. 主题化组织：通过标签体系实现多维分类，避免扁平化记忆的检索噩梦
4. 会话连续性：从"每次重启从零开始"转向"累积式 expertise 构建"

潜在局限

• 无内置加密：敏感记忆以明文存储于本地磁盘
• 单机约束：未提供分布式同步或云端备份机制
• 检索精度：模糊搜索依赖简单字符串匹配，大规模数据下效能待验证
• 无冲突解决：多代理并发写入存在覆盖风险

适合人群

• 长期运行的个人 AI 代理/助手项目
• 需要审计追踪的决策记录场景（如自动化运维、研究辅助）
• 对数据主权敏感、偏好本地优先架构的用户

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据泄露 | `~/.agent-memory/` 目录权限管理不当可能导致记忆内容暴露 |

| 完整性破坏 | 手动编辑 JSONL 或磁盘故障可能损坏索引 |

| 记忆膨胀 | 缺乏自动摘要机制，长期运行后存储线性增长 |

| 隐私合规 | 记忆内容可能包含 PII，需用户自行履行 GDPR/个人信息保护义务 |

核心功能与用法

Session Memory 是一套专为 AI Agent 设计的轻量级会话记忆持久化方案，通过纯 Shell 脚本实现跨会话的上下文连续性。核心架构围绕 ~/.agent-memory/ 本地目录展开，采用按日分片的 JSON Lines 存储格式，支持四种记忆类型：上下文（Context）、决策记录（Decisions）、洞察总结（Insights）和人际关系（Relationships）。

关键命令：

• ./scripts/save.sh "topic" "content" —— 带时间戳和标签的记忆写入
• ./scripts/recall.sh "query" —— 基于 grep 的模糊内容检索
• ./scripts/topics.sh —— 话题索引与条目统计
• ./scripts/daily.sh [date] —— 按日回溯记忆流
• ./scripts/prune.sh [days] —— 自动归档过期记忆（默认30天）

设计亮点：存储结构清晰（index.json + 年/月/日.jsonl + archive），支持 AGENT_MEMORY_DIR 环境变量自定义路径，Node.js 仅为可选依赖用于格式化输出，核心功能零依赖可用。

显著优点

1. 极致轻量：7个文件、233行代码，纯 Bash 实现，无第三方依赖包
2. 隐私优先：数据完全本地存储，零网络通信，符合 GDPR 数据最小化原则
3. 运维友好：标准 Unix 工具链（grep/cat/date/sed），跨平台兼容性强
4. 降级健壮：Node.js 缺失时自动回退到原始文本输出，功能不中断
5. 语义清晰：话题标签系统 + 时间戳索引，便于构建个人知识图谱

局限性与风险

架构局限：

• 基于文本 grep 的检索无法支持语义搜索，复杂查询效率受限
• 无内置并发控制，高频写入可能出现文件竞争
• JSON Lines 格式在单文件过大时（百万级条目）读取性能下降

安全考量：

• 记忆文件以明文存储，无加密选项，敏感信息存在泄露风险
• 输入验证仅检查参数存在性，缺乏字符白名单过滤（存在潜在 JSON 注入/路径遍历面）
• 目录权限未强制约束（建议 chmod 700）

来源风险：

• T3 级别个人开发者项目，维护连续性依赖单一作者，需关注更新动态

适合人群

• 个人 AI Agent 开发者：需要快速搭建无外部依赖的记忆层
• 隐私敏感用户：拒绝云端记忆方案，要求数据完全自主可控
• 离线/隔离环境：无网络权限的容器或内网场景
• 原型验证阶段：以轻量级方案验证 Agent 记忆架构可行性

使用建议

避免在记忆中存储密码、API 密钥等敏感凭证；定期执行 prune.sh 控制存储膨胀；生产环境使用前建议添加输入验证与目录权限加固。