前言¶
在 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 仓库。
