dsh-inline-media-viewer

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

English · 简体中文

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

https://…/view?filename=frame.png  →  <img>
exports/demo.mp4                   →  <video controls>
audio/sound.mp3                    →  <audio controls>

目录

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

功能特性

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

支持的媒体格式

安装

适配 DSH v0.1.3-alpha.1；旧版 DSH 请使用插件 1.0.9。

通过 npm 安装

在 Web profile 中安装并启用 Bundle：

dsh plugin --profile web add @wisdoverse/dsh-inline-media-viewer@1.0.10-alpha.1

安装后重启 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 当前界面语言，在中文与英文之间实时切换。

设置值保存在 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。

开发

常用命令

项目结构

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

许可证

本项目采用 MIT 许可证。