Introduction¶
In the context of DSH plugins, if PowerPoint and Word lesson plans are generated separately, page number mapping and page content are prone to discrepancies. The approach taken by shyboy/dsh-k12-lesson-builder is to first form a unified blueprint and then render the two files from the same blueprint.
What is this¶
This is a DeepSeek Harness plugin maintained by shyboy, licensed under MIT, version 0.1.1. It is used to generate synchronized K-12 English PPTX and DOCX lesson materials based on the textbook, curriculum standards, and PPT/Word templates provided by the teacher.
Key Features¶
- Reads the textbook, curriculum standards, PowerPoint template, and Word lesson plan template provided by the teacher.
- Forms a unified teaching blueprint:
lesson-blueprint.json. - Generates synchronized, editable PPTX and DOCX from the same blueprint.
- Calls
prepare_k12_lesson_sourcesto extract teacher sources and check templates. - Calls
render_k12_lesson_materialsto render materials. - First generates the PPT to obtain the final page numbers, then writes the page number mapping into the Word lesson plan.
- Reopens both files and generates an audit JSON.
- All inputs, intermediate files, and outputs are located in the current DSH task workspace; files are not uploaded to an independent service.
Environment Requirements¶
Supported Environments¶
- Windows 10/11
- Desktop versions of Microsoft Word and Microsoft PowerPoint installed
- DeepSeek Harness
0.1.0-rc.6 - PowerShell 7
package.jsonrequires Node.js>=24
Unsupported Environments¶
macOS, Linux, WPS, or web-only Office are not supported.
Installation¶
In the path where you can access the dsh-k12-lesson-builder-0.1.1.tgz file, execute the installation command:
dsh plugin --profile web add .\dsh-k12-lesson-builder-0.1.1.tgz
Typical Usage¶
1. Prepare Input Files¶
Place the four files in the current DSH workspace:
- Textbook:
.pdfor.docx; - Curriculum Standards:
.pdfor.docx; - PowerPoint Template:
.pptx; - Word Lesson Plan Template:
.docx.
The Word lesson plan template needs to contain the following 11 unique content control Tags:
lesson_title
grade_unit
lesson_type
duration
objectives
key_points
difficulties
procedure
assessment
homework
ppt_map
2. Describe the Task¶
Describe the task directly in DSH, for example:
Please use inputs/textbook.pdf, inputs/standards.docx, inputs/template.pptx and inputs/template.docx, to generate 1 lesson, 45 minutes of PPT and Word lesson plans for Grade 7 Unit 1 Reading pages 4-5, output to outputs/unit-1
3. View Output¶
Typical outputs include:
source-package.json
template-report.json
lesson-blueprint.json
Unit-1-Reading.pptx
Unit-1-Reading.docx
Unit-1-Reading-audit.json
File and Output Behavior¶
- Files with the same name will not be overwritten; new files will automatically use suffixes like
(2),(3), etc. - Partially generated files that fail will be moved to
failed/. - The plugin only accepts ordinary files within the current workspace and rejects paths and symbolic links outside the workspace.
- The default limit for a single input file is
50 MB, and the default limit for text extraction is200,000 characters. - The textbook and curriculum standards are opened in read-only mode; integration tests verify that the input hash remains unchanged.
- The plugin itself does not call a second model; the blueprint is generated by the current DSH Agent in the visible session.
Applicable Scenarios and Notes¶
Suitable for the K-12 English lesson preparation process in a Windows desktop Office environment, generating synchronized PPTX and DOCX lesson materials based on the textbook, standards, and templates provided by the teacher.
Please note:
- The current version does not include OCR; when the textbook PDF is a scanned image, it must first be converted to a copyable text PDF or DOCX.
- Currently aligned with DeepSeek Harness
0.1.0-rc.6developer preview; compatibility needs to be re-verified after the DSH plugin interface is upgraded. - The plugin runs with the permissions of the current dsh process; the source code and license should be checked before installation.
Conclusion¶
The value of shyboy/dsh-k12-lesson-builder lies in grounding “synchronizing PPT and Word lesson plans” on a single teaching blueprint, reducing content disconnection on both sides.
Directory Page Link: https://www.skillhub.cn/plugins/shyboy/dsh-k12-lesson-builder