DeepSeek Harness 界面显示和会话日志不一致:投影、重放与刷新三种情况怎么查
界面显示的是投影,不是日志本身。 会话日志是追加的事件事实,投影是把事件折叠成客户端视图的结果;投影可以重算,日志才是共同事实(来源)。所以「两个窗口显示不同」不一定是数据坏了,可能只是两个投影进度不同。
DeepSeek Harness 日志是事实,投影是视图
日志只追加,投影可重算。 日志记录发生了什么,投影决定现在显示什么。(来源)
这条分工带来两个重要结论:
- 投影滞后不等于日志缺失 — 事件可能已经写入,只是视图还没折叠到;
- 投影重算不等于数据修复 — 重算只是从日志重新生成视图,不改日志。
因此,看到不一致时先问「日志里有没有这个事件」,而不是先问「哪个窗口对」。日志有、投影没有,是显示问题;日志没有、投影有,才是数据问题。
投影还可能有多个消费者:Web 会话、CLI、SDK 各自折叠。不同消费者看到的视图可能短暂不同,但底层事件应一致。
DeepSeek Harness 三种不一致:投影滞后、重放差异、客户端缓存
三种来源对应三种处理方式,先分类再动手。 对照如下(来源):
| 类型 | 现象 | 先做什么 |
|---|---|---|
| 投影滞后 | 新消息还没出现,稍后自己出现 | 等待或刷新投影 |
| 重放差异 | 刷新后顺序或内容变化 | 检查重放进度与事件序列 |
| 客户端缓存 | 同一会话两个窗口不同 | 重开窗口或清缓存 |
投影滞后最常见。事件已提交,但投影还没折叠到最新;通常几秒内恢复,不需要修数据。
重放差异更像「视图按新规则重算」。例如投影逻辑升级后,同一批事件折叠出的视图可能不同;这时以日志为准,确认事件没变。
客户端缓存最容易被误判成数据损坏。两个窗口一个开着旧缓存、一个刚刷新,显示自然不同;重开或清缓存后通常一致。
DeepSeek Harness 判断谁对:以已提交事件为准
判断顺序是「日志 → 事件序列 → 投影 → 客户端」。 从源往视图查,不要反过来。(来源)
- 日志 — 会话文件里有没有对应事件;
- 事件序列 —
seq是否连续、是否有重复或倒退; - 投影 — 折叠结果是否覆盖了最新事件;
- 客户端 — 是否还在用旧缓存或旧订阅。
如果日志有、事件序列正常、投影缺,问题在投影;如果日志缺,问题在写入或持久化;如果日志和投影都有、客户端缺,问题在缓存或订阅。
不要用「刷新后对了」直接判断问题解决。刷新只是重建投影或清缓存,可能掩盖了投影滞后的根因。
DeepSeek Harness 刷新与重放
刷新是轻量重建,重放是完整重建。 两者适用场景不同(来源):
- 刷新 — 重新拉取投影,适合客户端缓存或订阅断开;
- 重放 — 从日志重新生成视图,适合投影逻辑变化或视图损坏;
- 重开会话 — 重新建立订阅,适合单会话异常。
刷新不会改日志,也不会重新计算历史;重放会从事件重新折叠,成本更高,但能修复投影层面的错乱。
如果刷新后仍然不一致,再考虑重放。重放前先确认日志完整,否则会把缺失事件一起重放成「正常视图」。
重放不是数据修复的万能药。日志损坏时,重放只会得到同样损坏的视图;这时才需要修数据。
DeepSeek Harness 什么情况下需要修数据
只有三种情况需要动会话数据。 其他情况先刷新或重放(来源):
- 日志损坏 — JSONL 截断、seq 缺口、无法解析;
- 事件缺失 — 关键事件没有写入,投影无法重建;
- 投影无法重算 — 事件格式与当前版本不兼容,且没有迁移。
三种情况的共同点是「日志层有问题」。如果日志完整、只是投影或缓存不一致,修数据是过度操作。
修数据前先备份。会话文件是事实来源,改错后很难恢复;备份成本远低于重建成本。
修数据时优先「补事件」而不是「改视图」。视图可以重算,事件才是长期事实;改视图只能暂时让界面好看。
DeepSeek Harness 一致性验证的四步
验证一致性,按四步走,不要只看一个窗口。 四步(来源):
- 日志检查 — 确认事件存在、seq 连续;
- 投影重算 — 重放后确认视图覆盖最新事件;
- 客户端对照 — 两个窗口刷新后是否一致;
- 复现路径 — 记录触发不一致的操作,确认不是订阅时序。
四步都过,说明日志、投影与客户端一致。只过第一步,常见问题是投影滞后;只过前两步,常见问题是缓存。
旧文 develop-session-projection-units 讲投影单元,develop-session-log 讲日志扩展,fix-session-projections-inactive-context 讲具体报错;本篇补的是三种不一致的分诊。先看日志,再看视图。
日志是共同事实,投影只是其中一种读法。
先确认事实,再修视图,顺序不能反。
常见问题
DeepSeek Harness 的会话日志是追加的事实记录,投影是把已提交事件折叠成客户端视图。日志是源,投影是视图,投影可以重算。
DeepSeek Harness 通常不是。DeepSeek Harness 刷新会重新拉取投影,投影可能滞后或按新规则重算;先看日志中的事件是否还在,再判断是显示问题还是数据问题。
DeepSeek Harness 里,以已提交事件为准。DeepSeek Harness 的投影可能因客户端缓存、订阅时序或重放进度不同而暂时不一致,日志中的事件序列才是共同事实。
DeepSeek Harness 里,只有当日志本身损坏、事件缺失或投影无法从日志重建时才需要修数据。单纯的显示滞后或缓存不一致,应先刷新、重放或重开客户端。
相关术语
- 会话日志
- 会话日志是 DeepSeek Harness 追加写入的事件记录,是模型历史与客户端视图的共同事实来源。— DeepSeek Harness 官方文档 - 会话
- 投影
- 投影是 DeepSeek Harness 把已提交事件折叠成客户端视图的过程,结果可以重算,不改变原始事件。— DeepSeek Harness 官方文档 - 会话投影
- 重放
- 重放是从会话日志重新生成视图或状态的过程,用于恢复、迁移与排查投影差异。— DeepSeek Harness 官方文档 - 会话投影
- 客户端缓存
- 客户端缓存是浏览器或客户端为减少请求保留的本地视图数据,可能与最新投影短暂不一致。— DeepSeek Harness 官方文档 - 会话投影
来源
- DeepSeek Harness 官方文档 - 会话投影· deepseek-harness
- DeepSeek Harness 官方文档 - 会话· deepseek-harness