Files
SuperJump/docs/math-content-spec.md

72 lines
2.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 数学思维课时内容创作规范(供创作代理参考)
## 输出文件
`src/content/math/<module>.json`,顶层结构:
```json
{
"module": "calc",
"moduleName": "计算与计数",
"points": [ { "id": "calc-01", "title": "...", "grade": "一~二年级", "difficulty": 1, "summary": "...", "md": "..." } ]
}
```
`module` 与 `moduleName` 固定对应:
- calc=计算与计数, apply=应用题, geo=几何, num=数论, travel=行程, eq=方程, combo=组合
## 单个 point 字段
- `id`: `<module>-<两位序号>`,如 calc-01、calc-02;同一文件内连续不重复。
- `title`: 课时标题,≤30 字。
- `grade`: 适用学段,如 "一~二年级" / "三~四年级" / "五~六年级" / "小升初"。
- `difficulty`: 1(基础)/2(提高)/3(竞赛入门)。
- `summary`: 一句话目标,≤40 字。
- `md`: 课时正文 markdown,**含一个 quiz 块**。
## md 正文结构(保证 ≥40 分钟,内容必须忠实于源材料、不要臆造知识点)
```
> ⏱ 本课约 40 分钟:热身 5' → 精讲与例题 20' → 即时练习 15'
## ① 回顾与目标
(1-2 句:承接什么、本课要达成什么)
## ② 知识精讲
### 概念/方法 1
(定义、法则、关键点;配 1-2 个例题,例题要写【思路】【解答】【验算/提醒】)
### 概念/方法 2
...
## ③ 常见错误与提醒
- (易错点,逐条列出)
## ④ 即时练习
```quiz
{"questions":[ ... 8~10 题 ... ]}
```
## ⑤ 本课小结
- (3-5 条要点回顾)
```
注意:正文用中文;数学式用纯文本(如 3/4、2×3、a+b),不用 LaTeX;不用图片。
## quiz 题目格式(必须是合法 JSON,放在 ```quiz 围栏内)
题型只用 choice / fill / judge 三种(order/match 在数学里判分不稳,避免使用):
```json
{"questions":[
{"type":"choice","stem":"25×32 等于多少?","options":["700","800","900"],"answer":1,"explain":"把 32 拆成 4×8,25×4×8=800。"},
{"type":"fill","stem":"计算:56+44=?","answers":["100"],"explain":"凑整:56+44=100。"},
{"type":"judge","stem":"0 除以任何数都得 0。","answer":1,"explain":"错。0 不能作除数,0 除以任何非 0 数才得 0。"}
]}
```
字段说明:
- `type`: "choice" | "fill" | "judge"
- `stem`: 题干字符串
- choice: `options` 为选项数组,`answer` 为正确项下标(0 起)
- fill: `answers` 为可接受答案数组(判分会 trim+小写比对,可给多个等价写法,如 ["100","100.0"])
- judge: `answer` 为下标,0=对、1=错(界面显示为"对/错")
- `explain`: 每题必填的讲解,讲清思路
每课 8~10 题,答案必须正确,覆盖本课知识点。
## 切分原则
- 每课聚焦一个可独立学会的知识单元,正文详实(概念+多例题+易错+练习),确保认真学+做题 ≥40 分钟。
- 源材料里一节内容很多的,按知识单元拆成多课;内容太少的小节合并成一课。
- 例题与练习题尽量取自源材料的原题;源材料没给答案的,你要算出正确答案并写进 explain。
- 不要照抄导航/目录类文字,只提炼知识内容。