三阶生长语文 v6

> v6 是什么：不是又加了几条规则，而是把七课（草原／丁香结／狼牙山／圆明园／桥／穷人／少年闰土）逐课被何老师纠偏的过程，
> 重排成一条能照着干的生产线。旧版《三阶生长语文全学段套装》的二十二节是"某天改了什么"的流水账；
> v6 按"动手顺序"组织：判学段 → 核教材口径 → 定单元分寸 → 排页面蓝图 → 写数据 → 过四关 → 配详案 → 对齐归档。
>
> 一条底线：v6 里凡与旧版冲突的，以 v6 为准。旧版留着当备份，别两边混着看。

一、什么时候用

用：做一课「三阶生长语文」的课件或逐字稿详案；说"三阶""五四三""一阶五步/二阶四步/三阶三步""扎根·生长·丰实""配套课件和教案""拿来即用版"。

不用：高中及以上；非统编版语文；只评课不给课（那用 effective-teaching-observation）；纯排版润色。

二、★ 一票否决的十二条（违反任何一条，整份重做）

这十二条是七课里被纠正次数最多的，排最前面。写代码前先念一遍，过完自查再念一遍。

第十二条最容易被误解，展开一句：先回答"这一课在单元里排第几、单元要素落到哪一层"，再回答"目标怎么写、评价怎么嵌"。
第一课就教成第三课的深度，单元就散了。落地动作：课件加一页"本课在单元里的位置"，详案第一栏写"0. 单元整体分析"（编号在课标分析之前），并写出本课的分寸（"初步体会"还是"抓住……体会"）。

三、生产线（七步，按序走）

步骤 0 · 判学段、判版本（两分钟）

判学段（决定骨架）：教材有没有明确的「语文要素」栏？
- 一/二年级没有 → 低年级：识字写字优先，田字格字理卡逐字示范（新笔画自动补红色笔画符号），原文带注音，二阶直接用课后题，没有多音字就不出该页。
产出走 sj_engine.build(DATA)（老引擎仍保留、仍可用），数据包范本：scripts/samples/data_qiutian.py（'lowgrade': True）。
- 三～六年级有 → 中高年级：一阶五步＋按本单元语文要素定二阶＋三阶读写结合。
产出走 nb_big 页型库（本技能主线），范本：scripts/samples/sample_courseware_runtu.py。

> 两条线不是二选一：sj_engine 是 2026-09 的老管线（整页版式、一页多块），nb_big 是 2026-10 起的大字号手绘管线（一页一件事、逐块动画）。新课一律用 nb_big；sj_engine 只在改低年级老课件、或要现成的田字格字理卡时用。拼音课（a o e / b p m f 等）也是 sj_engine 线，配 pinyin_kit.py + pinyin_letters.py（需要 numpy）。

判版本（决定规格）：

理由：何老师要把模式推给"大部分普通老师"。话术条是拿来即用版的成品本体——9pt 灰字在投影上看不清，而那行字是普通老师唯一的依靠。开话术条必须 set_big_script(True)，且在建页之前调用（正文底界 6.86 → 6.14）。

步骤 1 · 核教材口径（不许凭记忆）

先问一句"你手上是第几课"（2026-11-06 加，代价最大的一次）。
2025 修订版起，部分课文课号变了、字词表整份换掉、单元位置也变了。已确认的例子：

课号一错，一阶字词页整套报废、单元"分寸"也会写反（首篇该做"初步"，不是"深化"）。
问不清就按"学生课本"为准，并在数据包开头写一行：★ 教材口径（YYYY-MM-DD 核，来源：…）。

必核六项，写进数据包开头并加日期注释：会写字几个、会认字几个、词语几个、自然段几段、课后几题、课文里有没有版本特殊用字。

七课踩过四次（都是"凭记忆"造成的）：
- 会写字数量记错（《少年闰土》12 个，写成 8 个）；
- 自然段数记错（17 段 vs 教辅的 19 段）；
- 把教材原文当错字（"项带银圈"是原文，不是"戴"）；
- 课号与练习册编号不同（教材 25 课，主册 23 课）。

