在 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 的問題。
總結¶
該插件通過雙通道改寫機制確保了流式顯示與刷新後持久化的一致性,並提供了點擊放大、視頻播放等交互功能。