题库维护说明¶
题库章节文件是知识点练习的唯一正文来源。修改题干、选项、来源、图片或解析时，只修改 question-bank/ 下对应章节；课件中的练习通过引用自动更新。课件原例题、知识讲解和历年试卷保持各自原有组织。
一道题怎样维护¶
- 在对应题库找到
### 题目 001，保留来源题号。已经合并的题号不重新分配。 - 编辑题目与
??? note "答案与解析"中的内容，继续区分平台答案、整理解析和纠错。不要将???改成默认展开的???+。 - 在知识点讲解后保留相应的四级题号标题和引用。下面是格式示例：
MkDocs 在构建时读取题库正文，放回题号标题下，并按目标页位置调整相对链接。生成后的网页仍可在知识点处直接练题。普通 Markdown 阅读器显示原题链接；Obsidian 可用链接中的标题定位原题。引用标记和链接应成对保留，不能只留下 HTML 注释。
长题组的阅读方式¶
超过 8 题的练习组保留前 2 题直接展示，其余引用增加 compact：
网页将题干放入“展开题目”折叠框。题号标题保留在折叠框外，原有目录与题号链接仍能定位；答案使用原有的独立折叠框，展开题干不会提前显示答案。
新增或移动题目时，按主题调整引用位置和所在题组的题数说明。同一章每道知识题必须引用一次；题库中的全部题目都能独立阅读。新增章节或更改章节文件位置时，同步调整 scripts/question_bank.py 中的章节映射。
检查¶
历年大题引用¶
历年主观题仍以题库章节内的原题正文为唯一内容来源。数据流图、数据库案例、UML 案例、算法案例、Java 程序设计五类课件用 case 引用展示对应题目，年度试卷索引继续指向原题。普通 Markdown 可点击链接阅读，网站构建时展开原题，并调整图片的相对路径。
compact 表示题干默认收起；打开题干后，原答案折叠仍保持关闭。引用使用原题已经存在的定位符，不复制题干、不新增显式标题锚点。正文中的代码围栏和答案图必须完整保留。
大题的范围与完整性记录于 assets/question-bank/case-study-index.json，学习入口为应用技术大题。新增题目时同步来源记录、原卷索引、对应课件引用、完整性清单与进度。程序设计按原题语言识别，只把 Java 加入本次练习；不能机械地认为第 5 题总是 C++、第 6 题总是 Java。残缺材料和待整理目录不得加入完整题数。
运行检查¶
在仓库根目录、安装了 requirements-dev.txt 的 Python 环境中运行：
检查覆盖未知题号、重复题号、缺少引用、错误原题链接、标题与题号不一致、相对资源链接及代码示例保护；也会比较十二章折叠前后的 HTML 内容，确认所有题面、答案和题号锚点保留、答案默认关闭。
MkDocs 通过 scripts/question_bank.py 的 hook 在链接处理前展开引用，构建时也检查完整性。新增题目正常同步来源与引用即可，不需要维护旧题内容的固定摘要。
本次迁移额外执行了以下一次性检查：
该检查确认当时十二章 1121 道知识题迁移后，展开引用的 Markdown 与迁移前逐字一致，包括知识讲解和课件原例题。后续正常修订内容时无需维持与旧提交相同。