前言¶

在 DeepSeek Harness (DSH) 中，智能體通過 read_image 工具生成的圖片無法直接出現在消息流中。這些圖片通常被丟棄，只留下文本描述。爲了解決這個問題，需要一種方式在聊天界面中預覽這些圖片。

插件簡介¶

dsh-image-preview 是一個插件，用於在消息流中預覽智能體已經生成的圖片。它支持多種圖片格式（原生和轉碼），並通過官方 UI 渲染。該插件由 tianxia– 維護。

核心功能¶

1. 內聯預覽：在消息流中顯示智能體生成的圖片。
2. 多格式支持：支持多種圖片格式（原生格式和轉碼格式）。
3. 官方 UI 渲染：通過官方的 UI-attachment gallery 和 lightbox 進行渲染。
4. 路徑處理：處理 read_image 附件和文本中的文件路徑。

安裝與啓用¶

在 DSH 的 Web profile 中安裝插件：

dsh plugin --profile web add github:tianxia--/Dsh-ImageProview

典型用法¶

1. 使用 read_image 生成智能體圖片附件。
2. 在消息中輸入文件路徑以渲染 agent-image-path 節點。
3. 配置 maxBytes 和 allowRoots 以控制文件大小和訪問根目錄。

注意事項¶

1. 文本行保留，圖片行添加在旁邊。
2. 工具結果中未掃描路徑。
3. Lightbox 是官方的，不支持縮放或平移。
4. 轉碼依賴於主機機器上的工具（如 sips、magick、ffmpeg）。

短結尾¶

dsh-image-preview 通過爲智能體生成的圖片提供內聯預覽，解決了圖片在消息流中丟失的問題。安裝後，通過配置和工具使用即可生效。

目錄頁
GitHub 倉庫