OpenRaiser/PaperFit

📄 [Skill] Vision-in-the-loop LaTeX typesetting agent — auto-compile, render, diagnose, and fix paper layouts

PaperFit – 뷰전-인-더-루프 학술 타이포그래피 에이전트

무엇인가요 – PaperFit는 LaTeX 논문의 시각적 레이아웃을 자동으로 점검하고 수정하는 AI 에이전트 시스템입니다. 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에서 직접 가져왔으며, 추가 기능은 추정되지 않았습니다.