[xiaoyumuxi]

问题

恢复一个被压缩过的 Claude 会话时，压缩分界线之前的用户消息只显示文字，粘贴的截图不显示。气泡里只剩 [Image #4] … 这样的占位文字，上方是空白。

原因

压缩前的历史不是 Claude 适配器回放的，而是 Rust 宿主在 session/load 时自己读会话 jsonl 补全（claude_earlier_history.rs）。它的 block() 只处理 text、thinking、tool_use、tool_result，用户消息里的 image 块被直接丢弃。会话文件里的图片数据本身是完整的。

Swift 侧不需要改：#1472 已经能解析 ACP 的 image 内容块，并按 messageId 并入同一个用户气泡。

改动

• rust/lithe-agent-host/src/claude_earlier_history.rs：用户消息里 source.type == "base64" 的 image 块，转成 user_message_chunk 的 ACP image 内容块（data + mimeType），带上所在行的 messageId，使截图留在引用它的那条消息里。url 来源和空数据的图片块仍然跳过。图片大小由客户端 AgentImage.maximumBytes 限制。
• 新增测试 pasted_screenshots_stay_on_the_user_message_that_references_them：覆盖文本加 base64 图片同一条消息、url 来源跳过、空数据跳过、messageId 一致。
• shared/platform-feature-matrix/features/agent-tool-activity-timeline.json：补充证据文件、验证步骤和备注；Windows 侧仍待对齐。

验证

• cargo test -p lithe-agent-host --lib claude_earlier_history：6 个测试通过。
• verify-rust-core-comments.sh、verify-platform-feature-matrix.sh、verify-platform-feature-matrix-change.sh 通过。
• 还没有在真实应用里亲眼确认：需要用最新构建恢复一个压缩过、且压缩前有粘贴截图的 Claude 会话，确认缩略图出现且可点击放大。

[lithe-code-review]

Lithe Review

结论： ⚠️ 有建议
范围： preview ← fix/earlier-history-user-images · head: e775318

未发现需要阻塞合并的问题。图片转换字段与现有 macOS 消费路径一致；发现一项文档同步问题，另需补充视觉验证材料。

Findings

1. [P3] 同步更新压缩历史的图片回放边界说明
   rust/lithe-agent-host/src/claude_earlier_history.rs:185

   • 实际影响：当前有效的 Agent Note 仍将“图片不回放”列为宿主读取转录文件的限制，与新增行为相反，会让后续维护和测试范围判断继续依赖过时约束。
   • 触发条件：恢复最后一个压缩边界之前含非空 base64 用户图片的 Claude 会话。
   • 复现步骤：沿新增测试的输入检查 earlier_updates，图片现会生成 user_message_chunk；对照 .agents/notes/implemented/feature/2026-10-24-agent-transcript-images-and-task-notifications.md:65，该处仍明确写着“图片不回放”。
   • 来源：本次引入。新增图片分支使原先准确的限制说明失效；功能矩阵中的补充未同步修改持有该决策的原 Note。

Scope Check

• 关联 Issue 或需求是否完成：未找到可验证的关联 Issue。按 PR 描述，代码已补上压缩前用户消息中 base64 图片的转换，真实应用中的显示效果尚待确认。
• 已完成范围：保留图片数据、MIME 类型及所在行的 messageId；跳过 URL 来源和空数据；新增转换回归测试并更新功能矩阵，验证状态保持 pending。
• 未完成范围：真实 macOS 会话恢复、缩略图和点击放大的验收；Windows 图片呈现仍待对齐，属于已声明的平台缺口。
• 上游复用：沿用既有压缩历史补全机制、ACP image 块及 macOS AgentImage 解析和消息合并逻辑，没有新增历史存储或另一套图片呈现实现。
• Finding 来源及职责范围：上述文档差异由新增行为直接引入，属于本次回放边界变更的同步维护范围。

Suggestions

1. 对应 Finding 1，更新原 Note 的限制说明：仅回放用户消息中的非空 base64 图片，URL 来源继续跳过，并区分宿主现有转录文件上限与 macOS 客户端的图片大小、数量限制。
2. 补充同一会话恢复前后的界面截图，展示截图仍属于原用户气泡，并附放大查看状态。提供的 PR 描述和评论均未包含截图，视觉效果尚未验证。

Summary

本次实现范围集中，新增块的 data、mimeType 和 messageId 与现有客户端契约匹配。宿主的 Desktop 呈现层会保留该更新，macOS 加载历史时会按消息 ID 将图片并入原用户消息。新增测试覆盖转换与过滤规则，使用既有临时目录清理机制，没有新增等待或后台任务。未发现明确的正确性、契约或资源清理回归；主要遗留项是决策说明同步和实际界面验收。

Verification

• 实际检查：指定 d046fd1768d00a52b1fc99d45067d06cf535bc23...e77531859f4956eeeedc99bfb15d7ad1f4132948 的两个变更文件及 base 实现；追踪 LoadSession → earlier_updates → claude_desktop::Presenter → AgentEvent::Update → AgentConnectionModel → AgentImage，并检查消息合并、图片限制、相关测试和 Windows 消费分支。确定性文件清单完整。
• 已提供结果：PR 作者报告 6 个聚焦测试及 Rust 注释、功能矩阵检查通过；本次未独立复验。提供的 Check Run 中矩阵发布及平台 gate 有成功记录，但 Rust Core、Swift 和 Windows 测试均为 skipped，不能据此认定测试已执行。
• 本次未运行：任何仓库代码、测试、验证脚本或应用；遵守远程只读要求，未访问网络、修改文件或发布评论。
• 非阻塞验证缺口：缺少真实压缩会话恢复证据及前后截图；缩略图归属、点击放大和视觉效果仍需作者验证，Windows 图片呈现继续保持待对齐。

[xiaoyumuxi]