在 DeepSeek Harness (DSH) 的开发场景中,大模型生成结果常包含本地图片路径。若不加处理,这些路径仅作为文本显示,无法直接预览。dsh-inline-images 插件通过解析消息流,将本地图片和视频文件渲染至对话正文,解决这一痛点。
插件简介¶
这是一个客户端插件,由 Asher-2000 维护。它扫描助手回复文本中的本地图片路径,将其转换为可访问的 URL,从而在消息正文内直接渲染图片或视频链接。该插件基于 3403473060/dsh-inline-images 修复增强版,修复了原版在 DSH 0.1.x 上的多个兼容性问题。
核心功能¶
- 消息正文内联渲染:识别盘符路径、UNC 路径、POSIX 路径以及
语法,将真实存在的文件改写为可渲染的 URL。 - 图片+视频支持:图片格式支持 png、jpg、jpeg、webp、gif、svg、avif、bmp、ico;视频格式支持 mp4、webm、mov。
- URL 自动修正:消息中已存在的内联图片/视频 URL(带过期 token)会在流式输出时自动替换为当前进程有效 token,刷新页面后仍可访问。
- 流式+持久化双通道改写:同时改写
text-delta(保证保存的消息也是修正版)与block-end(保证流式实时显示)。 - 点击放大灯箱:点击正文中的图片可进入全屏查看大图,点击背景或按 Esc 键关闭。
- 可调尺寸:默认尺寸为 480×320,可通过设置或修改默认值调整(范围 64–2400 px)。
- 安静降级:对于不存在的路径、示例路径或占位路径,静默跳过,不影响对话体验。
安装与启用¶
安装该插件需要先下载源码,然后执行安装命令。
dsh plugin --profile web add ./dsh-inline-images
典型用法¶
插件支持 Markdown 语法,在消息中输入  即可触发渲染。支持在消息正文内直接显示截图、生成图等本地图片,视频文件则以可点击播放链接形式呈现。
若通过反向代理或自定义域名访问 DSH Web,需修改 src/index.ts 中的 https://<你的地址> 前缀为实际地址,并重新构建插件。
注意事项¶
- 依赖注入修复:使用该插件需补全
webServer、fs、attachments依赖注入,否则可能导致路由不注册或报错。 - 权限与来源:插件以当前 DSH 进程权限运行文件读取操作,请安装前检查源码与许可证(MIT)。
- 协议兼容:改版原版硬编码了本地地址,当前版本使用完整公网地址,兼容 Nginx 等反向代理部署,并修复了 MarkdownText 拒绝无协议 URL 的问题。
总结¶
该插件通过双通道改写机制确保了流式显示与刷新后持久化的一致性,并提供了点击放大、视频播放等交互功能。