前言¶
在 DSH 裏做短視頻內容管線時，常見做法是分散腳本：單獨抓鏈接、單獨調 ffmpeg、再換一套 ASR 與導出格式。鏈接形態多（單條、分享文案、作者主頁、sec_uid），平臺側還有登錄與分頁限制，轉寫引擎又在本地與雲之間切換。下面介紹社區插件 dsh-shortvideo-export（維護者 hangyesite，分類：聯網工具），它把抓取、無水印下載、轉寫、可選術語校對和多格式導出收進一個 DSH 插件，並自帶 Web 面板與 Agent 工具。
這是什麼¶
dsh-shortvideo-export 是 DeepSeek Harness（DSH）插件：註冊 Agent 工具、Skill、確認動作卡片、定時同步入口和帶任務進度的 Web 面板；重計算由內置 Python 引擎完成。package.json 版本爲 0.1.4，許可證 MIT。
它面向抖音與小紅書：下載無水印 MP4，用本地或雲端語音識別生成文稿，可選用聊天模型做術語級校對（不改寫全文、不動時間軸），並導出 Markdown（含 YAML front-matter）、TXT、SRT、VTT、JSON、HTML、DOCX；支持每條視頻單獨文件，或按時間合併合集。
核心功能¶
抓取與下載¶
- Fetch：支持粘貼視頻鏈接、視頻 ID、分享文案、主頁鏈接或原始
sec_uid；作者列表支持增量同步，遇到已收錄視頻即停止。 - Download：保存無水印 MP4（優先更高碼率變體，經 ffprobe 校驗），並提取 16 kHz 單聲道 WAV 供轉寫。
轉寫¶
提供多種可互換引擎（兩個本地、多個雲端；小紅書還可讀平臺自帶中文字幕軌）。任務可逐條或批量執行，面板與後臺任務可查看進度；支持連續失敗熔斷、無語音檢測（靜音視頻跳過而非整批失敗）。
| Engine id | 運行位置 | 時間戳粒度 | 主要依賴 |
|---|---|---|---|
sensevoice |
本地 CPU（int8） | 句級（ffmpeg 靜音檢測） | 需下載 bundled 模型 |
faster-whisper |
本地 CPU/GPU | 詞級 | faster-whisper 與模型 |
openai |
OpenAI 兼容 /audio/transcriptions |
依服務商 | base URL、key、model |
dashscope |
阿里雲百鍊 | 詞級 | API key |
volc |
火山引擎豆包 ASR | 句級 | API key；公開音頻 URL 或 TOS |
official |
小紅書筆記字幕軌 | 句級 | pip install xhshow、小紅書登錄；僅小紅書 |
official 與平臺綁定：輸入無小紅書鏈接或混有抖音時，面板會拒絕創建任務，API 返回 engine_platform_mismatch。
校對與導出¶
- Proofread（可選）：用聊天模型從樣本挖掘
wrong → right術語表，人工確認後做確定性替換；支持wrong => right || the sentence處理同音誤識別。配置在polish.*，與 ASR 分離。 - Export：按任務目錄輸出；可選合併合集（MD/TXT/HTML/DOCX），默認較新條目在前。
任務、面板與登錄¶
每次運行有獨立目錄結構（video/、audio/、transcript/、export/<format>/、export/合集/）及階段表（download / transcribe / export）。
面板側欄入口含：New task、Tasks、Library、Proofread、Login、Settings。Login 頁按平臺分卡（當前爲抖音、小紅書），各自 QR 登錄狀態；README 註明多數下載可不登錄，但抖音作者作品超過約 18 條、需翻頁時通常需要已登錄會話。
環境與依賴¶
| 需求 | 說明 |
|---|---|
| DSH | 較新版本；使用 ctx.tools、ctx.slots、ctx.skills、actionCards、schedule |
| Python | 3.10+，PATH 上爲 python（或 SV_PYTHON / 配置項 python） |
| ffmpeg | ffmpeg + ffprobe，或 media.ffmpegPath |
| 瀏覽器 | 系統 Chrome 或 Edge；Playwright 驅動抖音元數據抓取 |
| 雲端密鑰 | 僅在選擇雲端引擎時需要；本地 SenseVoice 無需賬號 |
首次使用某引擎時，Python 依賴按需安裝（未打入插件包）：
python -m pip install playwright sherpa-onnx faster-whisper python-docx
python -m playwright install chromium # 僅在沒有 Chrome/Edge 時
安裝與啓用¶
README 給出的安裝方式爲：
dsh plugin add https://github.com/<owner>/shortvideo-export
將 <owner> 換爲倉庫所屬用戶後執行；也可在 DSH Plugin Manager → install bundle 指向插件目錄。社區目錄頁：https://www.skillhub.cn/plugins/hangyesite/dsh-shortvideo-export；源碼倉庫：https://github.com/hangyesite/dsh-shortvideo-export。
插件在 當前 DSH 進程權限 下運行，會驅動本機瀏覽器、讀寫配置與輸出目錄。安裝前請自行查看源碼與 MIT 許可證，並評估本機路徑與密鑰存放方式。
首次使用建議¶
- 打開 Settings & Login，如需預熱 Cookie 可在 Warm up / Login 掃碼；配置持久化，但多數下載不強制登錄。
- 若用本地
sensevoice：在 Settings → Download model 下載 SenseVoiceint8（約 228 MB），或設置asr.sensevoice.modelDir。 - 在 Tasks → New task 粘貼鏈接，選擇僅下載或下載 + 轉寫 + 導出。
配置默認目錄爲 ~/.dsh-shortvideo/config.json（可用 SV_HOME 覆蓋）；默認輸出根目錄 outputDir 爲 ~/DouyinExport。Douyin 相關瀏覽器項建議保持 browser.headless 爲 false（README 說明無頭模式下頁面簽名易失敗）。
Agent 工具一覽¶
長任務返回 job id 並在後臺繼續；面板展示進度，Agent 側可用 sv_job 查詢。
| 工具 | 用途 |
|---|---|
sv_run |
一次完成 fetch → download → transcribe → export |
sv_sync |
同步作者視頻列表（默認增量，full 全量） |
sv_download |
按 ID 或作者下載無水印視頻 |
sv_transcribe |
對已下載視頻轉寫 |
sv_export |
導出文稿與可選合集 |
sv_polish |
術語挖掘、確認、應用與重置 |
sv_failures |
按類別說明失敗與重試建議 |
sv_library |
庫統計與列表 |
sv_settings |
讀寫設置、列出引擎 |
sv_login |
打開瀏覽器一次性掃碼登錄 |
sv_job |
列出 / 查看 / 取消後臺任務 |
sv_subscribe |
註冊定時增量同步（DSH scheduled task） |
也可通過 python -m shortvideo settings 讀寫配置（與 sv_settings 一致）。
適用場景與注意¶
適合：需要在 DSH 工作流或 Agent 對話中批量處理抖音 / 小紅書鏈接，並統一產出字幕與 Markdown 歸檔的開發者；希望本地 SenseVoice 或 faster-whisper 與雲端 ASR 按任務切換、且導出格式齊全的場景。
注意：
- 雲引擎需自備密鑰與合規使用；
volc等對音頻 URL 或 TOS 有額外要求。 - 小紅書
official引擎僅適用於小紅書任務，勿與抖音混批。 - 作者主頁深分頁受平臺登錄策略影響（如抖音匿名僅約 18 條可見），屬平臺限制而非插件上限。
- DSH 生態奉行「一切皆插件」；SkillHub 目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-shortvideo-export 把短視頻抓取、無水印下載、多引擎轉寫、可選術語校對和多格式導出封裝爲 DSH 原生能力，適合作爲個人或團隊的內容入庫前置步驟。進一步細節以倉庫 README（含中文版 README.zh-CN.md）爲準。
