终端图像显示与恢复

检查 Kitty、Ghostty、chafa 回退，以及 PNG 限额和会话持久化差异。

This page has not been translated into English yet. The original Chinese version is shown below.

交互终端可以显示助手响应和工具结果中的图像部分。它独立于 Markdown 渲染，render 与 raw 模式行为相同。

哪些环境会显示图像

环境	结果
直连 Kitty 或 Ghostty TTY，无 tmux/SSH	原生图像放置
其他终端且有 chafa	256 色 ANSI 预览，包括 iTerm2、Warp、tmux、SSH
无兼容渲染器或屏幕阅读器模式	文本占位，如 `[image: 1024x768 png]`

助手文本和图像保持原始顺序。工具结果先文字后图像，成功、失败和取消结果均可包含显示图像。

无头、ACP、daemon/Web Shell 和 IDE 不使用这条终端 inline 图像渲染路径。微信、企业微信、钉钉渠道仍可通过 [IMAGE: ...] 标记发送生成文件，这是另一条路径；其他 IM 渠道当前不支持发出图像。

像素预览要求有效 PNG，总计不超过 64 megapixels，每边最多 1,000,000 像素。其他格式、无效数据或超限 PNG 显示文本占位。

超过 8 MiB 的 inline payload 不做像素渲染。大部分超限数据进历史前被丢弃；因为准入按编码大小判断，略超阈值的部分仍可能保留成占位。每个助手响应或工具行最多显示四张，多余用 [+2 more images] 等标记提示。

工具图像随结果保存，恢复会话后可重建。助手图像只实时显示，目前不持久化；--continue / --resume 会恢复助手文字但没有原助手图像。

长会话可能把旧图像替换为清理标记，限制实时视图内存。这不删除已保存的工具图像，恢复后仍可重现；不要把 live view 清理当成记录已经清除。