学习证据检查
学习证据检查
一句话定义
学习证据检查用于判断 结业证据档案.md 和 完成判定表.md 里还有哪些空白证据项，避免把“文件存在”误判成“已经学会”。
使用命令
日常学习时，如果你想同时看到当天任务和最近证据缺口，优先运行：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\study_dashboard.py' --day 1
如果只想检查证据表本身，在仓库根目录运行：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\evidence_status.py'
输出怎么理解
脚本会输出每个证据表的：
rows：表格行数。incomplete_rows：仍有空白证据的行数。blank_cells：空白单元格数量。Next evidence gaps：最靠前的若干个证据缺口，格式是“文件 / 表格 / 行项目 / 缺哪些列”。
如果看到：
IN_PROGRESS evidence still missing
说明学习材料已经存在，但个人学习证据还没有填完。
如果看到：
Next evidence gaps
- 结业证据档案.md / 1. 入门诊断证据 / 入门诊断原始答案: missing 是否完成、备注
说明下一步不是继续看新资料，而是先把这个证据项补上。补的时候不要只写“已完成”，要写能被别人检查的答案、链接、shape、loss、截图说明、口头稿或追问回答。
只看少量下一步
默认会显示前 12 个证据缺口。如果今天只想拿到最小任务，可以运行：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\evidence_status.py' --next 5
如果只想看总体统计，不想显示缺口清单：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\evidence_status.py' --next 0
生成证据填写模板
如果知道缺哪一项，但不知道该怎么写，可以运行：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\evidence_prompt.py' --index 1
--index 1 表示当前证据缺口列表中的第 1 项。脚本会输出：应该填哪个文件、哪个表格、哪一行、缺哪些列，以及每列最低应该写什么。
生成 7 天补证计划
如果空白项很多，不要一口气补全部。运行：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\next_evidence_plan.py'
这个脚本会把当前证据缺口按优先级排序，默认安排成 7 天、每天 2 个任务。每个任务会说明证据位置、缺哪些列、今天要做什么、补到什么程度才算完成。
如果只想安排一个低压力版本：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\next_evidence_plan.py' --days 7 --per-day 1
严格模式
如果想在最终验收时让空白证据导致命令失败，可以运行：
& 'C:\Users\小王神棍\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' '12_深度学习原理与经典论文路线\scripts\evidence_status.py' --strict
严格模式适合最后结业前使用，不适合每天学习时使用。
和其他脚本的区别
| 脚本 | 检查什么 | 说明 |
|---|---|---|
scripts/audit_progress.py | 材料和 notebook 文件是否存在 | 文件层审计 |
scripts/start_today.py | 今天该做什么 | 每日启动 |
scripts/evidence_status.py | 结业证据是否填充 | 学习证据审计 |
scripts/evidence_prompt.py | 把一个证据缺口转成可填写模板 | 证据填写辅助 |
scripts/next_evidence_plan.py | 把空白证据项排成短期补证计划 | 补证计划 |
scripts/study_dashboard.py | 今天该做什么 + 最近证据缺口 | 每日学习控制台 |
scripts/quality_gate.py | 空白证据、空泛表达和一票否决项提示 | 最终质量门 |
注意
这个脚本只检查“是否填写”，不能判断答案质量。真正的质量判断仍要用 完成判定表.md、口头追问和人工复盘。
最终验收前，还要运行 scripts/quality_gate.py。它会先挡住空白证据，再检查表格里是否出现“已完成”“看完了”“大概懂了”“AI 解释了”“跑通了”“完整复现”等弱证据单元格。如果这些说法没有同时指向文件、shape、loss、追问、局限或错题修正，就不能算合格证据。脚本最后还会列出必须人工检查的一票否决项和质量红旗。