前言¶
在 DeepSeek Harness（DSH）裏做面向學生的教學輸出時，常見做法是臨時拼大綱、分段寫 Markdown，再手工排版進 Word 或另找工具轉 PDF。章節結構、學習目標、習題分層和交付前檢查往往分散在多輪對話裏，難以複用。
Course Handout Studio（倉庫 Nounoumm/course-handout-studio）是維護者 Nounoumm 發佈的 Harness 本地插件包，定位爲面向學生的模塊化課程講義生成器：從主題出發生成「模塊—章—節」骨架，補全例題、易錯點與分層習題，經檢查後一鍵產出 DOCX，並通過 Host 的 officeToPdf 得到 PDF。插件在 SkillHub 分類爲「模型推理」；GitHub 當前星標數爲 1。
這是什麼¶
- 名稱：課程講義工坊 · Course Handout Studio（插件包名
@local/course-handout，版本1.0.0） - 維護者：Nounoumm
- 許可證：MIT
- 解決的問題：把「教學設計 + 內容編寫 + 規格校驗 + 文檔交付」收口到一套工具與技能
course-handout，輸出默認可寫到工作區下的handouts目錄
實現上，Node 側 index.js 註冊工具與技能；Python 側 builder/handout_builder.py 負責 DOCX 渲染、Markdown 解析與規格檢查，依賴運行時自帶的 python-docx。PDF 不依賴系統 LibreOffice，由 Harness 的 officeToPdf 在內存中轉換。
核心功能¶
下面按 README 中的工具表說明各能力。
| 工具 | 作用 |
|---|---|
handout_templates |
列出四種模板：標準教材型、考前複習型、項目驅動型、雙語對照型 |
handout_scaffold |
按主題生成模塊—章—節骨架（JSON），含學習目標、小節佔位、習題框架 |
handout_check |
檢查結構、空小節、篇幅、學習目標與小結、習題與答案數量 |
handout_build |
渲染 DOCX，並調用 Harness 的 officeToPdf 轉成 PDF |
同時註冊技能 course-handout，固化章節設計、知識點清單、視頻素材結合方式、習題設計規範與交付前檢查。
教學設計約定（技能側）包括：
- 結構：2–4 個模塊，每模塊 2–4 章，每章 2–6 節；避免「第 0 章」「雜項」式分章。
- 雙螺旋寫法：問題引入 → 嚴格定義 → 解釋「爲什麼」 → 例題 → 易錯點 → 小結。
- 知識點清單：術語中英對照、符號與適用條件、方法步驟、例題、反例、章末小結、分層習題與答案。
- 視頻素材：可按需檢索公開課程大綱（如中國大學 MOOC、學堂在線、B 站、MIT OCW、Khan Academy 等），只借鑑章節順序，附錄給出真實鏈接，不復制受版權保護內容。
- 習題：基礎 / 提高 / 挑戰三層，答案寫出關鍵步驟。
安裝與運行環境¶
官方 README 要求先把倉庫放到本機，再在 Harness 會話裏安裝本地 bundle。安裝後無需重啓，工具與技能會出現在當前 profile。
plugin_manager install_bundle
target: <本倉庫的絕對路徑>
Python：插件依次檢查 DSH_PYTHON、$DSH_HOME/dsh-runtimes/*/dependencies/python、安裝目錄下的 resources/runtime/*/dependencies/python，最後回退到 PATH 上的 python3 / python。Harness 自帶運行時即可。
PDF：通過 Host 的 officeToPdf 服務轉換。
輸出目錄：默認 <工作區>/handouts；handout_build 可用參數 output_dir 覆蓋。
插件以當前 DSH 進程權限運行；安裝前應自行查看倉庫源碼與 MIT 許可證，確認是否符合你的環境與安全要求。
典型用法¶
對話式生成¶
在會話裏直接說明受衆、主題、模板與習題層次，例如：
幫我給高一學生做一份「牛頓運動定律」的講義，標準教材型，8 章，帶基礎和提高到。
助手會先確認關鍵信息，再生成 handouts/*.json、補全內容、檢查併產出 DOCX 與 PDF。
用示例規格直接構建¶
倉庫提供完整示例 examples/c-pointer-demo.json（4 章 8 節 15 題），可先檢查再構建：
handout_check spec_path: examples/c-pointer-demo.json
handout_build spec_path: examples/c-pointer-demo.json
規格文件（JSON）¶
講義由 JSON 描述，正文使用輕量 Markdown。完整字段與寫作規範見倉庫內 skills/course-handout.md。最小結構示例：
{
"schema": "course-handout/1",
"meta": { "title": "示例講義", "audience": "初學者" },
"modules": [
{
"title": "第一部分 基礎",
"chapters": [
{
"title": "第 1 章 開始",
"objectives": ["目標一", "目標二"],
"sections": [{ "title": "1.1 引入", "body": "正文……" }],
"summary": ["小結一", "小結二"],
"exercises": { "basic": ["練習題"] },
"answers": ["參考答案"]
}
]
}
]
}
適用場景與注意¶
適合誰：需要在 DSH 裏穩定產出學生向講義、並希望 DOCX/PDF 一併交付的教師、助教或做教育類智能體工作流的開發者。
不適合或需自備環節：插件不負責替代你對版權與素材合規的最終判斷；視頻素材僅借鑑公開大綱順序並附鏈接，不復制受保護內容。Node 側不引入第三方 npm 依賴，能力邊界清晰，複雜排版仍以 python-docx 與生成的 OOXML 爲準。
生態說明：DSH 奉行「一切皆插件」；SkillHub（skillhub.cn）爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係。本插件目錄頁與源碼以下面鏈接爲準。
結尾¶
Course Handout Studio 把講義從「臨時文稿」收成可校驗的 JSON 規格，再通過 handout_build 落到 DOCX 與 PDF，適合在 Harness 會話裏做系統化教學交付。查閱介紹與安裝說明可打開 SkillHub 目錄頁與 GitHub 倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/Nounoumm/course-handout-studio
- GitHub：https://github.com/Nounoumm/course-handout-studio