做法：知识库有电子课本就取原文；没有就联网核现行统编版；两者冲突以现行教材为准，并在数据包里写一行注释说明。
若用户已上传主册课件/题目，逐题核答案口径——自拟答案常与主册不一致（《桥》"人们停住脚，望着老汉"自拟判神态，主册答案是动作 B），一切以主册为准。

步骤 2 · 定单元骨架，写出"本课的分寸"

读本单元所有课文的教材要求原文，列一张四行表（课文｜课型｜教材原文要求｜在单元里的位置），然后用一句话写出本课的分寸。

《桥》那课的范例：教材写"初步体会环境描写对表现人物形象的作用"——"初步"两个字就是分寸，不能讲到"抓住心理活动"（那是《穷人》的活）。

这一步做对了，后面所有取舍都有依据；做错了，一课比一课教得深，单元就散了。抓框架时还会抓出错（《桥》的三把钥匙页原写"照这三把钥匙读《穷人》《在柏林》"，而本单元略读是《金色的鱼钩》——单课看看不出来）。

步骤 3 · 排页面蓝图（先写清单，再写代码）

这一步不能省。 直接写 Python 的后果是：页型乱、动画乱、练习位置错，改一次动全身。

蓝图＝一张表，一行一页：页号｜环节｜页型函数｜一句话内容｜是否给动画。按阶写完再核对三件事：

1. 练习是否只在每阶最后一步；
2. 三阶是否只有 4 页；
3. 有没有两页的标题可以互换（能互换＝有废话）。

三阶的定型四页（2026-11-02 定，此后不再变）：

连起来念：学什么 → 写成什么样 → 怎么写 → 怎么评。多一页就说明同一件事讲了两遍。

步骤 4 · 写数据包／构建脚本

照抄样例，不要手搓坐标：
- 课件：scripts/samples/sample_courseware_runtu.py（57 页，《少年闰土》，大字号、三阶四页、答案进括号）
- 详案：scripts/samples/qiao_plan.py（62 段逐页稿，《桥》，只写内容不写排版）

页型库在 scripts/nb_big.py，速查见第五节。三条习惯：
- 段号用 B.P(list(range(1, n+1))) 一次传入全部，让 p_read 自己均衡分页；分组调用等于绕开分页（17 段会被拆成 12 页）；
- 高度一律用 th()/nlines()/tw() 实测，不自己估；
- 每条 note 写"这里为什么这么排"给老师看，不写"本页设计意图"给学生看。

★ 一页到底装多少（拿来即用版 BOT=6.14 实测，2026-11-06）

先算再写，能省掉一半返工。1 行 32pt ＝ 0.596 英寸；1 个汉字宽 0.4625 英寸（不是 0.444，按 0.444 排必折行）。

写法上的三条硬规矩（都是这次踩出来的）：
1. p_table 的单元格不能放 \n——不换行，只把行高算高，版面上留一道假空白；要换行就拆成多行。
2. p_quiz 的答案必须紧贴左括号：（【tán】 chán） ✓　（chán 【tán】） ✗（会整体错到下一个括号）。
3. 话术条每段≤ 40 字（16pt，宽 11.16 英寸），超了换行压字，三行会叠在一起。

步骤 5 · 过四关（不通过不许交付）

一条命令（2026-11-06 起，四关合成一屏，约 1—2 s；原来跑四遍要 4 s 还要看四份输出）：

cd <技能>/scripts
python qc.py "<课件>.pptx" --plan plan_xxx.py          # 版面／字号／动画／详案 一次说完
python qc.py "<课件>.pptx" --render out/preview --pages 12,15-18   # 只出改过的那几页

输出形如（全通过退回 0，有失败退回 1，文件读不到退回 2）：

  ✅ 版面   重叠 0 ｜ 溢出 0 ｜ 越界 0 ｜ 45 页
  ✅ 字号   正文 <32pt：0 处 ｜ 装饰 359 处
  ✅ 动画   81 击（上限 90）｜零动画 26 页（下限 15）
  ✅ 详案   45 段稿 ｜ 缺号 0 ｜ 越界 0 ｜ 页序OK

