https://caozuohua.github.io/tags/persistence/Recent content in Persistence on CAO ZUOHUAHugozh-cnTue, 18 Aug 2026 10:20:00 +0800https://caozuohua.github.io/posts/2026-08-18-deepseek-harness-series-3-session-memory-compaction/Tue, 18 Aug 2026 10:20:00 +0800https://caozuohua.github.io/posts/2026-08-18-deepseek-harness-series-3-session-memory-compaction/<blockquote> <p>这是 DSH 系列的第三篇。很多 Agent 都声称支持“记忆”，但这个词往往同时指会话保存、上下文压缩、跨会话召回和目标续跑。DSH 的有趣之处，是把这些问题明确拆开了。</p> </blockquote> <h2 id="先把记忆拆成五件事">先把“记忆”拆成五件事</h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>Session Persistence 保存发生过什么 </span></span><span style="display:flex;"><span>Context History 决定模型当前看到什么 </span></span><span style="display:flex;"><span>Compaction 压缩当前可见历史 </span></span><span style="display:flex;"><span>Long-term Memory 跨会话主动召回知识 </span></span><span style="display:flex;"><span>Goal State Agent 还要继续完成什么 </span></span></code></pre></div><p>DSH 内置支持前四项中的一部分：它强内置会话事件日志和上下文压缩，Goal 是持久任务状态；真正的语义长期记忆则通过外部 Provider 或 MCP 接入。</p> <h2 id="1-session-persistence日志才是事实来源">1. Session Persistence：日志才是事实来源</h2> <p>DSH 不把 <code>messages[]</code> 当作唯一状态，而是将一次交互保存为 append-only 的类型化事件：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>turn/start </span></span><span style="display:flex;"><span>user/message </span></span><span style="display:flex;"><span>assistant/chunk </span></span><span style="display:flex;"><span>assistant/message </span></span><span style="display:flex;"><span>tool/call </span></span><span style="display:flex;"><span>tool/result </span></span><span style="display:flex;"><span>step/end </span></span><span style="display:flex;"><span>turn/end </span></span></code></pre></div><p>模型的历史消息由这些事件重新派生。这样可以让 UI、Replay、Fork、Telemetry 和恢复逻辑共享同一份事实来源。<a href="https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/subsystems/session.md">Session 文档</a></p> <p>持久化层通过 <code>ctx.sessionPersistence</code> 抽象出来，目前支持 JSONL 和 SQLite 后端。写入采用批处理和 flush checkpoint；崩溃恢复时，DSH 会识别没有关闭的 turn，并以 <code>interrupted</code> 结束它，而不是粗暴截断日志。<a href="https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/subsystems/persistence.md">Persistence 文档</a></p> <p>这是一种“事实优先”的设计：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>原始日志尽量完整 </span></span><span style="display:flex;"><span>模型上下文可以变化 </span></span><span style="display:flex;"><span>历史投影可以重新计算 </span></span></code></pre></div><h2 id="2-compaction压缩可见表面不删除原始历史">2. Compaction：压缩可见表面，不删除原始历史</h2> <p>上下文接近模型窗口时，DSH 不直接删除旧事件，而是选择一段旧的 surface，调用 summarizer 生成摘要，然后追加一个 checkpoint：</p>