前言¶
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 層的輕量級插件，它在不改變任何底層邏輯的前提下，顯著提升了使用純文本模型時的視覺體驗。
