内联媒体预览Wisdoverse/dsh-inline-media-viewer-plugin

dsh-inline-media-viewer

为 DeepSeek Harness Web 提供内联图像、视频和音频预览

English · 简体中文

将 DSH 对话中出现的媒体路径和 URL 安全地转换为内联预览，无需再从聊天日志中复制路径。

https://…/view?filename=frame.png  →
exports/demo.mp4                   →
audio/sound.mp3                    →

目录

- 功能特性
- 支持的媒体格式
- 安装
- 配置
- 安全设计
- 开发
- 许可证

功能特性

| 特性 | 说明 |
| --- | --- |
| 内联渲染 | 在提及媒体的聊天消息下方直接显示图像、视频和音频。 |
| 工作区安全读取 | 使用 realpath 解析本地路径，并拒绝目录穿越、工作区外路径和符号链接逃逸。 |
| 可选 ComfyUI 代理 | 由服务端从配置的源站获取识别到的 ComfyUI 媒体 URL，使远程用户和 HTTPS 页面也能正常查看。 |
| 资源限制 | 每个文件或响应最大 48 MiB，远程请求最长 20 秒。 |
| 用户控制 | 提供自动渲染、每条消息的媒体数量、媒体高度和可选的 ComfyUI 源站设置。 |

[!NOTE]
ComfyUI 不是必需依赖。即使没有安装或运行 ComfyUI，工作区文件和普通 HTTP(S)
媒体 URL 仍可正常使用；只有识别为 ComfyUI 的 URL 才会启用代理。

支持的媒体格式

| 类型 | 扩展名 |
| --- | --- |
| 图像 | png、jpg、jpeg、webp、gif、avif、bmp、svg |
| 视频 | mp4、webm、mov、m4v、mkv、avi、ogv |
| 音频 | mp3、wav、m4a、aac、ogg、oga、flac、opus |

安装

适配 DSH v0.1.3-alpha.1+ API，并已在 v0.1.5-rc.1 验证宿主启动和设置入口。尚未在 v0.1.5-rc.1 完成端到端媒体播放验证。

通过 npm 安装

在 Web profile 中安装并启用 Bundle：

dsh plugin --profile web add @wisdoverse/dsh-inline-media-viewer@1.0.11

安装后重启 Web profile。

从源码安装

1. 将插件克隆到 Web profile 可以访问的位置：

git clone https://github.com/Wisdoverse/dsh-inline-media-viewer-plugin.git \
/path/to/local-plugins/dsh-inline-media-viewer

2. 将插件添加到 profiles/web/package.json：

{
"dependencies": {
"@wisdoverse/dsh-inline-media-viewer": "link:/path/to/local-plugins/dsh-inline-media-viewer"
},
"dsh": {
"profile": {
"bundles": ["…", "@wisdoverse/dsh-inline-media-viewer"]
}
}
}

3. 重新构建或重启 Web profile。

插件通过 cordis.patch.yml 挂载宿主 RPC 通道、客户端投影和设置区域。

配置

打开 设置 → 媒体预览 / Media preview。

导航名称和全部设置文案会跟随 DSH 当前界面语言，在中文与英文之间实时切换。

| 设置项 | 默认值 | 可选范围 |
| --- | --- | --- |
| 自动渲染检测到的媒体 | 开启 | 开启 / 关闭 |
| 每条消息的最大媒体数量 | 12 | 1–30 |
| 媒体最大高度 | 380 px | 160–1200 px |
| ComfyUI 源站（可选） | 留空 | http(s)://host[:port] |

设置值保存在 DSH 设置文档中。只有回环连接可以写入；远程浏览器可以读取设置，但不能持久化修改。

ComfyUI 源站

- 不使用 ComfyUI 时无需配置此项。
- 留空时使用 http://127.0.0.1:8188。
- 支持 http://host[:port]、https://host[:port] 和不带协议的
host[:port]（默认使用 http）。
- HTTP 的默认端口为 8188，HTTPS 的默认端口为 443。
- 不允许包含凭据、路径、查询字符串或片段。
- 该地址必须能从 DSH 宿主进程访问。如果宿主运行在容器中，请填写容器内部可见的地址。

本地别名（127.0.0.1:8188 和 localhost:8188）以及配置的源站都会被识别为
ComfyUI 来源。非空的无效地址会明确报错，而不会静默回退到其他目标。

安全设计

本插件是本地信任辅助工具，不是通用的文件或网络代理：

- 本地读取仅限当前会话的工作区和已知媒体扩展名。
- 远程读取只能访问配置的 ComfyUI 源站，并拒绝重定向。
- 本地文件和远程响应均限制为最大 48 MiB。
- 设置写入仅允许回环连接。
- 浏览器接收的是 data: URL，而不是文件系统路径。

完整的信任模型和已知限制请参阅 SECURITY.md。

开发

常用命令

| 命令 | 用途 |
| --- | --- |
| node test.mjs | 直接运行无依赖的单元测试。 |
| npm test | 通过 npm 运行同一套单元测试。 |
| npm run lint | 对宿主模块和测试文件执行语法检查。 |

项目结构

| 路径 | 职责 |
| --- | --- |
| index.js | 宿主 RPC 通道、ComfyUI 代理和设置注册。 |
| lib.js | 无依赖的纯辅助函数。 |
| client/client.js | 消息投影、媒体渲染器和设置界面。 |
| cordis.patch.yml | Bundle 挂载和集成点。 |
| test.mjs | 纯辅助函数的单元测试。 |

运行中的 Web profile 使用构建后的副本。修改源文件后，请重新构建或重启 Web profile。

许可证

本项目采用 MIT 许可证。