将重IO与UI收尾解耦：消除桌面代理中的输入冻结
内容提要
桌面AI代理客户端中，模型输出完成后输入框常因磁盘持久化阻塞而延迟解锁，原因包括终端事件被重IO阻塞、IPC队列队头阻塞、窗口失焦丢包。解决方案：收到完成消息后乐观解锁输入框，为终端事件设旁路通道，前端每10秒对账清理。核心原则是交互乐观、持久化异步、定期对账保证最终一致。
延伸解读
问题根源：持久化阻塞事件分发
输入框延迟解锁并非简单的前端状态错误，而是异步磁盘持久化阻塞了事件分发管道。文章指出三个具体瓶颈：终端事件被重IO阻塞（等待SQLite写入、图片落盘、JSONL归档完成才发送agent_end）、IPC队列的队头阻塞（agent_end排在诊断日志之后）、窗口失焦导致丢包（Chromium节流后台定时器，跨进程包丢失后UI永久错过agent_end）。这些因素共同导致用户已看到最终回复，输入框却仍处于禁用状态。
解决方案：乐观解锁与旁路通道
文章提出三项改动。第一，乐观解锁：前端收到MessageComplete并确认是真正的终止轮次、无后台工具执行、用户未请求停止后，立即解锁输入框，不等磁盘写入。第二，为终端事件设旁路通道：agent_end、error、cancelled等生命周期事件跳过标准有序队列，直接派发到渲染进程，即使SQLite写入或归档队列积压，UI生命周期更新也不延迟。第三，前端每10秒运行一次低开销对账，清理因窗口失焦或丢包导致的孤立流式状态。
设计原则：交互乐观、持久化异步、定期对账
文章总结的核心原则是：在富客户端应用中，保持用户交互乐观且快速，将重持久化异步放到后台执行，并用定期对账保证最终一致性。这一思路不仅适用于桌面AI代理客户端，也可推广到其他需要处理重IO与UI状态解耦的场景。通过乐观解锁、旁路通道和10秒对账循环，输入框在生成完成瞬间即可用，窗口切换导致的焦点冻结问题也随之消失。
Q&A
桌面AI代理客户端中，模型输出完成后输入框为什么还会延迟解锁？
主要原因是磁盘持久化阻塞了事件分发管道。具体包括：终端事件被重IO阻塞（如SQLite写入、图片物化、JSONL归档等耗时操作在发送agent_end前执行）；IPC队列的队头阻塞（agent_end排在诊断日志等事件之后）；窗口失焦导致丢包（Chromium节流后台定时器，跨进程包丢失后UI永久错过agent_end）。
如何解决桌面代理中因重IO导致的输入框冻结问题？
文章提出三个解决方案：1. 乐观解锁：前端收到MessageComplete并确认是真正的终端回合、无后台工具执行、用户未请求停止后，立即解锁输入框，不等待磁盘写入；2. 为终端事件设旁路通道：agent_end、error、cancelled等生命周期事件跳过标准有序队列，直接派发到渲染进程；3. 前端每10秒运行一次低开销对账循环，清理因窗口失焦或丢包导致的孤立流状态。
什么是乐观解锁？在什么条件下可以立即解锁输入框？
乐观解锁是指输入框的可用性不等待磁盘写入完成。当前端收到MessageComplete并验证以下三个条件后，立即解锁输入框：1. 回复是真正的终端回合（EndTurn）；2. 当前没有后台工具正在执行；3. 用户没有请求停止。这样可将感知恢复延迟降为零。
为什么需要为终端事件设置旁路通道？
因为生命周期事件（如agent_end、error、cancelled）的优先级高于普通流式增量。在IPC桥中引入快速旁路后，终端事件可以跳过标准有序队列直接派发到渲染进程。即使SQLite写入或归档队列积压，UI生命周期更新也不会延迟，从而避免队头阻塞。
10秒对账循环是做什么的？如何实现？
10秒对账循环用于处理窗口失焦或丢包导致的孤立状态。前端每10秒检查一次，找出超过10秒无活动但仍标记为流式传输的会话，并对其进行幂等清理和同步。实现方式是在useEffect中设置setInterval，每10_000毫秒调用reconcileStaleStreamingSessions()。
这篇文章的核心设计原则是什么？
核心原则是：交互乐观、持久化异步、定期对账保证最终一致。具体来说，用户交互应保持乐观和快速，重持久化操作在后台异步执行，并通过周期性对账来确保最终一致性。这样输入框在生成完成时即可就绪，窗口切换导致的焦点冻结也会消失。
