ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness 界面显示和会话日志不一致:投影、重放与刷新三种情况怎么查

故障排查发布于 2026-11-18作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugin会话投影会话日志数据一致性
刷新后消息变了、同一条会话两个窗口显示不同,先别急着修数据。本文讲日志与投影的分工、三种不一致的来源,以及判断谁对的顺序和什么时候才需要动会话文件。

界面显示的是投影,不是日志本身。 会话日志是追加的事件事实,投影是把事件折叠成客户端视图的结果;投影可以重算,日志才是共同事实(来源)。所以「两个窗口显示不同」不一定是数据坏了,可能只是两个投影进度不同。

DeepSeek Harness 日志是事实,投影是视图

日志只追加,投影可重算。 日志记录发生了什么,投影决定现在显示什么。(来源)

这条分工带来两个重要结论:

  1. 投影滞后不等于日志缺失 — 事件可能已经写入,只是视图还没折叠到;
  2. 投影重算不等于数据修复 — 重算只是从日志重新生成视图,不改日志。

因此,看到不一致时先问「日志里有没有这个事件」,而不是先问「哪个窗口对」。日志有、投影没有,是显示问题;日志没有、投影有,才是数据问题。

投影还可能有多个消费者:Web 会话、CLI、SDK 各自折叠。不同消费者看到的视图可能短暂不同,但底层事件应一致。

DeepSeek Harness 三种不一致:投影滞后、重放差异、客户端缓存

三种来源对应三种处理方式,先分类再动手。 对照如下(来源):

类型现象先做什么
投影滞后新消息还没出现,稍后自己出现等待或刷新投影
重放差异刷新后顺序或内容变化检查重放进度与事件序列
客户端缓存同一会话两个窗口不同重开窗口或清缓存

投影滞后最常见。事件已提交,但投影还没折叠到最新;通常几秒内恢复,不需要修数据。

重放差异更像「视图按新规则重算」。例如投影逻辑升级后,同一批事件折叠出的视图可能不同;这时以日志为准,确认事件没变。

客户端缓存最容易被误判成数据损坏。两个窗口一个开着旧缓存、一个刚刷新,显示自然不同;重开或清缓存后通常一致。

DeepSeek Harness 判断谁对:以已提交事件为准

判断顺序是「日志 → 事件序列 → 投影 → 客户端」。 从源往视图查,不要反过来。(来源)

  1. 日志 — 会话文件里有没有对应事件;
  2. 事件序列 — seq 是否连续、是否有重复或倒退;
  3. 投影 — 折叠结果是否覆盖了最新事件;
  4. 客户端 — 是否还在用旧缓存或旧订阅。

如果日志有、事件序列正常、投影缺,问题在投影;如果日志缺,问题在写入或持久化;如果日志和投影都有、客户端缺,问题在缓存或订阅。

不要用「刷新后对了」直接判断问题解决。刷新只是重建投影或清缓存,可能掩盖了投影滞后的根因。

DeepSeek Harness 刷新与重放

刷新是轻量重建,重放是完整重建。 两者适用场景不同(来源):

  • 刷新 — 重新拉取投影,适合客户端缓存或订阅断开;
  • 重放 — 从日志重新生成视图,适合投影逻辑变化或视图损坏;
  • 重开会话 — 重新建立订阅,适合单会话异常。

刷新不会改日志,也不会重新计算历史;重放会从事件重新折叠,成本更高,但能修复投影层面的错乱。

如果刷新后仍然不一致,再考虑重放。重放前先确认日志完整,否则会把缺失事件一起重放成「正常视图」。

重放不是数据修复的万能药。日志损坏时,重放只会得到同样损坏的视图;这时才需要修数据。

DeepSeek Harness 什么情况下需要修数据

只有三种情况需要动会话数据。 其他情况先刷新或重放(来源):

  1. 日志损坏 — JSONL 截断、seq 缺口、无法解析;
  2. 事件缺失 — 关键事件没有写入,投影无法重建;
  3. 投影无法重算 — 事件格式与当前版本不兼容,且没有迁移。

三种情况的共同点是「日志层有问题」。如果日志完整、只是投影或缓存不一致,修数据是过度操作。

修数据前先备份。会话文件是事实来源,改错后很难恢复;备份成本远低于重建成本。

修数据时优先「补事件」而不是「改视图」。视图可以重算,事件才是长期事实;改视图只能暂时让界面好看。

DeepSeek Harness 一致性验证的四步

验证一致性,按四步走,不要只看一个窗口。 四步(来源):

  1. 日志检查 — 确认事件存在、seq 连续;
  2. 投影重算 — 重放后确认视图覆盖最新事件;
  3. 客户端对照 — 两个窗口刷新后是否一致;
  4. 复现路径 — 记录触发不一致的操作,确认不是订阅时序。

四步都过,说明日志、投影与客户端一致。只过第一步,常见问题是投影滞后;只过前两步,常见问题是缓存。

旧文 develop-session-projection-units 讲投影单元,develop-session-log 讲日志扩展,fix-session-projections-inactive-context 讲具体报错;本篇补的是三种不一致的分诊。先看日志,再看视图。

日志是共同事实,投影只是其中一种读法。

先确认事实,再修视图,顺序不能反。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

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 官方文档 - 会话投影

来源