name: mtnode-canvas-layout-ux title: 画布排版与可操作区 description: MTNode 画布节点排版：可编辑/控制节点靠上（小 y），处理与保存靠下或右侧；createMarks 分区、control 一键重跑；禁止 agent 调用 layout action。Use when auto-layout, createMarks, control nodes, or improving canvas UX for the user. metadata: version: "1.0.1"

画布排版与可操作区

先框定范围（scope）：只读 / 只改一颗壳时别灌整图

节点层 / 开发节点的架构图常有上百个块，整图一次读动辄几万字符。当这一段的工作只在某一颗壳内部（给某个模块排内部布局、补内部连线、调子块位置）时：

• 读：mtnode_canvas_get 传 scope:"<壳的标题或 id>"（scopeDepth:"direct" 默认只看它 + 直接子节点，"all" 看整棵子树），确需整图才 scope:"global"；返回里的 scopeInfo 说明这次看到的是哪一层、有没有祖先块。
• 改：mtnode_canvas_edit 同样传 scope，界外节点 / 绘制 / 连线会被跳过并在 warnings 里逐条说明（不会"顺手"挪走壳外的块），壳内新建节点缺 parentSuperId 时默认落进这颗壳。
• 用户此刻停在某颗壳里时，快照 scopeInfo 会点名这颗壳，照抄它的标题当 scope 用即可。

可操作区靠上

用户需要 编辑或操作 的节点应放在画布 偏上方（较小 y）：

• 输入节点、可改提示词、control ▶ 等

处理、保存、长说明放 下方或右侧。

分区（createMarks）

• 用 createMarks 画 box/text 分区：编辑区、说明、处理区、输出区
• box 可用 around:[节点alias] 在排版后包住节点，并设 label

控制节点

• control：ctrlAction=run（不要创建 clear「清空」控制节点），ctrlFillOnly=true 时仅补跑无输出节点
• 控制流不会沿数据线传导：control 必须直接连线到每一个需要一键重跑的节点（处理 / 保存 / 媒体等）

一键排版

1. 排版是自动的：任何改结构的编辑（建图 / 连线 / 删除 / 标注 / 改尺寸 / 分组）都会自动跑一次，不需要你调用任何「排版」动作
2. 算法保证：列顺序 = 层顺序并按行折起，每层包围盒收进 16:9~9:16（结构上收不进会在回执 warnings 里提示「仍是长条」）；同层里上游在左或在上；节点互不重叠
3. 用户手动「一键排版」按钮走同一套算法；不要替用户手摆 x/y 来「整理画面」
4. 真要微调（例如只挪一两个节点）：传 layout:false 再用 update / updateMarks 改坐标；勿增删节点、勿改连线

@引用

• 连线节点：@标题
• 为节点写 prompt/task 而要用别的节点内容时，一律写 @标题，不要把那个节点的正文复制粘贴进去（粘贴的正文不会随上游重跑更新）
• 素材节点本身不是 @ 候选：写 @内容条目标题（＝端子名）只引那一条，且只有已连线接进本节点的端子可引
• 全局广播：处理节点须 globalRefs:true 且 prompt/task 内写 @源标题（缺一不可）
• @Tag标签 引用该标签下全部节点（tagCatalog）