前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在 DSH 的 Web 界面中，右側邊欄默認的文檔預覽採用原生尺寸渲染，不自動適配窗口，僅提供滾動功能。這種靜態預覽對於圖標類資源尚可，但在查看大尺寸截圖、圖表或設計稿時，操作體驗較差。dsh-sidebar-image-zoom 插件通過替換右側邊欄的圖片渲染器，爲這些資源增加了縮放和平移能力。
插件概況¶
- 名稱：dsh-sidebar-image-zoom
- 維護者：Meowrium
- 類別：客戶端
- 許可證：MIT
安裝與啓用¶
插件通過官方命令安裝。安裝完成後需重啓 dsh web。
dsh plugin --profile web add github:Meowrium/dsh-sidebar-image-zoom
前置要求：DSH 版本需在 0.1.5 線（已驗證於 0.1.5-rc.1）。該插件擴展的右側邊欄文檔預覽功能在此之前不存在。
安裝後，在右側邊欄打開任意圖片文件（例如通過「新建標籤頁」→「工作區文件」選擇圖片），即可啓用該插件。
核心功能¶
插件提供以下交互與控制能力：
- 光標錨定縮放：滾動鼠標滾輪時，圖片以鼠標指針位置爲中心進行縮放，指針下的像素保持不動。
- 拖拽平移：當圖片放大超過窗口大小時，支持鼠標拖拽平移。
- 雙擊切換：雙擊圖片可在「適應窗口」和「1:1」原始尺寸之間切換。
- 多模式適配：支持適應窗口、適應寬度、1:1 原始尺寸三種顯示模式。
- 鍵盤快捷鍵：支持
+/-進行步進縮放；0鍵適應窗口；1鍵恢復 1:1。 - 縮放範圍：支持 10% 到 1200% 的縮放級別。
典型用法¶
在右側邊欄預覽大尺寸圖片時：
* 使用鼠標滾輪快速定位細節。
* 使用 + / - 鍵進行微調。
* 使用 0 鍵快速讓圖片適應當前窗口大小。
技術實現與注意事項¶
- 官方擴展點：僅使用官方擴展點註冊，不涉及
monkey-patching或私有 DOM 屬性修改。 - 卸載恢復：卸載插件後，DSH 會恢復內置的圖片渲染行爲，因爲內置定義依然註冊，只是優先級被插件覆蓋。
- 資源清理：關閉標籤頁時，插件會釋放所有監聽器、樣式、觀察器和對象 URL，無殘留。
- 加載方式：插件僅增加交互邏輯，不改變圖片的加載方式和來源。
