高校期末教学资料与课程归档规范性核查

概述

核查高校期末教学资料的归档规范性与材料完备性。以教学大纲、试卷审批表、成绩登记表、达成度评价报告、学生答卷包为对象，按课程分类逐项比对合规要求，输出可直接下发给教师整改的问题清单，以及供检查组使用的汇总报告。

本技能的实质价值不在"扫文件"，而在控制误报：用错规则的自动化脚本会批量冤枉合规教师，反而比人工翻阅更糟。因此所有判定都遵循固定的取证规则（见下文核心原则），凡证据不足一律转入"待人工复核"，绝不擅自判定违规。

> ⚠️ 首次使用（换单位）必读：assets/audit_config.json 里内置的机构名称是填好的示例值（取自「广东科技学院计算机与人工智能学院」）。换到贵单位前，请把它复制到待检查目录并改名 audit_config.json，把 institution.college_name（本院法定全称）、college_forbidden_names（需检出的历史旧称）、department_name（教研室名称）改成贵单位的写法。若照搬示例名称去查别的单位，红线 1（开课机构命名）会把全部合规大纲误报为违规——这是本技能最危险的单点错误。脚本在使用内置示例配置时会打印提醒。

何时使用

• 学期末开展教学资料检查、归档合规性核查、教学档案专项审计
• 工程教育认证、专业评估、教学检查前的材料自查
• 需要对一个归档目录下的多门课程批量核验材料是否齐全、表册是否填报规范
• 教师已按整改清单修改后，复核整改是否落实、负责人汇总材料是否与教师版同步
• 需要核对同一门课内同一份材料的多个副本是否同版本、同一信息在不同文件里是否自洽

核心原则（防误报，必须遵守）

1. 槽位锚定：机构名称、课程代码、适用专业只从教学大纲基本信息表的对应单元格提取，禁止对全文做关键词扫描——正文里的"本专业由原某某学院与某某学院联合筹建"一类叙述性文字不是行政判定依据。基本信息表按内容定位（含"课程代码""适用专业"等标签的那张表），不按索引取：有封面表格的大纲，基本信息表在 tables[1] 而非 tables[0]，写死索引会张冠李戴。
2. 多源联合仲裁：专业名称由「封面文本 + 基本信息表适用专业槽位」联合判定。封面因排版换行只显示"软件工程"、基本信息表填了"软件工程（卓越工程师方向）"，即判 100% 合规。判定时对外部基准给出的全部候选专业全称逐一比对，命中任一个即合规（同一专业不同年级/方向可能有多个合法全称）。
3. 动态豁免：按目录路径与考核方式确定必备材料清单。位于"笔试科目文档"下的课程，学生答卷由学院纸质统一装订入库，电子版一律免检，不得列为缺失。
4. 未检查 ≠ 合格：文件读不动、依赖缺失、判定依据不足时，记入"无法读取"或"待人工复核"，不计入合格，也不伪装成通过。
5. 不与 Excel 内部公式较劲：不核查达成度表内部的浮点除零、精度显示等细节，只查表间数据闭环与模板残留。详见 references/false_positive_lessons.md。

检查依据体系（核心机制）

本技能要求报告里每一条判定都能当场回答"依据是什么"。为此每条问题都携带 basis（判定依据）字段，依据只有三种来源：

每条依据带「文件 + 位置 + 基准值」三要素（如 外部文件：排课安排表v9.xlsx @ 排课安排表!B255，基准值「计算机学院」），教师质疑时可直接翻到原处。

基准文件的权威分工（三者不可互相替代）：

三条硬规则：

1. 多候选不误伤：一个课程代码可能对应多行（多个班级、多位任课老师、甚至多个代码）。比对时取该课程全部候选行逐一试配，任一命中即合规；不要只取第一行，否则会把合规材料误报（如某课有 18 行记录，取首行会比对错责任人）。
2. 冲突不隐瞒：基准文件之间、基准与配置之间若互相矛盾（如执行计划表写"计算机学院"而配置把它列为禁用旧称），记入报告「依据冲突」栏单列，并自动停用该禁用项，防止把全部合规文档批量误报；由人工裁定统一口径。
3. 无依据不硬判：外部基准缺失时退回配置；配置也无对应规则时，转「待人工复核」，不擅自定为违规。

