前言¶
在 DeepSeek Harness（DSH）裏做教學相關智能體時，常見需求是「把卷子、教案、課件做成學校認得的 Word/PPT/PDF」，而不是在對話裏堆一段 Markdown。學校往往已有空白卷模板、固定教案表頭；印前要查頁碼域、題號、分值。若每次靠手工排版或另開 Office 宏，重複勞動多，且容易把班級、模板路徑混在上一次任務裏。
下面介紹的 教師助手（GitHub：LeonhardJY/dsh-teacher-kit）是 DSH 工作流類插件：在對話輸入框下方增加「教師助手」入口，用本機 Python 與 DSH 內置 LibreOffice 生成 .docx / .pdf（及 .pptx、.html 等），不聯網、不上傳。它只做「把文件做出來」，不涉及學生評價、成績分析、評語等人際環節。
這是什麼¶
- 維護者：LeonhardJY（倉庫 LeonhardJY/dsh-teacher-kit）
- 分類：工作流
- 當前包版本（
package.json）：0.18.0，許可證 MIT - 運行環境：Windows 上的 DSH 桌面版或
dsh web，DSH 版本要求>= 0.2.1-rc.2 - 目錄頁：skillhub.cn 插件條目
裝好插件後，點「教師助手」會彈出功能卡片；從 0.15 起默認推薦 對話式：選一項後面板關閉，對話裏補全本次參數後直接出文件。面板底部仍保留 老方式（填表就出），與對話式共用同一套排版引擎。
核心功能¶
以下能力均來自項目 README 功能表，產物格式以說明爲準。
| 能力 | 簡要說明 | 典型產出 |
|---|---|---|
| 出試卷 | 粘貼題幹或從 Word 讀題；可選學校空白模板；8 開兩欄等版式；答題卡、答案卷、印前檢查；可 A/B 卷、教師卷（最多一次四份） | .docx + .pdf |
| 題庫組卷 | 選 Excel/Word 題庫，按題型挑題或全庫組卷，可多套、A/B、教師卷 | .docx + .pdf |
| 聽寫單 | 詞表文件或粘貼 → 雙欄聽寫紙，可選答案頁與聽寫 wav | .docx + .pdf |
| 教案 | 草稿按字段識別，表格式或流程版 | .docx + .pdf |
| 做課件 | 粘貼課時內容，可選學校 PPT 模板；備註寫「講：」行；可出網頁課件 | .pptx / .html |
| 整套 | 一節課多選：試卷 / 聽寫 / 教案 / 課件，缺哪件只報哪件 | 各自格式 |
| 文件加工 | Word 淨化、批量淨化、合併、抽文字、檢查一份卷子 | .docx / 文字 |
| 公衆號推文 | 活動稿結構化 → 可粘貼排版（不聯網發佈） | .html + .docx |
| 公文流轉 | 來文登記、擬辦、流轉單、回覆稿等 | .docx |
| 模板 | 舊卷轉空白學校模板（老方式入口） | .docx |
本地與依賴：全程本機運行；使用 DSH 自帶 Python 與內置 LibreOffice，不必另裝 Microsoft Office；生成的 Word/PPT 可在 WPS 中打開。第一次走對話式時，插件會詢問並記住學校模板、版式等習慣（README「學校畫像」章節）。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議瀏覽倉庫源碼與 MIT 許可證。社區目錄站點（如 skillhub.cn）與 DeepSeek / 幻方無官方從屬關係，索引源由維護者提供。
辦法 A：插件市場（索引源）¶
DSH：設置 → 插件市場 → 發現，在索引源中填入：
https://fastly.jsdelivr.net/gh/LeonhardJY/dsh-teacher-kit@main/market/index.json
保存並刷新後出現「教師助手」卡片，安裝後 重啓 DSH。README 說明：國內直連 raw.githubusercontent.com 可能失敗，故推薦 jsDelivr；備用原始地址爲 https://raw.githubusercontent.com/LeonhardJY/dsh-teacher-kit/main/market/index.json。
辦法 B：本地 zip 安裝¶
從倉庫 dist/ 取當前最大版本包（資料中示例爲 dsh-teacher-kit-0.18.0.zip），解壓後在目錄內執行：
node scripts/install-local.mjs --profile desktop
使用 dsh web 時將 --profile desktop 改爲 --profile web。腳本會把插件複製到對應 profile 的 node_modules 並在 cordis.patch.yml 中啓用。可選 --dry-run 預覽、--uninstall 卸載。完成後 重啓 DSH，對話輸入框下方應出現「教師助手」。
辦法 C：離線一鍵包（無 Node）¶
使用 dist/dsh-teacher-kit-<版本>-offline-win.zip：解壓到文件夾（勿在壓縮包內直接運行），雙擊 一鍵安裝.cmd，提示裝好後完全退出 DSH 再打開。腳本爲 PowerShell（offline-installer/install.ps1），不依賴 Node、不聯網。
驗證：設置 → 插件市場 → 已安裝中可見 dsh-teacher-kit；或在對話中讓助手調用 teacher_kit_status，應返回 Python 與 LibreOffice 版本信息。
典型用法¶
對話式出卷（推薦首次使用）¶
- 點「教師助手」→「出試卷」。
- 在對話中說明卷子名稱、是否套學校
.docx模板、紙型（默認 8 開橫向兩欄）、是否要答題卡 / 參考答案 / A/B / 教師卷等。 - 將題幹粘貼進對話；支持大題小題、選項、
【答案】/【解析】及卷尾集中答案段。可選粘貼聽力錄音稿並勾選生成 wav（Windows 自帶語音，離線）。 - 完成後結果給出路徑與預覽；印前檢查不通過時會阻止導出 PDF，Word 仍可拿到修改後再導。
題幹格式示例（README 摘錄）：
一、聽力（20 分）
1. What does the boy want to buy?
A. A book B. A pen C. A bag D. A cup
2. 下列字音正確的是（ ）
A. zhān B. zhǎn C. zhàn D. zhàn
【答案】B
【解析】zhǎn 是上聲。
題庫組卷¶
- 「教師助手」→「題庫組卷」→ 瀏覽選擇題庫（
.xlsx/.xls/.csv/.docx）。 - 表頭識別題號、題型、材料、題幹、選項、答案、解析、分值等列；閱讀/完形材料放「材料」列。
- 可先「看看題庫裏有什麼」；在「挑題」行寫如
單項選擇 10，或留空用全庫。 - 與出卷相同可套模板、答題卡、A/B、教師卷；「分成幾套」可一次出 2–4 套平行卷。
聽寫單與教案¶
- 聽寫單：選英→中 / 中→英 / 混排；詞表來自文件或粘貼；可勾「同時生成聽寫音頻」並設置每條停頓秒數。
- 教案：粘貼含
教學目標、教學過程等字段的草稿；選表格式或流程版，表格式可識別導入/新授等環節列。
老方式快速出成品¶
面板底部 直接出成品（老方式：填表就出，不經過對話）：表單填完點「開始做」，一次返回結果卡。與對話式產物一致，適合已熟悉字段的老師。
適用場景與注意¶
適合誰：中國大陸中學教師或教務，需要在本地批量產出符合本校版式的試卷、聽寫、教案、課件，並做 Word 淨化、公文流轉等重複文檔工作；希望數據不出本機、不依賴雲端 Office。
不適合當作什麼：它不替代教學設計決策，也不處理與學生直接相關的評價與數據分析。
權限與安全：插件代碼隨 DSH 加載執行，安裝前應自行審閱 GitHub 倉庫。README 明確不聯網、不收集數據；聽力/聽寫音頻依賴 Windows 系統語音包，缺失時僅提示，不阻斷文檔生成。
設置記憶：紙型、時長、學校模板、聽寫欄數、教案版式等「選擇類」項會記在本機；題幹、詞表、勾選框（答題卡/A-B 等）默認不記住，避免誤帶上次內容。
結尾¶
dsh-teacher-kit 把中學日常裏高頻的「出卷、組卷、聽寫、教案、課件、整節課文檔包」收進 DSH 對話旁的一條工作流，排版可對齊學校空白模板，印前有檢查項，全程本地 LibreOffice 鏈路完成 PDF。若你在 DSH 生態裏找 工作流 類教學文檔工具，可從目錄頁或倉庫 README 的安裝節任選市場索引、本地腳本或離線包一種方式啓用。
- 目錄頁：https://www.skillhub.cn/plugins/LeonhardJY/dsh-teacher-kit
- GitHub：https://github.com/LeonhardJY/dsh-teacher-kit
