前言¶
在 DeepSeek Harness（DSH）的右侧栏查看图片时，原本只是静态的 <img> 标签，滚动和拖拽都无法达到浏览器的原生体验。想要缩放或平移，只能刷新页面或打开新标签。1378616343 提供的 dsh-zoom-viewer 为右侧栏的图片注册了专门的渲染器，让图片具备真实的导航能力：以光标为锚点的滚轮缩放、拖拽平移、双击复位、工具栏控制以及全屏模式。
这是什么¶
dsh-zoom-viewer 是一个为 DSH 右侧栏提供的可缩放图片查看器插件。它通过宿主的文档预览注册表（documentPreviews）注册自己的渲染器，将原本的静态 <img> 替换为具备缩放与平移能力的视图。插件无构建步骤、无运行时依赖，支持常见的图片格式，且不涉及网络或文件系统权限。
核心功能¶
- 以光标为锚点的滚轮缩放：默认滚轮步长为 5%–1600%，按住 Ctrl 或使用触控板双指可获得更细的步进。
- 拖拽平移：按住图片可拖动视图，视口滚动条会保持同步。
- 双击复位：双击图片可重置为适应视图。
- 全屏覆盖：点击全屏按钮进入全屏模式，使用 Esc 或界面上的退出按钮关闭。
- 工具栏控制：提供
−/ 百分比 /+/ 适应 / 宽 /1:1/ 全屏 操作。
支持的图片格式包括 png jpg jpeg gif webp bmp ico svg。通过扩展名匹配后，如果内容类型不匹配，插件仍会通过魔术字节嗅探继续匹配。
安装与启用¶
通过命令行安装（推荐使用 --profile web 对应桌面应用）：
dsh plugin --profile web add dsh-zoom-viewer
如果系统路径中未配置 dsh，可通过 npx 调用：
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-zoom-viewer
或直接从仓库安装：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:1378616343/dsh-zoom-viewer
在 DSH 界面中，也可以通过 插件 / Plugins 页面，点击箭头菜单中的 安装第三方插件 / Install third-party plugin，然后粘贴 dsh-zoom-viewer、仓库 URL 或本地包含 package.json 的目录。
安装完成后需要重启 DSH，插件树仅在启动时读取。
典型用法¶
安装并重启 DSH 后，打开任意图片（如 PNG、JPEG、SVG 等）即可看到右侧栏变为可缩放、可拖拽的视图。默认情况下，该渲染器会注册在内建图片渲染器之上，因此这些格式会优先使用它。
使用滚轮缩放时，光标所在位置保持不变，缩放范围在 5%–1600% 之间。按住鼠标左键拖拽可平移视图。双击图片可快速回到适应视图。点击工具栏上的按钮可切换到适应、适应宽度、1:1 或全屏模式。
适用场景与注意¶
适合需要频繁查看、标注或分享图片的开发者与研究者，特别是在调试、文档展示、模型可视化等场景中。
注意：插件以当前 DSH 进程的权限运行。安装前建议查看仓库源码与许可证（MIT）。插件不发起网络请求、不访问文件系统、不包含安装脚本，依赖项仅声明 react 为可选的 peer 依赖。
结语¶
dsh-zoom-viewer 为 DSH 右侧栏的图片查看提供了更接近原生浏览器的交互体验，无需额外配置即可启用。更多细节与源码可参考：
- 目录页：https://www.skillhub.cn/plugins/1378616343/dsh-zoom-viewer
- GitHub：https://github.com/1378616343/dsh-zoom-viewer
