前言¶

在 DSH 的 Web GUI 对话流中，模型调用 read_image 后，用户通常希望直接看到图片，而不是只看到工具结果里的引用或文本。dsh-read-image-view 就是补上这一展示层的客户端插件：它让 Web GUI 在对话里直接显示 read_image 读到的图片，并覆盖透明图、多图和页面内放大等查看场景。

它由 Yu-tao-Li 维护，许可证为 MIT。

这是什么¶

dsh-read-image-view 是一个面向 DSH Web GUI 的客户端插件，定位是让 read_image 的结果在对话中直接可见。

• 纯客户端插件（browser-only）。
• 零运行时依赖。
• 不改 DSH 本体。
• 仅影响 Web GUI，TUI 和其他表面不受影响。

核心功能¶

下面列出的能力都围绕“把 read_image 读到的图显示出来”：

• 在 DSH Web GUI 对话流中直接显示 read_image 读到的图片。
• 提供专用 Read image 行。
• 结果默认展开，使用消息同款图片卡样式。
• 透明图片显示 PS 风格灰白棋盘格。
• 同一次请求读到的多张图合并成一行并排展示。
• 页面内放大层，支持缩放按钮、鼠标滚轮、1:1 原始尺寸。
• 图片字节通过 session/attachment 端点获取。
• 插件本身不做任何文件 I/O，不新增网络端点。

安装与启用¶

安装命令如下，--profile web 用于 Web GUI profile：

dsh plugin --profile web add github:Yu-tao-Li/dsh-read-image-view

profile 插件集在启动时装配，安装后需要重启：

dsh web

已核实资料给出的运行环境要求是：

Node >=22

典型用法¶

安装并重启后：

1、模型每次调用 read_image，对话里即可直接看到图。
2、一次请求读多张图时，自动并排成一行。
3、透明图片显示 PS 风格灰白棋盘格。
4、页面内放大层支持缩放按钮、鼠标滚轮、1:1 原始尺寸。

适用场景与注意¶

适合主要在 DSH Web GUI 里工作、需要把 read_image 结果直接看成图片的场景。它不会改变 TUI 或其他表面的行为。

作为 DSH 插件，插件以当前 dsh 进程权限运行，安装前应检查源码与许可证：

https://github.com/Yu-tao-Li/dsh-read-image-view

使用 LICENSE 查看许可条款，并建议阅读源码后再安装。

另外注意这些边界：

• 仅 Web GUI 生效，TUI / 其他表面不受影响。
• 图片字节只经 session/attachment 端点获取。
• session/attachment 按会话授权，只放行该会话持久日志中引用过的附件；跨会话引用被拒。
• 插件本身不做任何文件 I/O，不新增网络端点。
• 依赖 shell 内置的 react / react-dom / dsh-client-ui-primitives 模块、image.* 语言键与 useSession 快照钩子。
• 若上游调整了槽位契约、模块装载表或会话快照结构，需要同步适配。

结尾¶

dsh-read-image-view 的价值很集中：让 DSH Web GUI 里的 read_image 结果不再只停留在工具文本中，而是直接作为图片被查看。仓库地址：

https://github.com/Yu-tao-Li/dsh-read-image-view