dsh-teacher-preset: 面向教師的本地優先 AI 教學工作臺

前言¶

DeepSeek Harness (DSH) 是一個以本地存儲爲核心的模型推理框架。通用智能體在處理垂直領域任務時，往往缺乏特定的上下文和標準化的流程。dsh-teacher-preset 插件通過引入標準化的教學模板、結構化的教學上下文以及評價診斷閉環，將 DSH 從通用助手轉變爲面向教師的專用工作臺。它支持學校與教培兩種場景，並提供本地優先的數據存儲與版本管理能力。

功能概覽¶

該插件主要解決教學場景下的材料生成、上下文複用、評價診斷以及版本回溯問題。

場景化模式切換
支持三種模式：
- school：面向公立/私立學校教師，提供教案、評價量規、試卷等 7 種模板。
- tutoring：面向教培機構教師，提供試聽課、學情分析、續報話術等 7 種模板。
- all：全模式，默認模式，提供全部 14 種模板，LLM 會根據指令自動判斷場景。
教學上下文與材料管理
- 結構化上下文：支持保存並複用教師、班級、課程和學生信息，支持歷史版本恢復。
- 模板隔離：在 school 模式下，LLM 僅可見學校模板；在 tutoring 模式下，僅可見教培模板。
- 自動歸檔：生成的材料按類型/日期命名保存，同日同名文件會自動添加後綴以避免覆蓋。
- 全文搜索：支持跨所有已保存材料搜索關鍵詞，返回行號和上下文。
- HTML 導出：支持將 Markdown 材料導出爲 A4 排版的可打印 HTML。
教學閉環與質量控制
- 單元教學包：支持一次性創建並關聯多份材料（如教案、練習、測評），並生成校驗和。
- 質量門禁：在保存前攔截錯誤模式、未替換佔位符、缺失答案等問題。
- 評價診斷：支持錄入逐學生、逐目標的評價證據，自動計算掌握度並生成下一課的調整建議。
版本與遷移
- 版本生命週期：提供安全更新、自動備份、歷史版本列表與恢復功能。恢復前會自動備份當前版本。
- 非破壞遷移：v1 元數據保存在獨立目錄，原有 Markdown 文件保持不變，僅建立索引。

安裝與前置條件¶

使用前需確保環境滿足以下要求：

Node.js: ^22.19.0 || >=24.0.0
npm: 11.12.1
DSH: 0.1.1-rc.2
Cordis: 4.0.1

從 GitHub 安裝¶

執行以下命令安裝插件並啓動 Web 界面：

dsh plugin --profile web add github:AIMarshallLee/dsh-teacher-preset#v1.0.0
dsh web

從本地安裝¶

如果需要調試或查看源碼：

git clone https://github.com/AIMarshallLee/dsh-teacher-preset.git
cd dsh-teacher-preset && git checkout v1.0.0 && npm ci && npm run build
dsh plugin --profile web add file:./dsh-teacher-preset
dsh web

配置¶

在 DSH 配置目錄創建或編輯 cordis.patch.yml 文件，定義插件行爲：

- id: dsh-teacher-preset
  config:
    mode: "all"                   # school | tutoring | all
    gradeLevel: "小學六年級"        # 年級
    subject: "數學"                # 學科
    textbookVersion: "人教版"      # 教材版本
    outputDir: "./teacher-materials"  # 輸出目錄
    language: "zh-CN"              # 輸出語言

配置項說明¶

mode：決定 LLM 可見的模板集合。
gradeLevel 與 subject：用於加載對應學科的課程標準參考。
outputDir：所有生成文件的保存路徑，建議使用相對路徑。

典型用法¶

通過自然語言指令即可觸發插件工作流。

學校教師場景：
* 生成教案：幫我寫一節"分數的初步認識"的教案
* 生成試卷：生成一份第一單元的數學試卷，10道選擇題
* 生成反思：生成一份教學反思，記錄今天課堂中關於分數概念的難點

教培教師場景：
* 生成試聽課：幫我生成一份小數乘法試聽課教案
* 生成續報話術：寫一份春季班續報話術，這個學生計算薄弱

教學閉環流程：
1. 使用 teacher_save_context 保存或更新當前教學上下文。
2. 使用 teacher_create_unit_package 生成單元內的教案、練習、測評等材料。
3. 上課結束後，使用 teacher_record_assessment 錄入學生評價證據。
4. 插件根據證據計算掌握度，並生成下一課的調整建議。

數據結構與存儲¶

插件採用混合存儲結構以確保兼容性與性能：

outputDir/
├── lesson-plan/      # 原有 Markdown 文件
├── quiz/
├── .backups/         # 自動備份文件
└── .teacher-workspace/ # v1 元數據目錄
    ├── workspace.json
    ├── legacy-materials.json
    ├── contexts/     # 教學上下文
    ├── packages/     # 單元教學包
    ├── assessments/  # 評價數據
    ├── transactions/ # 事務日誌
    └── staging/      # 待落盤的臨時文件

隱私注意：
所有數據僅保存在本地 outputDir 目錄中。配置的絕對路徑不會加入模型提示詞。outputDir 不應包含敏感標識（如學生姓名），且嚴禁在上下文或材料中寫入密碼、API Key 或 Cookie。

適用場景¶

本插件適合需要使用 DeepSeek Harness 進行本地化、可控教學輔助的教師。它通過模板化和結構化，減少了重複性工作，並提供了可追溯的教學評價閉環。使用前請確認 DSH 版本及依賴項符合要求。