中职英语同步词汇试题生成器

适用场景

• 用户要求生成某单元的“同步词汇试题”“小卷”“词汇测试题”“单元测试”“词汇综合测试题”。
• 用户提供了单元重点词汇/短语/截图，需要据此命题。
• 用户提到“中职英语”“基础模块”“同步词汇”“职教高考词汇”等关键词。
• 用户要求按照真实样例卷的格式（六大部分：词汇选择、完形填空、阅读理解、语法填空、句子翻译、写作）出题，或要求“学生版 + 答案版”。

核心交付物（重要）

默认一次产出 两版 Word 文档，与教师实际工作流一致（参考 Unit 2 的“打印版 + 参考答案”两份文件）：

1. 学生打印版（题目，无答案，留横线/空格，可直接打印发卷）。
2. 教师参考答案版（题目 + 全部答案；语法/填空/翻译题附简要解析；作文附参考范文）。

> 若用户只要其中之一，按用户要求输出，但默认双版最稳妥。

标准题型结构（依据 9 份真实样例卷归纳）

> 自 v6 起，标准结构按高职高考/调研考常见分值调整为 六大部分，满分 100 分：
> - 词汇选择 25 题 × 1 分 = 25 分
> - 完形填空 15 题 × 1 分 = 15 分
> - 阅读理解 5 题 × 2 分 = 10 分
> - 完成句子 10 题 × 1 分 = 10 分
> - 句子翻译 10 题 × 2 分 = 20 分（中译英 5 题 + 英译中 5 题）
> - 写作 1 题 = 20 分
>
> 若用户另指定题量或分值，按用户要求；否则默认采用此 v6 标准结构。

编号规则（两种并存，默认“每节重置”）

• 每节重置：每一大题型内重新编号（选择题 1~25、完形 1~10、阅读 1~5、填空 1~25、翻译 1~25、写作不编号）。
• 全局连续：全卷连续编号（Unit 4 采用：选择 1~25、填空 26~50、翻译 51~75……），按需微调。
• 默认采用“每节重置”，除非用户指定全局连续。

排版格式规范（真题格式，用户定制，务必严格遵循）

> 生成脚本 scripts/generate_vocab_test.py 已按以下格式渲染（全篇 Times New Roman、1.5 倍行距）。任何排版改动都须保持此样式，不得回退为单行横排或乱缩进。这是用户逐版比对后锁定的"真题格式"。

• 标题（两行，均居中·15pt·加粗）：第一行写教材/模块（如 中职英语 基础模块二），第二行写单元与试卷名（如 Unit 1 I Love My Family 词汇综合测试题）。JSON 中 title 为第一行、subtitle 为第二行；不要再加"满分100分"之类的汇总行（分值已写进各题型大标题）。
• 信息行（班级/姓名/学号/得分）：左对齐、10.5pt、space_after=6，如 班级：____ 姓名：____ 学号：____ 得分：____。
• 题型大标题（一、二、…）：左对齐、11pt、加粗、space_after=4，标题内写明题型说明与分值（如 一、选出句中画线单词或词组的意义，使句子通顺、意思合理。（共25小题，每小题1分，满分25分））。
• 题型一·词汇选择题选项：题干 ( ) N. <英文句>（画线词加下划线）一行；选项另起一行，A/B/C/D 横向四列、上下题同字母纵向对齐，整行 first_line_indent=0.29"、制表位 [1.8, 3.4, 5.0]"，如 A. 苗条的 B. 肥胖的 C. 高大的 D. 矮小的。
• 题型二·完形填空选项：语篇 first_line_indent=0.25"、space_after=6；每题一行 ( ) N.A. <选项A>（A 紧贴题号，无空格），B/C/D 用制表位 [0.9, 2.3, 3.7, 5.1]"，上下题 A对A、B对B 纵向对齐。
• 题型三·阅读理解选项：题干单独成行；4 个选项各占一行，left_indent=0.75"、first_line_indent=-0.25"（悬挂缩进：字母在 0.5"、换行正文在 0.75"），保证 A/B/C/D 纵向对齐、长选项换行也对齐。
• 题型四·完成句子：每句一行、10.5pt、space_after=5，横线留空。
• 题型五·句子翻译：（一）中译英 / （二）英译中 小标题 10.5pt 加粗；每句一行后接一条 10pt、space_after=6 的下划线空行。
• 题型六·写作：提示语/要点/要求均 first_line_indent=0.25"；学生版留 8 条 10pt、space_after=6 的下划线空行。

各题型出题方法与要求（关键：形式与样例卷完全一致）

