前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者擴展其功能。在處理圖片相關的任務時，查看、下載和標註圖片是常見需求。wsl043/dsh-image-viewer 是一個爲此場景設計的輕量級插件，它提供了比原生查看器更豐富的交互方式，支持縮放、區域標註以及下載管理。
核心功能¶
該插件提供以下能力：
- 瀏覽與縮放
支持以鼠標位置爲中心進行縮放、拖動，以及雙指縮放。雙擊圖片可查看原始大小，支持適應窗口、鍵盤切換以及多圖瀏覽。 - 圖片信息展示
顯示圖片名稱、尺寸和當前的縮放比例。在查看 100% 大小時，調整窗口大小不會導致圖片消失。 - 下載管理
支持原圖下載，並顯示進度。下載過程中可以取消或重試。切換圖片或關閉查看器會自動取消正在進行的下載。 - 狀態反饋與隔離
提供清晰的加載和錯誤狀態，失敗時可重試。切換圖片會重置拖動狀態，並隔離不同圖片的標註，避免數據混淆。 - 區域標註
點擊標記區域，在編號旁編輯備註。按下Enter鍵保存，按下Shift+Enter鍵換行。 - 會話集成
關閉原生 DSH 圖片查看器時，插件會將標記的圖片和備註加入當前會話的草稿中。這會保留已有的文字，但不會自動發送，從而避免重複添加。操作失敗時支持重試。 - 主題適配
適配 DSH 的亮色和暗色主題，支持響應式佈局、焦點約束以及減少動態效果設置。
安裝與啓用¶
通過插件頁面或終端命令安裝。
插件頁面安裝¶
- 打開 DSH 的 插件 → 添加插件。
- 在“包名或地址”中粘貼
dsh-image-viewer@0.1.6並點擊安裝。 - 查看安裝結果，按提示刷新或重啓。
終端安裝¶
dsh plugin --profile web add dsh-image-viewer@0.1.6
注意事項¶
- 權限與隱私
插件只讀取 DSH 已渲染的圖片 URL，不調用模型，也不讀取供應商憑據。 - 標註數據持久性
標註通過 DSH 附件和草稿接口管理。在頁內重開查看器時可以看到備註，但這不代表備註已發送或永久保存。 - 卸載影響
卸載插件會恢復 DSH 內置的圖片查看器，不會刪除會話中的圖片或已有的文字內容。
總結¶
dsh-image-viewer 專注於圖片查看、下載和標註的交互細節。它通過集成 DSH 的草稿接口，讓標註內容更容易轉移到會話中，適合需要在開發或調試過程中快速標記圖片的開發者。
