5.7 KiB
证据政策上线与批次 3 复核清单
本文记录把页面类型证据政策应用到业务环境的步骤，以及批次 3 需要教师复核的项目。文中的业务数据操作均未执行，请由教师确认后按顺序操作。
一、诊断基线
在业务数据库只读检查确认：
- 批次 3 的 77 条评分引文中，14 条来自目录页，涉及 9 个评分项。
- 会话 6 保存的 20 条引用中，5 条指向阶段报告 1 的目录页。
这些数字是诊断基线。本次改动不自动改写批次 3 的既有分数，也不改写会话 6 的历史消息。
二、改动后的行为
| 情形 | 改动前 | 改动后 |
|---|---|---|
| 目录页命中 | 作为正文证据送入模型并计入候选 | 只作导航，不进入内容证据 |
| 内容目标证据 | 目录、摘要、章节标题均可 | 仅正文与附录的实质段落、数据、表格 |
| 结构目标证据 | 与其他证据等同 | 封面、目录、参考文献可用，明确标注来源 |
| 正文补检不足 | 仍可能给出较低模型分 | needs_review，模型分为 null，总分待处理 |
| 历史引文 | 与正文证据无区别 | 标记"历史评分引用" |
三、业务环境应用步骤
以下步骤尚未执行。
1. 备份
docker compose exec -T db pg_dump -U wisegrade -Fc wisegrade > data/backups/wisegrade-pre-0006-$(date +%Y%m%d-%H%M%S).dump
chmod 600 data/backups/wisegrade-pre-0006-*.dump
2. 隔离库演练（推荐）
把备份还原到隔离数据库，先在隔离库执行升级和重建，核对页面分类与检索结果，再动业务库。backend/tests/test_evidence_pages.py 已用真实报告覆盖这几类情形。
3. 应用迁移
迁移在 API 容器启动时自动执行（alembic upgrade head）。如需手工执行：
docker compose exec api alembic upgrade head
docker compose exec -T db psql -U wisegrade -c "SELECT version_num FROM alembic_version;"
# 期望：0006
0006 会：
- 为
knowledge_pages添加page_type、mixed、section、chapter、confidence、classification； - 为
knowledge_chunks添加chapter、page_type、block_type； - 为
score_evidences添加target_id、target_label、page_type、source_role、historical； - 为
criterion_scores添加evidence_gaps； - 把已有评分引文全部标记为
historical = true； - 按已保存的解析结果重新分类所有页面，写入审计日志。
重新分类不需要嵌入模型，因此在迁移中直接完成。downgrade 可撤销上述列。
4. 重建索引
分块方式已改变，旧索引不会被当作已分类正文使用。查看待重建清单：
curl -s http://127.0.0.1:18080/api/knowledge/stale/1 | python -m json.tool
重建（课程版本 1）：
curl -s -X POST http://127.0.0.1:18080/api/knowledge/reindex/1
docker compose logs -f worker
重建任务可重复执行：已是最新版本的文档跳过，源文件哈希变化的文档跳过并说明原因，失败项记录具体错误。结束后再次查询 /api/knowledge/stale/1，documents 应为空。
5. 核对页面分类
curl -s "http://127.0.0.1:18080/api/knowledge/documents/<document_id>/pages" | python -m json.tool
预期（仓库示例报告）：阶段报告 1 第 1 页 cover、第 2–3 页 toc、第 4–21 页 body、第 22 页 references；阶段报告 3 第 2–3 页 toc、第 11–12 页 body；最终报告第 2–3 页 abstract、第 4–5 页 toc、第 49 页 references、第 50–53 页 appendix。分类有疑义的页面为 unknown，不会当作正文。
6. 新批次验证
新建一个评分批次（不要重跑批次 3），确认真实模型下的表现：已评分项的引文来源为正文或附录；只检索到目录的内容项进入"待教师复核"。
四、批次 3 复核清单
只读检查得到的 9 个涉及目录页引文的评分项。建议教师逐项核对，不需要重跑批次：
| 处理方式 | 说明 |
|---|---|
| 查看该评分项证据 | 界面中旧引文显示"历史评分引用"标签，不能当作报告正文证据 |
| 在原始报告中定位正文 | 用引用卡片上的"查看页面文字"／"查看图像"跳转，或按下方章节提示查找 |
| 填写教师复核分 | 输入框不预填 0；填写后状态变为"教师已复核"，模型原始分与检索记录保留 |
复核时可直接检查的正文位置（仓库示例报告）：
- 阶段报告 1 第 6–7 页：文献调研与技术现状正文，含控制方法对比表和技术现状总结。涉及
stage1.literature。 - 阶段报告 3 第 11–12 页：系统测试与验证正文，含自主巡线测试、控制实时性、光照影响。涉及
stage3.data、stage3.verification。 - 最终报告第 6 页起：正文各章；第 50–53 页为附录，可用作内容证据。
- 最终报告第 2–3 页为摘要：可用于"摘要称……"这类明确归属的概述，不能单独证明方法已实现或指标已达标。
教师也可选择保留原有分数：本次改动不自动改写批次 3，历史分数在导出和界面中维持原值，仅在引文旁标明其来源类型。
五、注意事项
- 迁移和重建只改动页面分类、索引与引文元数据，不改动学生原件、评分批次、教师复核记录和会话历史。
- 重建过程可重试；失败项保留具体错误，重试入口在项目的"解析与索引任务"中。
- 迁移后旧评分引文的原始分数不会改变，但界面与导出会标明它们是历史引用。
- 若教师希望批次 3 的引文重新落在正文页，需要新建批次并重新评分；该操作会消耗模型调用，请先确认。