SuperAPI AI 工具集

light-typesetting

写作与研究

查看项目

更新于 10-16 00:00

技能介绍

用途:将已批准的论文写作稿件、图表交付物和引用交付物,转换为可复现的 PDF 投稿包。目标不只是让 LaTeX 编译通过,还要保留来源溯源、选择一致的引擎/后端、预检依赖、编译至收敛、定位首个根因、执行 profile 驱动的 desk-reject 检查,并把 PDF/页面事实交给 venue-matching。

主要能力:冻结输入契约(typesetting_input.json);预检缺失输入、\input/\include、图形、标签引用、引用交付 schema/状态、哈希、citekey 审计、图表 manifest 输出哈希等;按源码触发选择 pdflatex/xelatex/lualatex 与 bibtex/biber;用 latexmk(或后端匹配时的 tectonic)编译;用四种状态分类(PASS/ERROR/UNAVAILABLE/UNRESOLVED);从首个 file.tex:line 根因诊断;运行 desk_reject_gate.py 检查页数、匿名性、文档类、页面尺寸、字体嵌入等;生成 build-manifest、compile-report、compliance-report、venue-handoff、delivery 等产物;用 submission_readiness.py 推导就绪状态链。

使用方式:先读 typesetting-resource-map.md 与 references/build_contract.md;预检命令为 python scripts/build_submission.py --spec typesetting-input.json --preflight-only;编译为 python scripts/build_submission.py --spec typesetting-input.json;desk-reject 门禁为 python scripts/desk_reject_gate.py --tex ... --pdf ... --bib ... --log ... --profile ... --report ...;就绪检查为 python scripts/submission_readiness.py --input templates/submission-readiness.example.json --as-of YYYY-MM-DD --out submission-readiness-report.json;stage 11 检查点用 run_checkpoint.py --file .light/passport.yaml --stage 11 --gate "compile=..." --findings desk-reject-findings.json --ts <ISO8601> --write。

适用场景:论文投稿前的 LaTeX/PDF 构建与合规预检,尤其是需要保留引用与图表溯源、按 venue profile 做客观硬规则检查的流程。

限制:不重新判定 DOI、元数据冲突、撤稿或声明相关性;不重做图表视觉真实性、科学内容或出版尺寸生成;不编造声明、引用、实验或数字;venue 规则只能来自用户输入或带 URL/日期溯源的权威说明,未知规则保持 null/0/缺失;工具缺失标记 UNAVAILABLE,不得当作稿件 ERROR 或 PASS;只有 compile=PASS、compliance=PASS 且零 critical 才可标记 DELIVERED;静态检查无法证明语义匿名或判断最终视觉质量;不依赖付费 Overleaf、私钥、浏览器插件或 npm 重型工具;ROUTES 无 key 11,不得创建回边。