在 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 用户提供了在对话流中直接展示本地媒体的能力，避免了路径无法渲染的问题。其轻量级、仅作用于对话卡片的特性，使其成为辅助本地文件查看的实用工具。