题型一：词汇选择题（25 题）

• 题干：一句完整英文，句中 一个单词或词组画线（加下划线），要求选出其“意义”。
• 形式：( ) The battery in my phone needs to be replaced.
• 选项：A. 电池 B. 争吵 C. 战斗 D. 攻击
• 选项：A/B/C/D 四个 中文释义。正确答案是画线词的真实中文义；三个干扰项 = 在语境中“看似合理但明显不同”的中文词（不要与正确答案近义，确保唯一）。
• 考词覆盖：本单元核心单词 + 核心短语（词组）。
• 答案分布：A/B/C/D 尽量均匀（各约 6~7 题），避免连续相同。
• 题序随机打乱。
• 句子必须无歧义（重要）：画线词在句中应只表达其“本单元考察义”，避免一词多义造成误解。例如 broad 不宜放在 a broad smile（易理解为“咧嘴大笑”而偏离“宽的”本义），应改用 broad shoulders 这类只指向“宽阔的”的句子；cheerful 取最直接义“快乐的”而非延伸义“乐观的”；尽量用单词/短语而非整句句型（如 That's why）作考察点，减少歧义。
• 选项无歧义且互不近义：四个中文选项必须唯一正确、互不近义、语境合理但明显不同（如 barbecue 答“烧烤”，干扰项用“宴会/早餐/野餐”，不可把“野餐”与“烧烤野餐”同时出现造成混淆）。
• 有争议的题可删可换：若某词在教材语境下释义易混、选项有争议（如 resort/barbecue），应整题删除或替换为更明确的单元词，并维持题型总题量（默认 25 题，删一题则在末尾补一题）。
• 同题选项字数尽可能一致：A/B/C/D 四项中文选项字数应尽量相同（同题差异不超过 1 个字），避免出现“2字 vs 6字”的悬殊。
• 画线必须到位（自行校对）：JSON 中每题必须带 u 字段且 u 是 stem 的精确子串（如 can't wait to do 必须完整出现在题干中），否则生成时不会显示下划线——出题后必须逐题核对 u in stem。
• 例（Unit 5）：
  > ( ) The government is calling on everyone to save water.
  > A. 拜访 B. 号召 C. 称呼 D. 命名 → 答案：B
• 答案版写法：答案：B 或 【答案】B（按用户样例卷习惯）。

题型二：完形填空（15 小题，每小题 1 分，满分 15 分）

• 语篇体裁：记叙文（叙事性短文，如家庭故事/成长经历/校园生活），主题贴合单元话题。文中设 15 处空白，用 __1__~__15__ 标记。
• 篇幅（挖空后，即带 __N__ 占位符的文本）控制在 220~250 词——占位符不计入词数；易读度（Flesch Reading Ease）控制在 75~85 之间，保持对中职学生友好、可理解。
• 零生词：完形填空不要出现超纲/生词，所有用词（含非答案词）须在中职学生已学范围内；本单元核心词/短语（如 take after, look after, get into the habit of, keep in touch with, boarding school, independent…）可用，但不要每个空都机械地只考本单元新学表达。
• 选项：每空给 4 个英文单词/短语（A/B/C/D），学生选唯一正确项；正确答案须使文意、语法、搭配均通顺。
• 形式（学生版）：My father is ____(1)____ and broad. + 选项 A. well-built B. weak C. short D. tiny
• 教师版：直接在文中空白处填出正确词（加粗），便于批改。
• 考点须跨词性混合：沿"情节线（事件/动作/场景）+ 情感线（心情/感受）+ 逻辑线（因果/转折/习惯/独立）"三条线出题，每条线 3~5 空（通常 5+5+5）。三条线共同覆盖副词、形容词、动词、名词、短语的考核，避免只考单一词性或只考新学短语。
• 挖空位置与语篇架构（重要）：
• 首行/首句不设空：开场句（到第一个句号为界）必须完整、无空白，给学生进入语境的缓冲。
• 只挖"可推理性"空（最重要，用户硬要求）：挖空位置必须是学生能从上下文逻辑/主题推理出来的词；绝不要在考生无法从语境推断的位置设空（例如家庭"小/大/富/穷"这类无法由上下文判定的属性词，不应设空）。出题后务必逐空自检：遮住该空，学生能否凭前后文推出正确词；推不出的空必须换位或删去（本次 v6f 即因 Q1/Q10 原空不可推，改挖 but 后 warm、means 后 caring）。
• 相邻空距约 10~15 词（"大概隔至少 10-15 个字左右"）：两空之间至少隔开 10~15 个单词，不能太近（同句连挖）也不能太远；可先用脚本统计每段词数再定稿。
• 三个空距极端值（<10 或 >16）均需调整；允许个别 16 词作为"左右"容差，但 majority 须落在 10~15。
• 出题要求：
• 干扰项须"语境看似合理但明显错误"，且不与正确答案近义；
• 答案-选项位置必须一致（重要）：正确词必须放在 answer 字母所指向的选项位（如 answer:"B" 则正确词须是 options[1]）。出题后务必逐题核对，或在 JSON 每题加 "key":"正确词"，由生成脚本自检（[校对警告] 提示选项顺序错位）。
• 选项排版（真题格式）：每题的 A/B/C/D 四个选项横向排成四列，上下题同字母纵向对齐（如第 1 题 A. small 与第 2 题 A. hides 纵向对齐），生成脚本通过制表位实现。
• 同一语篇内的 15 个答案字母分布尽量均匀（A/B/C/D 各约 3~4 个，如 4/4/4/3），避免连续 4 个相同；
• 短文句子可与填空/翻译题复用同一批单元短语（这是词汇测试的预期），但不得与第四/第五大题出现完全相同的句子。
• 答案版写法：答案：A（身材魁梧的）。

