Creative Space
Build an Interactive Lesson Students Can Explore

Konten

Provide: A knowledge point or a unit; a grade or examination system; a language; two or three questions that I hope students can answer after finishing the study. When there are textbook pages, handouts, and exam syllabus, they will be given to you, so I will follow them.

Receive: An interactive courseware, which defaults to a single HTML file and can be opened in the browser by double-clicking it; attached is the teacher's notes (objectives of each lesson, common misunderstandings, discussion questions, answers) and a list of sources.

The explanation video is for students to understand; the interactive courseware is for students to try it out on their own. Therefore, the core of each lesson is not that the picture is beautiful, but that there is a model that students can operate with their own hands and that will make them change their minds.

Three usages

UsageWhat to do
An interactive lesson (default)A knowledge point, an operable model, and a complete "prediction → test → proof"
A whole chapterMultiple lessons strung together into one book: table of contents, progress, completion marks for each lesson, unified style of painting and interaction methods
Principle DemonstrationHow the engine, heart, gears, circuits, and the internal structure of the product work: you can rotate it, play it in slow motion, disassemble it, and explain it step by step; you can do it without prediction questions

For a whole chapter, do the first lesson first, and then do the rest of the lessons after confirmation. The interaction and painting style will follow the first lesson.

Tools and responsibilities

  • Agent: Write course scripts and codes (use Three.js for 3D web pages, Canvas or SVG for 2D), local preview and self-test. Main force.
  • Flova: Course cover and chapter illustrations, model textures or backgrounds, explanation voiceover, and an optional imported short video. Do not draw formulas or words.
  • Host reading ability: Read textbooks, handouts, and web pages given by users.
  • Internet search (optional): Check authoritative sources to verify facts when information is not available.
  • Browser: Preview and self-test; if you can take screenshots, take screenshots of the key images of each lesson for users to see.

Method index

  • : How to write "Prediction → Test → Prove", how to find misunderstandings, only one model per lesson, teacher note template, source list. Steps 2–3 Read.
  • : Single file structure, how to choose 3D and 2D, painting style, performance and mobile phone, downgrade, self-test list. Steps 4–7 Read.

Boundaries

  • Knowledge must be accurate: Formulas, constants, units, and conclusions should be compared with the textbooks or exam syllabus given by the user. Verify them in the source list; the values in the model are calculated according to the real formulas, and the numbers are not changed for the sake of appearance.
  • Simplification should be stated: Simplification has been made in order to enable interaction (ignoring air resistance, ideal gas, etc.), and this should be stated in the courseware.
  • Refer to other people's courseware and only learn the form: Do not copy other people's content, text and art.
  • Student Privacy: By default, no student data is collected, and external statistics and logins are not accepted; progress is only stored in the student's own browser.
  • assets rights: You must have the right to use the pictures, models, and audio provided by the user; keep the license description when using third-party libraries.

Workflow

Confirm knowledge points and objects (confirmation point) → Verify facts and find misunderstandings → Course script (confirmation point) → Interactive prototype (confirmation point) → Define the style → Complete implementation → Self-test → Delivery

1. Confirm knowledge points and objects (confirmation points)

  • Ask clearly: which knowledge point, grade or examination system, language, in what situation it is used (classroom screen projection, student self-study, mobile phone), and what answers you need to be able to answer after learning.
  • Only one knowledge point is taught in one class. When the user provides the whole unit, first list the lessons divided into several lessons, confirm it with the user, and proceed as "whole chapter".

2. Verify facts and find misunderstandings

  • If there is information, use the files, browsers or connectors available to the host to read it; if not, check textbooks, societies, official organizations and other sources.
  • Write a list of sources docs/sources.md.
  • Find out one or two of the most common misunderstandings about this knowledge point, which will become wrong choices in the prediction questions. For the method, see .

3. Course script (confirmation point)

One copy of docs/lesson-<编号>.md for each lesson, written in the format of : prediction questions, what students will do, what values are displayed in real time in the scene, explanations and formulas when revealed, and source numbers. The principle demonstration is written as a step-by-step explanation. Confirm to user.