动画一项超了只记 ⚠️（提醒，不判失败），想要硬判加 --strict。
理由：那是内容取向（该减就减），不是版面硬伤；官方样例《少年闰土》57 页 131 击也略超 114。

要单跑某一关仍然可以：

python samples/sample_courseware_runtu.py           # ① 构建：看有没有 "!! 版面告警"
python check_all.py   "<课件>.pptx"                  # ② 重叠 / 溢出 / 越界 必须全 0
python check_fonts.py "<课件>.pptx" 32               # ③ 正文 <32pt 必须是 0
python render2.py     "<课件>.pptx" <目录> --pages 5 # ④ 只出第 5 页

构建阶段就会报的六类错（2026-11-06 加，都是"看渲染图才发现"的坑，现在不用看图）：

第四关必做：render2.py 会真折行，能看出"文字顶出卡片""半页死白"；render_demo 不折行会把长行截断成"看起来没问题"。
看图只做两件事：扫一遍有没有压边、扫一遍哪页下半是空的（余量 > 0.85 英寸就该合并或撑满）。

省时间的三条：① 一次改一批（同类问题一起改），不要一页一改；② 只渲改动页（--pages），45 页全渲是 0.8 s、挑 4 页是 0.2 s，但看图的时间才是大头；③ 构建脚本用 B.save(prs, out)，别用 prs.save(out)。

步骤 6 · 配逐字稿详案

两个硬要求：① 页码一一对应，老师翻到 P几读 P几；② 按教学评一体化写（课标／教材／学情／目标／评价任务五栏在前面），但骨架是单元整体（第一栏是"0. 单元整体分析"）。

只写内容，排版交给 build_plan.py：

import build_plan, plan_xxx
build_plan.build(plan_xxx.PLAN, '/workspace/out/XX_三阶生长语文详案（逐字稿）.docx')

逐字稿必须能照着念：【方括号】是动作提示（点鼠标、停几秒），不是要念的话——「二、逐页逐字稿」标题下那行固定提示写明了这条，否则老师会把"【单击】"念出来。

步骤 7 · 对齐校验 + 归档

python3 check_plan.py "<课件>.pptx" plan_xxx     # 页号缺／越界／乱序

这一关专治"课件改版后详案没跟着改"：《桥》课件后来从 62 页压到 60 页，详案 62 段就整体错了 2 页——老师翻到 P20 会读到别的内容。样例 qiao_plan.py 保留的是 62 页版，跑 check_plan 会如实报"越界 P61/P62"，这正是它该抓的。

归档命名：课件 <序号>-第X单元-<课号> <课题>.pptx，详案 <课题>_三阶生长语文详案（逐字稿）.docx，同一课的课件与详案放在同一文件夹。

四、四关的判据（不要靠"看着还行"）

检测器比真实排版保守：check_all 按每字全宽、每行 0.42 英寸估；真实排版（nlines）约 0.596/行但一行装得更多。两者冲突时取大，代码里叫"双尺子"：

