/check-visual
**作用**: 仅执行视觉检测，输出诊断报告，不修改源文件。它是专家快捷入口，对应的普通自然语言请求如“检查这篇论文的视觉排版问题”“先做诊断不要改源码”也应能触发同类任务。
> /plugin marketplace add OpenRaiser/PaperFit > /plugin install paperfit@paperfit-vto
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/check-visual
Context preview
What this command does when you run it.
**作用**: 仅执行视觉检测，输出诊断报告，不修改源文件。它是专家快捷入口，对应的普通自然语言请求如“检查这篇论文的视觉排版问题”“先做诊断不要改源码”也应能触发同类任务。
Command definition
check-visual.md/check-visual — 执行视觉检测
**作用**: 仅执行视觉检测，输出诊断报告，不修改源文件。它是专家快捷入口，对应的普通自然语言请求如“检查这篇论文的视觉排版问题”“先做诊断不要改源码”也应能触发同类任务。
**用户入口说明**:
- 用户不需要手动执行 `paperfit render` 或其它内部命令。
- CLI、runtime、scripts 是 Agent 的内部执行层。
- 最终输出应以视觉问题、页码、严重级别和修复建议为中心，而不是底层命令细节。
工具调用约定
可执行脚本在 **`paperfit-cli` 包内**；在**论文项目根目录**执行：`paperfit render …`、`paperfit run scripts/parse_log.py …`；勿假设项目内有 `scripts/render_pages.py`。兜底：`npx paperfit-cli …`、`python3 "$(paperfit root)/scripts/…"`。
`column_void` Schema 提示
若本轮还会读取 A5 机检结果，注意：
- 原始 `detect_column_void.py` 输出文件：`data/reports/column_void_rN.json`
- 这个文件用 `pages[]`
- `by_page[]` 是 `paperfit run scripts/state_manager.py column-void ...` 合并进 `data/state.json` 后的摘要字段
也就是说：
- 读原始报告：`data["pages"]`
- 读状态摘要：`state["cv_signals_summary"]["by_page"]`
用法
/check-visual
执行流程
1. 编译 PDF（如需要）→ 在论文根目录执行 **`paperfit render <输出pdf路径> --output data/pages`**（脚本在全局安装的 `paperfit-cli` 包内，勿使用用户项目下的 `scripts/render_pages.py`） 2. 规则引擎检查编译日志 3. 排版侦探基于 VTO 分类体系识别缺陷 4. 输出结构化诊断报告
输出
- 缺陷列表（类别、页码、严重等级、描述）
- 修复建议
- 不修改任何源文件
调度
- 规则引擎：`agents/rule-engine-agent.md`
- 排版侦探：`agents/layout-detective-agent.md`
Vision-in-the-Loop Academic Typesetting Agent System PaperFit 是面向 Claude Code、Codex、Cursor 的 LaTeX 论文排版 Agent System。你只需要在论文项目根目录描述目标，PaperFit 会自动完成编译、页图渲染、视觉诊断、源码修复与最终验收。 为什么需要 · 核心能力 · 效果展示 · 快速开始 · 安装 · 使用方法 · 工作流 · 架构
Repo: OpenRaiser/PaperFit
Other commands on paperfit.
- /adjust-length
**作用**: 尝试通过排版微调或受控语义改写逼近目标页数。它是专家快捷入口；普通自然语言如“把正文压到 8 页，尽量不要改语义”也应能触发同类任务。
Open command - /fix-layout
**作用**: 对当前 LaTeX 项目执行完整的视觉排版优化（VTO）闭环
Open command - /migrate-template
**作用**: 将论文从原模板迁移至目标模板，自动处理图表尺寸、页数、宏兼容性等问题。它是专家快捷入口；普通自然语言如“把这篇论文迁移到 CVPR 模板”也应能触发同类任务。
Open command - /paperfit-priority
**作用**: 读取当前状态、视觉重点和修复计划，给出本轮应该先处理什么；若用户明确指定优先顺序，可将该顺序写入 `next_actions` 供后续 `/fix-layout` 直接遵循。
Open command - /paperfit-undo
**作用**: 恢复最近一次 PaperFit 自动写回前的备份版本，优先回滚主 `.tex`，必要时一并恢复 `data/state.json`。
Open command - /paperfit
**作用**: `/paperfit` 是 Claude Code 中的 PaperFit 主入口。用户可以直接用自然语言描述任务，例如排版分析、完整修复、模板迁移、长度调整、局部表格修复、视觉检查或状态查询。Agent 负责解析意图、识别主 `.tex`、判断是否需要画像、并自动进入对应的 PaperFit 子流程。
Open command