课本知识重点 · 整理规范
每科每学期一份 md,固定六段结构;课本目录逐章照录、知识重点按章整理,不放课本就一律标「待确认」,不凭记忆补编。
一、适用边界
- 本规范只管
课本知识库/,与考试复盘的口径(判卷分数、板块拆行、可挽回失分)无关,两套规则互不引用。 - 整理粒度按学期:一学期一个目录,一科一个 md,不再往下拆单元文件夹。
- 课本是唯一权威:册次、版本、章节、页码、篇目、公式全部以放入
课本/的原件为准。 - 截至 2026-11-17,44 个科目位已全部放书并完成知识点总结,状态均为「已整理」;产出为 B 复习框架版 + C 陕西中考参照层(3.3),口径见第八节补与补二。
二、放书与命名
| 项目 | 约定 |
|---|---|
| 放书位置 | <学期目录>/课本/,例如 03_八年级上册/课本/ |
| 建议命名 | <科目>_<学期简称>_<版本>[_序号].<扩展名>,例 数学_八上_人教版.pdf |
| 扫描件 | 多张图片放同一目录,序号写在文件名里;原件原名一律保留,我不改名、不移动、不删除 |
| 识别方式 | 脚本按文件名里的科目名或别名匹配(道法/政治 → 道德与法治);认不出的文件会进清点报告的「未识别」清单,已在 rules.json → unrecognized_resolved 核对结论的会显示核对备注 |
| 允许格式 | PDF、JPG/PNG/WEBP/TIF、DOCX、TXT、MD、EPUB |
| 排除 | 放这里.md、.gitkeep 等占位文件不计入清点 |
科目矩阵、别名表、版本词表都写在 rules.json 里;人读版与本文件冲突时,以本文件为准并同步 JSON。
三、知识重点 md 的固定六段结构
模板如下(这也是初始 44 份占位文件的内容骨架):
# <科目> · <学期> · 知识重点
> 状态:待放书 | 教材版本:待确认 | 课本文件:待确认
## 一、定位
- 学期 / 册次 / 教材版本:
- 本册在初中三年体系中的位置:
- 前置知识与后续承接:
## 二、能做什么
- 学完本册应能完成的可验收动作(3–5 条,带数量或范围):
## 三、要点
### 3.1 课本目录
| 章 / 单元 | 节 | 页码 | 备注 |
| --- | --- | --- | --- |
| 待确认 | 待确认 | 待确认 | 待确认 |
### 3.2 分章知识重点
#### 第 X 章 <章名>
- 核心概念 / 公式 / 定理 / 实验:
- 篇目 / 时序 / 词汇 / 语法:
- 与本章对应的能力要求:
### 3.3 陕西中考参照(查漏补缺)
| 维度 | 内容 | 依据级别 |
| --- | --- | --- |
| 待确认 | 待确认 | 待确认 |
### 3.4 细节速查清单(逐条打勾查漏)
| ☐ | # | 条目 | 具体内容(公式 / 规则 / 原句) | 条件与易错 |
| --- | ---: | --- | --- | --- |
| ☐ | 1 | 待确认 | 待确认 | 待确认 |
### 3.5 典型代表题与答案解析(逐条对应 3.4)
**#1 <条目名>**
`1-1` **基础·直接应用** 题干
- 答案:待确认
- 解析:待确认
`1-2` **辨析·易错变式** 题干
- 答案:待确认
- 解析:待确认
## 四、易错
| 易错点 | 典型表现 | 正确做法 |
| --- | --- | --- |
| 待确认 | 待确认 | 待确认 |
## 五、自测
1. 待确认(3–5 条,能对照课本自评)
## 六、依据
- 课本文件:待确认
- 目录页与正文页码:待确认
- 提取日期:待确认
- 待确认清单:待确认
六段顺序固定,不增不减;3.1 课本目录、3.2 分模块知识重点、3.3 陕西中考参照、3.4 细节速查清单、3.5 典型代表题 是「三、要点」下的五个小节。B 复习框架版的 3.1 只到章 / 单元一级,3.2 按学科模块组织(见第八节补),不写页码与 §X.X 小节号;3.3 是考试维度参照,不是考点清单(见第八节补二);3.4 是可逐条打勾的学科通识速查清单(见第八节补三);3.5 逐条配题并附答案解析,题号与 3.4 编号一一对应(见第八节补四)。
四、课本目录提取规则
- 只读课本封面的书名、册次、版本、版权页与目录页;目录逐章照录,含「章 / 单元 / 节 / 页码」,不合并、不改写、不补编。
- 目录跨页时按页顺序拼接;
build_outline.py从首个目录命中页连续取 4 页、去重、按章号排序,避免漏掉最后一两个单元。扫描不清、装订遮挡的条目标待确认,并列入第六段「待确认清单」,写明需要补拍哪一页。 - 课本里没有的章节,哪怕通用教材常见,也不写进 3.1;3.2 只能覆盖 3.1 中已有的章。
- 练习题、章节小结、附录是否进目录,按课本印刷口径处理;有疑问标
待确认并说明。 - 一个科目位放了两本不同版本的课本时,按
rules.json → textbook_selection的prefer指定主课本;用户明确更换教材后按新教材重新取数,旧课本保留在课本/但不参与抽取,并在文档里写明版本变更。未登记且无法判断时先问用户,不擅自合并两套目录。 - PDF 无文本层的图片扫描版:用
render_toc_images.py渲染前几页拼图到07_目录图片/,视觉核对到的章 / 单元骨架写入_data_knowledge_ext.py → CHAPTERS_OVERRIDE_EXT;看不清的一律标待确认,不凭旧版教材补编章名。 - 不同课本之间出现章号体系、学制等口径冲突时,各自照录并在文档「待确认清单」写明,不擅自统一(
VERSION_WARNINGS)。
五、知识重点写作规则
| 规则 | 说明 |
|---|---|
| 按章对齐 | 3.2 的模块与 3.1 的章 / 单元对应,章数可核对 |
| 每章 3–8 条 | 理科写公式、定理、适用条件、实验结论;文科写篇目、概念、时序、词汇语法、答题要点 |
| 可验收 | 每条都能对照课本判断对错;禁用「认真 / 加强 / 注意 / 多练 / 掌握好 / 熟练掌握」等无数量、无验收线的词 |
| 易错要具体 | 写清「典型表现」与「正确做法」,不写「粗心」「不熟」这类无信息量归因 |
| 自测 3–5 条 | 以问题或任务形式给出,能直接在课本里找到答案 |
| 依据可追溯 | 第六段写明课本文件名、页码、提取日期;任何未核实处标 待确认 |
六、状态流转
| 状态 | 触发 | 谁改 |
|---|---|---|
| 待放书 | 初始 | 模板默认值 |
| 已放书·待提取 | scan_books.py 识别到该科课本 | 脚本在清点报告中标出 |
| 目录已提取·待整理 | 我说「按 <学期> 提取课本目录」 | 我改 md 首行状态 |
| 已整理 | 六段齐全、校验通过 | 我改 md 首行状态,并重建手册 |
状态写在 md 首行引用 > 状态:… 里,_build_manual.py 据此决定该文档是否进入手册章节与文档地图。只有「已整理」的科目才会进入手册正文,避免空模板把手册撑成一本空书。
七、S1–S5 流程
| 步骤 | 动作 | 产出 |
|---|---|---|
| S1 | 运行 scan_books.py 清点课本 | 00_清点结果.md(册次、版本、缺书、未识别文件、版本变更登记) |
| S2 | 逐本照录封面与目录;图片版渲染拼图视觉核对 | 对应 <科目>.md 的 3.1,状态改「目录已提取·待整理」 |
| S3 | 按章整理要点、易错、自测、依据 | 六段齐全的 <科目>.md,状态改「已整理」 |
| S4 | 运行 _build_manual.py | 6 篇学期状态页 + 手册 + 独立页,已整理文档自动入册 |
| S5 | 校验 | 章数一致、六段齐全、无编造内容、死链为 0;旧结论变更先备份再更新 |
触发语:「按八上提取课本目录」「按七下整理数学知识重点」「课本放好了,整理知识重点」。
只放文件、没说明意图时,我先给清单与待确认项,再问是否开始,不擅自写知识重点。
八、原则
- 不编造章节、知识点、页码;缺失一律
待确认,并写明补什么材料。 - 不覆盖用户文件:课本原件只读;
知识重点/*.md已「已整理」的默认跳过,需_build_knowledge.py --force才重写;人工编辑过的文件一律跳过;改版前先备份。 - 只整理实际放了课本的科目,其余保持「待放书」,不凑数。
- 版本或册次口径变更(例如换成九年级全一册、更换教材版本)后,重新取数并重跑 S1–S5,旧结论作废。
- 脚本产物(
10_*.md~60_*.md、00_清点结果.md、00_*清单.md、课本知识手册.html、pages/*.html)勿手改,改源数据与脚本后重跑。
八·补、知识点总结的五层口径(2026-11-17 固化,v1.5 修订)
| 层级 | 产出 | 依据 | 状态标记 |
|---|---|---|---|
| A 严格逐节版(S2–S3) | 逐本照录课本章节 + 按章写要点,标 §X.X 与页码 | 课本正文逐页核对 | 课本逐节版(本库尚未生成) |
| B 复习框架版(当前 44 份) | 3.1 章/单元照录目录(抽不到标 待确认);3.2 按学科模块整理知识点总结 | 目录页抽取/视觉核对 + 学科知识模块 | 已整理(知识点总结) |
| C 中考参照层(当前 44 份的 3.3) | 考试地位、能力题型参照、缺口与补法、补充自测、待确认项 | 省厅通知/市级文件/课标/公开试卷评析,逐条标级别 | 已整理(含中考参照层) |
| D 细节速查层(当前 44 份的 3.4) | 462 条公式/语法/搭配/篇目卡,逐条打勾默写 | 学科通识 + 课本真实章 / 单元与篇目骨架 | 已整理(含细节速查层) |
| E 典型题层(当前 44 份的 3.5) | 924 道题,每条卡配 2 题 + 答案 + 解析 | 学科通识自编题,题号与 3.4 卡片对应 | 已整理(含典型题层) |
- F 可视化层(v1.6)不是第六个内容层:
导图/<学期号>_<科目>.html只是把 B / D / E 换成思维导图 + 卡片,内容与 3.4 / 3.5 完全一致,不改任何知识点。 - B 版不冒充课本逐节原文:不写页码、不虚构小节编号;每份「六、依据」都列出待确认清单(小节锚点、页码、原文表述)。
- 目录为图片扫描版或文本层不可解析的册次,3.1 一律标
待确认,不凭通用教材补编章名;补拍目录页或用07_目录图片/拼图人工核对后回填CHAPTERS_OVERRIDE_EXT。 - A、B、C、D、E 五层不得混用:把 B 版当课本原文引用、把 A 版的待确认项当成已知、把 C 层当官方考点清单引用、把 D 层公式当课本原文逐字引用、把 E 层自编题当课本原题或中考真题,都算违规。
- 3.2 的「模块」是复习用的知识组织方式,不是课本目录;后续要逐节锚定时按 S2–S3 重做 A 版。
- 数据源拆两份:
_data_knowledge.py(上一轮 24 份 + 六科验收口径)、_data_knowledge_ext.py(本轮 20 份 + 物理/化学/道法验收口径 + 视觉核对骨架 + 口径冲突警告)。表格单元格会转义 ASCII 竖线,数据源里禁用|字符(如绝对值写成「一个数的绝对值」)。 - 中间产物:
00_课本目录原文.md(目录页原文)、00_章节清单.md(清洗条目)、00_章单元清单.md(一级结构)、07_目录图片/(图片课本目录拼图与高清单页)。
教材版本变更与选书(2026-11-17 补充)
- 同一科目位有多版课本时,以
rules.json → textbook_selection的prefer为准;extract_toc.pick_pdf、build_outline.py、scan_books.detect_version都按此选书。 - 已登记:八上/物理由人教版换为苏科版(与八下、九上、九下物理同版本)。旧课本
【人教版】八年级上册(2024秋版)物理电子课本.pdf保留在课本/但不参与取数;八上物理知识点已按苏科版重新生成,文档首部写明版本变更。 - 清点报告新增「六、教材版本变更登记」,列出科目位、现行教材、被替换课本与原因;如需换回,改
rules.json后重跑 S1–S5。 - 已登记的课本口径冲突:九上数学目录为第二十五~三十章,九下数学为第二十六~二十九章,两册章号体系不连续;九上道法为「人教54制」。均已在对应文档「待确认清单」标注,需核对封面与版权页,不擅自统一。
八·补二、陕西中考参照层(2026-11-17 v1.3 新增)
- 陕西省没有逐科「中考考点清单/考纲」:省教育厅《关于做好 2026 年陕西省初中学业水平考试工作的通知》(陕教基一办〔2026〕1 号)只规定科目、方式、分值、时长,并明确命题依据为「各学科义务教育国家课程标准」。因此 3.3 不是考点清单,不据此重排 3.1 章名或 3.2 知识点。
- 依据分级:【官方】省厅与市(区)教育局文件 →【课标】国家课程标准 →【评析】公开试卷点评 →【研讨】研讨会第三方整理 →【统计】本库关键词统计 →【推算】按项目资料推算 →【待确认】。只有【官方】可作考试口径依据;【评析】【研讨】【参考·需核实】只作命题特点参照,不得当必考知识点。
- 3.3 固定五块:考试地位表(分值/时长/方式/实验操作/计分口径)、能力题型参照表、现有总结缺口与补法表、3 条带数量与验收线的补充自测、待确认项;每份带学期提示。
- 本轮没改 3.1 与 3.2:3.1 仍照录课本目录,3.2 仍是按学科模块整理的复习要点;补的是中考维度,不改课本口径。
- 计分科目由各市(区)自定:已核实的延安、安康等地文件明确自 2027 届起调整为 8 科计分、地理与生物学不再计入招生总分;其他地市与第三方汇总说法一律标
待确认,不代为假定用户所在市、学生届别与中考年份。 - 数据源与产物:
_data_shaanxi.py是唯一数据源,render_section()注入 44 份 3.3,render_report()生成00_陕西中考参照与查漏补缺.md;_build_knowledge.py每次运行自动重写该报告。政策按年份变化,来源更新后须改数据源重跑,旧结论作废。 - 全库缺口统计(2026-11-17,未补前):44 份中「中考/分值/结业/开卷/听力/实验操作/课标/答题规范/开放性/建模/材料分析/时政/地方史」命中均为 0,「跨学科/真实情境」各 6 份、「整本书阅读」4 份。这是本轮查漏补缺的客观依据。
八·补三、D 细节速查层(2026-11-17 v1.4 新增)
为什么加这一层:用户反馈原产出「偏大纲、没有细节、没法让孩子查漏补缺、知识点不够直观」。3.2 的模块表一条覆盖一整章,无法逐条默写公式、背诵搭配、核对文言实词,因此把颗粒度下沉到「一条公式 / 一条语法 / 一组搭配 / 一篇课文」。
- 3.4 固定结构:按组渲染可打勾表格,列为
☐ / # / 条目 / 具体内容(公式 / 规则 / 原句)/ 条件与易错;每份末尾附本科「逐条验收动作」(带数量与验收线)与待确认项。用法:遮住第 4 列逐条默写,不会的在 ☐ 打勾,隔天重测、连续两次全对才划掉。 - 各学科给什么:数学 / 物理 / 化学给基础公式、定理、定律与适用条件(含单位、符号含义、反例);英语给语法规则与固定搭配;语文给重点文言文的实词、通假、名句默写与重点课文的体裁主旨写法;历史 / 地理 / 生物 / 道法给核心史事、概念、过程与观点。
- 分组口径:尽量照录本册 3.1 的章 / 单元名;3.1 标
待确认的册次,以及语文(按文言文/现代文)、英语(按语法/搭配)改按学科模块分组,不编造章名或 Unit 名。 - 依据边界:篇目名、Unit 名、章名照录课本目录或
07_目录图片/视觉核对结果;公式、语法规则、名句默写属学科通识,不冒充课本逐节原文,不写页码、不虚构§X.X小节号。课本原始表述、Grammar Focus 所在页、例题编号一律标待确认。 - 数据源与产物:
_data_details.py是渲染框架(含render_section()与render_handbook()),卡片存于_data_details_sci.py(数理化)、_data_details_lang.py(语文英语)、_data_details_other.py(史地生道法),共 462 条、44 个科目位。_build_knowledge.py每次运行自动重写00_公式语法篇目速查手册.md(按学科汇总、可整本打印)。改卡片内容只改对应数据源,再--force重跑。 - 数据源禁用 ASCII 竖线:表格单元格会把
|转义吃掉绝对值符号;绝对值一律写成「一个数的绝对值」等中文表述。 - 本轮没改 3.1 / 3.2 / 3.3:只在「三、要点」下追加 3.4,课本目录、知识点模块与中考参照口径均保持原样。
八·补四、E 典型题层(2026-11-17 v1.5 新增)
为什么加这一层:用户要求「每个公式或知识点后面出两道典型代表题并附上答案解析」。3.4 只能默写打勾,缺少"会不会用"的验证;3.5 把每条卡片变成 2 道可独立作答的题,做完对答案、读解析,再回 3.4 打勾或划掉。
- 编号一一对应:题号
N-1/N-2对应同册 3.4 的第 N 条卡片。孩子哪条打勾,就翻到同号题重做;全库 462 条卡 × 2 = 924 道题。 - 两题分工:题 1 是「基础·直接应用」——用卡片「具体内容」列的公式/规则/原句就能做,必须带具体数值、完整句子或明确求解目标;题 2 是「辨析·易错变式」——针对「条件与易错」列设计具体错句、判断改错、补成立条件、易混概念比较或条件变化后重算。
- 答案与解析硬要求:答案唯一明确,禁止「略/见解析/答案不唯一/言之有理即可」;解析必须含关键步骤或判断依据 + 该条卡片的易错点。计算题答案带数值与单位,默写题答案给完整原句,英语改错题给改后的完整句子。
- 依据边界:题目按学科通识自编,不是课本原题、不是中考真题,不写页码、不标
§X.X、不编造课后习题号或真题出处,不得据此推断必考题型与分值;题目表述或答案与课本正文冲突时以课本为准。 - 数据源与产物:
_data_exercises.py是渲染框架(合并 7 份数据源、render_section()注入 3.5、render_book()生成总册、check()硬校验)。题目按学科分存:_data_exercises_math.py(数学 208 题)、_data_exercises_physchem.py(物理化学 206 题)、_data_exercises_chinese.py(语文 162 题)、_data_exercises_english.py(英语 138 题)、_data_exercises_histgeo.py(历史地理 112 题)、_data_exercises_bioethics.py(生物道法 98 题),_data_exercises_other.py只做后两份的合并入口。_build_knowledge.py每次运行自动重写00_典型题与答案解析手册.md(按学科汇总 924 题,可整本打印)。 - 数据契约:
EX[(学期, 学科)]的外层长度必须等于该册 3.4 卡片数,每组恰好 2 题,每题恰好 3 字段(题干, 答案, 解析);数据源禁用 ASCII 竖线。_build_knowledge.py运行前先跑check(),条数/字段/竖线任一不符就直接阻断生成,避免输出半套题号。 - 本轮没改 3.1 / 3.2 / 3.3 / 3.4:只在「三、要点」下追加 3.5,前面四层内容保持原样。
八·补五、F 可视化层(导图版,2026-11-17 v1.6 新增)
为什么加这一层:用户反馈「知识重点可读性很差,全是文字,能否用思维导图或更好的形式呈现」。问题不在内容,在呈现——md 与手册页面是「表格 + 长段落」,孩子定位不到某一条、也看不下去。本层只换呈现形式,不新增、不改写任何知识点。
- 产物:
导图/<学期号>_<科目>.html(44 份单科页)+导图/导图总览.html(全部科目入口)。每页两段:上半是思维导图(根 = 册次科目 → 章 / 模块 → 条目),下半是逐条卡片。 - 一页三视图:① 导图看结构,点章标签跳到该章第一张卡,点条目跳到具体卡片;② 卡片看细节,
具体内容正文 +易错 / 条件黄色警示块;③ 两道典型题折叠在卡片里,答案默认收起(先做再展开)。 - 自测开关:「遮住内容自测」把
具体内容模糊掉,用于默写公式/语法/名句,鼠标悬停或再次点击恢复;打印时自动解除模糊,答案全部展开。 - 数据来源与一致性:
_build_mindmap.py直接读_data_details.CARDS(3.4)与_data_exercises.EX(3.5),不另存一份内容;条目编号 N 与题号 N-1/N-2 一一对应。条数不一致(EX外层 ≠ 卡片数)时跳过该科并报错,不生成半套页。 - 口径不变:F 是呈现层,不是第六个内容层。导图里的公式、语法、篇目仍属学科通识(D 层边界),题目仍是自编题(E 层边界),不得因「看起来像图」就当成课本原文或中考考点。
- 入口:手册每章顶部「🖼 知识导图版」、手册侧栏「🧭 知识导图总览」、每份知识重点 md 第 3 行、速查手册首部均有链;
_build_manual.py只在导图文件存在时才挂链接,避免死链。 - 重建:
python _build_mindmap.py(在_build_knowledge.py之后、_build_manual.py之前),自带锚点与链接自检;--check只校验数据是否齐备、不写文件。
九、重建命令
在 课本知识库/ 目录下运行(顺序不可颠倒):
python extract_toc.py # 目录页原文 + 清洗章节清单(全部六学期)
python build_outline.py # 章/单元一级结构 → 00_章单元清单.md
python render_toc_images.py # 无文本目录的课本 → 07_目录图片/ 拼图(视觉核对后回填数据源)
python _build_knowledge.py # 生成尚未整理的六段 md(已整理默认跳过)+ 自动重写三份总册
python _build_knowledge.py --force # 口径变更后全量重写 44 份 + 重写三份总册(含题目硬校验)
python _build_mindmap.py # 生成 44 份单科导图 + 6 份学期合订本 + 导图总览.html(自带锚点/链接自检)
python scan_books.py # 清点课本,重写 00_清点结果.md
python _build_manual.py # 重建学期状态页、手册、独立页 + 死链校验
python _build_manual.py --check # 只校验链接,不写 HTML
单学期处理可给 extract_toc.py/build_outline.py 传学期简称,如 python build_outline.py 九上。
改知识点内容请改 _data_knowledge.py 或 _data_knowledge_ext.py,改中考参照口径请改 _data_shaanxi.py,改公式/语法/篇目卡请改 _data_details_sci.py/_data_details_lang.py/_data_details_other.py,改题目请改对应的 _data_exercises_*.py,再跑 _build_knowledge.py --force → _build_mindmap.py → scan_books.py → _build_manual.py。只改导图样式改 _build_mindmap.py 的 CSS,不用动数据源。题目条数与卡片数不一致时脚本会拒绝生成,须先补齐数据源。
十、相关文件
- 00_课本清单.md:三年六学期的册次总表与放书步骤
- rules.json:机器可读契约
- 00_陕西中考参照与查漏补缺.md:考试口径、依据分级、覆盖统计与来源链接
- 00_公式语法篇目速查手册.md:462 条公式/语法/搭配/篇目卡,可整本打印、逐条打勾
- 00_典型题与答案解析手册.md:924 道典型题 + 答案 + 解析,题号与速查卡一一对应,可整本打印
- 00_清点结果.md:实时清点报告
- 00_课本目录原文.md / 00_章节清单.md / 00_章单元清单.md:目录依据
- 导图/导图总览.html:44 份单科思维导图 + 卡片页入口
- 导图/合订_*.html:6 份学期合订本,一学期一文件、页内切科,不跨文件跳转(面板里点不动链接时用这个)
- 课本知识手册.html:全库单一手册