题型三：阅读理解（5 小题，每小题 2 分，满分 10 分）

• 语篇体裁与篇幅：
• 说明文 或 记叙文 均可，但篇幅均须 270~320 词（不要过短，阅读篇幅偏短会显得单薄）。主题贴合单元话题（如家庭/亲情/成长/校园生活），含本单元重点词汇/短语。
• 语篇架构：提出问题 → 分析问题 → 解决问题（三段式）。命题点必须不离开文章主体架构，5 道题的正确答案串联起来应能理解阅读理解大意（即覆盖"问题—原因/张力—解决/主旨"）。
• 易读度（Flesch Reading Ease）控制在 60~75 之间，略高于完形，考查学生的篇章理解能力。
• 题型分布（按体裁二选一）：
• 说明文：细节理解 2 题 + 推理判断 2 题 + 词义猜测 1 题；
• 记叙文：细节理解 2 题 + 推理判断 3 题。
• 用 qtype 字段标注每题类型（detail / infer / vocab），便于脚本校验分布。
• 题目：5 道选择题，题干与选项一律用英文，格式参照高职高考/调研考真题（读英文篇章 → 答英文问题）。
• 形式：( ) 1. What does the writer's father do? A. A doctor. B. A teacher. C. A nurse. D. A worker. → 答案：A
• ⚠️ 重要：阅读题的题干与选项必须是英文，不能用中文（职高学生也要练习读懂英文题干与选项）。教师版的 meaning 字段可保留中文释义，仅作批改参考，不写入学生版/题干。
• 题干与选项硬性规范（重要）：
• 题干 ≤ 12 个单词；过长题干必须压缩（如删冗余状语、改用更短疑问词）。
• 选项 8~10 个单词，且结构两两对应/平行：整组要么都是从句（如全 Because… / 全 That children…）、要么都是不定式（全 To…）、要么都是动名词；实在不行至少保证四个选项结构两两对应（如全为 More … to … 短语）。
• 5 题答案字母 A/B/C/D 分布尽量均匀；选项唯一正确、互不近义；不得有"两个选项都对"的歧义。
• 选项英文词数差不超过 3（如 [8, 8, 8, 8] 最佳，[8, 8, 8, 7] 可接受），保持选项长度相对一致，模拟高考真题/调研考风格。
• 答案-选项位置一致性：同题型二，正确词须落在 answer 字母对应选项位，可加 "key" 字段由脚本校验。
• 选项排版（真题格式）：题干单独成行，4 个选项各占一行、A/B/C/D 字母上下对齐；若选项较长需换行，设置悬挂缩进使换行部分与选项正文对齐。

> 题型二、三的选项排版是用户明确要求的真题格式（详见上文"排版格式规范"）：完形每题 ( ) N.A. <选项A>（A 紧贴题号）起头，B/C/D 用制表位横向排成四列、上下题同字母纵向对齐；阅读题干成行后，4 个选项各占一行、A/B/C/D 字母上下对齐，长选项换行时按悬挂缩进与正文对齐。生成脚本 render_cloze/render_reading 已实现，改动排版须保持此样式。
- 考点：细节理解、词义猜测、主旨大意、简单推理；尽量在题干中复现本单元词汇（如 take after, tender, resort, boarding school, keep in touch with）。
- 答案版写法：答案：A（医生）。

