Paper Check 是一个面向论文投稿前自查的技能,目标是确保论文中的每一个数字、方法陈述和引用都能追溯到代码、数据、结果或原始出处,并输出按优先级排列的问题清单与具体修复建议。若用户请求的是代码发布相关事项,则按 references/code-release.md 处理并跳过前四步。
一、用途 帮助作者在提交论文前系统检查论文与代码、实验产物、引用文献之间的一致性,减少数字错误、术语混乱、方法描述与实际实现不符、公式与代码不一致、引用元数据错误以及评测流程问题。
二、使用方式 第一步是发现文件:用 Glob 查找 **/*.tex,确定导入其他章节的主 .tex 文件与文档结构;查找用于引用检查的 .bib 文件;定位结果文件(JSON、CSV、日志)、配置、评测脚本和训练日志;识别论文方法所引用的关键代码模块。自行运行检查时需阅读全文或用户指定章节;若交给子代理执行,则传递上述文件路径。
第二步默认运行全部六项检查;若用户指定检查项(如仅引用或 BibTeX),则只运行对应项及其所需文件(第 5 项只需 .bib 文件与 \cite 位置)。六项检查相互独立,支持子代理时可并行执行。
三、六项检查
- 数字:从 .tex 提取每个数字及其上下文,追溯到结果文件、代码输出、配置、日志或跟踪系统,核对数值是否精确一致,注意舍入、百分比与小数、过期数字、数据集计数差一等问题,并记录到 Numerical Audit 表。
- 术语:提取方法部分定义的所有术语,在全部章节中搜索,标记同一概念不同名称、同名不同义、定义未用或用而未定义的情况。
- 代码与论文:为论文描述的每个方法或算法找到对应代码,比较算法步骤与代码流程、超参数与配置默认值、架构描述与模型代码、损失函数与损失代码、训练流程与训练脚本。
- 公式与代码:为每个公式找到实现代码,映射数学运算与代码等价物,核对求和边界与循环边界、除法边界情况、归一化因子、梯度流(detach、no_grad)、归约操作(mean 与 sum)。
- 引用:读取 .bib,用 \cite、\citep、\citet 等模式定位引用位置,检查每个条目(快速检查可抽查最重要的 5 条)。提取论断与被引论文键,用 paper-search 的 get_crossref_paper_by_doi 获取记录;arXiv 论文用 paper-search download arxiv 与 paper-search read arxiv;文本提取丢失表格或公式排版时直接查看 PDF。通过 web 搜索 site:dblp.org "paper title" 在 DBLP 核对 BibTeX 元数据,包括作者姓名拼写与顺序、论文标题(以发表版为准)、会议或期刊名称与发表年份。对带具体数字的被引论断,定位被引论文中的确切表格、图或文字核对;无法核实或原文并无该论断时,建议改用定性表述。
- 评测完整性:阅读评测脚本与结果文件,检查训练/验证/测试划分泄漏、指标计算差一错误、聚合方式错误(micro 与 macro)、真值与预测对齐错误、除零边界情况、结果无法由评测脚本复现等问题;条件允许时运行评测并与论文数值比较。
四、汇总与输出 将发现合并为按优先级排列的清单:HIGH(投稿前必须修复:错误数字、错误论断、缺失引用)、MEDIUM(术语不一致、已过期但接近的数字)、LOW(格式与可选改进)。报告前需复核:每个问题都有具体证据(文件路径、行号、确切值)、数值比较精确而非近似、已验证问题与疑似问题分开、修复建议具体可操作。输出格式包括摘要(检查的文件数与问题计数)、HIGH/MEDIUM/LOW 清单(含论文原文位置、代码或数据证据、建议替换文本)、Numerical Audit 表、Unverified Claims 表、修正后的 BibTeX 条目(注明 DBLP 或 Crossref 来源)、已验证论断,并为每个问题标注对应检查名称。
五、自动修复 对修复方式明确的 HIGH 问题(错误数字、拼写错误、过期值),展示确切的 .tex 位置与当前文本、来自来源的已验证正确值,并在应用修改前请求用户确认。
六、适用场景与限制 适用于 LaTeX 论文投稿前自查,尤其是含代码开源、实验数据与大量引用的机器学习类论文。该技能依赖论文的 .tex、.bib、代码与结果文件齐备,并可能需要 paper-search CLI 与网络访问 DBLP、Crossref;未提供文件或无法联网时相关检查无法完成。工具本身不自动改写论文,自动修复须经用户确认。关于收费、价格与支持平台等信息暂未提供。