前言¶
在 DeepSeek Harness（DSH）裏查看倉庫或會話附件時，圖片常在右側文件預覽面板打開。內置預覽支持縮放按鈕和 Ctrl+滾輪；若你更習慣在圖片上直接滾輪縮放、按住左鍵拖動平移，需要額外註冊一個客戶端渲染器。下面介紹社區插件 dsh-image-wheel-pan 的定位、能力與安裝方式。
這是什麼¶
dsh-image-wheel-pan 是 DSH 的 Web 客戶端插件（profile bundle）：純 ESM，無構建步驟、無運行時依賴，由 jinmuxi1 維護，以 npm 包 dsh-image-wheel-pan 發佈，源碼在 GitHub。它在 extension 頻段註冊圖片渲染器，使右側欄打開的 PNG、JPEG、GIF、WebP、BMP、ICO、SVG 使用滾輪縮放與拖動平移交互；SVG 仍走瀏覽器靜態 <img> 模式，不執行腳本。
社區目錄頁：skillhub.cn/plugins/jinmuxi1/dsh-image-wheel-pan（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
與內置預覽對比，同一文件在新渲染器下的手勢如下（資料原文）：
| 手勢 | 效果 |
|---|---|
| 在圖片上滾動鼠標滾輪 | 以指針爲中心縮放，範圍約 1%–800%，無需按 Ctrl |
| 按住左鍵拖動 | 平移圖片，光標變爲抓取手形 |
| 雙擊 | 將圖片適應預覽窗格 |
| 底部工具欄 | − / 百分比 / + / Fit / 100% |
100% 表示按圖片固有 CSS 像素尺寸顯示；Fit 或雙擊可整圖適應窗格。
插件只讀取預覽已加載的圖片字節，不額外發起文件或網絡請求。縮放與平移狀態隨當前預覽實例存在，關閉或重載標籤後會重置爲適應窗口。預覽區域會接管滾輪事件，鼠標在圖片上時不會帶動右側欄滾動。
安裝與啓用¶
安裝前建議瀏覽倉庫源碼與 MIT 許可證。客戶端插件在 DSH Web 進程權限下運行，安裝即信任其注入邏輯（本包通過 cordis.patch.yml 註冊，並在 client.js 中註冊渲染器）。
從 npm（推薦）¶
- 在 DSH 側欄打開 Plugins，選擇 Add plugin，輸入包名並安裝：
dsh-image-wheel-pan
也可讓 Harness 智能體執行：
plugin_manager action: install_bundle
target: dsh-image-wheel-pan
- 若 Web UI 已在運行，安裝後刷新頁面一次（
Ctrl/⌘+R）。
從 GitHub¶
- 在 Plugins → Add plugin 中粘貼倉庫地址：
https://github.com/jinmuxi1/dsh-image-wheel-pan
若字段要求 Git 規格，可使用：
git+https://github.com/jinmuxi1/dsh-image-wheel-pan.git
- 同樣在安裝後刷新已打開的 Web UI。
典型用法¶
- 在右側欄打開任意支持的圖片文件。新開圖片標籤會自動選用本渲染器。
- 若標籤此前用的是內置圖片查看器，在預覽頂部的下拉框中切換到 Image Wheel Zoom & Pan（中文界面爲 圖片滾輪縮放與拖動）。
- 在圖片上直接滾輪縮放；按住左鍵拖動平移；雙擊或點 Fit 適應窗格；點 100% 查看原始像素比例。
適用場景與注意¶
適合經常在 DSH 右側預覽大圖、截圖、UI 稿或 SVG 圖標，且希望交互接近桌面看圖軟件的開發者。不支持通過本插件改 DSH 全局快捷鍵或左側聊天區行爲；僅作用於文檔預覽中的圖片渲染路徑。
倉庫結構（便於自行審計）：index.js 爲主機側空 apply()；client.js 註冊渲染器並繪製縮放/平移表面；cordis.patch.yml 插入插件行；locale/{zh,en}.json 爲插件卡片文案。
結尾¶
dsh-image-wheel-pan 用很小的客戶端 bundle 補全右側圖片預覽的滾輪縮放與左鍵平移，與內置 Ctrl+滾輪方案並存，可按標籤切換渲染器。進一步瞭解可訪問 社區目錄頁 與 GitHub 倉庫。
