前言¶

在 DeepSeek Harness（DSH）裏讓模型「看懂」視頻，常見做法是直接接鏈接或抽幀 API：權限邊界模糊，B 站、YouTube 等站點一旦放開，往往連 cookie、上傳音頻一起進來。若你更關心「默認只讀本地、聯網通道必須人工放行、ASR 留在本機」，可以把視線放到社區插件 dsh-video-gate（維護者 PoiFlos，分類：聯網工具）。下面介紹它是什麼、能做什麼，以及如何在 Windows 上安裝與日常使用。

這是什麼¶

dsh-video-gate 是 DSH 的「視頻通道閥門」插件：默認只允許讀取本地文件；Bilibili 通道默認關閉，模型調用讀取工具前必須在彈窗或獨立窗口裏放行。YouTube、小紅書、Netflix 不在支持列表（README 說明前兩者需額外程序與 cookie，Netflix 涉及 DRM）。

平臺限定 Windows 10/11（依賴 install-deps.ps1、閥門界面爲 PowerShell / Python；macOS、Linux 未適配）。當前 package 版本 0.9.1，要求 Node >=20、DSH >=0.2.1-rc.2。

核心功能¶

通道與默認策略¶

本地工具鏈約定在工作區旁：tools\ffmpeg\ffmpeg.exe、tools\whisper\whisper-cli.exe 與 models\ggml-small.bin（來源與哈希見倉庫 docs/provenance-*.md）。允許訪問的本地根目錄寫在 %USERPROFILE%\.dsh\video-gate\state.json 的 localRoots，默認包含 <工作區> 與 %USERPROFILE%\Videos。

閥門與會話兩層開關¶

模型調用 video_read 時，插件按域名歸類通道。通道關閉時會彈出選項：只放行這一次、本會話放行、長期打開該通道（寫入 state.json）、保持關閉。用戶拒絕則工具返回錯誤，系統提示禁止換路子繞過；宿主無 userQuestions 服務時按關閉處理（fail-closed）。

與會話相關的另一層：每個會話需先發「啓用讀取視頻插件」 才允許讀取；未啓用時 video_read 直接返回「視頻插件還沒啓用」。發「關閉讀取視頻插件」可停用。/video 命令僅顯示狀態；改閥門走彈窗或獨立窗口。

雙擊 啓動閥門.cmd（或桌面快捷方式）可打開獨立小窗口，勾選通道即時寫入 state.json，插件每次讀取前重讀，無需重啓 DSH。窗口層管通道（持久），喚醒管本會話是否允許讀視頻（內存）；兩層都通過纔會真正讀取。

本地 ASR 與 B 站字幕¶

• 僅使用本地 whisper.cpp，音頻不出機器，無 API key、無上傳；單次最多處理前 15 分鐘（README 稱普通桌面 CPU 上約 7 分半視頻轉寫約 2–3 分鐘）。
• B 站匿名無法拿到音頻流（playurl 返回 0 條 audio），臺詞依賴平臺字幕；若需 ASR，需將視頻下載到本地走本地通道。
• 可選登錄：說「登錄 B 站」後將 SESSDATA 寫入 %USERPROFILE%\.dsh\video-gate\bilibili.cookie；插件不讀瀏覽器 cookie，只讀該文件，且域名限定在 bilibili 相關域。

B 站 AI 字幕在生成完成前可能返回其他視頻的字幕；0.9.0 起採用本地緩存、最多 8 次重試（間隔 400ms）及歸屬校驗（時長覆蓋、標題/UP 名關鍵詞至少命中 2 個），過不了則明確提示未取到，避免錯配臺詞。

安全與審計（代碼硬約束）¶

資料列出的約束包括：僅允許 http/https 公開 GET、無 POST；目標域名限定 B 站與本地文件；拒絕內網/迴環（SSRF）；子進程 argv 列表、帶超時；落盤僅在 cache/。狀態：state.json；審計：audit.jsonl；緩存：cache\。

安裝與啓用¶

安裝步驟以倉庫 README 爲準（需先取得倉庫目錄，再交給 DSH 的 bundle 安裝器）：

git clone https://github.com/PoiFlos/dsh-video-gate.git
plugin_manager action=install_bundle target=<克隆路徑>

ffmpeg（約 84MB）、whisper（約 11MB）、模型（約 465MB）不隨倉庫分發。先查看計劃與哈希，再下載：

powershell -ExecutionPolicy Bypass -File <克隆路徑>\install-deps.ps1 -Plan
powershell -ExecutionPolicy Bypass -File <克隆路徑>\install-deps.ps1

依賴裝到 <克隆路徑>\..\tools\，不裝服務、不改 PATH、一般不需要管理員。更細的下載、localRoots 配置與故障排查見倉庫 docs/安裝與使用.md；若交給 Agent 自動安裝，可讀 AGENTS.md。

卸載：

plugin_manager action=remove_bundle target=dsh-video-gate

典型用法¶

1. 完成安裝與依賴後，在 DSH 會話中發送：「啓用讀取視頻插件」。
2. 若需讀 B 站鏈接，先在彈窗或 啓動閥門.cmd 窗口中打開 Bilibili 通道（或按需選擇「只放行這一次」等）。
3. 向模型發送本地路徑或 B 站鏈接；本地視頻可在工具參數中使用 transcribe: true 觸發 whisper 轉寫。
4. 需要 B 站 AI 字幕時，按文檔配置登錄態文件；用完後可在閥門窗口「退出登錄」或按提示清理。

可選：運行 安裝托盤支持.cmd 將 pystray + Pillow 裝入 gui/_vendor，關閥門窗口時可縮到托盤（托盤點擊行爲 README 標註爲未人工驗證）。

適用場景與注意¶

適合：在 Windows 上用 DSH 分析本地教程、錄屏，或在明確放行後讀取 B 站公開信息與字幕，且希望聯網範圍與 ASR 儘量留在本機、可審計的場景。

務必注意：

• 插件以當前 DSH 進程權限運行；安裝前請自行審閱源碼與 MIT 許可（tools/ 內第三方二進制另有許可，如 ffmpeg GPL）。
• 僅 Windows 10/11 有完整路徑；其他系統勿按本文命令照搬。
• 社區目錄 SkillHub 插件頁 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；星標等元數據以頁面爲準（資料抓取時爲 1 star）。

結尾¶

dsh-video-gate 把「能不能讀視頻」拆成本地默認開放、B 站默認關閉、會話需喚醒、放行可審計幾層，並把抽幀與 whisper 轉寫綁在工作區工具鏈上。若你的 harness 工作流需要這種閥門式視頻通道，可從目錄頁與倉庫 README 繼續跟進版本與 provenance 文檔。

• 目錄頁：https://www.skillhub.cn/plugins/PoiFlos/dsh-video-gate
• GitHub：https://github.com/PoiFlos/dsh-video-gate