scripts/standards.py 负责加载与索引基准文件，scripts/basis.py 负责登记与渲染依据，scripts/audit_engine.py 负责判定并逐条挂依据。三者职责分离，改判定规则不必动依据模型。

课程内文件关联核查（R14–R16）

红线 1–10 查的是"单个文件自身是否规范"；本模块查的是"文件之间的关系"，解决两类隐藏缺陷：

• A. 同一材料的多个副本版本是否一致：同一份《教学大纲》常在「任课教师包」和「课程负责人汇总」两处各存一份，教师整改后只更新了自己那份，负责人汇总仍是旧版——文件名还往往不同，肉眼难发现。
• B. 不同文件里的同一信息是否自洽：课程名称、代码、开课单位、适用专业、考核方式、课程负责人、考核日期、班级、学生人数会同时出现在大纲、成绩表、审批表、达成度报告里，同一门课必须处处相同，并与外部基准一致。

为避免组合爆炸与海量误报，采用三层关联模型（详见 references/association_model.md）：

三条红线：R14 同课程文件版本一致（跨目录副本内容指纹不同 → 一般问题；同课程目录内 → 提示）、R15 课程内字段一致（同字段在课程内多种取值 → 一般问题，并按作用域限定）、R16 成绩数据闭环（成绩表人数 vs 达成度样本数，同班内不一致 → 待人工复核）。

关键防误报约定（改动本模块前必读）：

• 版本比对只在异地副本间进行（同目录并存是有意的多份材料，不是分叉），且只比对文件名签名（same_logical）指向同一份材料的副本——班级/年级/方向的命名差异会自动跳过。
• 字段比对按作用域分治：invariant（课程名/代码/开课单位/考核方式）全课比对；specific（负责人/考核日期/班级）只在同一班级内比对；major（适用专业）只在"取值不是本院专业"时才报。
• 刻意不比对「任课教师」：各班各署各的，跨文件比对必然误报；教师与基准的一致性由 R13 负责。
• 内容指纹 = 正文文本去空白后的 SHA1，不是字节哈希——"另存一次"不算版本不一致，"改一个字"才算。
• .doc/.pdf/图片/压缩包 提不出正文指纹，不做内容判定，转「待人工复核」，绝不当作"一致"。
• 课程负责人汇总目录里的达成度常是"多班合并口径"，不参与 R16 班级闭环。

环境准备

脚本依赖三个库，缺失时脚本会明确报错并降级，不会静默跳过：

pip install python-docx openpyxl xlrd

• python-docx：读 .docx 大纲（必需）
• openpyxl：读 .xlsx 成绩表与达成度报告（必需）
• xlrd：读旧版 .xls；未安装时 .xls 会记入"无法读取"（注意 xlrd ≥2.0 仅支持 .xls，不支持 .xlsx）

工作流程

1. 备齐判定依据：把《教学执行计划及课程负责人安排表》《人才培养方案》《专业教学进程计划表》放进同一目录（通常是待检查目录或其上一级），用 --standards 指向它。这是本次检查的基准来源——没有它，机构命名、课程代码、考核方式、课程名称、责任人等判定只能退回配置与人工确认，可靠性明显下降。
2. 确认检查范围与规则：明确待检查的归档根目录；核对 assets/audit_config.json 中的学院法定全称、禁用旧称、教研室名称、课程代码规则、目录名称是否与本学期实际一致。学院更名过就必须改这里（旧名进 college_forbidden_names、新名进 college_name），否则会把全部合规大纲误报为机构命名误写。
3. 目录索引与课程分类：按路径把课程归为笔试科目类、非笔试考查/机试/大作业类、整周实训/综合实践类，三类必备材料清单不同（见 references/course_classification_guide.md）。
4. 执行自动核查：运行 scripts/audit_engine.py，一次遍历完成命名、大纲元数据、签名与日期、达成度残留、答卷完备性、负责人材料同步、以及课程内文件关联（版本一致性 / 字段一致性 / 成绩数据闭环）共八项检查，每条问题附判定依据。
5. 逐条人工复核：处理报告中的「待人工复核」与「无法读取」两类，并填写报告末尾的人工确认台账（manual_checklist），这两类不自动定论，需打开文件确认并签署结论。关联核查转出的副本分叉、字段差异、人数不符也在此环节裁定。
6. 输出双报告：运行 scripts/build_report.py 生成《问题整改清单》与《核查情况汇总》，问题条目必须带证据坐标 + 判定依据，便于教师定位与质询回应。汇总报告含「课程内文件关联概况」板块（课程实体数、纳入比对的文件数、版本/字段问题数）。

