dsh-media-card

dsh plugin --profile web add dsh-media-card

dsh-media-card

在当前 DeepSeek Harness 对话卡片里展示本地图片或短视频,并支持一键下载。本机与远程连接均可使用。

[English](README.md) · [MIT](LICENSE) · [教程](TUTORIAL.zh.md)

DeepSeek Harness 社区插件,不是 DeepSeek 官方产品。

对话里的 markdown 不会渲染本地 file:// / Windows 路径。模型识图仍走官方 read_image。这个插件是给坐在卡片前的人看/下载的。

特性

工具 · dsh_show_media · 参数只有 file_path

图片 · PNG、JPEG、WebP、GIF

视频 · MP4、WebM、MOV、M4V、MKV · 单文件 64MiB

显示 · 原始文件内联预览(不是官方附件压缩)

下载 · 每张卡片带 ⬇ 下载 链接,保存原文件

预览 · 点图片/视频外框放大 · Esc / 点空白 / × 关闭

远程 · 通过 GET 预览端点转发,局域网/隧道/公网远程连接也能看到

范围 · 只挂在当前对话卡,不占 shell.overlay

与 0.1.0 相比:改用 GET 内联/下载端点,远程连接可用;修复了宿主端与浏览器端的依赖解析(inject),并移除了不稳定的 POST RPC 通道与内部诊断代码。

相对路径按会话工作区解析。

{ "file_path": "C:\\path\\to\\photo.webp" }

安装

从 GitHub 装(无构建步骤,lib/ 就是源码):

dsh plugin --profile web add github:YangRuiYangDan/dsh-media-card

或本地目录:

dsh plugin --profile web add /path/to/dsh-media-card

装完重启 web,然后在对话里让 Agent 展示本地文件即可。

做什么

• Agent 调用 dsh_show_media,卡片内联显示原始图片/短视频,并提供下载链接。
• 图片按部署的附件上限,视频上限 64MiB(DEFAULT_VIDEO_CAP)。
• 点击图片或视频外框进入大图/大屏预览。

安全

• 服务端信任 loopback 以及部署配置的受信任主机(与 dsh 自身的 /api 同一原则),所以不依赖任何特定远程插件,任何能让 dsh 正常远程访问的接入方式都可用。
• 只允许图片/视频扩展名,读取有字节大小上限。
• 这不是认证层;请用保护你 dsh 部署的方式(r dsh 网关配对联、反向代理认证、tailscale 等)保护远程访问。

不是什么

• 不是 read_image 的替代品(模型识图仍走官方通道)。
• 不是进程级浮动浮层。
• 不是第二套图库;只自定义 dsh_show_media 这一张工具卡。

开发

Host: lib/index.js(defineTool + GET 预览/下载端点)。

Client: lib/client.js(window.__ModuleLoader__,按工具名占 tool.call.toolview)。

Shared: lib/media.js。

node --check lib/index.js && node --check lib/client.js && node --check lib/media.js

License

MIT