paper-understanding-agent · diff
git:20261104.7322b99 to git:20261104.5c23432
8 added, 5 removed. Audit A to A.
---
name: paper-understanding-agent
- description: 从 PDF 或已解析论文提取可回查的原摘要、逐页事实、方法和实验，支持为专题分阶段核验，也可生成完整结构化记录、价值评估、解读、短卡和参考文献。
+ description: 从 PDF 或已解析论文按初筛、证据或完整解读三种范围抽取可回查的信息，按需核对附录和图表，支持专题证据交接、价值评估、深读、短卡与参考文献。
---
# 论文理解 Agent
给一篇 PDF 或已解析论文和期望的交付范围，按阶段提取可回查的论文信息。Agent 负责确认原文范围、选择交付和说明缺口。调度脚本负责依赖、并发、重试、缓存、校验与合并。
- 1. 阅读[输入与编排契约](references/routing.md)。优先复用已有 `input.json` 与范围清单。若只有解析文本或分块 JSON，保留论文 ID、版本和原文定位，准备同一论文的规范输入与页、章节、正文和参考区清单。仅有 PDF 时，用[PyMuPDF 入口](references/pdf-input.md)提取带页码和坐标的文本块，并按需渲染页面供视觉复核。
- 2. 执行 `python3 scripts/run_agent.py --input INPUT --manifest PLAN --plan-only` 检查范围和依赖，再以同一组输入运行 `python3 scripts/run_agent.py --input INPUT --manifest PLAN --out OUT`。使用单次对话版 VPF 时传入 `--vpf-service-name`、`--vpf-endpoint` 和调用人。各阶段在本地加载对应 Skill。
- 3. 专题筛选或证据补查可用 `--stage metadata` 或 `--stage-id` 选取页面与章节任务，读取 `stages/` 下的已验证阶段。完整运行以 `runner-report.json` 的 `ok`、`outputs` 及统一记录的 `processing_status` 为交付依据。给用户 `paper-record.json`、`paper-card.md` 和按需的 `paper-short-card.md`。阶段错误从 `failures` 与 `calls/` 查看，同一输入与范围可在原目录继续。
+ 1. 阅读[研究任务与证据交接](references/research-workflow.md)，选择 `screen` 初筛、`evidence` 专题取证或 `full` 完整解读。先复用同版本事实，专题默认走前两种；完整解读入口保留。
+ 2. 阅读[输入与编排契约](references/routing.md)。只有 PDF 时使用[PyMuPDF 入口](references/pdf-input.md)。保留正文、参考文献、附录与图表的原始定位；由当前会话核对草稿范围、读序、章节和摘要跨度，再标记 reviewed，不要求用户手写范围 JSON。
+ 3. 以 `run_agent.py --mode MODE --input INPUT --manifest PLAN --plan-only` 检查范围与依赖，再加 `--out OUT` 执行。使用可用的 Codex/VPF 后端；若没有后端，在当前会话按同一证据契约完成任务，明确执行方式，不伪造 runner 收据或模型调用统计。
+ 4. 对关键证明、设置、消融和数值缺口，使用 `read_evidence.py` 按单元、页码或标签回查。附录先索引，按理由激活；核心图表、解析异常由当前会话的视觉能力查看，核对转写后才导入。未读不等于未报告。
+ 5. 检查 `evidence-bundle.json` 的 review_queue，结合原文及必要页面图核验关键事实，写入有指纹的 reviews，再导出交接记录。区分来源定位、数字一致性与语义支持；自动检查通过不等于科学判断正确。
+ 6. 根据 runner-report 的 ok、outputs 和实际覆盖交付。screen/evidence 输出可复用证据；full 另输出原有 paper-record、完整阅读卡和短卡。深读与评估并行，推荐理由由评估生成、交付时合并。错误按来源重解析、视觉核对、局部重跑或待核处理；用共享缓存复用未受影响的任务。
- 整篇和深读都要能查回原始正文。论文事实、作者对前作的转述、外部材料与 Agent 判断分别保留来源。作者原始摘要由元数据阶段逐字抽取，生成摘要由阅读阶段另存。结构、范围和引文校验用于判断交付是否可追溯，阅读质量仍可用冻结要点独立评阅。
+ 整篇综合检查原文覆盖，后续深读与评估优先读取理解结果和证据库，必要时通过运行器的有界请求读取原文。论文事实、已核对图像转写、作者对前作的转述、外部材料与综合判断分别标记。作者原始摘要逐字保留，生成摘要另存。只有允许联网且存在具体缺口时补外部证据，优先复用专题已有基线；记录查证时间与来源类型。
## 云端打包
本包只有这个顶层技能入口。`runtime/PROFILE.md` 与 `references/specialists/*/PROFILE.md` 是完整保留的内部专业指导，由运行脚本按阶段读取，无需分别安装。