tsonglew/dsh-media-preview
30最近提交 2026年8月14日
dsh-media-preview DSH 插件
该插件注册为 dsh-better-sidebar 的 FileViewer，允许用户在侧边栏中直接预览音视频文件。它使用自己的流式路由，支持 HTTP Range，避免整个文件缓冲，实现大媒体文件的流畅定位。
如何安装 dsh-media-preview DSH 插件
dsh plugin --profile web add github:tsonglew/dsh-media-preview复制不会执行命令。安装 dsh-media-preview DSH 插件前请核对仓库和版本。
dsh-media-preview DSH 插件数据来源
dsh-media-preview DSH 插件快照日期：2026年8月16日
discovered
dsh-media-preview DSH 插件能做什么
- 支持视频格式：mp4、webm、mov、m4v、mkv、avi、ogv、ts、3gp、flv
- 支持音频格式：mp3、wav、ogg、oga、m4a、aac、flac、opus、weba、wma
- HTTP Range（206）定位，支持长视频跳跃
- 通过 fs.createReadStream 流式响应，无整文件缓冲
- 基于魔术字节嗅探无扩展名文件（ftyp、EBML、OggS、fLaC、RIFF、ID3 等）
- 可配置最大文件大小（默认 2 GiB）
dsh-media-preview DSH 插件适合哪些场景
- 在侧边栏文件树中预览视频文件，无需离开 web GUI
- 播放侧边栏能浏览的任何文件夹中的音频文件（例如 ~/Documents 中的音乐文件夹）
- 在文件系统中导航时快速查看媒体内容
- 流式播放大视频文件（最高 2 GiB）并支持定位
dsh-media-preview DSH 插件适合谁
- 安装了 better-sidebar 插件的 DSH 用户
- 需要在文件浏览器中内联预览媒体文件的用户
dsh-media-preview DSH 插件的限制
- 需要 dsh-better-sidebar >= 0.4.0
- 默认只允许本地回环请求；额外的 trustedHosts 需手动配置
- 单个文件大小硬限制为 2 GiB（可通过 maxMediaBytes 配置）
- 仅在 DSH web GUI 的侧边栏文件树中生效
dsh-media-preview DSH 插件的仓库 README 摘录
以下文字摘自 dsh-media-preview DSH 插件的上游仓库 tsonglew/dsh-media-preview 的 README，版权归原作者，仅作引用。
Audio and video preview for the DeepSeek Harness (dsh) web GUI, registered as a **FileViewer** inside [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar). Open an `.mp4`/`.webm`/`.mkv`/`.mov`/… or `.mp3`/`.flac`/`.wav`/… file in the sidebar file tree and it plays inline with native controls. | Video | Audio | |-|-| |<img width="679" height="643" alt="image" src="https://github.com/user-attachments/assets/061d92cb-4418-47d1-86bd-be52a9950dbc" />|<img width="692" height="542" alt="image" src="https://github.com/user-attachments/assets/74df4ef9-aa98-4be7-bdf1-852eed2ed51d" /> | ## Why a dedicated route better-sidebar's built-in `/sidebar/file` media route reads whole files into memory, has **no HTTP Range support**, and caps at an image-oriented size limit. This package serves media through its own streaming route (`/media-preview/file`) with: - HTTP **Range** (206) seeking — the browser can jump anywhere in a long video - Streamed responses (`fs.createReadStream`) — no whole-file buffering - Whole-filesystem scope behind the same browser trust fence the built-in `/api` documents (loopback Host + same-origin markers), matching the official directory-picker
阅读完整 README仓库许可: MIT
dsh-media-preview DSH 插件常见问题
如何安装 dsh-media-preview？
运行命令 `dsh plugin --profile web add github:tsonglew/dsh-media-preview`。确保已安装 dsh-better-sidebar 0.4.0 或更高版本，因为该插件依赖于 better-sidebar 提供的 registerFileViewer 接口。
支持哪些音视频格式？
视频格式：mp4、webm、mov、m4v、mkv、avi、ogv、ts、3gp、flv。音频格式：mp3、wav、ogg、oga、m4a、aac、flac、opus、weba、wma。插件还会通过魔术字节嗅探识别无扩展名的文件，因此许多常见容器格式即使文件名没有扩展名也能被识别。
为什么我的视频无法播放或无法定位？
首先检查文件是否在大小限制内（默认 2 GiB，可通过 maxMediaBytes 配置）。其次，默认情况下只允许本地回环连接（localhost）。如果从远程主机访问，需要将该主机添加到 trustedHosts 配置中。另外，某些编码格式可能不被浏览器支持——插件依赖于原生 HTML5 视频/音频能力。
可以预览当前会话目录之外的文件吗？
可以。侧边栏文件资源管理器可以浏览会话 cwd 之外的文件夹（例如 ~/Documents 中的音乐文件夹），插件会播放资源管理器能打开的任何文件。它继承了与内置目录选择器后端相同的文件系统访问范围。
如何增加最大文件大小限制？
在配置文件中，为 media-preview 插件添加 config 部分，设置 maxMediaBytes 为所需的字节数。例如，允许最大 4 GiB 则设置 `maxMediaBytes: 4294967296`。默认值为 2147483648（2 GiB）。