在 DeepSeek Harness (DSH) 中開發智能體時，圖片展示通常需要依賴外部圖牀或直接傳輸文件路徑，導致對話流中的體驗割裂。dsh-image-preview 插件利用 web profile 自帶的 HTTP 服務（默認 127.0.0.1:3080），在本地託管預覽目錄，使圖片能夠直接在聊天消息中內嵌渲染。
本插件由 ReiRui 維護，採用 MIT 許可證。它通過註冊模型工具和靜態路由，允許 AI 將本地圖片複製到預覽目錄，並返回可在聊天中渲染的 URL。
核心功能¶
- 靜態託管：在 web profile 自帶的 HTTP 服務上註冊
/preview/*路由，靜態託管預覽目錄裏的圖片。同源 URL（如http://127.0.0.1:3080/preview/<name>）在聊天裏可直接渲染，無混合內容/CORS 問題。 - 模型工具：註冊模型工具
preview_image(file_path)，將本地圖片複製進預覽目錄（已在目錄內則直接引用），返回可內嵌的 URL。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add "github:ReiRui/dsh-image-preview#main"
- 安裝後需要重啓 web profile 才能生效。
默認預覽目錄爲 ~/.dsh/preview，可在 $DSH_HOME/profiles/web/cordis.patch.yml 中覆蓋 root 配置項。
典型用法¶
- 讓 AI 生成或下載圖片到本地。
- AI 調用
preview_image工具，傳入圖片的絕對路徑。 - 工具返回
http://127.0.0.1:3080/preview/<name>。 - AI 在回覆中直接內嵌該鏈接（如
），即可顯示圖片。
也可以直接訪問 http://127.0.0.1:3080/preview/<name> 查看圖片。
注意事項與限制¶
- 必須調用工具：AI 必須調用
preview_image工具，禁止手動將文件複製進預覽目錄。新會話的文件沙箱默認爲workspace-write，AI 的文件工具寫不進預覽目錄（會報”目錄出錯”），工具內部不受該沙箱限制。 - URL 限制：URL 固定使用
127.0.0.1，局域網訪問需自行替換爲本機 IP（並確保 web 服務綁定 0.0.0.0）。 - 文件清理：預覽目錄內的文件不設清理策略，長期使用建議定期手動清理。
- 格式支持：僅支持 png、jpg、jpeg、webp、gif、avif、bmp 格式。
插件源碼位於 ReiRui/dsh-image-preview。
