在 DeepSeek Harness (DSH) 的使用場景中，雖然可以調用工具操作本地文件，但 Markdown 渲染器並不直接支持渲染本地文件路徑（如 file:// 協議或 Windows 路徑）。這導致在對話中向人類觀察者展示本地圖片或視頻時，往往需要額外的手動操作。
dsh-show-media 插件通過定義 dsh_show_media 工具，解決了這一痛點。它允許在當前的 DeepSeek Harness 對話卡片中直接展示本地圖片或短視頻，供人類觀察。
插件信息¶
- 名稱：dsh-show-media
- 維護者：NecromanAlbert
- 類別：Client
- 許可：MIT
安裝與啓用¶
安裝該插件需要使用 DSH 的命令行工具。安裝後建議重啓 Desktop GUI 以確保加載完成。
dsh plugin --profile desktop add github:NecromanAlbert/dsh-show-media
核心功能¶
該插件定義了一個名爲 dsh_show_media 的工具，該工具僅接受一個參數 file_path。
支持的格式與限制¶
- 圖片：PNG, JPEG, WebP, GIF
- 視頻：MP4, WebM, MOV, M4V, MKV
- 大小限制：視頻文件有 64MiB 的上限
- 顯示方式：顯示文件的原始字節，不進行官方附件的降採樣處理
交互方式¶
- 預覽：點擊圖片或視頻幀即可預覽。
- 關閉：按 Esc 鍵、點擊背景遮罩或點擊關閉按鈕（×）均可關閉預覽。
使用方法¶
1. 路徑解析¶
文件路徑是相對於當前會話的工作區（session workspace）進行解析的。
2. 調用方式¶
開發者或用戶需要通過 JSON 載荷向工具傳遞 file_path 參數。
{ "file_path": "C:\\path\\to\\photo.webp" }
適用場景與注意¶
- 作用域：該插件僅作用於當前的對話卡片，不會佔據
shell.overlay層。 - 非模型視覺替代品：該插件旨在展示給“坐在卡片前的人類”，而非用於模型調用。官方的
read_image仍用於模型視覺路徑，兩者互不替代。 - 非系統級覆蓋：它不是進程範圍的浮動覆蓋層，也不會作爲第二個圖庫出現，僅自定義了
dsh_show_media工具卡片本身。
總結¶
dsh-show-media 爲 DSH 用戶提供了在對話流中直接展示本地媒體的能力，避免了路徑無法渲染的問題。其輕量級、僅作用於對話卡片的特性，使其成爲輔助本地文件查看的實用工具。