def _h_seg(no_, txt, s_):
    h1 = nlines(full, 11.52, s_) * s_ * TXT_LH / 72.0     # 真实排版
    _n = 0                                                # 检测器口径
    for _seg in full.split('\n'):
        _wch = sum(_per if ord(_c) > 0x2E80 else _per * 0.55 for _c in _seg)
        _n += max(1, int(-(-_wch * 100 // max(1, int((11.58 - 0.10) * 100)))))
    return max(h1, _n * 0.42)

只按真实排版算，长段必被判溢出；只按检测器算，卡片会虚高一半。

五、页型库速查（scripts/nb_big.py）

动画分级（_anim(walk) 自动分配，不要逐页手工设）：

• walk（跟着走）：字词一卡一击、原文逐段、表格逐行、阶扉页目标逐条、练习答案；
• hold（摆出来）：说发现、练习布置、写话、三阶全部（除答案）、封面说明、三招页、对比页、任务布置页。

验收：零动画页 ≥ 全课 1/3；单页 ≤3 击（逐行表格除外）；总击数 ≤ 页数×2。

六、脚本索引（scripts/）

dump_titles2.py 输出到当前目录的 titles_out.txt。核对方法：把详案的"环节"与课件标题逐行并排念——念不通就是页序错了。

七、环境

沙箱/服务器（Linux）：系统已装 python-pptx、python-docx、Pillow、lxml，直接跑。

老师电脑（Windows 离线）：libs.zip 已内置 python-pptx / python-docx / Pillow / lxml，不用 pip install。
v6.2.2 起依赖打成一个 libs.zip（331 文件 → 1），整包 147 个文件，可过「上传文件数 ≤200」的平台限制；
首次运行自动解到 %TEMP%\sj_hsy_libs_v621（冷启动 +0.9 s，之后跳过），技能目录不落地。
引导顺序不能反——lxml 里是 cp313-win_amd64.pyd，在 Linux 上优先加载会报 cannot import name 'etree'。所以一律 import _boot（系统包优先，缺失才 append 解包目录）。
为什么解压而不是把 zip 挂到 sys.path：PIL / lxml 带 C 扩展（.pyd），zipimport 加载不了。
libs.zip 里是 cp313-win_amd64，对应 Python 3.13；WorkBuddy 自带解释器在
C:\Users\<用户名>\.workbuddy\binaries\python\envs\default\Scripts\python.exe。

字体（2026-11-05 修）：字宽测量统一走 scripts/_fonts.py，按
① 思源黑体 NotoSansCJK-Regular.ttc → ② 微软雅黑 msyh.ttc → ③ 思源 SC 可变字体 / 黑体 / 苹方
依次找第一款能加载的；找不到会明确报错，不静默降级。可用 SJ_FONT / SJ_FONT_BOLD 强制指定。
v6 原版这里硬编码 Linux 路径且无回退，Windows 上直接 OSError: cannot open resource——已修。
换字体会改字宽，改完必须重跑四关。NotoSansSC-VF.ttf 是可变字体，实测会让「对比栏过硬」
从 0 变 1、多出 1 处重叠，故排在微软雅黑之后。成片字体仍统一写"微软雅黑"（normalize_fonts(prs) 收尾）。

产物位置：默认 <技能>/out/，可用 SJ_OUT 改。

唯一没内置的依赖：拼音课要 numpy（pip install numpy，约 30 MB）。

八、references 索引（按需读，不要一次全读）

改规矩的唯一入口：新纠偏先写进 ref_changelog.md（带日期、原话、判据），确认稳定后再提到本文件第二节。不要直接改第二节又把来由丢掉——丢了来由，下次就会有人把它改回去。

九、交付清单（每课必刷一遍）

课件
- [ ] nb_big.WARN 为空（含新增六类：单元格 \n／答案没贴括号／p_erlei nrow≥3／话术条超宽／表格超行／文件被占用）
- [ ] qc.py <课件> --plan … 一屏全绿；出图只渲改动页（--pages）
- [ ] 构建脚本用 B.save(prs, out)，不用 prs.save（文件被预览占用时会另存 _v2）
- [ ] check_all 重叠／溢出／越界全 0；check_fonts 32 正文小字 0
- [ ] render2 逐页扫过：无压边、无半页死白（余量 >0.85 的都处理过）
- [ ] 零动画页 ≥ 1/3；任务布置页 0 击；练习答案每答 1 击
- [ ] 每阶首页是本阶三条目标；三阶 ≤4 页；练习只在每阶最后一步
- [ ] 原段都有段号；续页标题带段号范围
- [ ] 有"本课在单元里的位置"一页，写清本课的分寸

详案
- [ ] check_plan 四行都干净（缺号／越界／顺序）
- [ ] 逐页稿的"环节"与课件标题逐行并排念得通
- [ ] 前置 0—5 栏齐；目标按"条件＋行为＋可数程度"；每阶有可观察的达标表现
- [ ] 整份 A4 纵向（不切横向节）；五列压进 17.4cm，逐字稿列 8.0cm
- [ ] 封面之后直接进备课表，不插「使用说明」段

对话收尾（给老师的回复里要有）
- 一句话说清"这一课教到哪一层"（本课的分寸），不要只报页数；
- 报三关数字，不报"已完成"；
- 有做不到的地方直接说（比如主册没上传、教材段数两种说法），不要含糊过去。