前言¶
在 DeepSeek Harness（DSH）里点开工作区里的视频文件，右侧预览区常见两种空状态：提示「this file type cannot be previewed / download to view」，或原生文档预览对二进制扩展名直接不读内容。文件本身往往没问题，只是当前预览链路里没有组件声明能渲染 mp4 一类格式。若你习惯在侧边栏核对素材、对照录屏或教程片段，只能反复下载到本地播放器，打断和智能体同一窗口里的协作节奏。
下面介绍社区插件 dsh-mp4（维护者 shshjjj456，分类为客户端）。它在右侧栏用浏览器原生 <video> 播放常见容器格式，替代上述占位提示；同一包同时对接 dsh-better-sidebar 与 DSH 自带的 @deepseek-ai/dsh-client-ui-sidebar-documentpreview，Desktop、dsh web 与其它 profile 只需装一次，缺哪一侧注册哪一侧 idle，不会拖垮整插件。
这是什么¶
dsh-mp4 的定位很窄：在 DSH 右侧边栏内联预览 MP4、M4V、MOV，用浏览器自带视频控件播放，而不是显示无法预览的占位文案。
仓库：https://github.com/shshjjj456/dsh-mp4
社区目录页：https://www.skillhub.cn/plugins/shshjjj456/dsh-mp4
为什么会出现「无法预览」¶
README 里把两种右侧栏行为对照说明如下，便于判断你是否需要本插件。
| 右侧栏来源 | 谁决定打开什么 | 对 mp4 之前的表现 |
|---|---|---|
已安装 dsh-better-sidebar |
其 editor 标签通过 matchFileViewer(path) 选 viewer |
内置多为 markdown / html / jsonl / code；mp4 落到兜底 code viewer，按二进制读 → 无法预览 + 下载链接 |
| DSH 原生侧栏 | @deepseek-ai/dsh-client-ui-sidebar-documentpreview |
mp4 在 UNVIEWABLE_BINARY_EXTENSIONS 中，无 renderer 匹配 → 空状态，且不读取文件内容 |
本插件向上述两套机制分别注册；只存在其中一种时，另一半保持空闲，不导致安装失败。
核心功能¶
经资料核实，当前版本（package.json 中为 0.1.4）能力包括：
- 在右侧栏预览 MP4 / M4V / MOV，使用浏览器原生播放器 UI（播放、进度、音量等由浏览器提供）。
- 双路径注册：兼容
dsh-better-sidebar的文件 viewer 匹配，以及对原生 document preview 包的 client 注入（manifest 中inject指向@deepseek-ai/dsh-client-ui-sidebar-documentpreview）。 - 客户端 Web 插件：
dsh.client.platform为web，immediately: true；另通过cordis.patch.yml做 bundle patch。 - 运行时要求：Node >= 20，dsh >= 0.2.1-rc.5（见 package.json
engines）。 - 许可证：MIT。
资料未描述额外配置文件或环境变量；安装启用后，在支持的路径下选中对应扩展名文件即可走预览逻辑。
安装与启用¶
DSH 生态里插件以「一切皆插件」方式扩展；社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前请自行查看仓库源码与许可证——插件随当前 dsh 进程权限运行。
方式一： 在插件市场搜索 dsh-mp4。
方式二： 使用 README 给出的命令（勿自行拼接 github:owner/repo 形式）：
# Desktop 用户：优先 Settings → Plugins（Desktop 使用独立 profile）
dsh plugin --profile web add dsh-mp4
dsh plugin --profile <your-profile> add dsh-mp4
将 <your-profile> 换成你实际使用的 profile 名称；Desktop 与纯 dsh web 若 profile 不同，需在对应 profile 各装一次。
典型用法¶
资料中的用法即「安装 → 在文件树或对话上下文中打开工作区内的视频文件 → 右侧栏播放」，无单独 CLI 示例子命令。可复现步骤如下：
- 按上一节命令为当前 profile 安装
dsh-mp4。 - 重启或刷新 DSH Web / Desktop 客户端，确认插件已加载。
- 在工作区放置或生成扩展名为
.mp4、.m4v或.mov的文件。 - 在右侧预览区打开该文件：应出现内嵌视频播放器，而不再是「this file type cannot be previewed」类提示。
若仍走下载链接，检查是否装在了当前会话使用的 profile，以及是否与仅支持其它扩展名的 viewer 插件冲突（资料未列举冲突表，需结合你本地插件列表排查）。
适用场景与注意¶
适合： 在 Harness 里直接预览教程录屏、Agent 生成的演示视频、M4V/MOV 素材，而不离开侧边栏。
注意：
- 播放能力依赖浏览器对容器与编解码的支持；资料只承诺三种扩展名与侧边栏集成，不保证所有编码配置均可播。
- 大文件仍受浏览器与 DSH 加载策略影响，资料未给出大小上限。
- 星标与版本以 GitHub / 目录页为准；本文写稿日为 2026-11-05，后续请以仓库 README 为准。
结尾¶
dsh-mp4 解决的是 DSH 右侧栏对 MP4 系文件「无人认领 renderer」的问题：一处安装，兼容 better-sidebar 与原生 document preview 两条链路。需要进一步了解说明或提 issue，见 GitHub 仓库 与 skillhub 目录页。
