{
  "version": "1.7",
  "updated": "2026-11-17",
  "version_notes": "v1.0 初版：固化六学期 × 九科的课本册次矩阵、放书命名、知识重点六段模板、状态流与 S1–S5 流程。v1.1 新增 knowledge_summary_mode：区分严格逐节版与复习框架版，禁止把模块整理内容冒充课本原文；同步修正 scan_books.py 的短别名误匹配 bug。v1.2 新增 textbook_selection：同一科目位有多版课本时指定主课本（八上物理由人教版换为苏科版）；目录抽取与知识点生成扩展到全部六学期 44 个科目位；补充苏科版/人教54制等版本词。v1.3 新增 shaanxi_zhongkao：登记陕西中考参照口径与依据分级，44 份知识点增加 3.3 中考参照层（考试地位／能力题型／缺口与补法／补充自测／待确认），明确陕西省无官方逐科考点清单、命题依据为国家课程标准，禁止据试卷评析编造考点；新增 _data_shaanxi.py 与 00_陕西中考参照与查漏补缺.md。v1.4 新增 detail_layer：用户反馈原产出偏大纲、无法逐条查漏，故给 44 份增加 3.4 细节速查层（数理化公式原理、英语语法与固定搭配、语文重点文言文与课文、其他科核心条目），共 462 条可打勾卡片；新增 4 份 _data_details*.py 数据源与 00_公式语法篇目速查手册.md；A／B／C／D 四层口径不得混用。v1.5 新增 exercise_layer：用户要求「每个公式或知识点后面出两道典型代表题并附答案解析」，故给 44 份增加 3.5 典型题层，为 462 条 3.4 卡片各配 2 题共 924 道（题 1 基础直接应用、题 2 易错辨析或变式），每题含题干／答案／解析，题号 N-1 / N-2 与 3.4 卡片编号一一对应；新增 7 份 _data_exercises*.py 数据源与 00_典型题与答案解析手册.md；_build_knowledge.py 运行前做题目数据硬校验（条数／字段／竖线），不一致直接阻断。A／B／C／D／E 五层口径不得混用。v1.6 新增 visual_layer：用户反馈知识重点「可读性差、全是文字」，故把 3.4 卡片与 3.5 题目渲染成「思维导图 + 卡片 + 折叠答案」的 44 份单科 HTML（导图/<学期号>_<科目>.html）与导图总览；新增 _build_mindmap.py，只换呈现形式、不新增或改写任何知识点，F 层是呈现层而非第六个内容层；手册每章顶部、侧栏、md 首部均加入导图入口。v1.7 解决「导图链接点不动」：① 新增学期合订本 导图/合订_<学期号>_<学期名>.html 共 6 份，一学期一文件、页内按钮切科（JS 失效时自动降级为全部连续显示），彻底不依赖跨文件跳转；② pages/*.html 每页内置该页导图（iframe srcdoc，单科页用单科导图、状态页用该学期合订本），点开即看、不跨文件；③ 修 _build_mindmap 主干竖线 bottom 取值错误（原写成距顶坐标，竖线被压成一小段似断线）。",
  "root_dir": "课本知识库",
  "purpose": "把『课本放进固定目录 → 逐本提取目录 → 按学期整理各科知识重点 → 汇总成手册』的流程固化为机器可读契约",
  "subjects": [
    {
      "name": "语文",
      "aliases": [
        "语文",
        "chinese",
        "yw"
      ],
      "volumes": "七上/七下/八上/八下/九上/九下 共 6 册",
      "note": "统编版（部编版）为主"
    },
    {
      "name": "数学",
      "aliases": [
        "数学",
        "math",
        "sx"
      ],
      "volumes": "七上/七下/八上/八下/九上/九下 共 6 册",
      "note": "版本差异较大，以课本封面为准"
    },
    {
      "name": "英语",
      "aliases": [
        "英语",
        "english",
        "yy"
      ],
      "volumes": "七上/七下/八上/八下/九上/九下 共 6 册",
      "note": "人教版新目标 / 外研 / 译林 / 仁爱等"
    },
    {
      "name": "物理",
      "aliases": [
        "物理",
        "physics",
        "wl"
      ],
      "volumes": "八上/八下/九上/九下 共 4 册（苏科版分册）",
      "note": "本库实际为苏科版，八上/八下/九上/九下各一册；人教版常见九年级全一册，不混用"
    },
    {
      "name": "化学",
      "aliases": [
        "化学",
        "chemistry",
        "hx"
      ],
      "volumes": "九上/九下 共 2 册",
      "note": "部分版本为九年级全一册；本库为人教版上下册"
    },
    {
      "name": "道德与法治",
      "aliases": [
        "道德与法治",
        "道法",
        "政治",
        "思品",
        "zz",
        "df"
      ],
      "volumes": "七上/七下/八上/八下/九上/九下 共 6 册",
      "note": "统编版；九上为「人教54制」五四学制册，与六三制内容不同"
    },
    {
      "name": "历史",
      "aliases": [
        "历史",
        "history",
        "ls"
      ],
      "volumes": "七上/七下/八上/八下/九上/九下 共 6 册",
      "note": "统编版；七上七下中国古代史、八上八下中国近现代史、九上九下世界史"
    },
    {
      "name": "地理",
      "aliases": [
        "地理",
        "geography",
        "dl"
      ],
      "volumes": "七上/七下/八上/八下 共 4 册",
      "note": "八年级结业考后一般不再有新授课本"
    },
    {
      "name": "生物",
      "aliases": [
        "生物",
        "biology",
        "sw"
      ],
      "volumes": "七上/七下/八上/八下 共 4 册",
      "note": "八年级结业考后一般不再有新授课本"
    }
  ],
  "semesters": [
    {
      "id": "01",
      "name": "七年级上册",
      "short": "七上",
      "dir": "01_七年级上册",
      "subjects": [
        "语文",
        "数学",
        "英语",
        "道德与法治",
        "历史",
        "地理",
        "生物"
      ]
    },
    {
      "id": "02",
      "name": "七年级下册",
      "short": "七下",
      "dir": "02_七年级下册",
      "subjects": [
        "语文",
        "数学",
        "英语",
        "道德与法治",
        "历史",
        "地理",
        "生物"
      ]
    },
    {
      "id": "03",
      "name": "八年级上册",
      "short": "八上",
      "dir": "03_八年级上册",
      "subjects": [
        "语文",
        "数学",
        "英语",
        "物理",
        "道德与法治",
        "历史",
        "地理",
        "生物"
      ]
    },
    {
      "id": "04",
      "name": "八年级下册",
      "short": "八下",
      "dir": "04_八年级下册",
      "subjects": [
        "语文",
        "数学",
        "英语",
        "物理",
        "道德与法治",
        "历史",
        "地理",
        "生物"
      ]
    },
    {
      "id": "05",
      "name": "九年级上册",
      "short": "九上",
      "dir": "05_九年级上册",
      "subjects": [
        "语文",
        "数学",
        "英语",
        "物理",
        "化学",
        "道德与法治",
        "历史"
      ]
    },
    {
      "id": "06",
      "name": "九年级下册",
      "short": "九下",
      "dir": "06_九年级下册",
      "subjects": [
        "语文",
        "数学",
        "英语",
        "物理",
        "化学",
        "道德与法治",
        "历史"
      ]
    }
  ],
  "volume_note": "以上为常见人教版/统编版排布，仅作放书清点参照。实际册次、是否全一册、九下是否只有复习册，一律以用户放入的课本为准；多出或缺少的科目按实际增删，不为凑齐矩阵编造课本。",
  "textbook_selection": {
    "note": "同一科目位放有多本不同版本课本时，按 prefer 关键词指定主课本；未列出的按文件名最短者。用户更换教材后必须在此登记，旧课本保留在目录里但不参与目录抽取与知识点生成。",
    "八上/物理": {
      "prefer": "苏科版",
      "reason": "2026-11-17 用户更换教材：八上物理由人教版换为苏科版，与八下、九上、九下物理（均为苏科版）保持同版本连贯",
      "superseded": "【人教版】八年级上册(2024秋版)物理电子课本.pdf"
    }
  },
  "unrecognized_resolved": {
    "note": "文件名不含科目名而被清点脚本列为未识别的文件，经封面视觉核对后的结论；原件一律保留不改名，不参与选书。",
    "2.人教版八下新教材（彩版无水印）.pdf": "经封面视觉核对：人教版八年级下册英语（2024 审定），与 2026春新人教版英语八年级下册新教材（彩色高清版）.pdf 为同科第二本；文件名不含科目名故列入未识别清单，不作为主课本。"
  },
  "directory_structure": {
    "00_课本清单.md": "人读主清单：三年六学期 × 各科册次矩阵、放书步骤、版本差异说明",
    "00_整理规范.md": "人读规范：知识重点六段模板、目录提取规则、状态流、S1–S5 流程",
    "rules.json": "本文件，机器可读契约；与人读文档冲突时以 00_整理规范.md 为准并同步本文件",
    "<学期>/课本/": "用户放课本 PDF／扫描件／照片；只进不出，不重命名、不改动原文件",
    "<学期>/知识重点/": "AI 产出：每科一个 <科目>.md，固定六段结构；未整理前为占位模板",
    "10_*.md ~ 60_*.md": "脚本生成的 6 篇学期清单页（含放书状态与下一步），勿手改",
    "00_清点结果.md": "脚本生成的清点报告，勿手改",
    "00_课本目录原文.md / 00_章节清单.md / 00_章单元清单.md": "目录抽取中间产物，供 3.1 照录，勿手改",
    "07_目录图片/": "图片扫描版课本的目录页拼图，供视觉核对回填 3.1",
    "课本知识手册.html": "脚本生成的单一手册，左侧目录 + 锚点 + 文档地图 + 可打印",
    "pages/*.html": "脚本生成的独立页，带上一篇／下一篇／返回手册",
    "_build_manual.py": "重建脚本：生成学期清单页、占位文档、手册、独立页并校验死链",
    "scan_books.py": "清点脚本：逐学期逐科检查课本文件与知识重点状态",
    "extract_toc.py": "目录页原文抽取（全部六学期，按 textbook_selection 选主课本）",
    "build_outline.py": "章/单元一级结构抽取（跨页目录连续取 4 页、去重、按章号排序）",
    "render_toc_images.py": "为无文本目录的课本渲染 07_目录图片/ 拼图，供视觉核对",
    "_data_knowledge.py": "知识点数据源主体：上一轮 24 份 + 模块/自测模板",
    "_data_knowledge_ext.py": "知识点数据源扩展包：本轮 20 份 + 物理/化学/道法验收口径 + 视觉核对骨架 + 口径冲突警告",
    "_build_knowledge.py": "生成 44 份六段 md，并自动重写中考参照总报告、细节速查手册与典型题手册；运行前硬校验题目数据；默认保护已整理文档，--force 全量重写",
    "_data_shaanxi.py": "陕西中考参照唯一数据源：依据分级、考试地位、能力题型、缺口与补法、补充自测、来源链接；渲染 3.3 与总报告",
    "_data_details.py": "D 细节速查层渲染框架：合并 3 份数据源、渲染 3.4 可打勾表格与速查手册，含逐条验收动作",
    "_data_details_sci.py": "细节卡数据源：数学 6 册 / 物理 4 册 / 化学 2 册的公式、定理、原理与适用条件",
    "_data_details_lang.py": "细节卡数据源：语文 6 册文言文名句与重点课文、英语 6 册语法规则与固定搭配",
    "_data_details_other.py": "细节卡数据源：历史 6 册 / 地理 4 册 / 生物 4 册 / 道法 6 册的核心条目",
    "00_陕西中考参照与查漏补缺.md": "由 _data_shaanxi.py 渲染，勿手改：官方口径、市级差异、课标过渡、覆盖统计、待确认清单与来源",
    "00_公式语法篇目速查手册.md": "由 _data_details.py 渲染，勿手改：按学科汇总 462 条细节卡，可整本打印、逐条打勾",
    "_data_exercises.py": "E 典型题层渲染框架：合并 7 份数据源、渲染 3.5 与典型题手册，含 check() 硬校验",
    "_data_exercises_math.py": "题目数据源：数学 6 册 104 条卡 × 2 = 208 题",
    "_data_exercises_physchem.py": "题目数据源：物理 4 册 + 化学 2 册 103 条卡 × 2 = 206 题",
    "_data_exercises_chinese.py": "题目数据源：语文 6 册 81 条卡 × 2 = 162 题",
    "_data_exercises_english.py": "题目数据源：英语 6 册 69 条卡 × 2 = 138 题",
    "_data_exercises_other.py": "题目合并入口：史地生道法 20 册，汇总 histgeo 与 bioethics 两份数据源",
    "_data_exercises_histgeo.py": "题目数据源：历史 6 册 + 地理 4 册 56 条卡 × 2 = 112 题",
    "_data_exercises_bioethics.py": "题目数据源：生物 4 册 + 道法 6 册 49 条卡 × 2 = 98 题",
    "00_典型题与答案解析手册.md": "由 _data_exercises.py 渲染，勿手改：按学科汇总 924 道题与答案解析，题号与 3.4 卡片一一对应，可整本打印"
  },
  "file_name_pattern": "<科目>_<学期简称>_<版本>[_序号].<扩展名>",
  "file_name_examples": [
    "数学_七上_人教版.pdf",
    "英语_八下_外研版.pdf",
    "物理_九全_人教版.pdf",
    "化学_九上_人教版_01.jpg"
  ],
  "naming_policy": "命名建议而非强制：文件名含科目名或别名即可自动识别；扫描件原名一律保留，脚本不重命名、不移动用户文件。",
  "allowed_ext": [
    ".pdf",
    ".jpg",
    ".jpeg",
    ".png",
    ".webp",
    ".tif",
    ".tiff",
    ".bmp",
    ".md",
    ".txt",
    ".docx",
    ".epub"
  ],
  "placeholder_files": [
    "放这里.md",
    ".gitkeep"
  ],
  "versions": [
    "人教版",
    "统编版",
    "部编版",
    "北师大版",
    "苏教版",
    "苏科版",
    "沪教版",
    "沪科版",
    "外研版",
    "译林版",
    "仁爱版",
    "浙教版",
    "鲁教版",
    "粤教版",
    "华东师大版",
    "湘教版",
    "中图版",
    "教科版",
    "冀少版",
    "济南版",
    "西师版",
    "人教54制"
  ],
  "output_template": {
    "structure": [
      "一、定位",
      "二、能做什么",
      "三、要点（3.1 课本目录 + 3.2 分模块知识重点 + 3.3 陕西中考参照 + 3.4 细节速查清单 + 3.5 典型代表题）",
      "四、易错",
      "五、自测",
      "六、依据"
    ],
    "detail_check_note": "3.4 每条含「具体内容」与「条件与易错」，表首列 ☐ 供逐条打勾；遮住具体内容默写，连续两次全对才划掉",
    "exam_reference_note": "3.3 是考试维度参照，不是考点清单；不改 3.1 与 3.2，逐条标依据级别",
    "status_line": "> 状态：待放书　|　教材版本：待确认　|　课本文件：待确认",
    "chapter_toc": "3.1 课本目录必须逐章照录课本印刷目录（章/单元/节/页码），不合并、不改写、不补编",
    "key_points": "3.2 按 3.1 的每一章写 3–8 条知识重点；理科含公式/定理/实验，文科含篇目/概念/时序/词汇；每条可验收",
    "forbidden_words": [
      "认真",
      "加强",
      "注意",
      "多练",
      "掌握好",
      "熟练掌握"
    ],
    "quantified": "动作与目标必须带数量、范围或验收线；不写无验收线的空话",
    "exercise_note": "3.5 每条 3.4 卡片配 2 题，题号 N-1 / N-2 与卡片编号对应；题 1 基础直接应用、题 2 针对「条件与易错」列做辨析或变式；每题必须有唯一答案与含易错点的解析，禁止「略／见解析／答案不唯一」，禁止编造课本原题、课后习题号或中考真题出处"
  },
  "status_flow": [
    "待放书",
    "已放书·待提取",
    "目录已提取·待整理",
    "已整理"
  ],
  "pipeline": [
    "S1 运行 scan_books.py 清点各学期课本，确认册次、版本、缺书与未识别文件",
    "S2 运行 extract_toc.py 与 build_outline.py 抽取目录原文与章/单元一级结构；图片扫描版渲染 07_目录图片/ 拼图视觉核对",
    "S3 按 3.1 每章整理知识重点、易错、自测、依据，状态改为『已整理』",
    "S4 运行 _build_manual.py 重建手册与独立页，已整理文档自动纳入章节与文档地图",
    "S4' 运行 _build_mindmap.py 生成 44 份导图页与导图总览（须在 _build_knowledge.py 之后、_build_manual.py 之前）",
    "S5 校验：目录章节数与课本一致、六段齐全、无编造内容、死链为 0；旧版结论有变更时先备份再更新"
  ],
  "trigger_phrases": [
    "按 <学期> 提取课本目录",
    "按 <学期> 整理 <科目> 知识重点",
    "课本放好了，整理知识重点",
    "按学期生成知识重点"
  ],
  "if_only_files_added": "只放课本文件、未说明意图时：先给清点清单与待确认项，再询问是否开始提取目录与整理重点，不擅自写知识重点",
  "knowledge_summary_mode": {
    "note": "2026-11-17 固化：知识点总结共五层（A 严格逐节版 / B 复习框架版 / C 中考参照层 / D 细节速查层 / E 典型题层），不得混用",
    "strict_version": "A：S2–S3 逐本照录课本章节 + 按章写要点，标注 §X.X 与页码，以课本正文为准（本库尚未生成）",
    "review_framework_version": "B：_build_knowledge.py 生成的 44 份：3.1 章/单元照录目录（抽不到标 待确认）；3.2 按学科模块整理复习要点，不写页码、不虚构小节编号、不冒充课本逐节原文",
    "unconfirmed": "图片扫描版目录无法解析的册次，3.1 一律标 待确认，不凭通用教材补编章名；补拍目录页或用 07_目录图片/ 拼图核对后回填",
    "exam_reference_layer": "C：3.3 由 _data_shaanxi.py 渲染：陕西省无官方逐科考点清单，命题依据为各学科义务教育国家课程标准；只作备考维度参照，禁止把试卷点评当必考知识点或据此重排 3.1／3.2",
    "detail_layer": "D：3.4 由 _data_details*.py 渲染，共 462 条可打勾卡片；数理化给公式与原理、英语给语法与固定搭配、语文给重点文言文与课文名句、史地生道法给核心条目。分组尽量照录 3.1，3.1 待确认的册次及语文英语改按学科模块分组。公式为学科通识，不冒充课本原文、不写页码、不虚构小节号；课本表述与 Grammar Focus 页码待按正文校准",
    "card_format": "(分组, 条目, 具体内容, 条件与易错)；数据源禁用 ASCII 竖线，表格单元格会把竖线转义吃掉绝对值符号",
    "scripts": [
      "extract_toc.py",
      "build_outline.py",
      "_data_knowledge.py",
      "_data_shaanxi.py",
      "_data_details.py",
      "_data_details_sci.py",
      "_data_details_lang.py",
      "_data_details_other.py",
      "_build_knowledge.py",
      "_data_exercises.py",
      "_data_exercises_math.py",
      "_data_exercises_physchem.py",
      "_data_exercises_chinese.py",
      "_data_exercises_english.py",
      "_data_exercises_other.py",
      "_data_exercises_histgeo.py",
      "_data_exercises_bioethics.py"
    ],
    "outputs": [
      "00_课本目录原文.md",
      "00_章节清单.md",
      "00_章单元清单.md",
      "00_陕西中考参照与查漏补缺.md",
      "00_公式语法篇目速查手册.md",
      "07_目录图片/",
      "<学期>/知识重点/<科目>.md",
      "00_典型题与答案解析手册.md"
    ],
    "exercise_layer": "E：3.5 由 _data_exercises*.py 渲染，共 924 道题（462 条卡 × 2）。题号 N-1 / N-2 与同册 3.4 第 N 条卡片对应；题 1 基础直接应用卡片「具体内容」，题 2 针对「条件与易错」列设计具体错句／变式／补充条件。题目按学科通识自编，不是课本原题、不是中考真题，不得据此推断必考题型；答案与课本正文冲突时以课本为准",
    "exercise_format": "EX[(学期, 学科)] = [ [(题干, 答案, 解析), (题干, 答案, 解析)], ... ]；外层长度必须等于该册 3.4 卡片数，每组恰好 2 题，每题恰好 3 字段。数据源禁用 ASCII 竖线；生成前由 _data_exercises.check() 硬校验，不通过则 _build_knowledge.py 阻断"
  },
  "shaanxi_zhongkao": {
    "note": "2026-11-17 v1.3：用户要求参照陕西中考查漏补缺。核实结果为无官方逐科考点清单，故只增加可核查的考试维度参照层，不重排课本知识点。",
    "authority": "陕西省教育厅办公室《关于做好 2026 年陕西省初中学业水平考试工作的通知》（陕教基一办〔2026〕1 号，2026-01-03）",
    "has_official_point_list": false,
    "命题依据": "各学科义务教育国家课程标准；提高实践性、探究性、开放性、综合性试题比例，积极探索跨学科命题",
    "official_facts": {
      "九年级笔试": "语文 120／数学 120／英语 120（含听力 30）／物理 80／道德与法治 80（开卷）／化学 60／历史 60，共 7 科 7 卷；除道法外均为闭卷",
      "八年级笔试": "生物学 60、地理 60，共 2 科 2 卷，各 60 分钟",
      "实验操作": "八年级信息科技 10、生物学实验 10；九年级物理实验 10、化学实验 10；5 月完成",
      "体育与健康": "60 分",
      "成绩呈现": "分数与等级并列，A／B／C／D 四等，等级划分由各市（区）制定",
      "计分科目": "高中招生计分与参考科目由各市（区）自行确定"
    },
    "level_tags": [
      "【官方】",
      "【课标】",
      "【评析】",
      "【研讨】",
      "【统计】",
      "【推算】",
      "【待确认】"
    ],
    "level_rule": "只有【官方】可作考试口径依据；【评析】【研讨】【参考·需核实】只作命题特点参照，不得当必考知识点；【统计】只说明本库覆盖情况",
    "city_difference": "延安市、安康市等已明确自 2027 届起调整为 8 科计分、地理与生物学不再计入招生总分；其他地市与第三方汇总说法一律待确认，不代为假定用户所在市",
    "coverage_before": "2026-11-17 未补前，44 份中中考／分值／结业／开卷／听力／实验操作／课标／答题规范／开放性／建模／材料分析／时政／地方史命中均为 0；跨学科、真实情境各 6 份，整本书阅读 4 份",
    "pending": [
      "用户所在市（区）计分科目与总分",
      "学生年级与中考年份",
      "2022 版课标逐科新增／删减条目",
      "实验操作与信息科技具体考试项目",
      "各市等级划分比例",
      "2026 各科真题原文"
    ],
    "forbidden": [
      "编造陕西中考必考知识点清单",
      "按所谓考点重排 3.1 章名或 3.2 知识点",
      "把试卷点评／研讨会整理稿当官方考点",
      "假定用户所在市、学生届别与中考年份"
    ],
    "scripts": [
      "_data_shaanxi.py",
      "_build_knowledge.py",
      "_build_manual.py"
    ]
  },
  "principles": [
    "课本是唯一权威：册次、版本、章节目录、页码一律以放入的课本为准；看不清或缺失标 待确认，不凭通用教材记忆补编",
    "不编造章节、知识点、页码；矩阵只作清点参照，实际多出或缺少的科目按实增删",
    "不覆盖用户文件：课本原件只读；知识点 md 已「已整理」的，重跑脚本默认跳过，需 --force 才重写",
    "知识重点按学期归档、一科一文件，固定六段结构；禁用无数量、无验收线的词",
    "只在实际放入课本的科目上产出内容，其余保持 待放书 状态",
    "教材版本或册次口径变更（如换成全一册）时，重新取数并重跑 S1–S5，旧结论作废",
    "同科目位有多版课本时以 textbook_selection 的 prefer 为准；被替换的旧课本保留但不参与取数，并在文档中写明版本变更",
    "陕西中考参照层（3.3）只作考试维度参照：陕西省无官方逐科考点清单，命题依据为国家课程标准；不得据试卷评析编造考点、不得据此改 3.1 与 3.2，计分科目与学生届别一律标待确认",
    "细节速查层（3.4）只作学科通识逐条默写与打勾查漏：公式、语法、名句需按课本正文校准，不得当课本原文引用，不得据其改写 3.1 章名或 3.2 模块；数据源禁用 ASCII 竖线",
    "典型题层（3.5）只作学科通识自编练习：题目不是课本原题也不是中考真题，不得据此推断必考题型或分值；答案唯一、解析含易错点，数据条数／字段／竖线由 check() 硬校验，不通过不得生成"
  ],
  "visual_layer": {
    "purpose": "把 3.4 细节卡与 3.5 典型题渲染成思维导图 + 卡片视图，解决「全是文字、看不下去、定位不到某一条」的可读性问题",
    "is_content_layer": false,
    "note": "F 是呈现层，不是第六个内容层；内容口径仍以 B/C/D/E 为准，导图与卡片不得当成课本原文或中考考点",
    "outputs": [
      "导图/<学期号>_<科目>.html（44 份单科）",
      "导图/合订_<学期号>_<学期名>.html（6 份学期合订本）",
      "导图/导图总览.html"
    ],
    "builder": "_build_mindmap.py",
    "data_sources": [
      "_data_details.CARDS（3.4，462 条）",
      "_data_exercises.EX（3.5，924 题）"
    ],
    "views": [
      "思维导图：册次科目 → 章/模块 → 条目，点章跳该章首卡，点条目跳具体卡",
      "卡片：具体内容 + 易错/条件 + 2 道折叠题（答案默认收起）",
      "自测：遮住内容默写，打印时自动解除模糊并展开答案"
    ],
    "guards": [
      "EX 外层长度必须等于卡片数，否则跳过该科并报错，不生成半套页",
      "只导出链接存在的入口，避免死链",
      "_build_mindmap.py 自带锚点与 ../ 链接自检"
    ],
    "entry_points": [
      "课本知识手册.html 每章顶部「🖼 知识导图版」",
      "手册侧栏「🧭 知识导图总览」",
      "每份知识重点 md 第 3 行",
      "00_公式语法篇目速查手册.md 首部"
    ],
    "inline_in_pages": {
      "why": "WorkBuddy 预览面板对跨文件 / 跨目录链接支持不稳定，pages/ 里的 ../导图/xx.html 常点不动",
      "how": "pages/*.html 顶部插入 <details> + <iframe srcdoc>，把该页导图整份内嵌；页面自身不再需要跳转",
      "mapping": [
        "知识重点独立页 → 同名单科导图",
        "学期状态页 → 该学期合订本"
      ],
      "fallback": "iframe 显示空白时，提示用户用浏览器打开 导图/<文件名>",
      "guard": "找不到对应导图文件则不插入该区块（不生成空壳）"
    }
  }
}