题型四：完成句子 / 语法填空（10 题，每题 1 分，满分 10 分）

按用户截图与高职高考/调研考常见格式，两种小题型混合共 10 小题：

• （a）根据中文提示完成句子：横线 + （中文提示），填英文语块。
• 形式：I couldn't wait to go to ____________ (寄宿学校). → boarding school
• 允许使用一个长横线作为答题空间（参考真实样卷截图），不强制按词数分段；脚本对单段横线不触发“横线数≠词数”警告。
• （b）用所给单词的适当形式填空：括号给原形/提示词，考查词性转换、时态、语态、单复数、非谓语、主谓一致、比较级、定语从句等。
• 形式：When I visited him, he ____________ (write) at the desk. → was writing
• 同样允许一个长横线，不强制按词数分段。
• 出题要求：
• 紧扣本单元语法重点与核心词汇/短语；
• 10 题中通常前 5 题为“根据中文提示”，后 5 题为“用所给词适当形式”，也可按单元语法灵活调整；
• 填空题句子不与翻译题重复（重要）：第四大题的填空句子，不得与第五大题翻译的任一句子是同一句（避免同一内容考两次）。
• 单元语法重点映射（默认，可被用户覆盖）：
• Unit 1 I Love My Family → 过去进行时、宾语从句
• Unit 2 Time Really Matters → 虚拟语气
• Unit 3 I Have Got a Headache → 现在完成时、过去分词作定语
• Unit 4 We're Ready to Help → 连词（not only...but also, so...that, as well as）
• Unit 6 Not Just Tasty → 被动语态、非谓语（v-ing 作主语/宾语）、定语从句、主谓一致、比较级
• Unit 8 Festivals → 感叹句（what/how）、将来时、非谓语
• 答案版：列正确答案，并对语法/搭配点给 一句话解析（如 features（名词复数） / 过去进行时：was/were + doing）。

题型五：句子翻译（10 题，每题 2 分，满分 20 分）

• （一）中译英（5 题）：整句中文 → 整句英文，尽量套用本单元重点句型/短语。
• 形式：1. 这是我的妈妈，这是我的爸爸。 → This is my mum and this is my dad.
• （二）英译中（5 题）：给英文句子 → 写中文，句子含目标词汇语块。
• 中译英与英译中不得为同一句的互译（重要）：两部分必须选用互不相同的句子，绝不能把同一句话在两个方向各出一题。即：中译英的 5 句与英译中的 5 句应当两两不同、无镜像。
• 中译英/英译中的句子也不与填空题重复：翻译题的句子应区别于第四大题填空例句。
• 答案版：列完整译文。

题型六：写作（作文题，满分 20 分）

• 格式：
• 题目（如：假设你是李华，给你的英国笔友 Tom 写一封邮件，介绍你的家庭生活）
• 要点（3 个，如：1. 家庭成员外貌与性格 2. 一次难忘的家庭活动 3. 对家庭之爱的理解）
• 要求（词数，如 80~100 词 / 80~120 词；是否给出开头结尾）
• 【参考范文】
• 主题贴合单元话题，要求学生用至少 3~5 个本单元重点短语/句型。

出题原则（指南 + 真实样例卷验证）

1. 词汇不超纲：全部来自教材/用户提供的重点词汇，不偏不怪。
2. 词汇 + 语法双维：语法填空/完成句子/翻译必须嵌入明确语法或语块考点。
3. 词汇 + 语境统一：选择题与翻译都把词放进完整、真实的句子。
4. 选项唯一、干扰合理：选择题干扰项为语境合理但明显不同的中文词。
5. 答案分布均匀、题序打乱：避免模式化与连续相同答案。
6. 学生版留空、教师版给答案：两版配套，便于打印与批改。

工作流

Step 1 确定单元、语法点与题量

• 确定目标单元，套用上文“单元语法重点映射”（用户指定则优先）。
• 默认 25 题/题型、双版输出；如需 Unit 4 式分值变体或全局连续编号，按用户要求。

Step 2 加载本单元词汇与句型

• 读取 references/vocabulary_units_1_4.md（Unit 1-4）与 references/vocabulary_units_5_8.md（Unit 5-8）对应单元的重点单词、短语、句型。
• 若用户另提供词汇文件/截图，优先合并用户材料。

Step 3 命题（六类题型，形式严格对齐上文）

• 选题、完形、阅读、填空、翻译六类的形式、编号、选项排布必须与“各题型出题方法与要求”逐条一致。
• 完形填空与阅读理解两篇短文须使用本单元重点词汇/短语命题（可复用同一批单元词，但不得与填空/翻译题出现完全相同的句子）。
• 先草拟全部题目 + 标准答案 + 必要解析/范文。

