AI代理持久记忆，会话无缝延续

AI代理持久化记忆工具包，支持上下文保存、关联性检索、重要性分级与会话延续，纯bash+node零依赖实现。

基本信息

• 技能名称?Session Memory
• 中文名称?AI代理持久记忆，会话无缝延续
• 作者?swaylq
• 分类?专业技能
• 版本?2.0.0
• 标签?ai-agent, memory-management, bash, nodejs, context-retention, local-first, jsonl, search, session-management

使用方法

使用说明
核心用法
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 级记忆明文存储，若包含密钥等需配合磁盘加密或权限管控
   隐私边界 ：记忆内容可能累积用户敏感对话，需明确数据保留策略与清理周期