Hermes Agent四层记忆分工明确：工作记忆为环形缓冲区管当前会话；情景记忆用SQLite+FTS5存交互轨迹；语义记忆以内存向量固化领域知识；技能记忆以结构化Markdown封装可执行流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在研究Hermes Agent的记忆系统，却发现各层级功能边界模糊、调用逻辑不清，则可能是由于未厘清四层记忆在数据流与生命周期中的分工关系。以下是解析其协同工作机制的步骤：
一、工作记忆：维持当前任务连贯性的环形缓冲区
工作记忆作为最靠近执行层的记忆模块，承担即时上下文管理职责，确保单次会话中工具调用、状态流转与中间变量的一致性。它不参与跨会话知识沉淀，而是通过容量约束与自动轮转机制防止上下文膨胀干扰推理。
1、该层以环形缓冲区实现，仅保留最近90次工具调用的完整输入输出及元数据。
2、每次新工具调用写入时，若缓冲区已满，则最早一条记录被自动覆盖。
3、缓冲区内容全程驻留内存，不落盘、不索引，仅服务于当前会话的实时决策链。
二、情景记忆：基于SQLite+FTS5的持久化交互轨迹库
情景记忆负责跨会话事实存储，将用户指令、项目约定、环境配置等具象交互结果结构化归档，为后续检索提供可验证的历史依据。其核心价值在于支持“按需唤醒”，而非全量加载。
1、所有完成的会话片段经标准化清洗后，写入本地SQLite数据库的episodes表。
2、每条记录同步生成关键词标签与LLM生成的语义摘要，并启用FTS5全文索引。
3、当Agent判断当前任务需历史参考时，触发检索接口，返回Top-3匹配摘要而非原始日志。
三、语义记忆：内存缓存的嵌入向量知识图谱
语义记忆抽象并固化领域通用规则、技术栈规范、业务术语定义等非情境化知识，以向量形式驻留内存，支撑跨文档关联推理与概念泛化。它不依赖具体时间戳或会话ID，而是通过相似性匹配激活。
1、初始语义知识由初始化配置注入，包括技术栈清单、API限制说明、合规条款等。
2、运行中经LLM提炼的新规则（如“该客户禁止使用HTTP明文上传”）被实时编码为嵌入向量。
3、向量集合定期与本地知识库做余弦相似度比对，剔除重复或冲突项，保持语义一致性。
四、技能记忆：按SOP结构落盘的可执行流程文件
技能记忆是唯一具备程序化执行能力的记忆层，将多次验证成功的复杂任务路径封装为独立Markdown文件，每个文件严格遵循触发条件、执行步骤、失败回滚点与验证断言四段式结构，实现“一次跑通、永久复用”。
1、当单次会话中完成≥5次工具调用且最终目标达成，系统自动启动技能抽象流程。
2、剔除调试性尝试、无效重试与冗余分支，仅保留线性主干路径与关键断言节点。
3、生成Skill_YYYYMMDD_HHMMSS.md文件，存入skills/目录，并更新skills_index.json索引表。
五、四层协同的数据流向与触发时机
四层记忆并非并行静默存在，而是在会话生命周期内按固定节奏联动：工作记忆实时供给当前推理；情景记忆在任务启动前1.2秒触发预检检索；语义记忆在LLM生成响应前0.8秒注入领域约束；技能记忆则于工具调用准备阶段，根据触发条件匹配结果动态加载对应文件全文。
1、用户输入到达后，工作记忆立即捕获原始query与会话ID，建立临时上下文锚点。
2、系统提示词组装阶段，从情景记忆中异步拉取匹配摘要，从语义记忆中同步注入向量约束。
3、LLM输出首个token前，技能引擎扫描当前意图关键词，命中即加载对应Skill.md的执行步骤段落。
4、任务执行过程中，工作记忆持续更新中间状态；任务成功后，技能抽象模块接管，启动四段式结构化封装。
六、记忆污染防控机制：三层隔离策略
为避免层级间信息越界导致推理失真，Hermes Agent强制实施物理隔离、加载隔离与注入隔离三重防护，确保各层数据仅在预设通道与时机参与计算。
1、物理隔离：工作记忆纯内存驻留；情景记忆独占SQLite实例；语义记忆使用独立向量缓存区；技能记忆全部为只读文件系统访问。
2、加载隔离：情景记忆与语义记忆仅在系统提示词构建阶段加载；技能记忆仅在工具调用前加载；工作记忆全程常驻但不可被外部查询API读取。
3、注入隔离：工作记忆内容不进入任何检索索引；情景记忆摘要经LLM蒸馏后才注入上下文；语义记忆向量仅参与相似度计算，不暴露原始文本；技能记忆文件全文仅在执行时注入，且注入后立即标记为“已使用”防止重复加载。
七、记忆时效性控制：分级TTL与主动衰减策略
各层记忆均配置差异化生存周期（TTL），并引入基于使用频次与任务成功率的主动衰减算法，防止低效记忆长期占据资源。
1、工作记忆TTL为单会话生命周期，会话结束即释放全部内存块。
2、情景记忆默认TTL为180天，但若某条记录连续60天未被检索，自动降权并移出FTS5主索引。
3、语义记忆中向量节点若30天内无匹配行为，触发衰减系数0.95迭代，三次衰减后低于阈值即清除。
4、技能记忆文件若连续90天未被成功调用，系统将其移入archive/skills/目录并从索引中剔除。
八、跨层引用协议：记忆间安全跳转的URI标识体系
当某层记忆需显式引用另一层内容时（如技能文件中需调用特定情景记忆片段），采用统一URI格式进行定位，避免硬编码路径与ID耦合，保障架构可迁移性。
1、情景记忆引用格式为：episodic://episode_id，例如 episodic://20260425_142201。
2、语义记忆引用格式为：semantic://concept_hash，例如 semantic://a7f3b9c1d2e4。
3、技能记忆引用格式为：skill://skill_name，例如 skill://deploy_nextjs_page。
4、所有URI在加载时由Memory Router模块解析，执行权限校验与格式验证后再定向跳转。
