dsh-teacher-preset
面向教师的 DeepSeek Harness (DSH) 本地优先 AI 教学工作台 — 支持学校教师和教培教师，把教学上下文、成套备课、评价诊断与下一课调整连接为可追溯闭环。
功能
将 DSH 从通用 Agent 转变为教师专用助手。核心价值在于可复用教学上下文 + 单元教学包 + 评价证据 + 诊断反馈 + 本地版本恢复，同时保持 v0.4 Markdown 材料完全兼容。
核心能力:
- 模式切换：
school（学校教师）/ tutoring（教培教师）/ all（全模式，默认）
- 学校教师：7 种教学文档模板（教案、评价量规、试卷、课堂检测、家校通知、教学反思、练习单）
- 教培教师：7 种教培专用模板（试听课教案、学情分析报告、续报话术、招生简章、课程大纲、学员档案、知识点切片）
- 模式隔离：school 模式下 LLM 只能看到学校模板，tutoring 模式下只看到教培模板
- 自动文件保存与归档（按类型/日期命名，同日同名不覆盖）
- 课程标准参考（覆盖小学/初中/高中 6 个学科）
- 3 套条件系统提示词，按模式注入对应工作流和方法论
- 批量模板加载：一次调用加载多个模板，减少 LLM 轮次
- 全文搜索：跨所有已保存材料搜索关键词，返回行号和上下文
- HTML 导出：将 Markdown 材料导出为可打印的 HTML（A4 排版 + 中文字体）
- 版本生命周期：安全更新、自动备份、历史版本列表与恢复；恢复前再次保护当前版本
- 结构化教学上下文：本地保存教师、班级、课程和学生信息，支持更新历史与安全恢复
- 一键单元教学包：一次调用以可恢复事务保存多份材料，并关联教学目标、相对路径和 SHA-256 校验和
- 结构化质量门禁：拦截错误模式、未替换占位符、缺失答案、未知目标引用和目标覆盖缺口
- 评价诊断闭环：录入逐学生、逐目标证据，计算掌握度并生成可执行的下一课调整
- 非破坏迁移：只为 v0.4 材料建立索引，不移动、不改写原文件；索引可重复刷新
安装
前置条件
- Node.js
^22.19.0 || >=24.0.0
- npm
11.12.1（插件构建器）；Corepack 0.34.6 与 pnpm 11.24.0（独立 DSH 验收 profile）。构建插件本身不要求 pnpm
- DSH
0.1.1-rc.2（发布候选依赖，必须固定版本）与 Cordis 4.0.1
- DSH 安装：
npm install -g @deepseek-ai/dsh@0.1.1-rc.2
从 GitHub 安装（推荐）
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 | school | tutoring | all | all | 教师场景模式 |
gradeLevel | string | 小学六年级 | 教师所教年级 |
subject | string | 数学 | 教学学科 |
textbookVersion | string | 人教版 | 教材版本 |
outputDir | string | ./teacher-materials | 生成材料保存目录 |
language | string | zh-CN | 输出语言 |
模式说明
| 模式 | 适用教师 | 可用模板 | 系统提示词 |
|---|
school | 公立/私立学校在职教师 | 7 种学校模板 | 备课→上课→课后反馈 |
tutoring | 教培机构教师 | 7 种教培模板 | 招生→试听→排课→上课→反馈→续报 |
all | 两类都适用 | 全部 14 种模板 | 自动判断需求，先问清楚教师身份 |
工具
| 工具 | 说明 |
|---|
teacher_load_template | 按类型加载文档模板（enum 随 mode 动态变化） |
teacher_load_templates | 批量加载多个模板（数组参数，自动去重，减少 LLM 轮次） |
teacher_save_material | 将生成材料保存到输出目录，同日同名不覆盖（自动加后缀） |
teacher_list_materials | 列出已保存的材料，支持按类型筛选 |
teacher_read_material | 读取已保存的材料内容，用于查看或修改 |
teacher_update_material | 原地更新已有材料，自动备份旧版本 |
teacher_list_backups | 查看自动备份版本，支持按类型和原文件筛选 |
teacher_restore_material | 从指定备份恢复材料，恢复前自动备份当前版本 |
teacher_search_materials | 全文搜索已保存材料（大小写不敏感，返回行号和上下文） |
teacher_load_curriculum | 加载当前学科和年级的课程标准参考 |
teacher_export_material | 将材料导出为可打印 HTML（A4 排版 + 中文字体 + 打印 CSS） |
teacher_migrate_workspace | 初始化/刷新 v1 工作区并非破坏性索引 v0.4 材料 |
teacher_save_context | 创建或更新教学上下文，更新前自动保留旧版本 |
teacher_list_contexts | 按当前模式列出可复用教学上下文 |
teacher_read_context | 读取教师、班级、课程和学生上下文 |
teacher_list_context_versions | 列出教学上下文历史版本 |
teacher_restore_context | 恢复教学上下文，恢复前保护当前版本 |
teacher_create_unit_package | 一次创建并关联多份单元材料，通过质量门禁后以 staging + journal 可恢复落盘 |
teacher_list_unit_packages | 列出单元包及其上下文、目标和材料数量 |
teacher_read_unit_package | 读取单元包关系、材料校验和与质量报告 |
teacher_record_assessment | 记录评价证据、计算诊断并生成下一课调整 |
teacher_read_assessment | 读取评价证据、诊断与后续教学建议 |
v1 教学闭环
一次自然语言任务可以驱动插件内部完成以下链路：
teacher_save_context 保存或复用教师、班级、课程和学生上下文。teacher_create_unit_package 一次写入教案、练习、测评、量规等完整材料，并保存教学目标关联。- 教学后用
teacher_record_assessment 录入逐学生、逐目标的分数与观察。
- 插件按固定阈值生成诊断：掌握
>= 0.80、发展中 >= 0.60、其余为需要支持。
- 下一课再次调用
teacher_create_unit_package，传入 previousPackageId 和 sourceAssessmentId，形成证据可追溯的改进闭环。
本地存储、迁移与隐私
v1 元数据保存在 <outputDir>/.teacher-workspace/，原有 Markdown 仍位于 <outputDir>/<type>/：
teacher-materials/
├── lesson-plan/...
├── quiz/...
├── .backups/...
└── .teacher-workspace/
├── workspace.json
├── legacy-materials.json
├── contexts/
├── packages/
├── assessments/
├── transactions/
└── staging/
首次升级或复制旧材料后调用 teacher_migrate_workspace。迁移只读取文件并记录相对路径、大小、修改时间和 SHA-256，不改写材料；复制整个 outputDir 即可迁移工作区。JSON 写入使用可恢复 sidecar，单元包使用 staging + transaction journal；进程中断后插件启动会完成有日志的事务，无法关联的 staging 会保留并警告。损坏、不支持或越过目录联接边界的结构会报错并停止，不会静默重建。
所有数据仅保存在本地输出目录；配置的绝对输出路径不会加入模型提示，正常工具结果只返回工作区相对路径。底层文件系统异常的诊断可能含本机路径并被 DSH 发送给模型提供方，因此 outputDir 不应包含学生姓名等敏感标识。不要在上下文或材料中写入密码、API Key、Token、Cookie，学生信息只保留教学所需的最小范围。
完整的数据最小化、保留、删除和导出说明见 数据生命周期；安装、升级、卸载、回退和 DSH RC 风险见 运维手册；漏洞报告见 SECURITY.md。
模板
学校教师模板（mode: school）
| 模板 | 说明 |
|---|
lesson-plan | 教案 — 教学目标、教学过程、板书设计 |
rubric | 评价量规 — 多维度评分表格 |
quiz | 试卷 — 选择题、填空题、判断题、解答题 |
exit-ticket | 课堂检测 — 快速形成性评价（3-5题） |
parent-notice | 家校通知 — 家校沟通文档 |
reflection | 教学反思 — 目标达成、成功与不足 |
worksheet | 练习单 — 基础题、提高题、拓展题 |
教培教师模板（mode: tutoring）
| 模板 | 说明 |
|---|
trial-lesson | 试听课教案 — 破冰展示、互动练习、成果转化 |
student-report | 学情分析报告 — 入学测评、进步对比、薄弱分析 |
renewal-script | 续报话术 — 学情回顾、问题诊断、方案推荐、异议处理 |
enrollment-flyer | 招生简章 — 课程亮点、师资、排课、收费 |
course-outline | 课程大纲 — 多周排课、知识点分配、阶段测评 |
student-profile | 学员档案 — 学习风格、知识掌握、课堂表现、家长沟通 |
knowledge-map | 知识点切片 — 考点拆解、难度分级、前置依赖、常见错误 |
架构
DSH Agent (Node.js)
└─ Cordis Framework
└─ dsh-teacher-preset plugin (apply(ctx, config))
├─ Config Schema (zod: mode, gradeLevel, subject, textbookVersion, outputDir, language)
├─ TemplateManager (mode → getTypesForMode() → 7 or 14 types)
├─ System Prompt: buildSystemPrompt(mode) → school / tutoring / all
│ ├─ buildSchoolPrompt() — 备课→上课→课后反馈 + 教学法指南
│ ├─ buildTutoringPrompt() — 招生→试听→排课→上课→反馈→续报 + 教培方法论
│ └─ buildAllPrompt() — 双工作流 + 自动判断指引
├─ Tool: teacher_load_template (enum = tm.types, mode-filtered)
├─ Tool: teacher_load_templates (batch loading, array param, dedup)
├─ Tool: teacher_save_material (type validation = tm.types)
├─ Tool: teacher_list_materials (scans only mode-appropriate dirs)
├─ Tool: teacher_read_material (type validation = tm.types)
├─ Tool: teacher_update_material (atomic replace + automatic backup)
├─ Tool: teacher_list_backups (version history listing)
├─ Tool: teacher_restore_material (safe restore + current-version backup)
├─ Tool: teacher_search_materials (full-text search, case-insensitive)
├─ Tool: teacher_load_curriculum (课程标准)
├─ Tool: teacher_export_material (MD → HTML via marked + wrapHtml)
├─ WorkspaceStore (.teacher-workspace JSON + atomic writes + context history)
├─ Tool group: context migration / save / list / read / versions / restore
├─ Tool group: unit package create / list / read + structural quality gates
├─ Tool group: assessment record / read + deterministic diagnosis
├─ html-template.ts (print CSS, Chinese fonts, A4 page)
├─ 14 Markdown templates (7 school + 7 tutoring)
└─ ctx.effect() cleanup
使用示例
学校教师模式
> 帮我写一节"分数的初步认识"的教案
→ 自动加载教案模板 → 生成内容 → 保存到 teacher-materials/lesson-plan/
> 生成一份第一单元的数学试卷，10道选择题
→ 自动加载试卷模板 → 生成题目和答案 → 保存到 teacher-materials/quiz/
教培教师模式
> 帮我生成一份小数乘法试听课教案
→ 自动加载试听课模板 → 生成五环节内容 → 保存到 teacher-materials/trial-lesson/
> 写一份春季班续报话术，这个学生计算薄弱
→ 自动加载续报话术模板 → 生成学情回顾+方案+异议处理 → 保存到 teacher-materials/renewal-script/
全模式
> 帮我出一份招生简章
→ LLM 自动判断为教培场景 → 加载招生简章模板 → 生成内容 → 保存
> 写一节圆的面积的教案
→ LLM 自动判断为学校场景 → 加载教案模板 → 生成内容 → 保存
项目结构
dsh-teacher-preset/
├── src/
│ ├── index.ts # 插件入口: apply(ctx, config) + 3 套系统提示词
│ ├── templates.ts # 模板管理器 + 模式过滤 (SCHOOL/TUTORING/ALL types)
│ ├── params.ts # buildParameters() JSON Schema 转换
│ ├── html-template.ts # HTML 导出模板 (打印 CSS + 中文字体)
│ └── tools/
│ ├── load-template.ts # teacher_load_template (动态 enum)
│ ├── load-templates.ts # teacher_load_templates (批量加载 + 去重)
│ ├── save-material.ts # teacher_save_material (动态 type 校验)
│ ├── list-materials.ts # teacher_list_materials (动态 type 扫描)
│ ├── read-material.ts # teacher_read_material (动态 type 校验 + 路径遍历防护)
│ ├── update-material.ts # teacher_update_material (原子更新 + 自动备份)
│ ├── list-backups.ts # teacher_list_backups (备份版本列表)
│ ├── restore-material.ts # teacher_restore_material (安全恢复)
│ ├── search-materials.ts # teacher_search_materials (全文搜索)
│ ├── export-material.ts # teacher_export_material (HTML 导出)
│ └── load-curriculum.ts # teacher_load_curriculum
├── templates/ # 14 个 Markdown 模板
│ ├── lesson-plan.md # 学校: 教案
│ ├── rubric.md # 学校: 评价量规
│ ├── quiz.md # 学校: 试卷
│ ├── exit-ticket.md # 学校: 课堂检测
│ ├── parent-notice.md # 学校: 家校通知
│ ├── reflection.md # 学校: 教学反思
│ ├── worksheet.md # 学校: 练习单
│ ├── trial-lesson.md # 教培: 试听课教案
│ ├── student-report.md # 教培: 学情分析报告
│ ├── renewal-script.md # 教培: 续报话术
│ ├── enrollment-flyer.md # 教培: 招生简章
│ ├── course-outline.md # 教培: 课程大纲
│ ├── student-profile.md # 教培: 学员档案
│ └── knowledge-map.md # 教培: 知识点切片
├── test/
│ ├── integration.mjs # v0.4 兼容与插件回归（723 assertions）
│ ├── v1-integration.mjs # v1 工作区、恢复与教学闭环场景
│ ├── release-contract.mjs # 发布元数据、安全与运维文档契约
│ └── fixtures/ # v0.4 字节级迁移基线
├── cordis.patch.yml # 示例配置
├── package.json
├── tsconfig.json
├── CHANGELOG.md
└── LICENSE
路线图
| 阶段 | 范围 | 状态 |
|---|
| Phase 1 — MVP | 5 工具 + 系统提示词 + 7 学校模板 + 配置 + 测试 | Complete |
| Phase 1.5 — DSH 兼容 | 修复 8 个 DSH 环境兼容性问题 + 真实 LLM 验证 | Complete |
| Phase 2 — 教培模式 | mode 切换 + 7 教培模板 + 条件系统提示词 + 模式隔离 | Complete |
| Phase 3 — 增强 | 批量模板加载 + 全文搜索 + HTML 导出 | Complete |
| Phase 4 — 材料生命周期 | 安全更新 + 自动备份 + 版本列表 + 安全恢复 | Complete |
| Phase 5 — AI 教学闭环工作台 | 教学上下文 + 单元包 + 质量门禁 + 评价诊断 + 下一课调整 | Complete |
License
MIT
