OpenRaiser/PaperFit
📄 [Skill] Vision-in-the-loop LaTeX typesetting agent — auto-compile, render, diagnose, and fix paper layouts
PaperFit – 视觉闭环的学术排版智能体
是什么 – PaperFit 是一个 AI 智能体系统，帮助您优化 LaTeX 论文的视觉布局。它支持 Claude Code、Codex 和 Cursor。您用自然语言描述目标（例如：“修复布局”、“迁移到 CVPR 模板”、“压缩到 8 页”），智能体将执行闭环流程：
- 编译 LaTeX 项目并解析日志。
- 渲染 每页 PDF 为图像（通过 Poppler）。
- 诊断 视觉缺陷，如浮动对象堆积、空白区域、过宽盒子、表格样式不一致等。
- 规划 在遵守模板规则和 VTO 分类体系的前提下，制定源码级修复方案。
- 打补丁 仅在明确批准后（
--apply）才修改.tex文件。 - 重新编译 并重复，直到门控器接受结果。
该系统刻意采用“视觉闭环”设计：不仅检查编译是否成功，更关注论文的“外观”，并迭代优化。
核心功能
| 功能 | 作用 |
|---|---|
| 视觉布局诊断 | 检测孤立行、大空白、双栏空洞、浮动对象拥堵、表格样式不一致、溢出、错位等。 |
| 完整 VTO 修复 | 端到端循环：编译 → 渲染 → 诊断 → 打补丁 → 重新验证。 |
| 模板迁移 | 在常见会议模板（CVPR、ICLR、ACL、ACM 等）间转换论文，同时保持图表、表格和引用稳定。 |
| 页面预算控制 | 在最小语义变更下调整布局以满足目标页数。 |
| 局部对象修复 | 仅修复单个表格、图表或公式，不影响全文。 |
| 多主机分发 | 同一功能可作为 Claude Code 插件、Codex 提供者或 Cursor 规则集安装。 |
典型工作流（CLI / 智能体）
# 1. 安装 CLI 和主机插件
npm install -g paperfit-cli
paperfit-install --target claude # 或 codex / cursor
# 2. 运行健康检查并安装 Python 依赖
paperfit doctor --target claude
pip install -r $(npm root -g)/paperfit-cli/requirements.txt
# 3. 在项目根目录发出自然语言命令
用 PaperFit 把这篇论文迁移到 CVPR 模板，并尽量保持图表和引用稳定
# 或在 Codex 中使用英文
Use the paperfit agent to compress the manuscript to 8 pages with minimal semantic change
# 4. PaperFit 自动执行：
# - 找到主 .tex 文件
# - 编译 → 渲染 → 诊断 → 提出补丁
# - 显示摘要；您通过 `--apply` 批准
# 5. 批准后，智能体修改源码，重新编译，并报告成功。
安装前提
- Node.js 18+（用于 CLI 和主机插件）
- Python 3.8+（用于视觉分析脚本）
- Poppler（PDF → 图像转换）
- 与目标模板兼容的 LaTeX 引擎（
tectonic、pdflatex等）。
macOS：brew install poppler。Linux 用户安装对应包。
使用方式
| 主机 | 入口命令 | 示例请求 |
|---|---|---|
| Claude Code | /paperfit … |
/paperfit 用 PaperFit 分析 main.tex 的视觉排版问题 |
| Codex | Use the paperfit agent to … |
Use the paperfit agent to run a full layout repair loop |
| Cursor | 项目内的自然语言任务 | 用 PaperFit 把正文压到 8 页，尽量不要改学术内容 |
所有操作默认为 dry-run。仅当添加 --apply（或主机给予明确许可）时，源文件才会被修改。
架构概览
- agents/ – PaperFit 智能体定义（任务编排、决策）。
- skills/ – 可复用的能力包（视觉诊断、浮动对象优化、模板规则、语义微编辑）。
- config/ – 模板元数据、VTO 分类体系、布局规则。
- scripts/ – 低层级工具（PDF 渲染、日志解析、缺陷聚合、补丁生成、门控）。
- bin/paperfit.js – CLI 入口点，用于安装、健康检查、渲染和调用智能体。
谁会受益？
- 提交前希望快速进行视觉合理性检查的研究人员。
- 需要将论文迁移到新会议/期刊模板的作者。
- 任何需要在不改变学术内容的前提下将稿件压缩到严格页数限制的人。
许可证
MIT – 详见 LICENSE。
所有细节均直接取自仓库 README；未推断额外功能。
相关
- 项目
- 项目
- 项目
- 项目