zimai233/dsh-video-downloader

dsh-video-downloader

DeepSeek Harness（DSH）生态的媒体下载插件。检测并下载 Bilibili / YouTube / 抖音（Douyin）/ 小红书（Xiaohongshu）等站点的视频与音频。

Media downloader for the DeepSeek Harness ecosystem. Detects and downloads video/audio from Bilibili, YouTube, Douyin and Xiaohongshu — directly from your agent conversation.

为什么 / Why

DSH 插件生态里有浏览器自动化插件，但没有媒体下载器工具。本插件填补了这个缺口：把 Chrome MV3 扩展（video-downloader-extension）里的媒体识别逻辑从浏览器沙箱中剥离出来，变成纯 Node 函数，并以三个 agent 可调用的工具暴露给模型。

The DSH plugin ecosystem has browser-automation plugins but no media-downloader tool. This plugin fills that gap: it lifts the media-detection logic out of the Chrome MV3 extension's browser sandbox into pure Node functions, exposed as three agent-callable tools.

特性 / Features

- video_analyze — 只做分析、不下载。返回 JSON：{ isMedia, site, quality, ext, mimeHint }。按 hostname 识别站点（bilibili / youtube / douyin / xiaohongshu / other）。
Pure analysis, no download — classify a URL's media-ness, site, quality, container and mime hint.
- video_download — 用浏览器风格 User-Agent + Referer 请求媒体 URL，fs.createWriteStream 流式写入磁盘（默认 ./downloads/），跟随重定向（最多 5 次），60 秒超时（并响应执行取消）。返回 { savedTo, bytes, quality, ext, elapsedMs }。
Stream a media URL to disk with redirect handling and a 60s timeout.
- video_quality_parse — 纯正则质量/扩展名分析：{ quality, ext }。无网络请求。
Pure regex quality + extension extraction, zero network access.

- 零构建步骤——纯 ESM，发布包即运行时代码。
Zero build step — pure ESM, the published package is the runtime code.
- 纯函数全部导出，可直接用于测试与二次开发。
The pure core (isMedia, getQuality, getExt, detectSite) is exported for testing.

安装 / Install

从 npm 安装 / from npm
dsh plugin --profile myprofile add dsh-video-downloader

从 GitHub 安装（锁定 commit 以保证供应链安全） / from GitHub (lock the commit)
dsh plugin --profile myprofile add github:yourname/dsh-video-downloader#

用法 / Usage

用自然语言让 agent 执行：

"分析这个页面里的媒体：https://www.bilibili.com/video/BV1xx411c7mD"
"把这几个链接的 1080P 视频下载到 ./downloads 目录"

The agent calls the tools with:

{ "url": "https://bilivideo.com/xxx.m4s" }                              // video_analyze
{ "url": "https://bilivideo.com/xxx.m4s", "outPath": "./downloads/clip.mp4" }  // video_download
{ "url": "https://example.com/video.mp4?height=720" }                   // video_quality_parse

video_download 也接受可选的 headers 对象合并到默认的浏览器请求头中。

video_download also accepts an optional headers object merged over the browser-like defaults.

工具参考 / Tool Reference

| 工具 / Tool | 参数 / Parameters | 返回 / Returns |
|---|---|---|
| video_analyze | url (string, 必填) | { isMedia, site, quality, ext, mimeHint } |
| video_download | url (string, 必填), outPath (string, 可选), headers (object, 可选) | { savedTo, bytes, quality, ext, elapsedMs } |
| video_quality_parse | url (string, 必填) | { quality, ext } |

开发 / Development

npm install
npm test          # node:test，只测纯函数，不发网络请求 / 仅纯函数，无网络请求

安全提示 / Safety Note

只下载你有权获取的内容。 本插件只负责媒体识别与文件流式保存，不绕过任何 DRM、登录墙或平台付费内容。请遵守各平台的服务条款与著作权法。

只下载你有权获取的内容。 本插件仅执行媒体检测与文件流式保存——它不会绕过任何 DRM、登录墙或付费内容。请遵守各平台的服务条款与著作权法。

许可 / License

MIT