汉语课后作业设计器
目的
为一节汉语课生成一份可以直接发给学生、也方便教师批改的课后作业单。
覆盖零基础到高级四个水平档位，以及七种课型。
通用模型布置作业时最容易犯四类错误，本技能把它们从「靠提示词提醒」变成「靠规则与脚本硬校验」：
- 机械抄写过量 —— 「抄写所有生词每个三遍」是默认答案，但它只考察字形，本课的真正难点一个都测不到，还挤占了学生的时间。
- 任务抽象，学生不知道做什么 —— 「和同学录视频练习对话」对初学者等于没说，他们只会照读课文。
- 指令学生看不懂 —— 作业单上写「抄写」「录音」「拍照」，低水平学生可能不认识这几个字，作业要求本身就失效了。
- 课型错配 —— 口语课布置笔头练习，听力课不指定听力材料，写作课不给字数下限，这类错误在生成时极常见。
何时使用
- 一节课结束后要布置课后作业
- 需要把当次课的生词、语法点、汉字、语音等内容分层落到作业里
- 需要同时产出学生版作业单和教师版批改指南
- 需要检查已有作业是否覆盖全面、批改负担是否可控
输入
向用户收集，缺哪项问哪项，不要替用户假设：
必需
- 水平档位：L0 零基础 / L1 初级 / L2 中级 / L3 高级（用户未说明时必须询问，不要猜）
- 课型：综合课 / 口语课 / 听力课 / 阅读课 / 写作课 / 汉字课 / HSK 辅导（同上）
- 教材、课次与课题（如《发展汉语 中级口语 I》第 2 课《三口之家是理想的家庭吗》）
- 本次课实际覆盖的内容：课文、生词、语法点／结构、重点汉字、语音点
- 班级人数
可选但重要
- 已学课次累计词表（L2/L3 强烈建议提供）：中高级的词汇边界应由教材进度决定，内置词表只覆盖 HSK1–2，不提供累计词表会让大量学生早已掌握的词被误判为超纲
- 学生母语背景（影响媒介语选择）
- 学生课后是否有接触中国人的机会（决定生活类任务是必做还是选做）
工作流
Step 1 确定档位与课型，装载对应档案
先读两个档案，确定本次的规则集：
| 档案 | 路径 | 作用 |
|---|---|---|
| 水平档位档案 | references/level-profiles.md |
决定白名单来源、指令语言策略、抄写上限、句长上限、产出要求、机械占比上限 |
| 课型档案 | references/course-type-profiles.md |
决定必覆盖模块、开口任务项数、机械占比、特殊约束（材料来源／字数／文体／限时） |
这一步不能省。档位错了会导致指令过幼稚或过难，课型错了会导致作业形态完全不对。
关键差异提示：
- L0/L1 的指令必须逐条配拼音与英文；L2 起改为中文为主、难词注拼音；L3 中文即可
- L0 抄写上限 8 遍，L3 为 0（不布置机械抄写）
- 口语课要求开口任务 ≥2 项、机械占比 ≤20%；写作课要求字数下限与文体；听力课必须指定材料来源；汉字课抄写上限放宽 1.5 倍但须含部件分析
Step 2 对齐课次内容
确认本次课的重点词汇、语法点／结构、重点汉字与语音点。若用户使用《发展汉语 初级综合 I》，可读 references/dcr1-lesson-structure.md 核对课次结构；其他教材按用户提供的实际内容，将该文件作为结构模板。
关键判断：找出本课的真正难点。难点在口语（量词辨析、疑问词辨析、声调）就必须有开口任务；难点在字形才可以把汉字书写作为主体。
Step 3 挑任务组合
从 references/task-type-library.md 中选 3–4 项必做任务，覆盖至少 3 个维度，并满足本课型的必覆盖模块：
| 维度 | 典型任务 |
|---|---|
| 汉字 | 重点字书写、笔画标注、汉字寻宝、部件拆分 |
| 语音 | 录音回答真实问题、声调跟读、辨音选择 |
| 词汇 | 看图写词、词语搭配、近义词辨析 |
| 语法 | 句型替换、真实问答、结构造句 |
| 交际 | 同伴互问、实地询问、角色扮演准备 |
| 生活 | 生活寻宝拍照、采访、社会调查 |
| 听力 | 听后回答、听后复述、听写要点（须指定材料） |
| 阅读 | 读后回答、概括、查读任务（须给字数） |
| 写作 | 命题写作、续写、改写、应用文（须给字数与文体） |
必做 3–4 项之外，可另加 1 项选做，标为「性质：选做」。
Step 4 写学生指令
每条任务都要写出作业单上实际会印给学生看的那句话，而不是对任务的描述。写指令时读 references/homework-instruction-language.md：
- L0/L1：超出白名单的作业动作词必须同时给出拼音与英文
- L2：中文为主，动作词与抽象词括注拼音，英文可省
- L3：中文即可，专业术语括注解释
- 禁止使用「结合本课语法点完成练习」「谈谈你的家庭情况」这类抽象任务
- 交际类任务必须给出具体问题，不得只写「练习对话」
注意区分两类句子：
- 指令句（告诉学生做什么）→ 必须让学生看懂，按档位配注音
- 材料句（要读的问题、例句、对话）→ 是学习目标本身，只需保证用词不超纲，不要给目标语言配英文
Step 5 写教师版批改指南
为每个任务填写：考察重点、优秀标准、常见错误预警。常见错误预警要写本课的具体错误（如「五口人说成五个人」），不要写「可能出现语法错误」这种废话。
Step 6 跑校验
python scripts/check_homework.py --homework <作业单.md> --vocab <本课生词.txt> \
--known <已学累计词表.txt> --dimensions "词汇,语法,功能" --students 25 \
--level L2 --course-type speaking
--known 对 L2/L3 强烈建议提供。--level 与 --course-type 省略时默认 L0 + comprehensive，行为与旧版一致。
十一项检查：任务数量、维度覆盖（含课型必覆盖模块）、开口任务、生活／真实语境任务、机械占比、学生用时、批改时长、抄写遍数、指令可懂性（随档位切换策略）、课型特殊约束、产出要求（中高级成段／成篇）。
任一项不通过，必须修改后重新校验。
硬规则
- 必做任务 3–4 项，选做不计入必做预算
- 考察维度 ≥ 3 个，且覆盖本课型要求的必覆盖模块
- 开口任务数量满足课型要求（口语课 ≥2，综合课 ≥1）
- L0/L1 至少 1 项生活任务；L2/L3 鼓励真实语境任务
- 机械类用时占比不超过「档位上限与课型上限中的更严者」
- 学生总用时不超过档位上限（L0 30 分钟 → L3 60 分钟）
- 教师批改总时长 ≤ 40 分钟（按班级人数折算）
- 汉字抄写总遍数不超过「档位上限 × 课型系数」，且只抄重点字，不抄整张生词表
- 指令语言策略按档位执行，材料句与目标语言不配英文
- 禁止出现「复习」「预习」「谈谈」「结合语法点」等不可检查的抽象任务
- 交际任务必须给出具体问题
- 作业单上的每一条都要有明确产出物（照片、录音、写好的字、提纲），可提交、可检查
- 课型特殊约束必须满足：听力课给材料来源、阅读课给字数、写作课给字数下限与文体、HSK 辅导给限时、汉字课含部件或结构分析
资源
| 文件 | 用途 |
|---|---|
references/level-profiles.md |
四个水平档位的参数表（白名单来源、指令语言策略、抄写与产出要求） |
references/course-type-profiles.md |
七种课型的档案（必覆盖模块、开口项数、特殊约束） |
references/dcr1-lesson-structure.md |
《发展汉语 初级综合 I》课次结构，含第 5 课明细 |
references/task-type-library.md |
作业任务类型库，含考察维度、性质、用时、批改成本与组合规则 |
references/homework-instruction-language.md |
作业指令用语表，规定各档位下哪些词必须配注音 |
references/hsk1-2-vocab.md |
HSK 1–2 词汇表，作为低档位指令用词的白名单 |
scripts/check_homework.py |
十一项自动校验脚本，按档位与课型查表 |
assets/homework-template.md |
作业单输出模板 |
常见失败模式
- 把「抄写所有生词三遍」当作作业主体 —— 只测字形，本课难点测不到，批改也只能看字
- 对中级班仍逐条配英文 —— 显得幼稚，拖慢阅读，且掩盖了真实的语篇训练要求
- 交际任务只写「练习对话」 —— 学生会照读课文，达不到交际目的
- 口语课布置笔头练习、听力课不指定材料 —— 作业形态与课型错配
- 忽略批改成本 —— 25 人的班级，每项任务多 20 秒，总时长就多 8 分钟
- 把选做题混入必做 —— 学生会因此产生焦虑，且用时预算失真
- 中高级不提供累计词表 —— 学生早已掌握的词会被误判超纲，校验噪声淹没真实问题
