前言¶
在 DeepSeek Harness (DSH) 的插件生態中，擴展宿主能力的主要方式是安裝社區插件。面對一門課程或一篇論文的資料，單純閱讀大綱和課件往往難以快速提煉出其設計邏輯——即“先教什麼、後教什麼”，以及每個環節“爲什麼放在那裏”和“環節之間如何銜接”。
dsh-course-logic-extractor 插件旨在解決這個問題。它讀取課程或論文的資料（大綱、講義、課件、PDF 等），通過算法還原其設計邏輯，最終交付一份自洽的邏輯鏈分析報告、學習路線圖以及流程畫布。這能幫助學習者在正式深入內容之前先看清全局。
安裝與啓用¶
安裝插件需要執行一條命令。安裝完成後，插件會自動將預設分發到本地。
- 執行安裝命令：
dsh plugin --profile web add github:ShadowBruceMeaningLau/dsh-course-logic-extractor
- 重啓
dsh web（或任何使用 agent presets 的界面）。 - 新建會話時，在預設選擇器裏選擇「課程邏輯提取器」即可使用。
核心功能¶
該插件提供了三種輸入模式，並內置了意圖識別和迭代確認機制。
三種輸入模式¶
- 直接分析：直接提供資料路徑，進行標準邏輯提取。
- 論文模式：雙視角分析，兼顧研究邏輯與學習邏輯。
- 自主找資料：當沒有資料時，按學習需求走迭代確認制流程。
入口分流（意圖理解）¶
插件會分析用戶的首條消息。根據消息內容自動分流：
* 給出資料路徑：走標準流程。
* 表達學習需求（任何表達“想獲得知識/技能/理解”的意圖都算）：走自主流程。
* 未提供任何信息：先介紹本 agent 的用法。
自主找資料（迭代確認制）¶
在無資料模式下，流程分爲兩個階段，每階段以用戶明確表態“完全確定”爲唯一齣口。
- 階段一：確定能力點清單
構建多層樹形結構。一級並列能力點下包含從屬子能力點。將過大能力點分解爲可學習、可檢驗的葉子節點，並標註前置/後置依賴與掌握標準。必須產出能力點依賴圖。 - 階段二：確定資料清單
先確認學習形態偏好（書籍自學/視頻爲主/AI 決定/其他）。
生成固定七列清單：覆蓋能力點、名稱、來源、鏈接/位置、形態、價值評估、狀態。
資料落地順序爲：本地優先 → 網絡下載 → 缺失由用戶決斷。
規劃內容留檔於0-規劃/目錄。
材料管線¶
當處理 PDF 等非文本資料時，插件會啓動以下管線：
1. PDF 渲染：使用內置 MuPDF（已打包，無需網絡安裝）將 PDF 渲染爲高清頁面圖。
2. OCR 轉錄：調用智譜 GLM-OCR 的 layout_parsing 接口進行轉錄。
3. 質量對賬：檢查缺失頁、空頁、公式配對等問題，生成質量報告。
4. 直出歸檔：合併轉錄內容，歸檔至交付目錄。
5. 優化稿（可選）：在直出後詢問用戶是否需要，生成便於 Obsidian 閱讀的優化版（與其他產出物無關）。
交付物¶
插件最終交付以下內容：
* 邏輯鏈分析：包含七節內容、frontmatter 和自檢報告。
* 學習路線圖：指導學習路徑。
* 流程圖畫布集：生成 Obsidian .canvas 文件，包括模塊地圖、學習路線圖等。
* 證據層與材料層：包含分塊七要素的證據提取文件和材料歸檔。
配置與注意事項¶
OCR 密鑰配置¶
轉錄功能依賴智譜 GLM-OCR，需要配置密鑰。若未配置，轉錄功能不可用，但不影響其他功能（如盤點、純文本分析）。
支持兩種配置方式：
1. 環境變量：ZHIPU_API_KEY。
2. 配置文件：在 ~/.dsh/free-vision.json 中增加字段 {"zhipuApiKey": "…"}。
本地修改保護¶
插件具有冪等性。如果目標位置已存在沒有 .dsh-plugin 標記的預設（例如你自己寫的版本），插件不會覆蓋它。只有插件自己安裝過的副本纔會在版本升級時更新。
可移植性¶
插件本體包含必要的依賴（如 node_modules/mupdf），無需網絡安裝步驟。整個預設通過相對路徑引用官方包，完全可移植。
目錄結構與交付物¶
插件目錄結構¶
插件安裝後，其本體包含以下結構：
* package.json：插件聲明。
* cordis.patch.yml：宿主行掛載配置。
* lib/index.js：宿主半邊，負責冪等落盤預設。
* preset/course-logic-extractor/：包含預設組合文件和技能目錄。
運行時交付目錄¶
運行時會在當前目錄下生成 課程邏輯交付/<課程名>/ 目錄，包含：
* 0-規劃/：能力點清單、依賴圖、資料清單。
* 1-報告/：邏輯鏈分析、學習路線圖、畫布集。
* 2-證據/：證據提取文件。
* 3-材料/：頁面渲染圖、轉錄稿、直出稿、質量報告。
