paper-figure-drawio

name	paper-figure-drawio
description	Generate DrawIO architecture diagrams and TikZ figures for papers. Use when user says "画DrawIO", "技术路线图", "流程图", or needs non-data diagrams for a paper. This is a lightweight sub-step split from paper-figure to avoid context accumulation.
argument-hint	["figure-plan-or-data-path"]
allowed-tools	Bash(*), Read, Write, Edit, Grep, Glob, Agent

Paper Figure — DrawIO/TikZ Diagrams (Sub-step)

Generate DrawIO architecture diagrams and TikZ figures for: $ARGUMENTS

This is a lightweight sub-step split from paper-figure. It ONLY handles non-data diagrams (DrawIO + TikZ). Data figures (matplotlib/seaborn) were already generated in the previous paper-figure step.

Constants

• FIG_DIR = figures/

• CUSTOM_REQUIREMENTS — User-specified requirements, highest priority.

Workflow

Step 1: Read existing state + DrawIO plan

1. Check what already exists from the previous paper-figure step:

echo "=== Existing figures ==="

ls -la figures/*.pdf 2>/dev/null | head -30

echo ""

echo "=== Existing .drawio files ==="

ls -la figures/*.drawio 2>/dev/null

echo ""

echo "=== latex_includes.tex exists? ==="

[ -f figures/latex_includes.tex ] && echo "YES" || echo "NO"

2. Extract the DrawIO/TikZ plan from planning docs:

echo "=== DrawIO plan from PROBLEM_ANALYSIS.md ==="

grep -A 50 'DrawIO' PROBLEM_ANALYSIS.md 2>/dev/null | grep -E 'DrawIO-[0-9]' || echo "No DrawIO plan found"

echo ""

echo "=== TikZ plan ==="

grep -E 'TikZ-[0-9]|模型架构|变量关系|因果路径|算法流程|几何示意' PROBLEM_ANALYSIS.md 2>/dev/null || echo "No TikZ plan found"

echo ""

echo "=== GPT Image failures (need DrawIO fallback) ==="

# 读取前一步 paper-figure 持久化的 GPT Image 状态

if [ -f figures/_gptimg_status.txt ]; then

    GPTIMG_STATUS=$(cat figures/_gptimg_status.txt)

    echo "GPT Image status: $GPTIMG_STATUS"

    if [ "$GPTIMG_STATUS" = "ALL_SUCCESS" ]; then

        echo "All GPT Image figures succeeded — only generate DrawIO for figures NOT covered by GPT Image"

    elif [ "$GPTIMG_STATUS" = "SOME_FAILED" ]; then

        GPTIMG_FAILED=$(cat figures/_gptimg_failed.txt 2>/dev/null)

        echo "GPT Image failures: $GPTIMG_FAILED — generate DrawIO for these"

    elif [ "$GPTIMG_STATUS" = "ALL_FAILED" ]; then

        echo 

    

         

    



     



 



 grep -qi  PROBLEM_ANALYSIS.md CLAUDE.md 2>/dev/null; 

    DRAWIO_LANG=



    DRAWIO_LANG=



 

⛔ 读完规划后，必须输出一个 DRAWIO PLAN CHECKLIST（后续步骤对照用）：

DRAWIO PLAN CHECKLIST (from PROBLEM_ANALYSIS.md):

[ ] 1. fig_roadmap — 技术路线图 (DrawIO)

[ ] 2. fig_flow_q1 — 问题一求解流程图 (DrawIO)

[ ] 3. fig_flow_q2 — 问题二求解流程图 (DrawIO)

[ ] 4. fig_pipeline — 数据处理 Pipeline (DrawIO)

[ ] 5. tikz_architecture — 模型架构图 (TikZ, if planned)

Total: N DrawIO + M TikZ

每一条都必须在后续步骤中生成。规划清单就是合同。

⛔ DrawIO 图中所有文字必须与论文语言一致。

⛔ 竞赛论文必须至少生成 1 张 DrawIO 技术路线图。其他 DrawIO 图按规划清单生成。

⛔ 如果规划清单里有 N 条 DrawIO 图，本步骤结束时必须有 N 个 .drawio 文件和 N 个对应的 .pdf。缺一不可。

Step 2: Read DrawIO rules

MANDATORY: Read the DrawIO rules before writing ANY .drawio XML:

cat _utils/drawio_rules.md 2>/dev/null || cat skills/shared-scripts/drawio_rules.md

Step 3: Generate .drawio XML files

⛔ CRITICAL: DrawIO XML 文件很大（200-500行），必须分段写入，防止输出截断导致空工具调用。

正确写法（分 3 段写入）：

# 第 1 段：写文件头 + 前半部分节点

cat << 'XMLEOF' > figures/fig_roadmap.drawio

<mxfile>

  <diagram name="Page-1">

    <mxGraphModel>

      <root>

        <mxCell id="0"/>

        <mxCell id="1" parent="0"/>

        <!-- 前半部分节点（顶部标题栏 + 左栏 + 前几个阶段） -->

XMLEOF



# 第 2 段：追加中间节点

cat << 'XMLEOF' >> figures/fig_roadmap.drawio

        <!-- 中间部分节点（核心阶段 + 右栏方法） -->

XMLEOF



# 第 3 段：追加剩余节点 + 连线 + 闭合标签

cat << 'XMLEOF' >> figures/fig_roadmap.drawio

        <!-- 连线和底部 -->

      </root>

    </mxGraphModel>

  </diagram>

</mxfile>

XMLEOF

每段不超过 150 行。 一张技术路线图分 3 段，一张流程图分 2-3 段。

⛔ 不要用 Write 工具写大 XML——Write 工具的 content 参数也会被截断。用 Bash heredoc 分段追加最可靠。

按规划清单逐条生成，每张图一个 .drawio 文件：

⛔ 配色与风格自由发挥原则：

• 根据论文主题自主选择柔和高级的配色方案，不要每次都用默认学术蓝

• 不同子问题的流程图用不同配色，形成视觉区分

• 推荐风格：低饱和度渐变色（莫兰迪色系）、柔和的暖色/冷色搭配

• 技术路线图：鼓励在三栏结构基础上自由发挥阶段配色、子框样式、箭头形态

• 求解流程图：鼓励使用多种节点形状（六边形=数据处理、平行四边形=输入输出、圆柱=数据源、菱形=判断），不要全用圆角矩形

• 布局可以灵活：纵向、横向、L 形拐弯、泳道分区都可以，根据内容选最合适的

• 核心约束不变：三栏结构（技术路线图）、判断分支+并行+循环（流程图）、双行节点、html=1、无 shadow

| 图类型 | 文件名示例 | 内容要点 |

|--------|-----------|---------|

| 技术路线图 | fig_roadmap.drawio | ⛔ 随机选模板 A 或 B（见 drawio_rules.md），保持三栏结构。节点居中分布 |

| 子问题求解流程图 | fig_flow_q1.drawio | ⛔ 必须包含：(1) 判断分支（菱形+是/否）(2) 并行分叉 (3) 右侧工具栏 (4) 循环反馈箭头 (5) 节点双行 |

| 数据处理 Pipeline | fig_pipeline.drawio | 横向多阶段、每阶段工具/方法标注 |

| 概念框架图 | fig_framework.drawio | 理论模块分层展示，层间大箭头 |

| 指标体系层次图 | fig_index_hierarchy.drawio | 目标层→准则层→指标层的树形结构 |

| 模型选择决策树 | fig_model_decision.drawio | 从数据特征出发的分支判断 |

| 甘特图/调度方案图 | fig_gantt.drawio | 横轴时间+纵轴任务/资源 |

| 网络拓扑/路径图 | fig_network.drawio | 节点+边的网络结构 |

⛔ 以下图类型不要用 DrawIO，用 TikZ 生成：模型架构图、变量关系图、算法流程图（带公式）、几何示意图。

⛔ 完整 XML 示例：生成前先随机选模板（cat _utils/example_roadmap.drawio 或 cat _utils/example_roadmap_stats.drawio）参考其 XML 结构和样式。

⛔ 生成技术路线图前必须执行：

echo "=== 随机选择技术路线图模板 ==="

TEMPLATE=$(python3 -c "import random; print(random.choice(['A', 'B']))" 2>/dev/null || echo "A")

echo "本次使用模板: $TEMPLATE"

if [ "$TEMPLATE" = "A" ]; then

    echo "--- 模板 A: 三栏结构（左栏阶段+中栏内容+右栏方法）---"

    cat _utils/example_roadmap.drawio 2>/dev/null | head -50

else

    echo "--- 模板 B: 粉色标题+六边形阶段节点 ---"

    cat _utils/example_roadmap_stats.drawio 2>/dev/null | head -50

fi

echo "... (参考完整 XML 结构后再生成)"

⛔ 生成求解流程图前必须执行：

echo "=== 读取求解流程图示例 ==="

cat _utils/example_flow.drawio 2>/dev/null | head -50

echo "... (参考完整 XML 结构后再生成)"

⛔ 每张图生成后立即验证文件存在：

[ -f figures/fig_roadmap.drawio ] && echo "✅ fig_roadmap.drawio created" || echo "❌ MISSING"

Step 4: Export to PDF + self-check + fix loop (⛔ 最多 3 轮)

每张 .drawio 文件必须经过：导出 → 自检 → 修复 → 重新导出的循环，最多 3 轮。

对每张 .drawio 文件，执行以下循环：

FOR each figures/*.drawio file:

  FOR round = 1 to 3:

    1. Export: draw.io.exe --export --format pdf --crop

    2. If PDF not generated → check XML syntax (ID duplicate, unclosed tags, escaping), fix, CONTINUE to next round

    3. Self-check the XML (Step 5 checklist below):

       - Overlap check (x/y/width/height collision)

       - Edge crossing check (jumpStyle, waypoints)

       - Text overflow check (width vs char count)

       - Spacing consistency

       - Style consistency

       - Size check (within page bounds)

    4. If any check fails → fix the XML, CONTINUE to next round

    5. If all checks pass → BREAK (this file is done)

  END FOR

  If still failing after 3 rounds → fallback to TikZ for this diagram

END FOR

导出命令：

draw.io.exe --export --format pdf --crop --output "figures/${bn}.pdf" "$drawio_file" 2>&1 &

DRAWIO_PID=$!

( sleep 60 && kill $DRAWIO_PID 2>/dev/null && echo "⚠ timeout" ) &

TIMER_PID=$!

wait $DRAWIO_PID 2>/dev/null

kill $TIMER_PID 2>/dev/null

自检清单（每轮都过一遍）：

1. [重叠检查] 同行节点：(x1 + width1 + 30) ≤ x2；上下层：(y1 + height1 + 30) ≤ y2

2. [连线遮挡] 所有连线 jumpStyle=arc;jumpSize=6;rounded=1，不穿过节点

3. [文字溢出] 中文 width ≥ 字数×16+40，英文 width ≥ 字符数×8+40，whiteSpace=wrap

4. [间距一致] 同层节点间距差异 ≤ 10px

5. [样式一致] 同类节点 fillColor/strokeColor/fontSize 一致，fontstyle=1

6. [尺寸检查] 总宽度 ≤ pageWidth，总高度 ≤ pageHeight

7. [⛔ 居中检查] 中栏子框和节点必须在虚线框内居中分布，不要左对齐留大片空白。计算：左边距 = (容器宽度 - 内容总宽度) / 2。特别检查：只有 2-3 个节点的行、最后一行（结论阶段）

⛔ 发现问题必须立即修改 XML 并重新导出，不能跳过。3 轮都失败 → 降级到 TikZ 兜底。

Step 5: Structure validation loop (⛔ MUST PASS)

对技术路线图和求解流程图运行结构自检脚本。如果不通过，必须读取示例文件参考后重写，然后重新导出+重新自检，最多 3 轮。

PYTHON=$(command -v python3 2>/dev/null || command -v python 2>/dev/null)



# 技术路线图结构检查 + 强制修复循环

if [ -f figures/fig_roadmap.drawio ]; then

    for ROUND in 1 2 3; do

        echo "=== 技术路线图结构自检 (round $ROUND) ==="

        $PYTHON _utils/drawio_check.py figures/fig_roadmap.drawio roadmap

        if [ $? -eq 0 ]; then

            echo "✅ 技术路线图结构合格"

            break

        fi

        if [ $ROUND -lt 3 ]; then

            echo "⛔ 不合格 — 读取示例后重写..."

            echo ">>> cat _utils/example_roadmap.drawio 参考结构"

            # Claude: 你必须在这里读取 example_roadmap.drawio，修改 fig_roadmap.drawio，然后重新导出 PDF

        else

            echo "⛔ 3 轮仍不合格 — 降级到 TikZ"

        fi

    done

fi



# 求解流程图结构检查 + 强制修复循环

for flow in figures/fig_flow_*.drawio; do

    [ -f "$flow" ] || continue

    for ROUND in 1 2 3; do

        echo "=== 求解流程图结构自检: $(basename $flow) (round $ROUND) ==="

        $PYTHON _utils/drawio_check.py  flow

         [ $? -eq 0 ]; 

             

            

        

         [  -lt 3 ]; 

             

             

        

             

        

    

⛔ 关键：上面的 bash 脚本只是检测框架。Claude 在看到 ⛔ 不合格 输出后，必须：

1. cat _utils/example_roadmap.drawio 读取完整示例

2. 重写 .drawio XML（修复结构问题）

3. 重新导出 PDF（draw.io.exe --export ...）

4. 重新运行 drawio_check.py 验证

5. 重复直到通过或 3 轮用完

不允许看到 CRITICAL 后跳过不修。

Step 6: Plan reconciliation loop (⛔ 缺一不可)

逐条对照规划清单，缺失的必须补生成。循环直到全部齐全。

echo "=== DrawIO plan reconciliation ==="

echo "Planned:"

grep -E 'DrawIO-[0-9]' PROBLEM_ANALYSIS.md 2>/dev/null

echo ""

echo "Generated:"

ls -1 figures/*.drawio 2>/dev/null

echo ""

echo "Exported PDFs:"

ls -1 figures/fig_roadmap.pdf figures/fig_flow_*.pdf figures/fig_pipeline*.pdf figures/fig_framework*.pdf figures/fig_index_*.pdf figures/fig_model_*.pdf figures/fig_network*.pdf 2>/dev/null

⛔ 对照上面的输出：

1. 规划清单中的每一条，是否都有对应的 .drawio 文件？

2. 每个 .drawio 文件是否都有对应的 .pdf？

3. 如果有缺失 → 立即回到 Step 3 补生成该图的 .drawio XML → 导出 PDF → 自检

4. 重复本步骤直到所有规划项都有 .drawio + .pdf

5. 如果某张图反复失败（3 轮），启用跨工具兜底：DrawIO 失败 → TikZ，TikZ 失败 → DrawIO（简化版）

⛔ 校验完成后，更新 DRAWIO PLAN CHECKLIST 状态：

DRAWIO PLAN CHECKLIST (reconciliation):

[✅] 1. fig_roadmap — figures/fig_roadmap.drawio + figures/fig_roadmap.pdf (exists, XXX bytes)

[✅] 2. fig_flow_q1 — figures/fig_flow_q1.drawio + figures/fig_flow_q1.pdf (exists)

[❌] 3. fig_flow_q2 — MISSING — need to generate

[✅] 4. fig_pipeline — figures/fig_pipeline.drawio + figures/fig_pipeline.pdf (exists)

Result: 3/4 complete, 1 MISSING → go back to Step 3 for fig_flow_q2

Step 7: Generate TikZ diagrams (if planned)

如果规划清单中有 TikZ 类型的图，在此步骤生成。

1. Read TikZ rules:

cat _utils/tikz_rules.md 2>/dev/null || cat skills/shared-scripts/tikz_rules.md

2. Write TikZ code to figures/tikz_diagrams.tex.

3. Compile + fix loop (最多 3 轮)：

FOR round = 1 to 3:

  1. Compile: xelatex -interaction=nonstopmode -output-directory=figures figures/tikz_diagrams.tex

  2. If compilation fails:

     - Check: math mode paired? (\usetikzlibrary missing? align= attribute? xelatex for Chinese?)

     - Fix the .tex file

     - CONTINUE to next round

  3. Run tikz_check.sh:

     bash _utils/tikz_check.sh figures/tikz_diagrams.tex

  4. If CRITICAL issues found:

     - Fix the .tex file (color scheme, overlap, text width, edge crossing)

     - CONTINUE to next round

  5. If all pass → BREAK

END FOR

If still failing after 3 rounds → fallback to DrawIO (simplified version, no formulas)

编译命令：

xelatex -interaction=nonstopmode -output-directory=figures figures/tikz_diagrams.tex 2>&1 | tail -10

tikz_check.sh 自检（编译成功后必须执行）：

for texfile in figures/tikz_*.tex figures/tikz_diagrams.tex; do

    [ -f "$texfile" ] || continue

    echo "=== TikZ 自检: $(basename $texfile) ==="

    bash _utils/tikz_check.sh "$texfile" 2>/dev/null || bash skills/shared-scripts/tikz_check.sh "$texfile"

    if [ $? -gt 0 ]; then

        echo "⛔ 有 CRITICAL 问题 — 必须修复后重新编译"

    fi

done

⛔ tikz_check.sh 报告的所有 CRITICAL 必须修复后重新编译。不允许带着 CRITICAL 完成步骤。

手动内容自检（编译成功 + tikz_check 通过后过一遍）：

• 所有节点文字完整可见，没有被截断

• 连线没有穿过其他节点或文字

• 箭头方向正确（因果关系/数据流向）

• 数学公式渲染正确（变量名/希腊字母/上下标）

• 配色与论文整体风格一致（参考 tikz_rules.md 配色方案）

• 节点间距均匀，整图居中

如果没有 TikZ 图需要生成 → 跳过此步骤。

Step 7.5: TikZ 视觉自检（vision LLM，自动修复）

对每个编译成功的 TikZ PDF，用 vision LLM 检查布局质量。最多 3 轮修复。

⛔ 如果 vision API 不可用（exit 2），跳过此步骤，不阻塞流程。

⛔ 执行方式：这不是一个完整的 bash 脚本。你需要逐步执行：先运行 PDF→PNG + vision 检查，如果返回 ISSUE，你必须用 Read 工具读取 TikZ .tex 源码，根据 vision 反馈修改（调整坐标/间距/节点宽度/颜色），用 Write/Edit 工具写回，然后重新编译 xelatex，再重新检查。每轮都是：检查→修改→编译→再检查。

PYTHON=$(command -v python3 2>/dev/null || command -v python 2>/dev/null)

mkdir -p _tmp



for tikz_pdf in figures/tikz_*.pdf; do

    [ -f "$tikz_pdf" ] || continue

    bn=$(basename "$tikz_pdf" .pdf)

    tikz_tex="figures/${bn}.tex"

    [ -f "$tikz_tex" ] || tikz_tex="figures/tikz_diagrams.tex"



    for VROUND in 1 2 3; do

        echo "=== TikZ 视觉自检: $bn (round $VROUND) ==="



        # PDF → PNG（尝试多种方式）

        PNG_OK=0

        if command -v pdftoppm >/dev/null 2>&1; then

            pdftoppm -png -r 200 -singlefile "$tikz_pdf" "_tmp/${bn}_vcheck" && PNG_OK=1

        fi

        if [ "$PNG_OK" -eq 0 ] && $PYTHON -c "from pdf2image import convert_from_path" 2>/dev/null; then

            $PYTHON -c "

from pdf2image import convert_from_path

imgs = convert_from_path('$tikz_pdf', dpi=200, first_page=1, last_page=1)

imgs[0].save('_tmp/${bn}_vcheck.png', 'PNG')

" && PNG_OK=1

        fi

        if [ "$PNG_OK" -eq 0 ]; 

             

            

        



        

        VRESULT=$( _utils/tikz_vision_check.py  2>&1)

        VEXIT=$?

         



         [  -eq 0 ]; 

             

            

         [  -eq 2 ]; 

             

            

        



        

         [  -lt 3 ]; 

             

             

             

        

             

        

    

Step 8: Update latex_includes.tex

为所有 DrawIO/TikZ 导出的 PDF 追加 LaTeX include 片段到 figures/latex_includes.tex。

⛔ 注意：前一步 paper-figure 已经在 latex_includes.tex 中写入了数据图的 include 片段。本步骤只追加 DrawIO/TikZ 图的片段，不要覆盖已有内容。使用 >> 追加而非 > 覆盖。

⛔ 图片尺寸双约束（防止占满整页）：

| 图类型 | width | height |

|--------|-------|--------|

| 技术路线图 | \textwidth | 0.45\textheight |

| Pipeline 图 | \textwidth | 0.3\textheight |

| 概念框架图 | 0.9\textwidth | 0.4\textheight |

| 求解流程图 | 0.85\textwidth | 0.38\textheight |

| 决策树 | 0.85\textwidth | 0.38\textheight |

| 指标体系 | 0.9\textwidth | 0.25\textheight |

| 网络拓扑 | 0.6\textwidth | 0.35\textheight |

⛔ 所有图必须有 keepaspectratio。

⛔ Captions must match paper language.

% === 技术路线图 ===

\begin{figure}[H]

\centering

\includegraphics[width=\textwidth,height=0.45\textheight,keepaspectratio]{figures/fig_roadmap.pdf}

\caption{整体技术路线图}\label{fig:roadmap}

\end{figure}

⛔ 追加后自检：

echo "=== latex_includes.tex 追加验证 ==="

# 1. 检查每个 DrawIO/TikZ PDF 是否都有对应的 \includegraphics

for pdf in figures/fig_roadmap.pdf figures/fig_flow_*.pdf figures/fig_pipeline*.pdf figures/fig_framework*.pdf figures/fig_index_*.pdf figures/fig_network*.pdf; do

    [ -f "$pdf" ] || continue

    bn=$(basename "$pdf")

    if grep -q "$bn" figures/latex_includes.tex 2>/dev/null; then

        echo "✅ $bn has include entry"

    else

        echo "❌ $bn MISSING from latex_includes.tex — must append"

    fi

done

# 2. 检查 label 是否有重复

DUPS=$(grep -oh '\\label{[^}]*}' figures/latex_includes.tex 2>/dev/null | sort | uniq -d)

[ -z "$DUPS" ] && echo "✅ No duplicate labels" || echo "❌ Duplicate labels: $DUPS"

如果有 ❌，立即修复（追加缺失的 include 或修复重复 label）。

Step 9: Final quality gate

echo "=========================================="

echo "  DRAWIO/TIKZ QUALITY GATE"

echo "=========================================="

GATE_FAIL=0



# DrawIO diagrams

DRAWIO_COUNT=$(ls figures/*.drawio 2>/dev/null | wc -l)

DRAWIO_PDF=0

for df in figures/*.drawio; do

    [ -f "$df" ] || continue

    bn=$(basename "$df" .drawio)

    [ -f "figures/${bn}.pdf" ] && DRAWIO_PDF=$((DRAWIO_PDF+1))

done

if [ "$DRAWIO_COUNT" -gt 0 ] && [ "$DRAWIO_PDF" -eq "$DRAWIO_COUNT" ]; then

    echo "✅ DrawIO: $DRAWIO_COUNT .drawio files, all exported to PDF"

elif [ "$DRAWIO_COUNT" -gt 0 ]; then

    echo "❌ DrawIO: $DRAWIO_COUNT .drawio but only $DRAWIO_PDF PDFs"; GATE_FAIL=$((GATE_FAIL+1))

else

    echo "❌ No DrawIO diagrams generated"; GATE_FAIL=$((GATE_FAIL+1))

fi



# TikZ (if planned)

 grep -qi  PROBLEM_ANALYSIS.md 2>/dev/null; 

      figures/tikz_*.tex 2>/dev/null > /dev/null || [ -f figures/tikz_diagrams.tex ]; 

         

        

         texfile  figures/tikz_*.tex figures/tikz_diagrams.tex; 

            [ -f  ] || 

            bash _utils/tikz_check.sh  2>/dev/null

            TC_EXIT=$?

             [  -gt 0 ]; 

                 

                GATE_FAIL=$((GATE_FAIL+))

            

        

        

        TIKZ_PDF=0

         tf  figures/tikz_*.tex figures/tikz_diagrams.tex; 

            [ -f  ] || 

            bn=$(  .tex)

            [ -f  ] && TIKZ_PDF=$((TIKZ_PDF+))

        

        [  -gt 0 ] &&   || {  ; GATE_FAIL=$((GATE_FAIL+)); }

    

         ; GATE_FAIL=$((GATE_FAIL+))

    







 [ -s figures/latex_includes.tex ]; 

     

    

    DRAWIO_IN_INCLUDES=$(grep -c  figures/latex_includes.tex 2>/dev/null ||  0)

     [  -gt 0 ]; 

         

    

         

        GATE_FAIL=$((GATE_FAIL+))

    



     ; GATE_FAIL=$((GATE_FAIL+))







 pdf  figures/fig_roadmap.pdf figures/fig_flow_*.pdf figures/fig_pipeline*.pdf figures/fig_framework*.pdf; 

    [ -f  ] || 

    sz=$( -c < )

    [  -lt 5000 ] && {  ; GATE_FAIL=$((GATE_FAIL+)); }





 

[  -eq 0 ] &&   ||  

⛔ If GATE_FAIL > 0:

1. 逐个修复每个 ❌ 项（重新生成 .drawio → 导出 → 自检，或重新编译 TikZ，或追加 latex_includes）

2. 重新运行本质量门脚本

3. 重复直到 GATE_FAIL = 0

4. 不允许带着任何 ❌ 结束本步骤。 如果某张图反复失败，启用跨工具兜底（DrawIO↔TikZ）

⛔ 质量门全部通过后，输出最终 CHECKLIST 确认：

DRAWIO PLAN CHECKLIST (FINAL):

[✅] 1. fig_roadmap — figures/fig_roadmap.pdf (XX KB) — drawio_check PASS

[✅] 2. fig_flow_q1 — figures/fig_flow_q1.pdf (XX KB) — drawio_check PASS

[✅] 3. fig_flow_q2 — figures/fig_flow_q2.pdf (XX KB) — drawio_check PASS

[✅] 4. fig_pipeline — figures/fig_pipeline.pdf (XX KB)

[✅] latex_includes.tex — contains 4 DrawIO entries

ALL COMPLETE — paper-figure-drawio step finished successfully

Key Rules

• DrawIO .drawio files export to PDF via draw.io.exe --export --format pdf --crop

• All fonts bold (fontstyle=1), line width 3pt

• All edges: jumpStyle=arc;jumpSize=6;rounded=1

• ⛔ Edges must NOT cross nodes or obscure text

• Component spacing 30-50px, grid alignment (gridSize=10)

• Default color scheme: academic blue #dae8fc/#6c8ebf

• Each mxCell id must be globally unique

• Chinese text in UTF-8, XML special chars must be escaped

• ⛔ No shadow=1, no XML comments, no shape=callout

• ⛔ All nodes must have html=1 (including edge labels)

• ⛔ No in-figure title — titles managed by LaTeX \caption{}

• ⛔ 3 rounds DrawIO fail → fallback to TikZ; 3 rounds TikZ fail → fallback to DrawIO