dsh-image-preview：爲 DeepSeek Harness 提供 `read_image` 工具的內聯預覽

DeepSeek Harness (DSH) 框架下，read_image 工具的默認輸出通常僅包含路徑信息。對於開發者而言，直接在界面中查看圖片內容或複製圖片是高頻需求。dsh-image-preview 插件通過接管 DSH 的工具渲染插槽，爲 read_image 提供了內聯預覽能力，並內置了複製功能。

核心功能¶

該插件基於 DSH 的 tool.call.toolview 插槽實現，覆蓋了直接調用和嵌套調用兩種場景：

1. 內聯預覽與嵌套支持：支持直接調用 read_image，也支持在 run_code Code Mode 中通過 tools.read_image(...) 進行嵌套調用。
2. 圖片複製與格式轉換：提供複製按鈕，PNG 格式直接複製原字節，其他格式（JPEG, WebP, GIF）在瀏覽器端轉換爲 PNG 後複製，並反饋成功或失敗。
3. 安全與資源管理：僅通過 ctx.sessions.binding(sessionId).session.readAttachment(attachmentId) 讀取認證附件，模型提供的路徑僅用於展示。Blob URL 在替換、重試、卸載或 HMR 時自動回收。

安裝與啓用¶

安裝前需確保環境滿足依賴：DeepSeek Harness 0.1.2-alpha.2 或兼容版本。

pnpm pack --pack-destination "$HOME/.dsh/packages"
dsh plugin --profile web add "$HOME/.dsh/packages/dsh-image-preview-0.3.4.tgz"
dsh --profile web --dump-config

執行上述命令後，刷新 Web Profile 頁面即可生效。插件會將自定義渲染器注入到 DSH 的工具列表中。

典型用法¶

1. 直接調用：在工具調用中直接使用 read_image，圖片將以內聯形式展示。
2. Code Mode 調用：在 run_code 代碼塊內部使用 tools.read_image(...)，插件會自動識別並渲染嵌套的圖片。
3. 手動加載預覽：在 DSH 設置（Plugins）中關閉“Open previews automatically”選項後，圖片默認摺疊。點擊工具行中的“Show preview”即可加載圖片內容。
4. 複製圖片：點擊圖片區域即可複製到剪貼板，PNG 格式保留原樣，其他格式自動轉換。

適用場景與注意¶

該插件適用於需要在 DSH 工具調用中直觀展示或處理圖片的開發者。插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。

更多細節與源碼，可訪問 GitHub 倉庫。