前言¶
DeepSeek Harness (DSH) 生态强调通过插件扩展功能。在使用纯文本模型（如 deepseek-v4-flash）时，粘贴图片会被 dsh-tool-vision 转换为文本提示，导致对话中只能看到文字而看不到图片。dsh-bridge-preview 旨在解决这一展示层痛点。
这是什么¶
dsh-bridge-preview 是一个客户端插件，由 xing666173 维护，采用 MIT 许可证。它为 DeepSeek Harness 的 dsh-tool-vision 插件提供“图片桥接”的对话内联预览功能。
该插件不修改持久化消息、不触碰插槽系统、也不影响模型的请求内容。它仅在用户界面层工作，将原本纯文本的提示渲染为可视化的图片。
核心功能¶
-
气泡内联显示
用户气泡中会直接显示图片缩略图，点击缩略图可查看大图。 -
自动扫描机制
插件通过 MutationObserver 监听 DOM 变化，实现新消息的即时预览；同时包含 2 秒的兜底扫描逻辑，用于补全旧消息的预览。 -
纯加法架构
在逻辑层是“纯加法”：仅增加展示，不修改底层数据存储、不改变对话槽位、不干扰模型推理。 -
静默降级
如果图片加载失败，插件会自动移除对应的图片标签，不会破坏对话结构或显示错误提示。
安装与启用¶
在终端执行以下命令安装：
dsh plugin --profile web-desktop add github:xing666173/dsh-bridge-preview
前置条件：
安装前请确保已安装并启用 dsh-tool-vision，且其配置中开启了图片桥功能（默认配置为 bridgeTextOnly: true）。
安装后，重启 dsh（或执行页面硬刷新），插件即会生效。
典型用法¶
当用户通过 dsh-tool-vision 粘贴图片时，系统会生成类似以下的文本提示：
[User sent an image (image.png), exported to: C:\...\dsh-vision-bridge\image_sha256:xxx.png. Inspect it with the inspect_image tool to see its content.]
插件会在文本块上方自动注入 <img> 标签，将 exported to: 后的路径指向的图片渲染出来。
适用场景与注意事项¶
适用场景：
- 使用纯文本模型进行多模态交互。
- 需要在对话流中快速查看图片内容，而不想频繁切换到日志查看。
注意事项：
1. Windows 文件名处理：在 Windows 上，dsh-tool-vision 导出的文件名包含冒号（如 image_sha256:xxx.png）。这实际上是 NTFS 备用数据流（ADS），Node.js 可以直接读取，无需特殊处理。
2. 维护提示格式：若上游 dsh-tool-vision 更改了提示文本格式，需同步更新 client.js 中的正则表达式 HINT_RE 以保持兼容。
3. 服务端路由限制：服务端注册了同源回环路由 /plugins/dsh-bridge-preview/image，该路由限制了请求的 Host（仅限本机）、图片扩展名以及文件大小上限（20MB），并进行了防目录穿越处理。
结语¶
dsh-bridge-preview 是一个专注于 UI 层的轻量级插件，它在不改变任何底层逻辑的前提下，显著提升了使用纯文本模型时的视觉体验。
