中文 · English
真正投稿前，先让 AI reviewer 把该挑的坑挑出来。
一句话版： PaperJury Codex 会在投稿前替你的论文做一轮“刻薄但有证据”的 AI 预审：先找 reviewer 可能会抓住的问题，再判断这些问题到底成不成立；能安全修改的只给最小补丁，缺实验、缺证据的交回作者，不靠谱的意见直接驳回。
刚写完初稿、投稿前想再自查一遍，或者只想先让它挑一遍风险，都可以直接用日常话描述需求；不用先研究它的内部机制。
- 🎉 RedNote（小红书）里程碑： 相关分享已经达到 3 万浏览、1.8k 收藏。感谢大家转发和收藏，也感谢大家把 PaperJury 推荐给更多正在赶论文、改论文的朋友。
- 📄 PaperJury 论文已上 arXiv。 arXiv 页面：PaperJury: Due-Process Review for Bounded LaTeX Revision（arXiv:2606.16322）。论文系统介绍了「审稿 → 裁定 → 修改 → 复查」这套引擎。
- 🚀 Codex plugin 已发布。 PaperJury Codex 现在可以通过 Codex plugin marketplace 安装；需要时也可以继续用 legacy clone 安装。
- 🔔 v1.0 release。 Codex plugin 带有软更新提醒；发现新的稳定 tag 时只提示，不打断当前工作。
- 🧪 Dogfood sample 已加入。 仓库里放了修改前后 PDF 和人工核对过的运行报告。
PaperJury Codex 是 PaperJury 的 Codex 版。 它把投稿前自查组织成一套闭环：审稿 → 裁定 → 修改 → 复查。你可以让它像 reviewer 一样挑问题，也可以让它安全地改一处 LaTeX / Markdown；真正落稿前，它会先把补丁交给你确认。
它不会照单全收 AI 反馈，而是先把每条意见分成三类：
| 结果 | 含义 |
|---|---|
| ✅ 安全修复 | 表达不清、claim 过强、结构不顺这类文本问题；不需要补实验，也不会把原意改偏。 |
| 🧑💻 作者处理 | 缺实验、缺 ablation、缺数据或证据，必须由作者自己判断。 |
| 🛑 不成立 | AI reviewer 误读了论文，或者提了不该改的问题。 |
Important
PaperJury 是投稿前的自查工具，不能替代作者的科学判断，也不能替代 peer review。它不能用来编造实验、伪造结果、添加没有证据支撑的 claim，或掩盖论文局限。遇到需要新实验、缺证据、需要作者私有知识或研究判断的问题，它都会交回作者处理。
| 你现在的情况 | 可以直接这样用 |
|---|---|
| 📝 刚写完初稿 | 让它像 reviewer 一样通读全文，先找最可能影响投稿的问题。 |
| 🔍 投稿前最后自查 | 让它检查 claim 是否说过头、实验是否撑得住，以及有没有明显格式风险。 |
| ✍️ 只想改一段话 | 直接说「把这段改紧一点，但不要改变 claim」，它会先起草补丁，等你确认后再改。 |
| 🔁 想多轮打磨但不想一直盯着 | 明确授权 auto 模式；安全修改可以落稿，高风险问题仍会交回作者决定。 |
| 输出 | 内容 |
|---|---|
| 📋 问题清单 | 每条 reviewer-style 问题都会带证据、位置、判断结果和当前状态；不会把一堆意见直接倒进正文。 |
| 🧩 可审阅补丁 | 只有安全修复会进入最小补丁；高风险改动会先放着，等作者决定。 |
| 🛠️ 复查报告 | 有 LaTeX 工具链就真实编译；没有就明说哪些检查做不了，不会假装验证过。 |
| 🧪 真实样例 | samples/dogfood/ 里有修改前后 PDF 和人工核对过的运行报告。 |
先把 marketplace 加到 Codex：
# Latest channel：安装或重新安装时使用当前 main 分支
codex marketplace add Spark-To-Paper-Skills/paperjury-codex
# 稳定 pinned release：可复现的 v1.0 安装
codex marketplace add Spark-To-Paper-Skills/paperjury-codex@v1.0然后在 Codex plugin UI 里安装 PaperJury Codex。安装后可以直接在论文项目里说：
审稿，重点看实验设计、claim 强度和格式风险。
或者：
把这段 intro 改紧一些，但不要改变原来的 claim。
安装后会出现 paperjury skill，随插件一起安装的还有确定性 Node guards。node 是必需的；LaTeX 工具链可选，有工具链时会真实编译，没有时会明说哪些检查做不了。
| 场景 | PaperJury Codex 会怎么做 |
|---|---|
| 🔎 投稿前挑问题 | 模拟几位不同方向的 reviewer 通读全文，找出真正可能被抓住的弱点，并把致命问题和小修小补分开。 |
| ✍️ 安全改 LaTeX / Markdown | 只针对你指定的位置起草补丁，自检后再交给你确认；不会把一处小改扩成整篇重写。 |
| 🛡️ 复查格式风险 | 本机有 LaTeX 工具链时会真实编译，检查报错、未定义引用、overfull box、页数和常见 desk-reject 风险；没有工具链时会明说。 |
| 🔁 多轮打磨 | 在你明确授权的 auto 模式下，多轮跑完「评审-修订-复查」；安全修改可以自动应用，高风险问题会留给作者处理。 |
| 模式 | 什么时候用 | 行为 | 人工确认 |
|---|---|---|---|
| ✍️ direct-edit（常用） | 只想改一处文字、caption、LaTeX 表达或段落结构。 | 不开评审面板，直接用写作工具包起草补丁。 | 作者确认后再应用。 |
| 🔎 review（偶尔） | 想让它审稿、挑问题、mock-review，或只审某一节 / 某条 claim。 | 启动对抗式评审引擎，先判断问题是否成立，再决定要不要修改。 | 每处改动逐一确认。 |
| 🔁 auto（无人值守） | 已经明确给出 Codex goal 或配置 mode: auto，希望它多轮跑到一个可验证目标。 |
先确认 spine 和评审分配，再按 bounded-aggressive + edit-safety 策略迭代。 |
先给整体授权；高风险项仍交回作者。 |
简单说：改一处 → 直接说；想被挑刺 → 说「审稿」；想让它多轮跑 → 给它一个 Codex goal。
Warning
auto 必须明确开启。 只打开工具权限再发普通 prompt，只会跑一轮就停，不会进入多轮循环。原因见 codex/AGENT-GUIDE.md。
codex marketplace add Spark-To-Paper-Skills/paperjury-codex然后在 Codex plugin UI 里安装 PaperJury Codex。
稳定 pinned release：
codex marketplace add Spark-To-Paper-Skills/paperjury-codex@v1.0每次 PaperJury workflow 开始时，插件会检查 GitHub 上的稳定 release tag。如果发现新版，只会给出 latest channel 和 pinned release 的安装命令，不会打断当前工作；如果 GitHub 不可达，就静默继续。设置 PAPERJURY_DISABLE_UPDATE_CHECK=1 可以关闭提醒。重新安装或切换 release channel 后，建议新开一个 Codex thread，让新版 skill 内容重新加载。
如果当前 Codex 界面还没有 plugin 安装入口，可以 clone 成 skill：
git clone https://github.com/Spark-To-Paper-Skills/paperjury-codex "$env:USERPROFILE\.codex\skills\paperjury"给 Codex / 编码 agent： 先读 codex/AGENT-GUIDE.md 和 codex/runtime.md，再用 codex/phase-contracts.md 确定各阶段输入、输出、隔离和校验规则。Codex 版通过显式授权的 subagents 并行运行这套流程。
| 版本 | 入口 | 差异 |
|---|---|---|
| Codex 版 | 本仓库；Codex plugin 或 .codex/skills/ |
语义阶段由显式授权的 Codex subagents 运行；阶段契约写在 codex/phase-contracts.md；确定性检查由 orchestrator 通过 Node 调用。 |
| Claude Code 版 | paperjury | 使用 Claude Code skill / plugin 路线；语义阶段由 Claude Workflow 文件驱动。 |
两个版本共享同一套方法论：bounded review、issue ledger、recall audit、edit-safety、compile guard 和 submission-readiness。Codex 版不携带也不执行 Claude Workflow 文件。
仓库里有一个 dogfood sample：在一篇真实草稿上跑完整多轮评审，附修改前后 PDF 和一份人工核对过的运行报告。
samples/dogfood/（original_draft.pdf · revised_draft.pdf · 运行报告）
如果只想确认稿件不会先被格式问题挡住，可以说：
跑一下 submission-readiness / 合规检查。
它会做确定性格式筛查，再配合编译驱动的版面检查。
新用户可以先跳过这一节。想看机制、源码结构或 agent 驱动方式，可以从这里开始：
| 你想了解 | 入口 |
|---|---|
| 真实运行效果 | samples/dogfood/RUN_REPORT.zh-CN.md |
| Codex runtime / agent 驱动方式 | codex/AGENT-GUIDE.md · codex/runtime.md |
| 语义阶段输入输出和隔离契约 | codex/phase-contracts.md |
| 完整协议和状态机 | references/review-engine-v3.md · references/ledger-schema.md |
| 在线可视化说明 | 交互式总览 |
展开机制、架构和项目结构说明
PaperJury 把审稿拆成一套有边界的“庭审”流程：先由有限数量的 reviewer 找问题，再把有争议的意见拿出来审议；编辑阶段按风险加护栏，多轮结束时由确定性脚本判断是否收敛。
assign-reviewers → reading-check → coverage-auditor → merge
→ { trial ‖ polish } → recall-audit → drafter
→ { edit-audit | meaning-audit } → clerk
- 读稿分解：把手稿切成阅读单元、规范段落列表和稳定段落编号，防止问题锚点漂移。
- 核心声明（仅 auto 模式）：提取核心 claim，交给作者确认后冻结为配置。
- Ledger：用机器可读的记录保存活跃问题，跨轮次、跨会话都能接上。只要没有仍然阻塞的 major 问题，就视为工具侧完成；author-required 会进入人工待办，不算工具侧未完成。
- 日志：编辑历史只追加记录，方便回滚。
- 补丁应用：原子性应用编辑，记录日志，必要时可以恢复。
- 锚点追踪：定位已冻结的核心 claim；上下文变化时，标出需要重新审计的部分。
- 交叉引用检查：编辑前先查改动关键词是否还出现在其他位置；如果出现，就标记为需要语义审计。
- 编译检查：尝试真实 LaTeX 编译；无法编译时退到结构检查，并明确说明哪些结果不可验证。
- 提交合规检查：用脚本先筛一遍常见提交格式风险。
- 评审员分配：根据论文研究方向，分配 N 位领域 reviewer。
- 完整阅读检查：每位 holistic reviewer 通读全文一遍，列出弱点、原文引文、总体置信度和按节覆盖情况；引不出原文，就视为没有真读。
- 覆盖审计：检查哪些 reviewer / section 组合可能被略读。
- 去重：合并重复评论，并整理重要性、问题类型和交叉确认情况。
- 审议（trial）：对有争议的问题开庭。先由 5 人审议，必要时升到 12 人；法官把成立的问题判定为
valid-fixable或author-required。 - 润色：快速路径处理机械性问题和轻微问题；如果判断不稳，就升级回审议。
- 召回审计（recall）：找回误判丢掉的问题，并在落稿前抽查强共识 major，防止集体误判。
- 编辑起草：对确认可修的问题起草最小改动。
- 编辑审计 / 含义审计：检查高风险改动、跨节一致性、冻结锚点和论证链条。
- 书记官：汇总本轮结果，合并重复项，整理残留问题，并用确定性规则判断是否收敛。
也支持简化的 3 人评审小组，作为快速路径。
- Codex 不执行 Claude Workflow 文件。语义阶段定义在
codex/phase-contracts.md；确定性检查由 orchestrator 通过 Node 调用。 compile-guard.js不会假装验证过：无法真正编译时，就退到结构 lint，并报告compiled:null。- 提交就绪检查分两部分：A =
compliance-check.js+ 一个语义 agent；B = 复用compile-guard.js的编译检查，再让模型读取 PDF 做版面复查。 - 你的项目文件、ledger、journal 和 patch 都留在本地论文项目里。PaperJury 自己没有后端或服务器，也就不会把文件上传到 PaperJury 服务器。审稿走的是你自己的 Codex session；模型本身仍可能跑在云端，内容如何被处理取决于宿主环境的条款和设置，PaperJury 不会再额外加一层。
| 路径 | 作用 |
|---|---|
plugins/paperjury-codex/ |
Codex plugin 发布包；README、skill、运行资源和 marketplace metadata 都在这里同步。 |
codex/ |
Codex runtime 映射、phase contracts 和 agent 驱动说明。 |
agents/ |
Codex 侧语义 agent 定义。 |
scripts/ |
确定性检查脚本：ledger、journal、apply-patch、anchor-diff、cross-ref、compile-guard、doctor 等。 |
references/ |
引擎协议、ledger schema、评审者人格、写作工具和方法论。 |
docs/ |
交互式总览、站点资产和设计说明入口。 |
samples/dogfood/ |
真实草稿的 before/after PDF 和人工核对过的运行报告。 |
tests/ |
确定性脚本和核心状态机测试。 |
- Codex plugin marketplace release。 将 PaperJury 打包为可通过 Codex plugin marketplace 路线直接安装的版本，同时保留 legacy clone 安装。
- 软更新提醒。 启动时检查有没有更新的稳定版 tag，有就给一条非阻塞提示。
- 快速版本 / quick mode。 更快、更省 token 的检查路径；不追求完整庭审深度，先给一轮可用的快速 triage。
- 按不同会议的审稿口味调整 reviewer persona。 CVPR、ACL、NeurIPS 的 reviewer 关注点并不一样；目标是让评审更贴近各自社区的预期。
- 基于视觉的版面校验。 编译、渲染、再检查版面，不只看编译日志。
- 从
.cls/ 模板自动识别 venue。 - 用更多真实论文做规模化验证。
更多文件与路径
- 引擎协议：
references/review-engine-v3.md - Codex 运行时映射：
codex/runtime.md - Codex 语义阶段契约：
codex/phase-contracts.md - 自动模式：
references/auto-mode.md - 评审者角色、编辑工具：
references/reviewer-personas.md、references/writing-toolkit.md - 账本结构和状态：
references/ledger-schema.md - 提交合规：
references/submission-compliance.md - Codex runtime / agent 说明：
codex/AGENT-GUIDE.md - 脚本：
scripts/ - Codex 运行包：
codex/
PaperJury 的 spine 和防漂移设计受 PaperSpine 启发，尤其是 anchor logic-transfer audit、claim register、minimal-edit 且保义的改写策略。PaperSpine 更偏 motivation-driven 的论文起草和改写；PaperJury 借用了其中的 anchoring 思路，以及“可检查步骤交给确定性脚本、判断交给 model agent”的分工，再在此基础上加入对抗式 review 和庭审式裁定流程。