前言¶
在 DSH 插件場景裏，PPT 和 Word 教案如果分開生成，頁碼映射與頁面內容容易出現偏差。shyboy/dsh-k12-lesson-builder 的做法是先形成統一藍圖，再從同一藍圖渲染兩個文件。
這是什麼¶
這是 shyboy 維護的 DeepSeek Harness 插件，許可證爲 MIT，版本爲 0.1.1。它用於根據教師提供的教材、課程標準與 PPT/Word 模板生成同步的 K12 英語 PPTX 和 DOCX 教案材料。
核心功能¶
- 讀取教師提供的教材、課程標準、PowerPoint 模板和 Word 教案模板。
- 形成統一教學藍圖：
lesson-blueprint.json。 - 從同一藍圖生成同步的可編輯 PPTX 與 DOCX。
- 調用
prepare_k12_lesson_sources提取教師來源並檢查模板。 - 調用
render_k12_lesson_materials渲染材料。 - 先生成 PPT，取得最終頁碼，再把頁碼映射寫入 Word 教案。
- 重新打開兩個文件並生成審計 JSON。
- 所有輸入、中間文件和輸出都位於當前 DSH 任務工作區，不把文件上傳到獨立服務。
環境要求¶
支持環境¶
- Windows 10/11
- 已安裝桌面版 Microsoft Word 和 Microsoft PowerPoint
- DeepSeek Harness
0.1.0-rc.6 - PowerShell 7
package.json要求 Node.js>=24
不支持環境¶
不支持 macOS、Linux、WPS 或純網頁版 Office。
安裝¶
在可以訪問 dsh-k12-lesson-builder-0.1.1.tgz 文件的路徑下，執行安裝命令：
dsh plugin --profile web add .\dsh-k12-lesson-builder-0.1.1.tgz
典型用法¶
1、準備輸入文件¶
把四個文件放入當前 DSH 工作區：
1、教材：.pdf 或 .docx；
2、課程標準：.pdf 或 .docx；
3、PPT 模板：.pptx；
4、Word 教案模板：.docx。
Word 教案模板需要包含以下 11 個唯一內容控件 Tag：
lesson_title
grade_unit
lesson_type
duration
objectives
key_points
difficulties
procedure
assessment
homework
ppt_map
2、描述任務¶
在 DSH 中直接描述任務，例如：
請用 inputs/textbook.pdf、inputs/standards.docx、inputs/template.pptx 和 inputs/template.docx，爲七年級 Unit 1 Reading 第 4—5 頁生成 1 課時、45 分鐘的 PPT 和 Word 教案，輸出到 outputs/unit-1
3、查看輸出¶
典型輸出包括：
source-package.json
template-report.json
lesson-blueprint.json
Unit-1-Reading.pptx
Unit-1-Reading.docx
Unit-1-Reading-audit.json
文件與輸出行爲¶
- 已有同名文件不會被覆蓋，新文件會自動使用
(2)、(3)等後綴。 - 生成失敗的半成品會移動到
failed/。 - 插件只接受當前工作區內的普通文件，拒絕工作區外路徑和符號鏈接。
- 單個輸入文件默認上限爲
50 MB，提取文本默認上限爲20 萬字符。 - 教材與課程標準只讀打開，集成測試會覈對輸入哈希不變。
- 插件本身不調用第二個模型，藍圖由當前 DSH Agent 在可見會話中生成。
適用場景與注意¶
適合在 Windows 桌面 Office 環境中，基於教師提供的教材、課標和模板，生成同步 PPTX 與 DOCX 教案材料的 K12 英語備課流程。
需要注意：
- 當前版本不含 OCR；教材 PDF 爲掃描圖片時，需先轉換爲可複製文本的 PDF 或 DOCX。
- 目前對齊 DeepSeek Harness
0.1.0-rc.6開發者預覽版；DSH 插件接口升級後需要重新驗證兼容性。 - 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
結尾¶
shyboy/dsh-k12-lesson-builder 的價值，是把“PPT 與 Word 教案同步”落到同一份教學藍圖上，減少兩邊內容脫節。
目錄頁線索：https://www.skillhub.cn/plugins/shyboy/dsh-k12-lesson-builder
