前言¶
在 DeepSeek Harness（DSH）裏，模型回覆、工具截圖和工作區產物經常以 Markdown 圖片或內嵌圖的形式出現。內置預覽比裸 <img> 好用，但通常做不到在指針處縮放、雙軸平移，保存時也往往拿不到可讀的文件名。若你經常在對話裏覈對架構圖、逐屏看 agent 截圖，或要把某張圖落盤後再用本地工具打開，就需要一個接管「內容圖點擊」的客戶端插件。
下面介紹社區維護的 dsh-image-zoom（GitHub：bingomu/dsh-image-zoom）。它攔截聊天中的內容圖點擊，用獨立對話框提供縮放、平移、圖集瀏覽和帶規則命名的下載，對工作區原圖還可交給系統默認應用打開。
這是什麼¶
dsh-image-zoom 是面向 DSH Web 客戶端 / DSH Desktop 的純客戶端插件：通過 dsh.bundle.patch 與 dsh.client Web 入口注入，不向會話或磁盤寫入插件側數據。維護者爲 bingomu（Genzo），許可證 MIT，當前發佈版本 1.0.1。插件在 DSH 插件市場（registry 條目 awesome-dsh-plugin）有 listing，分類爲客戶端。
一句話定位：聊天裏的內容圖查看器——滾輪/觸控板縮放、雙指與拖拽平移、多圖畫廊、自動命名下載、工作區圖片用系統默認應用打開。
核心功能¶
查看與手勢¶
插件在指針位置縮放，並支持多種平移方式，與 README 中的對照表一致：
| 需求 | 行爲 |
|---|---|
| 鼠標滾輪一格 | 在指針處縮放；Windows 100 / Chrome 120 等「一格」立即生效；平滑滾輪或極小 delta 會在約 75 ms 內作爲獨立事件確認後同樣縮放 |
| 觸控板捏合 | Ctrl+滾輪（ pinch ）連續縮放 |
| 左右、上下平移 | 雙指滾動流可同時平移兩軸；拖拽平移；Shift+滾輪橫向平移 |
| 看清小字 | 適應窗口 / 1:1 / 雙擊切換；+/- 按 25% 步進；可輸入 5%–4000% 比例；R / Shift+R 順時針 / 逆時針旋轉 90° |
| 多張截圖切換 | ←/→ 或側欄箭頭；頁腳顯示如 3 / 7 |
頁腳提供三種滾輪模式 Auto / Zoom / Pan，保存在 localStorage。Auto 即上述啓發式；若鼠標平滑滾動驅動干擾自動判斷，可改 Zoom；若希望滾輪始終移動畫面，選 Pan。
下載命名¶
每次下載文件名格式爲：
<description>-<YYYYMMDD-HHmmss>.<ext>
- description：優先圖片
alt，否則有意義的源文件名，否則本地化文案「image」。 - 本地時間戳保證唯一且便於排序；擴展名按檢測到的格式，避免 blob 截圖變成
.bin。 - 替換 Windows 非法字符；保留設備名加尾
_；描述最長 48 字符。下載按鈕 tooltip 會預覽完整名稱；macOS 保存對話框會預填該名。
標題欄操作¶
| 按鈕 | 作用 |
|---|---|
| Download | 按上述規則保存原圖 |
| Copy image | 以 PNG/JPEG 複製到剪貼板 |
| Copy link | 僅對站外 http(s) 圖複製絕對 URL |
| Open original | 工作區 /api/file?path=… 圖經 Host 的 openWorkspacePath 用系統默認應用打開；外鏈新窗口；blob:/data: 會說明無本地路徑 |
| Close | 同 Esc（先退出縮放比例輸入） |
適用圖片包括 Markdown 圖片、工具截圖、工作區 artifact 等「內容圖」點擊場景。
安裝與啓用¶
要求（摘自 engines 與 README）：
| 項 | 值 |
|---|---|
| DSH | >=0.2.1-rc.2 <0.3.0-0；開發與測試基於 DSH Desktop 0.2.1-rc.5 |
| 運行環境 | Web 客戶端 / DSH Desktop |
| 平臺 | macOS Desktop 已測；Windows 共用 Web 客戶端（滾輪一格路徑有合成 delta 測試覆蓋） |
從 GitHub Release 安裝（當前文檔給出的命令）：
dsh plugin --profile <your-profile> add https://github.com/bingomu/dsh-image-zoom/releases/latest/download/dsh-image-zoom-1.0.1.tgz
插件市場 listing 使用同一 tarball URL。本地開發 checkout 時可用：
dsh plugin --profile <your-profile> add /path/to/dsh-image-zoom
安裝後重啓 DSH；若只改了 client.js，重載頁面即可。插件無構建步驟，主入口爲單文件 client.js。
典型用法¶
- 在已安裝插件的 DSH 配置文件中完成上述
dsh plugin add（將<your-profile>換成你的 profile 名）。 - 重啓或重載客戶端後，在任意對話中點擊一張內容圖（非僅懸停預覽）。
- 在打開的查看器中：滾輪或捏合放大局部；雙指滾動或拖拽平移；多張圖時用方向鍵或側欄切換。
- 需要留存時點 Download，確認 tooltip 中的
<description>-<時間>.<ext>再保存；工作區原圖可用 Open original 交給 Photoshop、預覽等默認應用。
快捷鍵摘要（與 README 一致）：Esc 關閉；0/1 適應 / 實際尺寸；Shift+方向鍵平移 72 px；圖集 ←/→。
適用場景與注意¶
適合誰： 經常在 DSH 裏閱讀模型生成的 diagram、對比多屏 tool 截圖、從聊天保存 artifact 圖並希望在 Finder/資源管理器裏一眼認出文件名的工作流。
生態說明： DSH 強調「一切皆插件」；SkillHub 目錄頁 與 GitHub 倉庫均爲社區信息源，與 DeepSeek / 幻方無官方從屬關係，不宜表述爲官方應用商店。
安全與權限： 插件隨當前 DSH 客戶端在瀏覽器/Electron 環境中運行，會處理你點擊的圖片 URL、blob 與剪貼板。安裝前建議閱讀 倉庫源碼 與 MIT 許可證；問題與功能請求可走 GitHub Issues。
結尾¶
內置預覽解決「能看見」；dsh-image-zoom 解決「能當查看器用、能按規則保存、工作區圖能進默認應用」。若你的 profile 已跑在 DSH 0.2.1-rc.2 及以上且低於 0.3.0，可按 Release tarball 安裝後直接在聊天裏點圖驗證。
- 目錄頁：https://www.skillhub.cn/plugins/bingomu/dsh-image-zoom
- 倉庫：https://github.com/bingomu/dsh-image-zoom
