用途:把已定稿的学术 Markdown 手稿做版式变换,生成投稿 docx、投稿 PDF(APA 7 man)、发表预览 PDF(APA 7 jou)与干净 md,并附忠实性声明、占位符清单、剥离报告。不做内容写作,不回头改内容;引用须已由上游核验。
主要能力:双引擎——docx 走 pandoc + reference-apa7.docx(行号经 OOXML 后处理),PDF 走 XeLaTeX + apa7 类(man 双倍行距+行号+图表末置,jou 双栏+悬挂缩进),无 apa7 时可用 generic article 兜底。排版前按 strip_rules 剥离内部痕迹(gate codes、corpus ID、过程顶注),保留方法学披露。每件产物落盘前跑 fidelity_check:源与产物逐 token 比对,出现源中没有的数字、或载荷性数字/标签绑定/DOI 缺失即失败(退出码 2,不落该件,不设 --warn-only)。
用法:上游或用户产 typeset_request.yaml,声明 manuscript、outputs、template_family、metadata、references、tables、figures、strip_rules 等字段,运行编排器 typeset.py;CLI 签名与降级路径见 README,输入契约见 MANUSCRIPT-INPUT-CONTRACT.md。引用默认档为保真渲染 md 参考列表,不走 citeproc/.bib。
适用场景:APA 系 author-date 期刊投稿排版、发表预览、内部痕迹剥离。
限制:仅支持 apa7(man/jou)+ generic;编号制期刊与 CSL/.bib 通用引用档延期至 v2;不自动翻译、不核验参考文献、不渲染森林图/漏斗图/PRISMA;依赖 pandoc、xelatex、python3+pyyaml,缺 xelatex 可降级出 docx+md,缺 pandoc 则退出码 1;名值绑定错误超出排版层职责。