4. Interactive prototype (confirmation point)

First use gray squares and simple lines to run through the interaction: it can be operated, the value will change, and prediction and revelation can be completed. Ask the user to click it again in the browser (if you can take a screenshot, attach a screenshot), confirm that the "hands-on step" is established before uploading the art. If the interaction is not established, it will be useless no matter how good the picture is.

5. Set the painting style

Choose a painting style and write it with unified settings (lines, colors, materials, lighting, fonts), and the entire courseware will follow it word for word. Use Flova to create covers, illustrations, stickers or backgrounds, as well as explain voiceovers and import short videos when needed. For the painting style and writing method, see .

6. Complete implementation

Replaced art, completion reveals, formulas, teacher entrances, and downgrade prompts on the prototype. Equations are rendered with KaTeX or MathJax. A complete chapter is added with a table of contents, progress and completion marks, and the progress is stored locally in the browser.

7. Self-test

Go through the list of one by one: each prediction question can be completed, the answers are correct, the values and formulas are consistent with the sources, the mobile phone can be used, there is a prompt when there is no graphics acceleration, and the loading time is reasonable. Once the problem is found, correct it and then test again.

8. Delivery

Deliver the HTML file (and necessary assets folder), teacher notes docs/teacher-notes.md, source list, and screenshots. When users want to put it online, they are only given a link to the official documentation of the hosting service, and the user publishes it themselves.

Project directory

lesson-<主题>/
├── docs/      brief.md、sources.md、lesson-*.md(课程脚本)、teacher-notes.md
├── assets/    Flova 生成的封面、插画、贴图、配音
├── src/       原型和完整版的源码
└── output/    index.html(单文件课件)、截图、自测记录

course design

The structure of a lesson: predict → test → prove

LinksWhat students doWhat courseware does
SituationLook at a specific scene (a book falls off a shelf, a kettle boils water)Explain the situation in one or two sentences without making sense
PredictionAnswer a multiple-choice question: "What do you think will happen?"There is a common misunderstanding among the options; lock in the answer first and don't judge right or wrong immediately
TestDo it in the model: drag, click, adjust parameters, change conditionsValues are displayed in real time, and changes are visible (color, length, scale)
ProofUncover the answerGo back to the prediction and explain clearly what was right and what was wrong with the misunderstanding; give formulas or rules and correspond to the phenomenon you just saw one by one
Consolidation (optional)Try again under different conditions, or a small questionTest whether students can transfer

Principle demonstrations can remove predictions and change to step-by-step explanations: each step highlights a component and tells what it does. Students can turn, slow-play, and disassemble it at any time.

How to find misunderstandings

  • Sources: "Error-prone points" in textbooks, teachers' experience, frequently asked questions in searches, and wrong questions given by users.
  • Write sentences that students will actually choose and are not obviously wrong answers. For example, "The energy was used up" is more like what students would say than "The energy became zero."
  • One lesson is only designed around one misunderstanding; when you cannot find a definite misunderstanding, use the "Intuitively you would think..." option and do not make up statistics.

Only make one model per lesson

  • The model requires students to change one quantity with their own hands and see another quantity change accordingly. It can only be seen but not moved. It is not considered a model but is an illustration.
  • Only one or two adjustable parameters are open at a time, the rest are fixed and written on the screen.
  • Each adjustable parameter is given a reasonable range and unit; when it is dragged to the boundary, a prompt is given to prevent the model from calculating absurd results.
  • Values are calculated according to real formulas, and appropriate digits are retained when displayed.

Course script format

docs/lesson-<编号>.md:

标题:
学习目标:学完能回答「……」
情境:
预测题:题干 / 选项 A(误解)/ B / C(正确)/ D
模型:场景里有什么;学生能调什么(范围、单位);实时显示什么
试验引导:一两句提示学生去试什么
揭晓:正确答案;为什么误解不对;公式或规律(每个符号的含义和单位)
简化声明:
出处:S01、S02

Teacher Notes

