sijidoubi/dsh-image-zoom: Markdown 圖片點擊放大查看器

前言¶

DeepSeek Harness (DSH) 的 Web 客戶端默認將 Markdown 圖片渲染爲固定寬度的縮略圖。當模型返回包含大圖、架構圖或流程圖的回覆時，用戶難以看清細節。sijidoubi/dsh-image-zoom 插件通過在頁面上直接提供放大查看功能，解決了這一痛點。

插件定位¶

這是一個 DeepSeek Harness (dsh) 客戶端插件，由用戶 sijidoubi 維護。它不依賴 React 或額外服務，純 DOM 實現，專注於爲聊天或文檔中的 Markdown 圖片提供點擊放大的交互體驗。

核心功能¶

插件在點擊任意一張 Markdown 圖片後，會彈出一個全屏查看器，支持以下操作：

• 縮放：支持鼠標滾輪、＋ − 按鈕進行連續縮放，範圍從 100% 到 1200%。
• 平移：放大後支持拖拽平移圖片。
• 控制欄：提供 適應 按鈕（一鍵回到窗口適配）、⧉ 按鈕（在新標籤頁打開原圖）以及關閉按鈕（Esc 鍵、點擊背景或 ×）。
• 智能過濾：自動跳過附件縮略圖（包裹在 <button> 中）以及任何 [role="dialog"] 內的圖片，避免與系統內置預覽衝突。

安裝與啓用¶

通過命令行安裝插件：

dsh plugin --profile web add github:sijidoubi/dsh-image-zoom

安裝後啓動 Web 客戶端即可生效。

典型用法¶

• 基礎查看：點擊任意一張聊天中的 Markdown 圖片，即可進入全屏查看模式。
• 配合 Mermaid：與 dsh-tool-mermaid 搭配使用時，模型渲染的架構圖或流程圖點擊後也會彈出查看器，而非跳轉新標籤頁。

注意事項¶

• 構建腳本問題：如果使用 pnpm ≥ 10，首次安裝時可能會因 prepare 構建腳本被拒絕。解決方法是將提示的包 key 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 字段後重試。
• 資源回收：插件採用純 DOM 實現，所有監聽器、DOM 元素和樣式在插件卸載時會被自動回收。

總結¶

該插件通過簡單的點擊交互，提升了在 DSH Web 客戶端中查看圖片細節的效率。項目採用 MIT 許可證，源碼託管在 GitHub。