前言¶
在 DeepSeek Harness（DSH）裏用智能體寫講義、課件或教案，常見問題是：結論沒有綁到一手來源、頁與頁之間口徑不一致、導出物難以復現。手工在對話裏拼 Markdown，也很難系統化做版權審計和門禁檢查。
下面介紹社區插件 dsh-teaching-material-workbench（維護者 Golden2002，分類：工作流）。它在案例目錄裏搭腳手架、登記來源與主張、跑分層門禁，並提供 Web 端「教學物料」工作臺，把「有證據的教學物料生產」收成一套可重複的流程。核心與學科、學段、場景無關；學科內容只放在你指定的案例目錄中。
這是什麼¶
一句話：Evidence-gated（證據門禁）教學物料生產插件——建立案例、綁定一手材料、跑 E1/E2/E3 三層門禁、審計版權、記錄產物 SHA-256，並支持逐頁編輯與多格式導出。
- 倉庫：Golden2002/dsh-teaching-material-workbench
- 社區目錄頁：skillhub.cn 插件頁
- 當前包版本（
package.json）：0.6.0 - 許可證：MIT
- 運行時技能名：
teaching-material-workbench（教智能體工作流與證據規則）
插件以 Host-only bundle 形式發佈，聲明 engines.dsh >= 0.2.2-rc.1、node >= 20，無 install 腳本、無構建步驟、無運行時 npm 依賴，且不做網絡請求；案例數據留在你選擇的目錄裏。
核心能力¶
智能體工具（Tools）¶
| 工具 | 作用 |
|---|---|
teaching_material_init |
創建案例腳手架：情境畫像、課時數據、來源/主張登記表、對齊、量規、時間軸、術語表、誤區、調色板、教師包、校驗模板等 |
teaching_material_gate |
運行 E1（自洽）、E2（外部標準）、E3（實證）門禁，寫出 gate-report.md |
teaching_material_ground |
主張級接地審計：每條主張需有來源與 locator；未支撐主張失敗；教師包需 [Sxx] 標記；寫 verification/grounding-report.md |
teaching_material_outline |
從案例數據確定性生成逐頁 Markdown 大綱，寫 build/outline.md |
teaching_material_pages |
讀/寫/保存頁模型 pages.json；保存會重建大綱並寫入 .history/ |
teaching_material_export |
導出講義、課件、分鏡、逐頁 Manim 腳本；本機有 python-docx/python-pptx 時可導出 DOCX/PPTX，缺依賴時在報告中說明，不僞造 |
teaching_language_check |
按 PAEG 教學語言規則檢查文本或 language.md，返回違例位置與機械替換預覽 |
teaching_material_audit |
審計來源登記與版權，寫 verification/rights-report.md |
teaching_material_repro |
對 build 產物做 SHA-256，寫 verification/repro.json |
teaching_material_standards |
返回外部標準登記表及 verified / partial / not-obtained 狀態 |
Web UI「教學物料」頁籤¶
安裝 bundle 並刷新 Web 後，對話視圖旁會出現 教學物料 頁籤，僅讀寫你傳入的案例目錄內允許的文本文件；預覽爲近似預覽，版式以導出文件爲準。
主要能力包括：
- 逐頁：按時間軸編輯頁草稿；中間欄改標題、時長、要點、講義、講稿與來源編號；右側 16:9 課件卡與講義卡；未接地句子可補
[Sxx]；圖示可走figures.json或assets/。 - 新建案例：嚮導填寫標題、學科、學段、學習者、場景、時長、評估、來源與時間軸。
- 來源：以卡片編輯
sources.csv，區分已覈驗一手、未覈驗、受限。 - 導出：生成
build/handout.md、deck.md、storyboard.md、script.md、subtitles.srt與animations/Scene*.py；條件允許時同時生成 DOCX/PPTX。 - 檢查中心：聚合門禁三態、語言違例、claims 接地與來源審計。
- 版本回退：基於
.history/恢復或與當前pages.json並排對比。
門禁分層¶
| 層級 | 含義 | 示例 |
|---|---|---|
| E1 | 自洽：結構、算術、跨文件引用 | schema、時間軸合計、量規總分、來源 id 存在性 |
| E2 | 外部標準與文檔 | 來源登記規則、考綱、WCAG 2.2、GB/T 15834、許可條款 |
| E3 | 外部實證 | 獨立同行評議、學習者試點數據 |
每條檢查帶層級與依據；skip 表示未運行，不計爲通過。空試點模板會導致門禁失敗；有試點數據但沒有書面試驗設計也會失敗。
中文教學文本的語言檢查依賴上游 paeg-teaching-language-skill（MIT）；可枚舉問題（禁用措辭、標點、數字格式、人稱等）由工具覆蓋，修辭與術語仍須人工審閱。
安裝與啓用¶
插件是 Host-only bundle，不要手工改 profile 文件。
從本機包目錄安裝（Web UI：Plugins → Install，指向包目錄；或在 agent 會話中）：
plugin_manager action=install_bundle target=<absolute package directory>
CLI 等價形式：
dsh plugin --profile <name> add <absolute package directory>
從公開倉庫按 commit 固定安裝：
plugin_manager action=install_bundle target=git+https://github.com/Golden2002/dsh-teaching-material-workbench.git#7b805288da07a1985157948f35feb940179bb384
運行環境要求：帶 Host tools 服務的 DeepSeek Harness（當前 profile）、Node.js ≥ 20。DOCX/PPTX 導出爲可選項，依賴宿主機 Python 與 python-docx/python-pptx。
安裝前建議在倉庫中自行查閱源碼與 LICENSE；插件以當前 DSH 進程權限運行，只應在你信任的環境中安裝。
典型用法¶
README 給出的 Quick start 可概括爲以下順序。
1、初始化案例
在 agent 中調用（路徑與字段按你的環境填寫）：
teaching_material_init directory=D:\work\case-001 title=... subject=... level=... audience=... setting=...
2、填寫配置與登記表
編輯 profile.yml（權威機構、閾值等）與各 CSV。每個來源需有出版社、日期、 locator、訪問方式、許可與覈驗狀態；二手材料只能定位一手材料。claims.csv 每行一條實質主張（claim、source_id、locator、supported|partial|unsupported）；可選 knowledge.csv 將概念映射到同一來源與 locator。
3、接地與大綱
運行 teaching_material_ground，刪除或修正未支撐主張。用 teaching_material_outline 生成 build/outline.md；再用任意工具生成 build/deck.pptx / build/handout.docx，並在 teacher-pack.md 中寫 [Sxx] 引用。
4、門禁、版權與可復現
運行 teaching_material_gate——只修數據，不要放寬門禁。再運行 teaching_material_audit 與 teaching_material_repro。
5、人工與試點證據（如有）
在填寫 pilot.csv 前先寫 verification/trial-design.md；未執行時兩者保持「未執行」標記。
適用場景與邊界¶
適合誰：需要在 DSH 裏把教案/講義/課件當成可審計製品來做的開發者或教研流程設計者——尤其在意來源登記、主張接地、版權與產物哈希、以及分層 QA 門禁，而不是一次性對話出稿。
邊界（README 已聲明）：
- 門禁主要在數據層；生成 deck/handout 的版式、溢出等仍要用外部工具（例如 LibreOffice 渲染）檢查，插件不包攬。
- E3 只檢查證據是否存在，不評判質量。
- 無網絡、無遙測、不採集學生數據。
- 標準登記中無法取得的條款標爲
not-obtained，不應被引用爲已覈驗條文。
上游自測：node --test tests/*.test.js（資料記載當前爲 38 tests，0 failures）。
結尾¶
dsh-teaching-material-workbench 把教學物料生產收進「案例目錄 + 登記表 + 三層門禁 + 檢查中心 + 導出與復現哈希」的工作流，並與 Web 逐頁編輯配合，減少無來源主張和不可復現導出。
- 目錄頁：https://www.skillhub.cn/plugins/Golden2002/dsh-teaching-material-workbench
- 源碼與文檔：https://github.com/Golden2002/dsh-teaching-material-workbench
社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝與使用請以倉庫 README 與許可證爲準。
