fin-arch-diagram

fin-arch-diagram

生成高质量架构/流程/层次图，专为 PPT 汇报和技术文档插图设计。 不依赖数据（与 fin-viz-launch / fin-paper-figure 的"数据图表"互补）， 不阻塞论文流水线（用户主动触发）。

触发条件

• 关键词: 架构图 架构 流程图 流程 层次图 层次 swim_lane process_flow hierarchy 画架构 生成架构图 绘制流程图 绘制架构图 画一个流程图 组织架构图 架构示意图 系统架构图
• Skill 语法: Skill: fin-arch-diagram "[描述]"
• 前置条件: 无需数据 / 无需 DataFrame

三种图类型

推荐用法（PPT 制作最常用）

from scripts.research_framework.arch_diagram_gv import draw_diagram
from scripts.research_framework.arch_diagram import (
    DiagramSpec, Node, Edge, Layer,
)

# 例：生成 FinResearch Agent 系统架构图
spec = DiagramSpec(
    title="FinResearch Agent · 系统架构",
    layers=[
        Layer("USER LAYER", y_top=70, y_bottom=55, color="#FDEBD0", text_color="#D68910"),
        Layer("SKILLS LAYER", y_top=53, y_bottom=38, color="#D6EAF8", text_color="#21618C"),
        Layer("PERSISTENCE", y_top=36, y_bottom=21, color="#EBDEF0", text_color="#6C3483"),
        Layer("INFRASTRUCTURE", y_top=19, y_bottom=4, color="#D5F5E3", text_color="#1E8449"),
    ],
    nodes=[
        Node("u1", "Researchers", layer="USER LAYER", color="#E67E22", icon="U"),
        Node("u2", "HitL Reviewer", layer="USER LAYER", color="#E67E22", icon="U"),
        Node("a1", "Orchestrator", layer="SKILLS LAYER", column="Sub-agents",
             color="#1ABC9C", icon="1"),
        Node("p1", "fin-full-pipeline", layer="SKILLS LAYER", column="Pipelines",
             color="#3498DB", icon="1"),
        # ... 更多节点
    ],
    edges=[
        Edge("u1", "p1"),
        Edge("p1", "a1", label="dispatch", style="invoke"),
        Edge("a1", "u2", label="HITL", style="invoke"),
        # ... 更多边
    ],
)

# 默认 graphviz 后端（接近 draw.io 风格）
out = draw_diagram(spec, "output/figures/finresearch_arch.png")
print(f"生成: {out}")

# 显式指定后端
out = draw_diagram(spec, "out.png", engine="graphviz")    # 高质量 (推荐)
out = draw_diagram(spec, "out.png", engine="matplotlib")  # 零系统依赖