dsh-media-preview
DeepSeek Harness 的视频和音频预览：在右侧边栏文档预览中播放 mp4/mov/mkv/webm 和 mp3/flac/wav，通过经过身份验证的 HTTP Range 路由进行流式传输，无需加载整个文件即可进行定位。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:439436269-ctrl/dsh-media-preview#fe8e9dd7813f7f2d193e98b64d68f9b06e41e77b
Media Preview 以 dsh-media-preview 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Video and audio preview for DeepSeek Harness: play mp4, mov, mkv, webm and mp3, flac, wav right inside the right-Sidebar document preview instead of the built-in “this format cannot be previewed” empty state.
中文 | English (this file) · 中文说明
The built-in preview registers renderers for text, code, Markdown, images, PDF, HTML, Office and spreadsheets, and lists video/audio suffixes as known binary containers with no renderer — so opening a video shows an icon and one line of text. This plugin registers those suffixes and draws the browser's native player, fed by an authenticated streaming route that honours HTTP Range, so seeking works and a 2 GB file is never loaded into memory or into the conversation.
dsh plugin --profile <profile> add dsh-media-preview
Then restart the desktop app (a profile patch change is read at boot). No configuration is required; the defaults cover the common suffixes.
To check it loaded, open any .mp4 from the Files tab: the preview pane shows the player rather than the unsupported-format notice.
dsh-media-preview/media (video suffixes) and dsh-media-preview/audio (audio suffixes), with priority extension, loading: 'renderer', and their suffixes declared binary so the “plain text” fallback is not offered.<video>/<audio> element with the browser's own controls. The video is fitted into the pane with object-fit: contain inside a flexible frame, so a portrait or landscape clip is fully visible at once, with black letterboxing instead of spilling past the preview edge. Below it sit 倍速 / Speed (cycles 1× → 1.25× → 1.5× → 1.75× → 2× → 0.5× → 0.75×), 循环 / Loop, and — for video — 全屏 / Full screen and 画中画 / Picture in picture. Speed and loop also apply to audio, and the choice is remembered per browser. Audio shows a card with the file name, its size and the player. The body reports loaded / failed back to the document preview owner so the tab's loading state settles.GET|HEAD /api/media-preview?path=<absolute path> that answers 200 with Accept-Ranges: bytes, 206 with Content-Range for one byte window, 416 with Content-Range: bytes */size for an unsatisfiable window, and HEAD with headers only. It reads the file a chunk at a time (chunkBytes, 1 MiB by default) through ctx.fs.readByteRange, so memory stays flat./api/, which means the composition's connection service applies its Host/Origin fence and browser-session cookie check before the handler runs. A cross-site page cannot read local files through it.Settings live on the media-preview entry (Settings → Plugins, or the profile patch). Every key has a code-side default, so a partial config is valid.
| Key | Default | Meaning |
|---|---|---|
enabled | true | Mount the route at all. Off leaves the renderer registered but transfers no bytes (503). |
routePath | /api/media-preview | Route pathname. Must start with /api/; anything else falls back to the default so the auth fence still applies. |
maxBytes | 2147483648 (2 GiB) | Largest file served; larger files answer 413. |
chunkBytes | 1048576 | Bytes per ranged read. |
videoExtensions | mp4, m4v, mov, webm, ogv, ogg, mkv, avi, wmv, flv, 3gp, ts, m2ts, mts | Suffixes the video player claims. |
audioExtensions | mp3, wav, flac, m4a, aac, oga, opus, weba, wma, aiff, aif | Suffixes the audio player claims. |
The browser half mirrors the suffix lists in lib/client.js; keep them in sync when changing either side. The route path is published to the page as __DSH_MEDIA_PREVIEW_CONFIG__ by the Host, so a configured path and the player's URL never drift apart.
Playback depends on the browser's own codecs, not on this plugin. Chromium/Electron plays MP4 (H.264/AAC), WebM (VP8/VP9/Opus), Ogg and most audio formats. Matroska (.mkv) and AVI usually do not decode in Chromium; the player then reports “浏览器不支持这个编码 / This codec is not supported by the browser” and the Open in app control in the preview header still hands the file to the system player. Remuxing such files to MP4/WebM is the reliable fix.
lib/index.js Host entry: name / inject / Config / apply (route + index injection)
lib/config.js Defaults and normalization, no host imports (unit-testable)
lib/schema.js schemastery Config for the loader/settings page
lib/range.js HTTP Range interpretation, pure functions
lib/mime.js Suffix → media type
lib/route.js The authenticated streaming handler (fetch-shaped, chunked)
lib/client.js Browser bundle: renderers, bodies, styles, copy
test/ node --test: range, config, route, adapter mount, client bundle
scripts/ Headless browser E2E + HTTP probe used for verification
The browser half is a hand-written module-loader bundle (window.__ModuleLoader__.load({ id, factory })) with react and react/jsx-runtime as its only module-table requests, so it needs no build step and cannot drift from the Host's React copy.
node --test test/*.test.js
For end-to-end checks, start a host with the plugin installed and run the probe:
node scripts/e2e-browser.mjs --base http://127.0.0.1:<port> --token <token> --video "<absolute path to a video>"
E2E_BROWSER_CHANNEL=msedge makes Playwright use the system Edge when the bundled Chromium is unavailable.
Range header is answered 416. Browsers only ever ask a media element for one window..mkv, .avi, .wmv, .flv are claimed and listed, but Chromium cannot decode them; the plugin shows the player's error state rather than pretending they play.MIT