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