docs/teacher-notes.md, one paragraph for each lesson: learning objectives, common misunderstandings and how to ask questions in class, two or three discussion questions, answers, recommended time, and chapters corresponding to the textbook or examination syllabus.

Provenance list

docs/sources.md: Number, content (formulas, constants, conclusions), source (book title and page number, or website), original text excerpt, verification status. Reference numbers are used in course scripts and courseware; content with "no reliable source found" is not included in the courseware.

Web page implementation and self-test

Only write about pitfalls that are easy to step into. The usage of libraries such as Three.js and KaTeX shall be subject to their respective official documents.

3D or 2D

  • Use 3D: The spatial structure itself is a knowledge point (molecular structure, mechanical transmission, celestial body position, internal structure), or rotating the perspective can help students understand.
  • In 2D (SVG or Canvas): Curves, diagrams, circuit diagrams, force diagrams, processes. Faster, more power-saving, and more stable on your phone.
  • Use 2D when in doubt.

Single file

  • A index.html is delivered by default, with styles and scripts written in it, and can be opened by double-clicking.
  • When third-party libraries are loaded from CDN, the version number is hard-coded. When the classroom may be offline, link the library into the file, or put it in the same folder as the file and deliver it together, and explain it.
  • Using the ES module, when double-clicking to open a cross-domain error report, use the local static server preview (for example, python3 -m http.server), and write it in the delivery instructions.
  • Pictures and textures should be compressed inline or placed as assets/, and each image should not exceed 1–2K pixels.

Painting style

The entire courseware is unified and written into unified settings:

Painting styleKey points of practice
Ink line on paperLight-colored paper background, model with white material and dark strokes and lines; energy, temperature, etc. are represented by luminous solid colors
Low polyFlat shading, few faces, soft ambient light plus a key light
Flat 2DFlat color blocks and uniform line width, consistent with the flat style of the explanation video

Flova produces covers, chapter illustrations, paper or material maps, and backgrounds; the model itself is built with code. Numerical values, formulas, and labels are superimposed on the scene using web text and are not drawn into the texture to ensure clarity and can be changed.

Performance and mobile phones

  • Only redraw during interaction or animation, stop when stationary.
  • The maximum pixel ratio is 2; control the number of model faces and objects; do not use real-time shadows, or only give them to the main object.
  • Physics and animation use fixed time steps to ensure the same results every time.
  • View rotation limits the angle and zoom range, so students will not lose the model.
  • Touch screen operable; buttons and draggable points are large enough.

Downgrades and Accessibility

  • Detect whether the browser supports WebGL; give a prompt if it does not support it, and provide a 2D version or screenshots of key steps.
  • Not only rely on color to distinguish information, but also use text or shapes; the color contrast is sufficient.
  • Respect the system's "Reduce Dynamic Effects" setting when there are animations.
  • Voiceover only plays when students click, it does not play automatically.

Self-Assessment Checklist

Before each delivery, go through each item one by one and record it in output/test-log.md:

  • Each prediction question can be selected, locked, and revealed; the revealed content is consistent with the course script;
  • Each adjustable parameter will not produce ridiculous results in the entire range, and the displayed values and units are consistent with the source list;
  • The formulas are rendered correctly without garbled characters;
  • Can be fully operated on computers and mobile phones (vertical screen);
  • Turn off graphics acceleration or switch to an old browser, and the downgrade prompt will appear;
  • The first loading time is acceptable and no errors are reported on the console;
  • When a whole chapter is completed: directory jump, progress saving, and completion mark are normal.

When you can use the browser tool, take a screenshot of a key picture of each lesson and attach it to the delivery.

Preview in chat host

The output is HTML. Some chat hosts can preview pages directly, such as ChatGPT canvas and Claude artifacts. Test pages with 3D or external libraries in the current host; if unsupported, deliver the HTML file to open in a browser.

Proses kreatif

  1. Three.js

    Three.js

    Build an interactive experiment

    Create an interactive model that demonstrates parameter changes and results.

  2. Flova

    Flova

    Generate lesson assets

    Create illustrations, cover images, and explanatory voiceovers.