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 倉庫。