DeepSeek Harness Chat Image Lightbox 插件

在 DeepSeek Harness (DSH) 中开发智能体时，图片通常以缩略图形式嵌入。要查看细节，通常需要保存图片并在外部查看。下面介绍一个插件，用于在聊天界面中提供全屏查看体验。

这是 loyalchiiina/dsh-chat-image-lightbox，一个由 loyalchiiina 维护的 DSH 客户端插件。它将聊天中的图片渲染为带有缩放、下载和导航功能的灯箱视图。

核心功能¶

1. Inline display via markdown：图片通过 Markdown 语法直接渲染在聊天中。
2. Click to zoom in/out：点击图片即可进入全屏灯箱，再次点击退出。
3. Drag to pan when zoomed：放大状态下，支持鼠标拖拽平移查看细节。
4. Download (save-as dialog)：支持下载功能，触发浏览器的“另存为”对话框。
5. Prev/next navigation：支持通过按钮、键盘方向键或触摸滑动切换同一条消息中的多图。
6. Show caption/filename：显示当前图片的文件名或描述。
7. Accessible：支持无障碍访问，包含 role=dialog、aria-modal 和焦点管理。
8. Prefetch adjacent images：预取相邻图片，保证切换流畅。
9. Close via backdrop, Escape, or X button：支持点击背景、按 Escape 键或点击关闭按钮退出。
10. ZCode-style rendering：采用 ZCode 风格渲染，不操作 DOM 节点，避免虚拟列表冲突。
11. Preserve aspect ratio, capped height：保持图片纵横比，高度限制为 min(460px, 64vh)。
12. Responsive CSS-grid for multiple images：单条消息中的多图采用响应式 CSS Grid 布局。
13. Open with HD original resolution：点击打开时显示高清原图，缩放查看实际分辨率。
14. Clean UI：关闭时隐藏工具栏，界面简洁。
15. Auto-enhance new images：使用 MutationObserver 自动增强新添加的图片。

安装¶

打开终端，执行以下命令安装插件：

dsh plugin --profile desktop add @loyalchiiina/dsh-chat-image-lightbox

典型用法¶

1. 将图片文件放入 DSH 的上传目录 ~/.dsh/uploads/。
2. 在 AI 回复中使用 Markdown 语法引用图片：

![Description](http://127.0.0.1:<port>/images/your-image.jpg)

注意事项¶

• URL 格式要求：图片必须使用 http(s) URL。插件不渲染 base64 或 data-URI 格式的图片。
• 防盗链问题：如果图片托管平台启用了防盗链，可能会导致图片显示为空白。
• 跨域下载：跨域图片可能无法触发“另存为”对话框，而是直接在新标签页打开。
• 进程重启：安装或修改插件配置后，必须完全退出所有 DSH Desktop 进程并重启，插件才能生效。

生态背景¶

DSH 理念是「一切皆插件」。该插件由社区开发者维护，与 DeepSeek 或幻方官方无从属关系。更多信息请参考插件目录或 GitHub 仓库。