智能批改作业 Skill v1.0

串联 doc-browser（批量读取）→ academic-workflow（评分模板） → 输出审核报告

触发场景

• 用户上传毕业设计存档目录、zip 压缩包、或指定路径
• 用户说「批改作业」「审查毕业设计」「毕设审查」「审查存档」「智能批改」
• 用户要求对学生毕业论文/毕业设计做规范性检查

审查流程（5 步）

第①步：批量读取（doc-browser 模式）

对目标目录中所有文件执行：

文件优先规则：当同一文档存在 .doc 和 .docx 两个版本时，检查 .docx 是否为模板半成品（判断标准：含占位符/格式说明文字/旧项目名），若是则改读 .doc。

数据交接：提取文本写入 /tmp/auto_grading/ 目录下对应的 .txt 文件。

第②步：单文档评分

按毕业设计评审模板（references/review_template.md）对每份核心文档评分：

第③步：跨文档交叉审查

第④步：PPT 答辩评审

第⑤步：输出汇总报告

必须在输出前执行安全护栏

安全护栏（Harness Engineering）

核心原则：宁可漏报，不可误报。

三层硬约束

审查工作流（L1+L2+L3 全链路）

① batch_extract.py 提取文本 → /tmp/auto_grading/
② LLM 评分 + 输出 issues.json（每条含 file/issue/evidence/confidence）
③ harness.py --input issues.json --txt-dir /tmp/auto_grading --archive-dir \x3C存档目录>
   ├── L1: 校验 evidence 非空、confidence 有效
   ├── L2: grep 原文确认 evidence 真实存在
   │      ├── 找到 → passed（高/中置信度保持）
   │      └── 未找到 → 自动降级为 ⚠️待验证
   └── L3: 有 .doc/.docx 冲突时自动选择正确版本
④ 输出清洗后的 clean_issues.json + 护栏报告

为什么这套 Harness 能防止之前的虚假 bug

之前的错误（报"图1-1来源错误"但实际不存在）→ L2 会因 evidence 字符串在原文中找不到而自动降级。 之前的错误（审了模板 .docx 而非正式 .doc）→ L3 会检测模板残留信号，自动选 .doc。

第⑤步：输出结构化评审结果

① 输出 JSON（给 harness.py 校验）：

{
  "student": "姓名",
  "review_date": "2026-06-15",
  "single_doc_scores": {
    "创作报告": {"完整性": 30, "规范性": 13, "逻辑性": 15, "论证": 16, "总分": 74}
  },
  "cross_check": {"要素一致性": 45, "引用一致性": 25, "分工一致性": 18, "总分": 88},
  "ppt_review": {"基本信息": 18, "内容结构": 25, "视觉美感": 20, "观点表达": 22, "总分": 85},
  "issues": [
    {
      "file": "创作报告.doc",
      "issue": "副标题仍为'以曹乐川为主'",
      "evidence": "游戏《归浦：数字宿命》——以曹乐川为主",
      "confidence": "高"
    }
  ]
}

② 运行 harness.py 校验：

python3 scripts/harness.py --input /tmp/issues.json \
  --txt-dir /tmp/auto_grading --archive-dir \x3C存档目录>

③ 基于清洗后的 clean_issues 生成 Markdown 报告（评分表 + 交叉审查表 + 修改清单 + 整体评价）。

安装依赖

pip install PyPDF2 python-docx python-pptx olefile
# macOS 自带 textutil、antiword（可选）