前言¶

在 DeepSeek Harness (DSH) 中，智能体通过 read_image 工具生成的图片无法直接出现在消息流中。这些图片通常被丢弃，只留下文本描述。为了解决这个问题，需要一种方式在聊天界面中预览这些图片。

插件简介¶

dsh-image-preview 是一个插件，用于在消息流中预览智能体已经生成的图片。它支持多种图片格式（原生和转码），并通过官方 UI 渲染。该插件由 tianxia– 维护。

核心功能¶

1. 内联预览：在消息流中显示智能体生成的图片。
2. 多格式支持：支持多种图片格式（原生格式和转码格式）。
3. 官方 UI 渲染：通过官方的 UI-attachment gallery 和 lightbox 进行渲染。
4. 路径处理：处理 read_image 附件和文本中的文件路径。

安装与启用¶

在 DSH 的 Web profile 中安装插件：

dsh plugin --profile web add github:tianxia--/Dsh-ImageProview

典型用法¶

1. 使用 read_image 生成智能体图片附件。
2. 在消息中输入文件路径以渲染 agent-image-path 节点。
3. 配置 maxBytes 和 allowRoots 以控制文件大小和访问根目录。

注意事项¶

1. 文本行保留，图片行添加在旁边。
2. 工具结果中未扫描路径。
3. Lightbox 是官方的，不支持缩放或平移。
4. 转码依赖于主机机器上的工具（如 sips、magick、ffmpeg）。

短结尾¶

dsh-image-preview 通过为智能体生成的图片提供内联预览，解决了图片在消息流中丢失的问题。安装后，通过配置和工具使用即可生效。

目录页
GitHub 仓库