跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

终端图像显示与恢复

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

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

哪些环境会显示图像

环境结果
直连 Kitty 或 Ghostty TTY,无 tmux/SSH原生图像放置
其他终端且有 chafa256 色 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 清理当成记录已经清除。