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 版本及依赖项符合要求。