前言¶
用 Agent 處理長視頻時，常見做法是手動複製鏈接、再單獨跑字幕或轉寫腳本，最後自己排版成筆記。步驟分散，平臺和登錄方式也不統一。DeepSeek Harness（DSH）支持通過插件把 skill 註冊進運行時；dsh-video-notes 把上游 skill bilibili-douyin-notes 打成 DSH 組合包，裝好後在對話裏給出視頻鏈接即可走同一套流程：抓字幕或本地語音識別、截取重點畫面、按模板輸出 .md，且不依賴付費 API。
下面介紹插件定位、能力與安裝用法；功能細節與各平臺說明以上游倉庫爲準。
這是什麼¶
dsh-video-notes 是維護者 lucky-Luor 發佈的 DSH 插件（當前 package 版本 0.1.0，MIT 許可）。它解決的是：在已運行的 DSH 裏，把 B 站、抖音、YouTube、小紅書等鏈接轉成結構化 Markdown 課堂筆記，免登錄可用（部分平臺可選配置憑據以提升成功率）。
插件本體是外殼：啓動時讀取包內 skill/bilibili-douyin-notes/SKILL.md，通過 DSH 官方的 ctx.skills.register() 註冊 skill，並帶上 skill 目錄作爲 resourceBase，供模型拼出 scripts/*.py 等真實路徑。實現只使用 Node 內置模塊，無 @deepseek-ai/* 依賴、無構建步驟，從 GitHub 安裝時一般不需要給 allowBuilds 授權。
核心功能¶
依據 README 與 package 描述，已覈實能力包括：
- 多平臺：B 站、抖音、YouTube、小紅書視頻鏈接。
- 字幕與語音：字幕抓取；本地語音識別（ASR，requirements 中與 Whisper 等相關依賴見 skill 內註釋）。
- 筆記產出：重點截圖、筆記模板、質量門禁，輸出課堂筆記 Markdown。
- 使用成本：README 寫明免登錄可用、不調任何付費 API。
- 上游關係：業務邏輯與模板在上游 bilibili-douyin-notes；本倉庫含同步副本，
skill.lock.json記錄對應上游 commit。請勿直接改skill/下文件，應改上游再同步。
YouTube 場景 README 建議另外安裝 deno（yt-dlp 解 JS 挑戰需要）。抖音簽名腳本 scripts/abogus.py（GPLv3）不隨包分發，由 ensure_abogus.py 在首次使用時按需下載。
安裝與啓用¶
前置條件：Node.js ≥ 20、Python ≥ 3.10、本機已能運行 DSH（npx @deepseek-ai/dsh）。
1、把插件裝進 DSH 的 web profile（其他 profile 將 web 換成對應名稱）：
npx -y @deepseek-ai/dsh plugin --profile web add github:lucky-Luor/dsh-video-notes
需要鎖定版本時：
npx -y @deepseek-ai/dsh plugin --profile web add github:lucky-Luor/dsh-video-notes#<tag 或 commit>
2、安裝 Python 依賴（各平臺所需依賴見 requirements 文件內註釋）：
pip install -r https://raw.githubusercontent.com/lucky-Luor/dsh-video-notes/main/skill/bilibili-douyin-notes/requirements.txt
3、重啓 profile 使插件生效：
npx -y @deepseek-ai/dsh web
確認已加載：執行 npx -y @deepseek-ai/dsh --profile web --dump-config，輸出中應能看到 dsh-video-notes 這一層。
卸載：
npx -y @deepseek-ai/dsh plugin --profile web remove dsh-video-notes
配置與憑據¶
skill 的配置文件 config.json（B 站 SESSDATA、小紅書 cookie、ASR 參數等，字段見 config.example.json）位於 skill 目錄，一般是 Agent 加載 skill 時給出的 Base directory，典型路徑爲：
$DSH_HOME/profiles/<profile>/node_modules/dsh-video-notes/skill/bilibili-douyin-notes/
（$DSH_HOME 默認爲 ~/.dsh。）
B 站掃碼登錄寫入同一目錄：
python "<skill目錄>/scripts/bili_fetch.py" --login
已知限制：該目錄在 profile 的 node_modules 內，插件升級、重裝或卸載後 config.json 會丟失。升級前請備份 config.json，升級後放回原處，或重新 --login 與填寫配置。config.json 含登錄憑據，請勿分享。
典型用法¶
裝好後，在 DSH 裏對 Agent 說明意圖並附上鍊接即可，README 示例爲：
幫我把這個視頻做成課堂筆記：https://www.bilibili.com/video/BVxxxx
Agent 會按 skill 流程抓字幕或語音識別、截取重點畫面並生成課堂筆記 .md。筆記樣式與各平臺差異見上游倉庫文檔。
適用場景與注意¶
適合誰：已在用 DSH、希望用自然語言驅動「視頻 → Markdown 課堂筆記」的開發者或內容整理者；需要本地 Python 環境與可選平臺憑據。
運行與信任：插件與 skill 腳本以當前 DSH 進程權限在本機執行，會訪問網絡抓取視頻與字幕、讀寫配置與輸出文件。安裝前請閱讀 GitHub 倉庫 與上游 skill 源碼及許可證（插件 MIT；部分組件另有許可說明）。
生態說明：DSH 社區插件目錄託管於獨立站點 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
結尾¶
dsh-video-notes 把多平臺視頻筆記 skill 接入 DSH：一句對話加鏈接，走字幕/ASR 與模板化輸出，避免單獨維護多套腳本。目錄頁：https://www.skillhub.cn/plugins/lucky-Luor/dsh-video-notes；源碼與安裝說明：https://github.com/lucky-Luor/dsh-video-notes。
