dsh-image-viewer

[!NOTE] 这是一个可选、可独立卸载的 DSH 插件。它增强 DSH 已显示图片的查看、下载与区域标注，不接管会话、附件或模型流程；图片生成插件也可以按需把它作为共享查看器使用。

正式版 0.1.0 已发布到 npm。遇到无法识别的新图片结构时会保留 DSH 原生行为，不会猜测接管。

稳定版与当前 Alpha 都在隔离环境验收真实附件的多图切换、缩放、拖动、下载、区域备注及关闭后焦点恢复。发布前必须通过；定时工作流每六小时检查官方新版本，失败保留浏览器和启动记录，不自动宣称兼容或发布。

功能

• 以鼠标位置为中心的滚轮缩放、拖动查看、触控双指缩放和双击原始大小。
• 适应窗口、原始大小、原图下载、键盘切换和多图浏览。
• 0.1.1：下载时显示可用的进度，支持取消和重试；切换图片或关闭查看器会取消正在进行的下载。
• 显示图片名称、尺寸与真实像素缩放比例；超宽大图也能切换到 100%，调整窗口后保持图片可见。
• 图片加载中和加载失败都有明确提示，失败可重试；切换图片会重置拖拽状态，区域备注不会串到另一张未命名图片。
• 一次点击标记一个区域，备注直接显示在图片编号附近并自动获得输入焦点；Enter 保存并收起，Shift+Enter 换行。
• 0.1.1：在 DSH 原生图片入口添加备注后，关闭查看器会把带编号的 PNG 和备注加入打开图片时的会话草稿，保留已有文字，不自动发送。没有修改备注时不会重复添加；失败时保留标注并可重试或仅关闭。
• 使用 DSH 设计令牌适配亮色、暗色、响应式布局、焦点约束和减少动态效果设置。
• 提供可选的 nativeImageViewer 客户端服务，图片生成插件可以按需增加自己的后续操作。

未安装本插件或插件无法识别更新后的图片界面时，DSH 仍保持原有查看能力。其他插件可以在检测到服务时使用高级查看，但仍应保留自己的基础回退。

安装

DSH 0.1.6-alpha.2 使用候选版 dsh-image-viewer@0.1.2-beta.1。在官方 插件 → 添加插件 中只填写该包名与版本，不粘贴整条终端命令；按安装结果提示刷新或重启。下面的 0.1.0 命令面向已支持的旧内核，不代表支持所有新 alpha。

从 npm 安装正式版：

dsh plugin --profile web add dsh-image-viewer@0.1.0

保存正在进行的工作后手动重启 DSH。本插件不需要供应商凭据或图片生成账户权限。

更新

使用目标版本对应的固定 dsh plugin ... add 命令更新。

卸载

dsh plugin --profile web remove dsh-image-viewer

卸载后恢复 DSH 内置图片灯箱，不会删除会话、附件、生成图片、供应商插件或凭据。

自定义下载接入

调用 nativeImageViewer.open() 时，图片条目的 download.onInvoke 会收到 { item, src, signal, onProgress }。将 signal 传给下载请求，并通过 onProgress({ loaded, total }) 上报字节数。文件总大小未知时省略 total，查看器显示准备状态和取消按钮。

旧的下载回调仍可使用；要实际停止自定义传输，回调需要响应 signal。查看器会忽略已取消操作的迟到进度和结果。下载权限及原图完整性校验仍由提供图片的插件负责。

隐私

插件只读取 DSH 已经渲染的图片 URL，不调用模型或读取供应商凭据。下一版的标注操作会通过 DSH 的附件与输入框接口加入当前草稿，由用户决定是否发送。当前页面内重新打开同一张图片时，区域备注仍会保留；这不等于已发送或永久保存会话。

反馈

请通过问题反馈表单提供准确的插件版本、DSH 版本、操作系统、图片所在位置（消息或输入框）以及失败的操作。不要提交私人图片、凭据或完整会话日志。敏感安全问题请通过 GitHub Security Advisories 私下报告。

许可证

English · 反馈问题 · 功能建议 · MIT