Step 4 排版成卷（调用生成脚本）

• 推荐用 scripts/generate_vocab_test.py：把题目与答案写成 JSON，脚本自动渲染学生打印版 + 教师参考答案版两份 .docx，格式严格对齐真实样例卷（标题、班级姓名行、粗体题型序号、横线留空、答案/解析位置）。
• 若不调用脚本，也可经 tencent-docx 插件按上述格式手写，但务必保证两版与格式规范一致。
• 生成后必须调用 present_files 打开预览。

Step 5 校验（必须执行，不可跳过）

• 检查：题量是否对齐 v6 结构（选择 25、完形 15、阅读 5、完成句子 10、翻译 10、作文 1）、编号是否连续、学生版是否无答案、教师版答案是否齐全、选择题答案分布是否均匀。
• 选择题专项校对（依据题型一规范）：
  1. 逐题确认 u 字段是 stem 的精确子串（无漏划线）；
  2. 同题 A/B/C/D 选项字数差异不超过 1 个字；
  3. 画线词在句中无一词多义歧义、四个选项互不近义且唯一正确。
• 完成句子专项校对（依据题型四规范）：
  1. 10 小题须覆盖本单元核心词汇、短语与语法；
  2. 单段长横线允许作为答题空间；多段横线仍需核对「空段数 == 答案词数」；
  3. 完成句子句子不与第五大题翻译题任一句子重复。
• 翻译题专项校对（依据题型五规范）：
  1. 中译英 5 句与英译中 5 句必须两两不同、无镜像互译；
  2. 翻译题句子不与第四大题完成句子例句重复。
• 完形填空 / 阅读理解专项校对（依据题型二、三规范）：
  1. 完形 15 空、阅读 5 题的答案均须为有效字母 A/B/C/D，且分布尽量均匀；
  2. 完形易读度 75~85、阅读易读度 60~75（可用 textstat / flesch.linguisticscience.com 复核）；
  3. 阅读题选项英文词数差不超过 3；
  4. 完形与阅读短文中的句子不得与第四/第五大题出现完全相同的句子（复用同一批单元短语是允许的）。
• 运行 scripts/generate_vocab_test.py 时，脚本会自动打印：
• [校对警告]：选择题漏划线、多段横线数≠答案词数、翻译题中译英与英译中重复、完形/阅读答案字母无效；
• [校对提示]：选择题选项字数不齐、阅读选项英文词数差>3、完成句子中文提示可能与翻译题重复。
• 必须确认无上述任何警告/提示后再交付；若生成失败（如目标文件被预览占用），改用新文件名输出。

参考文件

• README.md：安装与使用说明（换电脑时先看这个：拷贝到 ~/.workbuddy/skills/ → pip install -r requirements.txt → 跑示例验证）。
• requirements.txt：依赖清单（必需 python-docx；可选 textstat 用于易读度复核）。
• examples/unit1_example.json：完整可运行示例（Unit 1 全卷，可直接作新单元模板）。
• references/vocabulary_units_1_4.md：Unit 1-4 重点单词、短语、句型及作文主题素材库。
• references/vocabulary_units_5_8.md：Unit 5-8 重点单词、短语（提取自真实样例卷的中英互译题）及作文主题。
• references/question_format_spec.md：六类题型的逐题排版模板（取自真实样例卷的微型范例＋用户锁定的真题格式），生成时严格对照。
• scripts/generate_vocab_test.py：题目 JSON → 学生版 + 教师版 .docx 的格式化生成器（含出题自检）。

换电脑迁移（用户只需做 1 步）

1. （用户做） 把整个 zhongzhi-english-vocab-test-generator 文件夹拷到新机的 ~/.workbuddy/skills/（Windows：C:\Users\<用户名>\.workbuddy\skills\）。
2. （AI 做） 需要时安装依赖 python-docx：pip install -r requirements.txt。
3. （可选） 验证：python scripts/generate_vocab_test.py examples/unit1_example.json ./out，能生成两份 docx 即成功。

> - 该 skill 目录不含任何绝对路径依赖，可整体打包迁移。
> - 分享给同事：本技能为个人自建、未发布到技能库（SkillHub 推荐市场），同事在技能面板搜不到；把文件夹（或 zip）拷到她的 skills 目录即可用。不要只发 SKILL.md——缺 scripts/generate_vocab_test.py 就生成不出 Word。