视频文件预览插件
zemul/dsh-video-preview · 技能
dsh-better-sidebar 的视频文件预览插件： 在侧边栏打开 .mp4 .webm .mov .mkv .avi 等视频文件时，内联渲染一个可播放、可拖拽进度条的 播放器。
★ 5GitHub 星标
1分支
2026-09-01最近更新
JavaScript开发语言
MIT许可证
主要功能
- 通过 ctx.betterSidebar.registerFileViewer 注册 video 预览器（id video，与内置 viewer 同权）
- 该路由不支持 HTTP Range（整个文件读进内存、返回 200），浏览器无法拖动进度条（seek）
- 打开侧边栏 → 在文件资源管理器中打开任意视频文件，video 预览器自动命中
- 路由复用与 /api 网关相同的 Host 头信任围栏（loopback 或 trustedHosts，拒绝跨站）
- 内联 播放/暂停、拖进度条（Range 206）、倍速、全屏、音量、preload=metadata
使用条件
- 支持浏览器可解码的容器/编码（H.264 的 mp4/m4v、VP8/VP9 的 webm、mov、OGV 等）
- Chrome/Edge/Firefox 不内置解码的格式（如部分 HEVC、AV1 组合）会在播放器内报错，可用「下载」取回原文件
安装命令
dsh plugin --profile web add github:zemul/dsh-video-preview