前言¶
在 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 目錄頁。
