paper-format-check

发布前查图，提交前查文档 —— 这是同一家族的第二件工具。

论文 / 实验报告的格式体检。给定一份 .docx 和一套格式规则，输出可定位、可执行的问题清单。

零依赖（纯 Python 标准库，不需要 python-docx）、原件只读、判定口径保守。

引擎分三层：scripts/ooxml.py 解析 docx、scripts/checks.py 判定、scripts/check.py 编排与 CLI —— 加规则不必碰 XML 解析。

$ python scripts/check.py 实验三_HBase\ shell\ 操作.docx --student-id 2411020125 --student-name 彭超

报告：实验三_HBase shell 操作.docx
预设：实验报告　非空段落：86　表格：2　图片：5
已查：header、margins、bodyRange、body、breaks、captions、headings

[F001] header
    页眉里找不到姓名 彭超（当前页眉：2411020125）
    修法：双击页眉 → 补上姓名 彭超

[F002] body · 二、实验内容 · 第 12 段「随着数据量的增长，HBase 采用…」
    字号 五号 10.5pt，要求 小四 12pt
    修法：选中该段 → 字号改为 小四 12pt

[F003] body · 二、实验内容 · 第 12 段「随着数据量的增长，HBase 采用…」
    行距约 1.00 倍，要求 1.5 倍
    修法：段落 → 行距 → 倍数，设为 1.5

结论：有 3 处必须修改（error 3 · warn 0 · info 0）

为什么需要它

格式检查这件事有三个特点：机械（全是可判定的客观参数）、高频（一学期十几份，每门课要求还不一样）、反馈滞后（自己查不出来，被打回来才知道）。

Word 的「显示格式」只能逐段看，不能批量比对；「格式刷」解决的是改不是查；学院发的格式要求是给人读的 PDF，机器不可读。

所以缺的是：把「格式要求」变成可执行规则、再拿规则批量扫全文的东西。

查什么

• 正文字号、首行缩进、行距、中文字体
• 页眉是否带学号与姓名
• 页边距（逐节）
• 图题、表题的编号连续性
• 手动换行（Shift+Enter）与连续空段落 —— 肉眼看不出来但确实错
• 标题各级字号与加粗

不查：内容（错别字、语句、抄袭）、自动修复、.doc。

安装

作为 DeepSeek Harness 插件：

dsh plugin --profile web add github:Stephen-pc/paper-format-check

包内 package.json 已声明 dsh.bundle、lib/ 已提交，所以不需要 allowBuilds 授权。

独立使用（只跑检查，不装插件）：

git clone https://github.com/Stephen-pc/paper-format-check
cd paper-format-check
python scripts/check.py 你的报告.docx

需要 Python 3.8+，不需要安装任何第三方包。

用法

python scripts/check.py 报告.docx                        # 用「实验报告」预设
python scripts/check.py 报告.docx --preset 学位论文       # 换预设
python scripts/check.py 报告.docx --list-presets         # 看有哪些预设
python scripts/check.py 报告.docx --show-rules           # 看实际生效的规则
python scripts/check.py 报告.docx --json                 # 机器可读（永不截断）
python scripts/check.py 报告.docx --strict               # warn 也算不通过
python scripts/check.py 报告.docx --ignore margins        # 本次不查页边距

批量（助教批改）：

python scripts/check.py --batch 作业目录                  # 每份一行结论 + 汇总
python scripts/check.py --batch 作业目录 --fail-list      # 只要要退的路径
python scripts/check.py --batch 作业目录 --strict --fail-list

退出码：0 通过，1 不通过，2 文件读不了（不存在 / 非 docx / 加密 / XML 损坏）。

按自己学院的要求改规则

每个学院的格式要求都不一样，所以规则外置在 references/rules.json，插件本身不带「正确答案」。

复制一份，改 presets 里的键值，用 --rules 指过去：

cp references/rules.json 我的格式.json
# 编辑 我的格式.json
python scripts/check.py 报告.docx --rules 我的格式.json --preset 我的格式

字段含义见 references/rules.md（随包分发，不用去仓库外找）。三五个字段就能覆盖 80% 的要求。

判定口径

宁可漏，不可误报。误报一次，人就不信这个工具了；漏报只是被打回来，跟不用工具的结果一样。

具体三条：读不到就不报（报 info 不报 error）；不确定就降级（文档网格、固定值行距、SEQ 域、自动编号）；能定位才报（每条 finding 必须指到标题路径 + 段内序号）。

还有一条硬规矩：本次真正比较过的检查项为 0 时，禁止判通过 —— 规则文件写错会让所有检查静默跳过，此时报「通过」就是在骗人。

自测

node tools/dsh-selftest.mjs

16 个合成 fixture + 2 个特殊用例，断言退出码、summary、checked 三件（不断言文案）。fixture 由 tests/make-fixtures.py 生成，样本规格是可 review 的源码。期望值见 tests/EXPECTATIONS.md。

已知限制

• 编号连续性、章号一致、页码域、纸张尺寸尚未实现
• 参考文献格式只做形态提示，不做判定
• 误报率尚未用真实语料验证（设计稿 §11.3 的验收口径是 ≥20 份真实文档、precision ≥95%）

许可

MIT