前言¶
在 DeepSeek Harness（DSH）裏做工作流時，常見需求是：用戶一邊在瀏覽器裏看課程，一邊希望 Agent 能持續感知「當前在看什麼」，並把零散觀看記錄整理成可檢索、可導出的學習材料。手工記標題、再自己去 B 站補簡介和字幕，成本高，也很難按學科歸檔。
下面介紹的插件面向 Windows 桌面場景：定時讀取前臺瀏覽器或視頻客戶端窗口標題，用 LLM 判斷是否有知識含量並按學科分類，再儘量從 B 站拉取簡介、字幕、彈幕與評論做總結，最終生成分學科的 Word 學習手冊和帶 Mermaid 思維導圖的總覽文檔。
這是什麼¶
dsh-video-coursemap 是社區維護的 DSH 插件（維護者 linner1224），在 SkillHub 插件目錄 中歸類爲「工作流」。一句話定位：視頻課程知識地圖 Agent——觀察前臺播放、識別課程、按學科歸檔並輸出 Markdown + Mermaid 知識地圖與 Word 學習手冊。
源碼與說明見 GitHub：linner1224/dsh-video-coursemap。插件以 MIT 許可證發佈；安裝前建議自行審閱源碼與許可證。插件在 DSH 進程權限下運行，涉及窗口讀取與網絡抓取，部署環境需與此匹配。
核心功能¶
資料中明確的能力如下。
- 前臺窗口輪詢：默認每 15 秒輪詢一次前臺窗口（瀏覽器或視頻客戶端），識別視頻標題並剝離平臺後綴。
- 內容與學科判定：由 LLM 判斷是否爲「有知識含量」的內容（課程、教程、科普、紀錄片、測評、知識分享等），並按學科分類。
- B 站內容補充：按標題反查 B 站視頻，抓取簡介、字幕、彈幕、評論用於總結；失敗時自動降級爲僅使用標題。
- 文檔輸出：每個學科生成
學習手冊.docx；根目錄生成課程總覽.docx（含 Markdown 與 Mermaid 思維導圖）；內部狀態與 Markdown 源保存在.state/。 - Agent 工具：提供
course_map_status與course_map_scan兩個工具，供 Harness 內查詢狀態或觸發掃描類操作（具體參數以實現爲準，見倉庫文檔）。
當前版本在 package.json 中爲 0.2.0。
安裝與啓用¶
在已配置 DSH 桌面 profile 的環境中，使用 README 給出的安裝命令（勿自行拼接其他形式的 dsh plugin add）：
dsh plugin --profile desktop add github:linner1224/dsh-video-coursemap
安裝後可在插件配置中啓用並調整輪詢與輸出目錄。示例配置如下：
- id: dsh-video-coursemap
name: dsh-video-coursemap
config:
enabled: true
pollIntervalMs: 15000
stablePolls: 2
fetchContent: true
outputDir: null # null → <用戶目錄>/課程知識地圖
說明各字段含義：
pollIntervalMs：輪詢間隔，默認 15000 毫秒。stablePolls：標題穩定判定所需的連續輪詢次數，默認 2。fetchContent：是否嘗試抓取 B 站簡介、字幕等；關閉則更多依賴標題。outputDir：輸出根目錄；爲null時使用用戶目錄下的「課程知識地圖」文件夾。
典型用法與輸出結構¶
啓用插件並保持目標瀏覽器或視頻客戶端處於前臺後，插件會在後臺按間隔識別當前視頻並累積分類結果。經過上面的步驟，可在配置指定的輸出目錄（或默認 <用戶目錄>/課程知識地圖）查看產物：
<outputDir>/<學科>/學習手冊.docx：該學科下的分冊手冊。<outputDir>/課程總覽.docx：全部學科的總覽。<outputDir>/.state/：內部狀態與 Markdown 源文件，便於排查或二次處理。
在 Agent 對話中，可調用 course_map_status 瞭解當前映射狀態，或通過 course_map_scan 配合工作流做掃描（以倉庫 README 與實現爲準）。
適用場景與限制¶
適合誰
- 主要在 Windows 上通過瀏覽器或客戶端前臺看 B 站等平臺課程，希望自動按學科沉澱 Word 手冊與思維導圖總覽的 DSH 用戶。
- 希望把「觀看行爲」接入 Harness 工作流，而不是每次手動複製標題的用戶。
務必注意的限制（來自官方 README）
- 僅支持 Windows：前臺窗口讀取依賴 PowerShell 與
user32.dll，其他系統無法使用同一機制。 - 必須前臺播放：只有當前前臺窗口是瀏覽器或視頻客戶端時纔會識別；後臺或最小化播放無法檢測。
- B 站相關：B 站 AI 總結接口需登錄，文檔標明暫不可用；評論匿名接口封頂 3 條，總結深度可能受限於抓取結果。
DSH 生態理念是「一切皆插件」；SkillHub 爲社區目錄站點，與 DeepSeek、幻方無官方從屬關係，本文僅作插件能力說明，不構成官方背書。
結尾¶
dsh-video-coursemap 把「前臺正在看的視頻課」變成按學科歸檔的 Word 手冊與 Mermaid 知識地圖總覽，並暴露 Agent 工具供工作流查詢與掃描。若你的場景符合 Windows 前臺觀看與 B 站補充資料這兩條前提，可按上文命令安裝並在啓用前核對源碼與配置。
