Graph 用继承分层（graph.py:191-397），初学者记住递进关系：

• GraphBaseMeta（:191）：核心元数据——version、is_active、name、description、instructions、forked_from_id。
• BaseGraph（:206）：加 nodes + links，并提供一批计算字段（L02）。
• Graph（:348）：加 sub_graphs（拍平的子图列表）。
• GraphModel（:385）：最完整，带 user_id/created_at 和执行期全部计算字段。

简化版 → 真实版代码对照（帮你看懂继承是怎么"逐层加厚"的）：

class 薄图:      # 只有名字、版本
    name; version
class 中图(薄图): # 加上工位和传送带
    nodes; links
class 厚图(中图): # 加上用户、时间、执行期字段
    user_id; created_at

class GraphBaseMeta(...)   # :191 name/version/is_active
class BaseGraph(GraphBaseMeta):  # :206 + nodes/links + 计算字段
    nodes: list[Node]     # Node :104
    links: list[Link]     # Link :82
class Graph(BaseGraph):   # :348 + sub_graphs
class GraphModel(Graph, GraphMeta):  # :385 + user_id/created_at

# graph.py:218 input_schema —— 扫描所有 BlockType.INPUT 节点
# graph.py:230 output_schema —— 扫描所有 BlockType.OUTPUT 节点
# 合成整个 Agent 对外的输入/输出 JSON schema

还有一批计算字段"扫一遍节点判断图有没有某种能力"（graph.py:244-302）：has_external_trigger（有 webhook 触发块吗）、has_human_in_the_loop（有需人工介入的块吗）、has_sensitive_action（有敏感操作吗）、trigger_setup_info 等。

# graph.py:401
@property
def starting_nodes(self):
    outbound_nodes = {link.sink_id for link in self.links}   # 被连入的节点
    input_nodes = {n.id for n in self.nodes if n.block.block_type == BlockType.INPUT}
    return [n for n in self.nodes if n.id not in outbound_nodes or n.id in input_nodes]

validate_graph（graph.py:686）对主图和每个子图都跑，两大类：

• 结构校验（:995）：每条 Link 两端节点/Block 存在、连接的输入输出口名字在 Block schema 里。还会把"源是 static_output 的连线"标记为 is_static=True（:1041）。
• 节点校验（:735）：必填字段已填或已连线（provided_inputs = input_default 的 key + 入边的 sink_name）、字段依赖、凭证 discriminator、auto-credentials 不能硬编码。

每个 (id, version) 是一行。__create_graph（graph.py:1623）保存时若版本已存在自动 +1（:1662）；is_active 标记当前活跃版本；set_graph_active_version（:1436）激活某版本、把其它设非活跃。

• fork（fork_graph）：复制整图，reassign_ids（:621）给所有 node/link/graph 重新生成 UUID、清凭证引用、记 forked_from_id。像 git fork——基于别人的 Agent 改自己的。
• 子图拍平（get_sub_graphs，:1375）：从主图出发，广度优先逐层查出所有被 AgentExecutorBlock 引用的子图，拍平成 sub_graphs 列表。

✋ 动手

P=autogpt_platform/backend/backend/data
sed -n '191,302p' $P/graph.py | head -60      # 三层模型 + 计算字段
sed -n '686,740p' $P/graph.py | head -40      # 校验
grep -n 'def fork_graph\|def get_sub_graphs\|set_graph_active_version' $P/graph.py