前言¶
在 DeepSeek Harness（DSH）的右側欄查看圖片時，原本只是靜態的 <img> 標籤，滾動和拖拽都無法達到瀏覽器的原生體驗。想要縮放或平移，只能刷新頁面或打開新標籤。1378616343 提供的 dsh-zoom-viewer 爲右側欄的圖片註冊了專門的渲染器，讓圖片具備真實的導航能力：以光標爲錨點的滾輪縮放、拖拽平移、雙擊復位、工具欄控制以及全屏模式。
這是什麼¶
dsh-zoom-viewer 是一個爲 DSH 右側欄提供的可縮放圖片查看器插件。它通過宿主的文檔預覽註冊表（documentPreviews）註冊自己的渲染器，將原本的靜態 <img> 替換爲具備縮放與平移能力的視圖。插件無構建步驟、無運行時依賴，支持常見的圖片格式，且不涉及網絡或文件系統權限。
核心功能¶
- 以光標爲錨點的滾輪縮放：默認滾輪步長爲 5%–1600%，按住 Ctrl 或使用觸控板雙指可獲得更細的步進。
- 拖拽平移：按住圖片可拖動視圖，視口滾動條會保持同步。
- 雙擊復位：雙擊圖片可重置爲適應視圖。
- 全屏覆蓋：點擊全屏按鈕進入全屏模式，使用 Esc 或界面上的退出按鈕關閉。
- 工具欄控制：提供
−/ 百分比 /+/ 適應 / 寬 /1:1/ 全屏 操作。
支持的圖片格式包括 png jpg jpeg gif webp bmp ico svg。通過擴展名匹配後，如果內容類型不匹配，插件仍會通過魔術字節嗅探繼續匹配。
安裝與啓用¶
通過命令行安裝（推薦使用 --profile web 對應桌面應用）：
dsh plugin --profile web add dsh-zoom-viewer
如果系統路徑中未配置 dsh，可通過 npx 調用：
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-zoom-viewer
或直接從倉庫安裝：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:1378616343/dsh-zoom-viewer
在 DSH 界面中，也可以通過 插件 / Plugins 頁面，點擊箭頭菜單中的 安裝第三方插件 / Install third-party plugin，然後粘貼 dsh-zoom-viewer、倉庫 URL 或本地包含 package.json 的目錄。
安裝完成後需要重啓 DSH，插件樹僅在啓動時讀取。
典型用法¶
安裝並重啓 DSH 後，打開任意圖片（如 PNG、JPEG、SVG 等）即可看到右側欄變爲可縮放、可拖拽的視圖。默認情況下，該渲染器會註冊在內建圖片渲染器之上，因此這些格式會優先使用它。
使用滾輪縮放時，光標所在位置保持不變，縮放範圍在 5%–1600% 之間。按住鼠標左鍵拖拽可平移視圖。雙擊圖片可快速回到適應視圖。點擊工具欄上的按鈕可切換到適應、適應寬度、1:1 或全屏模式。
適用場景與注意¶
適合需要頻繁查看、標註或分享圖片的開發者與研究者，特別是在調試、文檔展示、模型可視化等場景中。
注意：插件以當前 DSH 進程的權限運行。安裝前建議查看倉庫源碼與許可證（MIT）。插件不發起網絡請求、不訪問文件系統、不包含安裝腳本，依賴項僅聲明 react 爲可選的 peer 依賴。
結語¶
dsh-zoom-viewer 爲 DSH 右側欄的圖片查看提供了更接近原生瀏覽器的交互體驗，無需額外配置即可啓用。更多細節與源碼可參考：
- 目錄頁：https://www.skillhub.cn/plugins/1378616343/dsh-zoom-viewer
- GitHub：https://github.com/1378616343/dsh-zoom-viewer
