Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/openraiser/paperfit/check-visualgit clone --depth 1 https://github.com/OpenRaiser/PaperFitWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.00535 |
| Opus 5 | $0.00000 | $0.00267 |
| Sonnet 5 | $0.00000 | $0.00107 |
| Haiku 4.5 | $0.00000 | $0.00053 |
Grade A, and why
check-visual scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
/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
执行流程
- 编译 PDF(如需要)→ 在论文根目录执行
paperfit render <输出pdf路径> --output data/pages(脚本在全局安装的paperfit-cli包内,勿使用用户项目下的scripts/render_pages.py) - 规则引擎检查编译日志
- 排版侦探基于 VTO 分类体系识别缺陷
- 输出结构化诊断报告
输出
- 缺陷列表(类别、页码、严重等级、描述)
- 修复建议
- 不修改任何源文件
调度
- 规则引擎:
agents/rule-engine-agent.md - 排版侦探:
agents/layout-detective-agent.md
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 50 lines · 0 tokens per session scan A 6c52c79d402f
check-visual is a command published in the GitHub repository OpenRaiser/PaperFit (330 stars, last pushed 2mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 535 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.
wtfp:export-latex
Export the manuscript and bibliography to portable LaTeX source with declared formatting.
work-doc
발표/보고 산출물 제작 workflow. Presentation, Report, Decision Brief 등 고품질 산출물을 생성한다.
ocr
One-shot OCR — scanned PDF to Word + WeChat HTML + audit trail.
bmad-index-docs
Generates or updates an index.md of all documents in the specified directory.
latex-posters
Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter. Use when the requested deliverable is a conference or research poster rather than sequential presentation slides. For slide decks, use $beamer-deck.