脚本用法

第一步：全量核查，输出 JSON 与 Markdown 报告

python scripts/audit_engine.py --root "/待检查的归档目录" \
    --standards "/存放执行计划表与培养方案的目录" --out ./检查报告

# 用主目录担任基准来源，只查签名、日期与达成度残留
python scripts/audit_engine.py --root "E:/期末资料" --standards "E:/期末资料" \
    --only score,attainment --out ./out

# 只做课程内文件关联核查（副本版本一致性 + 跨文件字段一致性）
python scripts/audit_engine.py --root "E:/期末资料" --standards "E:/期末资料" \
    --only version,field --out ./out

第二步：由 JSON 生成双报告

python scripts/build_report.py --json "./检查报告/审计报告.json" --out ./检查报告

生成四份文件：问题整改清单.docx/.md（面向任课教师，按课程分组，含证据坐标与整改建议）、核查情况汇总.docx/.md（面向检查组，含统计与问题类型分布）。两份报告都含依据登记率、基准文件清单、依据冲突、检查项–依据对照表、人工确认台账五个依据相关板块。未安装 python-docx 时自动只出 Markdown 并提示，不静默丢弃。

配置说明

机构专属规则全部集中在 assets/audit_config.json，脚本内不写死任何学校、学院、人名。换单位使用时，把该文件复制到待检查目录下命名 audit_config.json 即可覆盖内置配置（项目级优先于 skill 内置），无需改脚本。

主要配置项：

> 每学期开检前必做：核对 institution.college_name 与 college_forbidden_names 是否与本学期实际一致。学院更名时把旧名移入 college_forbidden_names、新名写入 college_name。若把新旧名写反，会导致全部合规文档被误报为机构命名误写——这是本技能最危险的单点错误。

问题分级与报告口径

报告另设两栏，不计入合格：待人工复核（如压缩包内部批改细节、值写在下一行的槽位留白、成绩表人数与达成度样本数不符 R16、不可解析格式副本）、无法读取（文件损坏或缺依赖，其内容根本未被检查）。此外报告开头会给出依据登记率（多少条问题已附判定依据）、基准文件清单与依据冲突，末尾附检查项–依据对照表与人工确认台账。

参考资源

已知边界

以下内容自动化无法判定，一律列入待人工复核，不要当作通过：

• 学生答卷压缩包内部的批改规范（大题合分、小题评分细则表、教师签名）
• 成绩表内签名图片的真实性（只能确认是否存在图片对象）
• 旧版 .xls 的内嵌签名图片（xlrd 读不到图片对象）
• 表头与人名是否属于本课程（能比对代码、课程名与责任人一致性，但人名的真实性无法核验）
• 学院名称、专业名称是否正确（只能检出基准文件与配置中出现的名称，基准里没有的旧称需自行补进配置；不联网核对教育部专业目录）
• 文件名错别字（只能命中 naming.common_typos 中登记的组合，表外的错别字需人工发现）
• 《专业教学进程计划表》的学分、学时与执行计划表的逐项吻合（进程表不含课程代码，只能以课程名关联，同名课程可能张冠李戴，故该项转「待人工复核」）
• 基准文件本身的版本正确性：脚本无法判断 --standards 指向的是不是本学期最新版的执行计划表。放入过期版本会得到失真结论，放入前须人工确认版本与学期
• 依据冲突的裁定：脚本能发现基准之间/基准与配置的矛盾并单列，但选哪个口径为准需人工决定
• 关联核查的裁定：脚本能发现"同一材料的两个副本内容不同"（R14），但不能判定哪一份是对的；能发现"同一份材料字段取值不一"（R15），但同义写法的口径需人工确认；能发现"成绩表人数与达成度样本数不符"（R16），但差异是否源于缺考/重修剔除须人工判定
• 不可解析格式的副本比对：.doc/.pdf/图片/压缩包 只能比对文件大小，内容级差异须人工逐项核对
• 课程归属：路径与文件名都不含《课程名》的文件无法建立关联，整体转人工