前言¶
在 DeepSeek Harness（DSH）里，模型回复、工具截图和工作区产物经常以 Markdown 图片或内嵌图的形式出现。内置预览比裸 <img> 好用，但通常做不到在指针处缩放、双轴平移，保存时也往往拿不到可读的文件名。若你经常在对话里核对架构图、逐屏看 agent 截图，或要把某张图落盘后再用本地工具打开，就需要一个接管「内容图点击」的客户端插件。
下面介绍社区维护的 dsh-image-zoom（GitHub：bingomu/dsh-image-zoom）。它拦截聊天中的内容图点击，用独立对话框提供缩放、平移、图集浏览和带规则命名的下载，对工作区原图还可交给系统默认应用打开。
这是什么¶
dsh-image-zoom 是面向 DSH Web 客户端 / DSH Desktop 的纯客户端插件：通过 dsh.bundle.patch 与 dsh.client Web 入口注入，不向会话或磁盘写入插件侧数据。维护者为 bingomu（Genzo），许可证 MIT，当前发布版本 1.0.1。插件在 DSH 插件市场（registry 条目 awesome-dsh-plugin）有 listing，分类为客户端。
一句话定位：聊天里的内容图查看器——滚轮/触控板缩放、双指与拖拽平移、多图画廊、自动命名下载、工作区图片用系统默认应用打开。
核心功能¶
查看与手势¶
插件在指针位置缩放，并支持多种平移方式，与 README 中的对照表一致：
| 需求 | 行为 |
|---|---|
| 鼠标滚轮一格 | 在指针处缩放；Windows 100 / Chrome 120 等「一格」立即生效；平滑滚轮或极小 delta 会在约 75 ms 内作为独立事件确认后同样缩放 |
| 触控板捏合 | Ctrl+滚轮（ pinch ）连续缩放 |
| 左右、上下平移 | 双指滚动流可同时平移两轴；拖拽平移；Shift+滚轮横向平移 |
| 看清小字 | 适应窗口 / 1:1 / 双击切换；+/- 按 25% 步进；可输入 5%–4000% 比例；R / Shift+R 顺时针 / 逆时针旋转 90° |
| 多张截图切换 | ←/→ 或侧栏箭头；页脚显示如 3 / 7 |
页脚提供三种滚轮模式 Auto / Zoom / Pan，保存在 localStorage。Auto 即上述启发式；若鼠标平滑滚动驱动干扰自动判断，可改 Zoom；若希望滚轮始终移动画面，选 Pan。
下载命名¶
每次下载文件名格式为：
<description>-<YYYYMMDD-HHmmss>.<ext>
- description：优先图片
alt，否则有意义的源文件名，否则本地化文案「image」。 - 本地时间戳保证唯一且便于排序；扩展名按检测到的格式，避免 blob 截图变成
.bin。 - 替换 Windows 非法字符；保留设备名加尾
_；描述最长 48 字符。下载按钮 tooltip 会预览完整名称；macOS 保存对话框会预填该名。
标题栏操作¶
| 按钮 | 作用 |
|---|---|
| Download | 按上述规则保存原图 |
| Copy image | 以 PNG/JPEG 复制到剪贴板 |
| Copy link | 仅对站外 http(s) 图复制绝对 URL |
| Open original | 工作区 /api/file?path=… 图经 Host 的 openWorkspacePath 用系统默认应用打开；外链新窗口；blob:/data: 会说明无本地路径 |
| Close | 同 Esc（先退出缩放比例输入） |
适用图片包括 Markdown 图片、工具截图、工作区 artifact 等「内容图」点击场景。
安装与启用¶
要求（摘自 engines 与 README）：
| 项 | 值 |
|---|---|
| DSH | >=0.2.1-rc.2 <0.3.0-0；开发与测试基于 DSH Desktop 0.2.1-rc.5 |
| 运行环境 | Web 客户端 / DSH Desktop |
| 平台 | macOS Desktop 已测；Windows 共用 Web 客户端（滚轮一格路径有合成 delta 测试覆盖） |
从 GitHub Release 安装（当前文档给出的命令）：
dsh plugin --profile <your-profile> add https://github.com/bingomu/dsh-image-zoom/releases/latest/download/dsh-image-zoom-1.0.1.tgz
插件市场 listing 使用同一 tarball URL。本地开发 checkout 时可用：
dsh plugin --profile <your-profile> add /path/to/dsh-image-zoom
安装后重启 DSH；若只改了 client.js，重载页面即可。插件无构建步骤，主入口为单文件 client.js。
典型用法¶
- 在已安装插件的 DSH 配置文件中完成上述
dsh plugin add（将<your-profile>换成你的 profile 名）。 - 重启或重载客户端后，在任意对话中点击一张内容图（非仅悬停预览）。
- 在打开的查看器中：滚轮或捏合放大局部；双指滚动或拖拽平移；多张图时用方向键或侧栏切换。
- 需要留存时点 Download，确认 tooltip 中的
<description>-<时间>.<ext>再保存；工作区原图可用 Open original 交给 Photoshop、预览等默认应用。
快捷键摘要（与 README 一致）：Esc 关闭；0/1 适应 / 实际尺寸；Shift+方向键平移 72 px；图集 ←/→。
适用场景与注意¶
适合谁： 经常在 DSH 里阅读模型生成的 diagram、对比多屏 tool 截图、从聊天保存 artifact 图并希望在 Finder/资源管理器里一眼认出文件名的工作流。
生态说明： DSH 强调「一切皆插件」；SkillHub 目录页 与 GitHub 仓库均为社区信息源，与 DeepSeek / 幻方无官方从属关系，不宜表述为官方应用商店。
安全与权限： 插件随当前 DSH 客户端在浏览器/Electron 环境中运行，会处理你点击的图片 URL、blob 与剪贴板。安装前建议阅读 仓库源码 与 MIT 许可证；问题与功能请求可走 GitHub Issues。
结尾¶
内置预览解决「能看见」；dsh-image-zoom 解决「能当查看器用、能按规则保存、工作区图能进默认应用」。若你的 profile 已跑在 DSH 0.2.1-rc.2 及以上且低于 0.3.0，可按 Release tarball 安装后直接在聊天里点图验证。
- 目录页：https://www.skillhub.cn/plugins/bingomu/dsh-image-zoom
- 仓库：https://github.com/bingomu/dsh-image-zoom
