← 返回手册目录第 2 / 55 篇 · 总览与规范
文件路径:00_整理规范.md源文件 .md

课本知识重点 · 整理规范

每科每学期一份 md,固定六段结构;课本目录逐章照录、知识重点按章整理,不放课本就一律标「待确认」,不凭记忆补编。

一、适用边界

二、放书与命名

项目约定
放书位置<学期目录>/课本/,例如 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 编号一一对应(见第八节补四)。

四、课本目录提取规则

  1. 只读课本封面的书名、册次、版本、版权页与目录页;目录逐章照录,含「章 / 单元 / 节 / 页码」,不合并、不改写、不补编。
  2. 目录跨页时按页顺序拼接;build_outline.py 从首个目录命中页连续取 4 页、去重、按章号排序,避免漏掉最后一两个单元。扫描不清、装订遮挡的条目标 待确认,并列入第六段「待确认清单」,写明需要补拍哪一页。
  3. 课本里没有的章节,哪怕通用教材常见,也不写进 3.1;3.2 只能覆盖 3.1 中已有的章。
  4. 练习题、章节小结、附录是否进目录,按课本印刷口径处理;有疑问标 待确认 并说明。
  5. 一个科目位放了两本不同版本的课本时,按 rules.json → textbook_selection 的 prefer 指定主课本;用户明确更换教材后按新教材重新取数,旧课本保留在 课本/ 但不参与抽取,并在文档里写明版本变更。未登记且无法判断时先问用户,不擅自合并两套目录。
  6. PDF 无文本层的图片扫描版:用 render_toc_images.py 渲染前几页拼图到 07_目录图片/,视觉核对到的章 / 单元骨架写入 _data_knowledge_ext.py → CHAPTERS_OVERRIDE_EXT;看不清的一律标 待确认,不凭旧版教材补编章名。
  7. 不同课本之间出现章号体系、学制等口径冲突时,各自照录并在文档「待确认清单」写明,不擅自统一(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.py6 篇学期状态页 + 手册 + 独立页,已整理文档自动入册
S5校验章数一致、六段齐全、无编造内容、死链为 0;旧结论变更先备份再更新

触发语:「按八上提取课本目录」「按七下整理数学知识重点」「课本放好了,整理知识重点」。
只放文件、没说明意图时,我先给清单与待确认项,再问是否开始,不擅自写知识重点。

八、原则

  1. 不编造章节、知识点、页码;缺失一律 待确认,并写明补什么材料。
  2. 不覆盖用户文件:课本原件只读;知识重点/*.md 已「已整理」的默认跳过,需 _build_knowledge.py --force 才重写;人工编辑过的文件一律跳过;改版前先备份。
  3. 只整理实际放了课本的科目,其余保持「待放书」,不凑数。
  4. 版本或册次口径变更(例如换成九年级全一册、更换教材版本)后,重新取数并重跑 S1–S5,旧结论作废。
  5. 脚本产物(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 卡片对应已整理(含典型题层)

教材版本变更与选书(2026-11-17 补充)

八·补二、陕西中考参照层(2026-11-17 v1.3 新增)

八·补三、D 细节速查层(2026-11-17 v1.4 新增)

为什么加这一层:用户反馈原产出「偏大纲、没有细节、没法让孩子查漏补缺、知识点不够直观」。3.2 的模块表一条覆盖一整章,无法逐条默写公式、背诵搭配、核对文言实词,因此把颗粒度下沉到「一条公式 / 一条语法 / 一组搭配 / 一篇课文」。

八·补四、E 典型题层(2026-11-17 v1.5 新增)

为什么加这一层:用户要求「每个公式或知识点后面出两道典型代表题并附上答案解析」。3.4 只能默写打勾,缺少"会不会用"的验证;3.5 把每条卡片变成 2 道可独立作答的题,做完对答案、读解析,再回 3.4 打勾或划掉。

八·补五、F 可视化层(导图版,2026-11-17 v1.6 新增)

为什么加这一层:用户反馈「知识重点可读性很差,全是文字,能否用思维导图或更好的形式呈现」。问题不在内容,在呈现——md 与手册页面是「表格 + 长段落」,孩子定位不到某一条、也看不下去。本层只换呈现形式,不新增、不改写任何知识点。

九、重建命令

在 课本知识库/ 目录下运行(顺序不可颠倒):

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,不用动数据源。题目条数与卡片数不一致时脚本会拒绝生成,须先补齐数据源。

十、相关文件

⌂ 首页