SuperAPI AI 工具集

verify-artifact

部署与运维

查看项目

更新于 10-16 03:17

技能介绍

用途:确保即将发送、发布或交付的文件确实是你想要的那个版本,防止评审者针对不存在的缺陷给出看似合理的结论。

主要能力与必要做法:一、从源重新构建,并在同一条 shell 命令中重建后立即复制到发送位置,避免使用昨天的构建产物。云同步目录(Dropbox/iCloud/OneDrive)可能出现文件脱水,PDF 变成 0 字节或不完整副本,症状如 Syntax Error: Couldn't find trailer dictionary;构建工具提示“up to date”不代表文件完整,因其只检查时间戳。应始终先落到本地非同步目录再验证。二、做机械、快速、不可省略的完整性检查:字节大小是否在预期范围,页数、记录数、行数是否符合预期;用真实读取器解析(pdfinfo、pdftotext、JSON/CSV 解析器、unzip -t),文件存在不等于可用;抽样首尾内容,截断通常出现在末尾;统计未解析标记,如 ??、[cite]、TODO、XXX、\ref{ 残留、"Chapter ??",代码数据中的 NaN、空单元格、占位值。三、将派生产物与源做差异比对:枚举标识符/锚点/ID 在源与产物中的集合,源中定义且被引用却在产物中缺失即为断裂;检查编号稳定性,删除带编号对象会使其后自动重编号,使“Lemma 10”变为“Lemma 6”,下游引用看似合理实则错误;比对章节、表格、图表、行、函数、端点等计数;注意嵌套内容,摘录块可能连带删除其中嵌套语句;若做了删减,应在产物内留下可见说明,避免评审者把省略当作缺失。四、让接收方自证:要求评审者(人或模型)在回复开头写明其评审的确切文件名、页数/记录数和版本,以发现过期缓存、错误附件或静默回退到旧上传;每轮使用唯一文件名(如 report_r6.pdf 而非 report.pdf),重复文件名易导致接收系统返回缓存旧副本。五、若评审结论异常,先怀疑产物:出现缺失/未定义引用、章节截断、证明中途结束、编号与你的副本不符等信号时,先重新验证产物,再验证工作本身,否则按产物引起的伪问题去“修复”会真正损坏正确材料。

最低检查清单:从源重建并在同一命令中落到本地目录;验证可解析并检查大小、计数、首尾内容;未解析标记数应为零;与源比对标识符、编号、计数,并在产物内注明有意省略;本轮使用唯一文件名;要求接收方回显文件名与计数。

限制:以上均为流程性操作规范,具体工具、平台兼容性与价格等资料暂未提供,且不涉及自动修复或云端同步不可用时的替代方案。