zimoliao paper2any - Paper2Any MCP 增强组件
Paper2Any 是外部项目 OpenDCAI/Paper2Any。ScholarAIO 不 vendoring 它的代码和依赖；ScholarAIO 只提供一个轻量 MCP sidecar，把 agent 请求转交给真实 Paper2Any checkout 或它自己的 FastAPI 后端。
隔离与晋级边界
Paper2Any 是 isolated extension，不是 ScholarAIO 或当前 Agent 的默认生成路径。
- 普通网页检索、论文阅读、写作、图表和演示稿按任务能力与交付契约路由，不按 Agent 品牌路由；先检查当前会话实际提供的原生能力，能够满足任务时由当前使用的 Agent 原生能力完成。
- 只有用户明确要求 Paper2Any，或正在执行 Paper2Any 对比评测时，才运行本 skill；不要为普通 PPT、海报、rebuttal 或图表自动执行
setup。 - checkout、虚拟环境、MCP sidecar、FastAPI 后端和输出目录继续与 ScholarAIO 基础运行时隔离。
- 在提升为默认或一等能力之前，必须完成 fixed-corpus 对比，至少记录事实准确性、可编辑性、版式质量、延迟、成本、安装负担和失败降级行为。
默认外部 checkout 位置：
data/runtime/extensions/paper2any/Paper2Any
使用顺序
确认用户明确要求 Paper2Any 或本次任务是 fixed-corpus 评测，然后准备外部 Paper2Any runtime：
scholaraio paper2any setup如果用户明确要让 agent 把 upstream Python runtime 也准备好，使用：
scholaraio paper2any setup --install-runtime这个命令会使用 OpenDCAI/Paper2Any 自己的 requirements 在
data/runtime/extensions/paper2any/.venv中准备隔离环境；不要把依赖清单转嫁给非开发者用户。当前支持的上游安装契约是
requirements-base.txt+requirements-paper.txt。任一清单缺失时应停止并提示更新 checkout，不要把空虚拟环境报告为安装成功。这个选项只安装 Python 依赖；Paper2Any 当前文档列出的 LibreOffice、Inkscape、Poppler、FFmpeg、wkhtmltopdf、Tectonic 等系统工具仍需按实际工作流单独准备。确认 sidecar 是否可用：
scholaraio paper2any status如果不可用，启动 ScholarAIO 轻量 MCP sidecar：
scholaraio paper2any mcp-serve这只启动 ScholarAIO 的 MCP 代理，不会伪造 Paper2Any 结果。真实产物仍由外部 Paper2Any CLI 或 Paper2Any FastAPI 生成。
如果需要 Paper2Any FastAPI 工作流，启动真实上游 backend。上游
/api/v1/...路由要求BACKEND_API_KEY/X-API-Key，因此先在config.local.yaml写入paper2any.backend_api_key，或设置环境变量：export PAPER2ANY_BACKEND_API_KEY="..." scholaraio paper2any backend-serve这个命令只负责从外部 checkout 启动 Paper2Any 自己的
fastapi_app.main:app，优先使用data/runtime/extensions/paper2any/.venv。列出可用工具：
scholaraio paper2any tools scholaraio paper2any call paper2any_capabilities运行真实 CLI 工作流时，必须提供真实输入文件和输出目录：
scholaraio paper2any call paper2any_run_cli --arguments-json '{ "workflow": "paper2figure", "input": "workspace/example/paper.pdf", "output_dir": "workspace/_system/paper2any/example-figure", "extra_args": ["--graph-type", "model_arch"] }'如果 upstream Paper2Any 只允许写入自己的
Paper2Any/outputs目录，sidecar 会先在那里真实运行，再把真实产物复制回请求中的 workspace 输出目录。结果里会同时给出paper2any_output_dir和requested_output_dir。调用真实 Paper2Any FastAPI 后端 JSON 路径；这同样要求
paper2any.backend_api_key或PAPER2ANY_BACKEND_API_KEY：scholaraio paper2any call paper2any_call_api --arguments-json '{ "path": "/api/v1/system/verify-llm", "json": {"model": "gpt-4o"} }'
MCP 工具
paper2any_status: 检查外部 checkout、CLI 脚本、FastAPI/health。paper2any_capabilities: 列出所有已知 CLI 工作流和 API 工作流族。paper2any_run_cli: 运行真实 upstream standalone CLI 脚本。paper2any_call_api: 代理真实 upstream FastAPI/api/v1/...或/health。paper2any_outputs: 列出输出目录中的真实产物。
覆盖的 Paper2Any 路径
真实 CLI 脚本路径：
paper2figure:script/run_paper2figure_cli.pypaper2ppt:script/run_paper2ppt_cli.pypaper2ppt_frontend:script/run_paper2ppt_frontend_cli.pypdf2ppt:script/run_pdf2ppt_cli.pyimage2ppt:script/run_image2ppt_cli.pyppt2polish:script/run_ppt2polish_cli.pypaper2poster:script/run_paper2poster_cli.pypaper2video:script/run_paper2video_cli.py
真实 FastAPI 工作流族：
paper2figure,paper2ppt,paper2citation,paper2video,paper2posterpdf2ppt,image2ppt,image2drawio,image_playground（实际路径为/api/v1/image-playground/...）mindmap,kb,kb_workflows,kb_embedding,files（kb_workflows与kb_embedding实际挂在/api/v1/kb/...下）paper2drawio,paper2rebuttal
配置
config.yaml:
paper2any:
transport: mcp
mcp_url: http://127.0.0.1:8770/mcp
root: null
base_url: http://127.0.0.1:8000
api_key: null
backend_api_key: null # required for upstream /api/v1/... routes
config.local.yaml 只放本机密钥：
paper2any:
api_key: ""
backend_api_key: ""
可用环境变量：
PAPER2ANY_ROOTPAPER2ANY_MCP_URLPAPER2ANY_MCP_API_KEYPAPER2ANY_BACKEND_URLPAPER2ANY_BACKEND_API_KEY（上游/api/v1/...路由必需）
Agent 规则
- 不要 fake 产物；报告必须来自真实
paper2any_run_cli、真实paper2any_call_api或真实输出目录检查。 - 如果 upstream 依赖、模型 API key、Node/Python 环境缺失，明确报告边界，不要生成替代伪产物。
- 用户产物放在
workspace/_system/paper2any/或用户指定 workspace；不要写到仓库根目录。 - 不要把 OpenDCAI/Paper2Any vendored 到 ScholarAIO 源码；外部 checkout 属于 runtime extension。