Veritas Memory 会话记忆

要解决的问题

veritas-memory 针对 AI Agent 跨会话记忆不可靠的问题：Agent 可能把 STATE.md 当成唯一事实，手动维护容易漏；会话中断或超时后，自动同步未触发，下一次启动时仍读取过期状态；遇到“没修好”“上次那个呢”这类不完整上下文时，Agent 又容易反问用户，造成体验损耗。它把会话历史作为 ground truth，文件只是可重建的索引和缓存。

技能如何工作

核心是两层同步与启动校验：

• 会话结束前：在不打断对话的前提下，将关键事件同步到 STATE.md 与 MEMORY.md。
• 下次启动时：比对 STATE.md 时间戳与上次会话时间，发现缺口则先补同步，再回答。
• 上下文丢失恢复：收到不完整指令时，先查当前 session，再读取 sessions_history(prev_session) 的原文；补齐信息前不反问用户。
• Memory Tender：可选周期整理，合并旧事件、清理过时记忆、交叉验证，保持 STATE.md 与 MEMORY.md 精简。

适用边界

适合需要长期上下文、跨会话追踪任务状态的 Agent 场景。它不替代业务数据库，也不保证会话一定结束；若 sessions_history 不可读、权限受限或外部日志缺失，仍可能无法恢复全部事实。文件内容应保持小索引：STATE.md 控制行数，冲突时以会话为准，再回写文件。