前言¶
在 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
