前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者扩展其功能。在处理图片相关的任务时，查看、下载和标注图片是常见需求。wsl043/dsh-image-viewer 是一个为此场景设计的轻量级插件，它提供了比原生查看器更丰富的交互方式，支持缩放、区域标注以及下载管理。
核心功能¶
该插件提供以下能力：
- 浏览与缩放
支持以鼠标位置为中心进行缩放、拖动，以及双指缩放。双击图片可查看原始大小，支持适应窗口、键盘切换以及多图浏览。 - 图片信息展示
显示图片名称、尺寸和当前的缩放比例。在查看 100% 大小时，调整窗口大小不会导致图片消失。 - 下载管理
支持原图下载，并显示进度。下载过程中可以取消或重试。切换图片或关闭查看器会自动取消正在进行的下载。 - 状态反馈与隔离
提供清晰的加载和错误状态，失败时可重试。切换图片会重置拖动状态，并隔离不同图片的标注，避免数据混淆。 - 区域标注
点击标记区域，在编号旁编辑备注。按下Enter键保存，按下Shift+Enter键换行。 - 会话集成
关闭原生 DSH 图片查看器时，插件会将标记的图片和备注加入当前会话的草稿中。这会保留已有的文字，但不会自动发送，从而避免重复添加。操作失败时支持重试。 - 主题适配
适配 DSH 的亮色和暗色主题，支持响应式布局、焦点约束以及减少动态效果设置。
安装与启用¶
通过插件页面或终端命令安装。
插件页面安装¶
- 打开 DSH 的 插件 → 添加插件。
- 在“包名或地址”中粘贴
dsh-image-viewer@0.1.6并点击安装。 - 查看安装结果，按提示刷新或重启。
终端安装¶
dsh plugin --profile web add dsh-image-viewer@0.1.6
注意事项¶
- 权限与隐私
插件只读取 DSH 已渲染的图片 URL，不调用模型，也不读取供应商凭据。 - 标注数据持久性
标注通过 DSH 附件和草稿接口管理。在页内重开查看器时可以看到备注，但这不代表备注已发送或永久保存。 - 卸载影响
卸载插件会恢复 DSH 内置的图片查看器，不会删除会话中的图片或已有的文字内容。
总结¶
dsh-image-viewer 专注于图片查看、下载和标注的交互细节。它通过集成 DSH 的草稿接口，让标注内容更容易转移到会话中，适合需要在开发或调试过程中快速标记图片的开发者。
