前言¶
DeepSeek Harness（DSH）通過插件擴展智能體能力。dsh-video-downloader 面向一個具體場景：當 agent 拿到一個視頻或音頻 URL 時，需要先判斷它是不是媒體、屬於哪個站點、質量如何，再把文件保存到本地。
下面介紹這個插件提供哪些工具、如何安裝，以及使用時需要注意的邊界。
定位¶
dsh-video-downloader 是 DSH 媒體下載插件，包名爲 dsh-video-downloader，由 zimai233 維護，許可證爲 MIT。
它按 hostname 識別 Bilibili、YouTube、Douyin、Xiaohongshu 等站點的媒體 URL，並向 agent 暴露三個工具：
video_analyze：只做分析，不下載。video_download：把媒體 URL 流式保存到磁盤。video_quality_parse：用正則解析質量與擴展名，不髮網絡請求。
實現上，它是純 ESM 包，零構建步驟，發佈包即運行時代碼。核心判斷邏輯導出爲 isMedia、getQuality、getExt、detectSite 等純函數，可用於測試與二次開發。
核心工具¶
video_analyze¶
video_analyze 只分析 URL，不下載文件。它返回：
{ "isMedia": true, "site": "bilibili", "quality": "1080P", "ext": "m4s", "mimeHint": "video/mp4" }
字段包括：
isMediasitequalityextmimeHint
參數示例：
{ "url": "https://bilivideo.com/xxx.m4s" }
video_download¶
video_download 用瀏覽器風格請求頭請求媒體 URL，並把響應流寫入磁盤。默認寫入路徑爲：
./downloads/<sanitized-filename>
它支持可選的 outPath 參數，也支持可選的 headers 對象；headers 會合併到默認的瀏覽器請求頭中。
下載行爲：
- 流式寫入本地文件。
- 跟隨重定向最多
5次。 60秒超時。- 響應執行取消。
返回字段包括：
{ "savedTo": "./downloads/clip.mp4", "bytes": 1048576, "quality": "1080P", "ext": "mp4", "elapsedMs": 1500 }
參數示例：
{ "url": "https://bilivideo.com/xxx.m4s", "outPath": "./downloads/clip.mp4" }
如果需要自定義請求頭，可以在參數裏傳入 headers 對象。
video_quality_parse¶
video_quality_parse 只做本地正則解析，不發起網絡請求。它返回：
{ "quality": "720P", "ext": "mp4" }
參數示例：
{ "url": "https://example.com/video.mp4?height=720" }
安裝與啓用¶
下面介紹安裝步驟。先確認要使用的 DSH profile，再執行插件安裝命令：
dsh plugin --profile myprofile add dsh-video-downloader
經過上面的步驟後，插件會加入對應 profile。安裝前建議檢查 GitHub 倉庫中的源碼、README.md 和 MIT 許可證；啓用後，插件以當前 dsh 進程權限運行，因此需要由使用者自行確認來源可信。
典型用法¶
可以直接用自然語言讓 agent 執行任務，例如：
分析這個頁面裏的媒體：https://www.bilibili.com/video/BV1xx411c7mD
把這幾個鏈接的 1080P 視頻下載到 ./downloads 目錄
agent 在執行時可能會調用下面這些工具參數。
分析媒體：
{ "url": "https://bilivideo.com/xxx.m4s" }
下載到指定路徑：
{ "url": "https://bilivideo.com/xxx.m4s", "outPath": "./downloads/clip.mp4" }
解析質量與擴展名：
{ "url": "https://example.com/video.mp4?height=720" }
適用場景與注意¶
適合的場景包括：
- 讓 agent 判斷一個 URL 是否爲媒體文件。
- 識別 Bilibili、YouTube、Douyin、Xiaohongshu 等站點。
- 解析媒體質量、擴展名和 MIME 提示。
- 把可訪問的媒體文件流式保存到本地目錄。
不適合的場景包括：
- 繞過 DRM。
- 繞過登錄牆。
- 獲取平臺付費內容。
- 需要平臺私有接口鑑權的複雜抓取。
安全邊界要寫清楚：只下載你有權獲取的內容。這個插件負責媒體識別和文件流式保存，不負責破解版權保護、登錄驗證或付費牆。使用時應遵守各平臺服務條款與著作權法。
獲取¶
GitHub 倉庫：
https://github.com/zimai233/dsh-video-downloader
許可證：
MIT
