前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在 DSH 的 Web 界面中，右侧边栏默认的文档预览采用原生尺寸渲染，不自动适配窗口，仅提供滚动功能。这种静态预览对于图标类资源尚可，但在查看大尺寸截图、图表或设计稿时，操作体验较差。dsh-sidebar-image-zoom 插件通过替换右侧边栏的图片渲染器，为这些资源增加了缩放和平移能力。
插件概况¶
- 名称：dsh-sidebar-image-zoom
- 维护者：Meowrium
- 类别：客户端
- 许可证：MIT
安装与启用¶
插件通过官方命令安装。安装完成后需重启 dsh web。
dsh plugin --profile web add github:Meowrium/dsh-sidebar-image-zoom
前置要求：DSH 版本需在 0.1.5 线（已验证于 0.1.5-rc.1）。该插件扩展的右侧边栏文档预览功能在此之前不存在。
安装后，在右侧边栏打开任意图片文件（例如通过「新建标签页」→「工作区文件」选择图片），即可启用该插件。
核心功能¶
插件提供以下交互与控制能力：
- 光标锚定缩放：滚动鼠标滚轮时，图片以鼠标指针位置为中心进行缩放，指针下的像素保持不动。
- 拖拽平移：当图片放大超过窗口大小时，支持鼠标拖拽平移。
- 双击切换：双击图片可在「适应窗口」和「1:1」原始尺寸之间切换。
- 多模式适配：支持适应窗口、适应宽度、1:1 原始尺寸三种显示模式。
- 键盘快捷键：支持
+/-进行步进缩放；0键适应窗口；1键恢复 1:1。 - 缩放范围：支持 10% 到 1200% 的缩放级别。
典型用法¶
在右侧边栏预览大尺寸图片时：
* 使用鼠标滚轮快速定位细节。
* 使用 + / - 键进行微调。
* 使用 0 键快速让图片适应当前窗口大小。
技术实现与注意事项¶
- 官方扩展点：仅使用官方扩展点注册，不涉及
monkey-patching或私有 DOM 属性修改。 - 卸载恢复：卸载插件后，DSH 会恢复内置的图片渲染行为，因为内置定义依然注册，只是优先级被插件覆盖。
- 资源清理：关闭标签页时，插件会释放所有监听器、样式、观察器和对象 URL，无残留。
- 加载方式：插件仅增加交互逻辑，不改变图片的加载方式和来源。
