Academic Figure Architecture Extractor & Analyzer

学术图表架构提取与分析

将论文 PDF 或现有架构图转换为结构化的 架构图分析结果，以便顺畅交接给配色专家和提示词技能。

调色板：→ references/palettes.md（仅名称）
缺失信息：→ references/missing-info-policy.md
提取器：→ scripts/extract_pdf_figures.py

适用范围说明

• 有用户提供的图像时，优先使用这些图像。
• PDF 提取由真实的本地辅助工具完成（pdfimages / PyMuPDF / 可选的 pdftoppm），不是训练好的检测器。
• 尺寸筛选仅为启发式方法；判断图像属于架构图、照片还是表格由 Agent 判断。
• 调色板：从 references/palettes.md 推荐名称；需要时通过配色专家获取十六进制颜色值。

输入约定

• 优先提供：PDF 路径、图像、领域、会议
• 最低要求：一个 PDF 或一张架构图
• 信息缺失时：分析现有内容；列出受阻步骤

输出约定 — 架构图分析结果

• 清单（路径/页码、尺寸、保留/舍弃原因）
• 每张保留图的结构（组件、层级、流程、类型）
• 推荐调色板名称
• 供 academic-figure-prompt 使用的重绘参数

步骤

步骤 1：获取图像

已提供图像 → 为路径编制索引。

已提供 PDF → 运行辅助工具（从技能目录或仓库根目录运行）：

python3 academic-figure-architecture-extractor/scripts/extract_pdf_figures.py \
  /path/to/paper.pdf -o /tmp/arch-extract/paper

常用标志：

标志	含义
--backend auto|pdfimages|pymupdf	嵌入图像后端
--min-side 300	丢弃过小的图标（默认值）
--min-pixels 90000	丢弃低分辨率裁剪图
--pages 4 或 --pages 1-3 或 --pages all	同时通过 pdftoppm 栅格化页面
--dpi 150	栅格化 DPI

读取输出目录中的 extract-report.json（kept / dropped / tools）。

如果两个后端都不可用 → 请用户提供导出的图表；不要编造路径。

完成条件：每个候选图都有路径或页码引用，或明确说明工具受阻。

步骤 2：筛选类似架构图的图像

从 kept（尺寸符合要求）开始。由 Agent 重新分类：

保留线索	舍弃线索
方框 + 箭头、分层模块	纯照片、只有散点的图、密集表格
结构化边 / 模块	已因尺寸过小而筛除的微型图标

不确定时 → 保留并标注为 待确认。

完成条件：每张图都被标为保留 / 舍弃 / 不确定，并附上一句话说明原因。

步骤 3：结构分析

对每张保留的图：

1. 组件（核心组件与辅助组件）
2. 层级 / 数据流
3. 类型：总体框架 / 网络架构 / 模块细节 / 对比图
4. 领域说明

完成条件：每张保留的图都有类型、组件列表和流程摘要。

步骤 4：推荐调色板 + 重绘交接

根据 references/palettes.md 进行映射（例如：≥4 个模块的框架 → Nature Blue；模块细节 → Blue Monochrome；对比图 → ML TopConf Deep）。

图类型: ...
核心组件: ...
配色方案名: ...
布局建议: 16:9 | 3:2 | 4:3
风格: white fill, colored borders, flat vector
标注要求: ...

完成条件：每张保留的图都有重绘参数和调色板名称（不含十六进制颜色表）。

停止条件

报告交付、提取受阻且等待用户提供图像，或用户只需要清单时，即可停止。