上周把一个 18 页的中后台审批流画进原型画布时,我顺手把“风控复核”节点往右拖了 80 像素,又从列表页新增了一条驳回支线。结果刷新画布的一瞬间,三根连线直接斜穿过了中间两张页面卡片,另外两条横向和纵向的跳转线在中间叠成了十字路口,一眼根本分不清谁连向谁。
更让人崩溃的是,之前为了看清分支,我花十分钟手动拉直了两条绕行折线。结果这次只是在旁边加了一个新节点,全局排版脚本一跑,整张画布的卡片位置和那两条手调折线被全部推翻重算。
那天晚上我把这套画布连线拆开看,发现自己在流程图连线上踩的坑几乎都绕不开三件事:
- 只画起止点直线,不避让卡片:连线直接从卡片肚子上穿过去,页面一多整张画布像一团乱麻;
- 多条线交叉时没有任何视觉区分:两条线垂直相交,如果不画跳弧,评审时开发只能拿鼠标一条一条顺着往回摸;
- 一改线就触发整张画布重排:新增一根连线或微调一个位置,就把用户原本排好的所有页面和手动折点全冲掉。
在用 HTML 和 JSON 维护产品原型画布时,怎么做到“自动避开卡片、交叉处清晰跳弧、同时绝不乱动用户手调的卡片和折线”?
一、根因剖析:为什么原型画布上的连线总是越画越乱?
复盘最近几个版本里画布路由(runtime/routing.mjs)的迭代踩坑,我发现画布连线难用往往卡在三个底层设计上:
- 只支持固定四边中点,逼着连线强行绕大圈:
如果每张卡片只能从上、下、左、右正中心出发,当同一个列表页要连出 3 条分支时,3 根线全部挤在同一个中心点重叠,或者被迫绕到卡片背面才能贴边。 - 所有连线互相抢通道,没有“独立避障 + 交叉跳弧”的边界:
有些连线算法会把其他线条也当成障碍物,改一条线连带交换另外十条线的端口,导致整张图每动一下就全屏闪烁跳变;反过来如果完全不管交叉,几十条线叠在一起又彻底丧失可读性。 - 不保留手调状态,重算路由直接覆盖全局布局:
产品经理在评审前经常手动对齐页面卡片、拉出关键折点。只要工作台在新增连线或移动单个节点时顺手调用全局重排,前面的手工整理就会白费。
二、新旧模式对比:全局重排与死板直连 vs 元形 v0.5.1 画布路由方案
在开源原型工作台 元形 (yuanxing) v0.5.1 中,我把画布连线拆成了“独立避障路由 + 手动结果保留 + 交叉跳弧”三层职责:
| 对比维度 | 传统连线方式(固定中点 + 全局重排) | 元形 (yuanxing) v0.5.1 画布路由方案 |
|---|---|---|
| 连线避障策略 | 直接穿过卡片,或互相挤压导致全图端口交换 | 每条线独立避开节点卡片,不以其他线为障碍,不乱改他线 |
| 交叉可读性 | 多线垂直相交糊成一片,分不清流向 | 交叉点自动绘制 r=6 半圆跳弧,邻近交叉合并为胶囊桥 |
| 端口锚定自由度 | 只能连在四边正中,多分支重叠严重 | 四向圆点磁吸 + 边框轮廓任意点连续吸附(fromAnchor / toAnchor) |
| 手动调整保留 | 动一下节点,之前手调的折点与文字位置全丢 | 保留中间折点形态与 labelT,单侧移动只衔接端点邻段 |
| 整张画布稳定性 | 每次连线触发全局布局重算,位置全乱 | 不触发全局重排,仅重算端点改变或受影响的连线 |
三、实操落地:3 步搭建可避障、带跳弧的原型流程画布
在元形 v0.5.1 的项目中,画布布局和连线全部保存在 artifact/workbench.json 里,不绑定任何在线设计平台。按下面 3 步就能把一套复杂分支画布整理得清清楚楚。
第一步:在编排里声明边框相对锚点、线型与路径文字位置
打开 artifact/workbench.json,现在不需要把所有线死死绑在卡片中心,可以直接用 fromAnchor / toAnchor(边框相对坐标 [nx, ny])把多条分支错开挂在同一条边上,并按业务语义区分线型和文字位置 labelT:
{
"nodes": [
{ "id": "list", "title": "订单列表", "kind": "html", "path": "pages/list.html", "x": 60, "y": 120, "width": 1280, "height": 800 },
{ "id": "audit", "title": "风控复核", "kind": "html", "path": "pages/audit.html", "x": 580, "y": 40, "width": 1280, "height": 800 },
{ "id": "reject", "title": "驳回补件", "kind": "html", "path": "pages/reject.html", "x": 580, "y": 400, "width": 1280, "height": 800 }
],
"edges": [
{
"id": "to-audit",
"from": "list",
"to": "audit",
"fromSide": "right",
"toSide": "left",
"fromAnchor": [1, 0.25],
"toAnchor": [0, 0.5],
"lineType": "polyline",
"label": "提交复核",
"labelT": 0.4
},
{
"id": "to-reject",
"from": "list",
"to": "reject",
"fromSide": "right",
"toSide": "left",
"fromAnchor": [1, 0.75],
"toAnchor": [0, 0.5],
"lineStyle": "dashed",
"arrow": "end",
"condition": "初审驳回"
}
]
}
除了默认的圆角折线(polyline),数据结构还支持直线(straight)、三次贝塞尔曲线(curve)、虚线(dashed)以及单向/双向/无箭头(end | both | none)。在工作台里拖线时,靠近卡片四向连接点会自动磁吸,拖到边框其他位置则支持连续吸附,按住 Shift 还能锁定 45° 或 90° 方向。
第二步:利用独立避障与交叉跳弧,只重算受影响的端点邻段
启动本地可编辑工作台后,元形的路径计算层(runtime/routing.mjs)会配合内置 libavoid 路由做三件克制的事:
# 开源仓库: github.com/JasperLin2333/yuanxing | 一键安装: npx skills add JasperLin2333/yuanxing --skill yuanxing
# 开源原型工作台: github.com/JasperLin2333/yuanxing | 在线体验: jasperlin2333.github.io/yuanxing
# 一键安装 Skill: npx skills add JasperLin2333/yuanxing --skill yuanxing
# 启动或复用可编辑工作台(仅新启动服务时自动打开浏览器一次)
node "<Skill目录>/scripts/yuanxing.mjs" open --root "projects/order-audit" --reuse
- 单线独立避障,不扰动其余连线:新建或改接某条线时,只计算当前这一条路径,绝不因为改了 A 线而重新分配 B 线的端口;
- 跨线自动生成
r=6半圆跳弧:当横线与纵线或两条折线必须交叉时,交叉点会自动绘制半径6px的平滑半圆跳弧;如果两条平行线挨得很近,邻近交叉还会自动合并成一段胶囊桥,视觉上立刻能看出谁压在谁上面; - 保留手调
waypoints,单端移动只衔接邻段:选中连线后,拖动线段上的细长手柄就能手动微调折线(靠近同线其他拐点自动对齐,按Alt取消吸附),拖动线上文字则沿当前路径保存labelT(靠近中点自动居中吸附)。之后再拖动其中一张卡片,工作台会尽量保持你手调的中间折点形态不变,只衔接贴近被移动卡片的首尾邻段。
第三步:在画布与离线分享之间保持同一套路由与坐标
所有画布手调位置、边框锚点、waypoints、labelT 和线上文字原地编辑(双击文字或选中连线按 Enter / F2 / 直接键入)都会自动保存,不会弹出全画布自动重排把页面打散。评审定稿后,导出单文件离线 HTML 即可完整带走相同的坐标与跳弧表现:
# 确认改动后导出单文件离线评审画布(内含流程画布、完整原型、交互式需求文档三视图)
node "<Skill目录>/scripts/yuanxing.mjs" export \
--root "projects/order-audit" \
--view review \
--out "projects/order-audit/dist/review.html" \
--replace
如果同时在用 Coding Agent 调整 artifact/workbench.json,记得先保存修改前的原始 JSON 作为基线,通过 apply --base ... --model ... 做三方合并,避免把工作台里刚手调好的页面坐标和连线折点覆盖掉。
四、时间账与协作收益对比
把画布连线从“凑合画条线”收敛成“独立避障 + 跳弧 + 锚点保留”之后,我整理复杂多分支原型的时间账变化很直观:
| 协同环节 | 过去做法(固定中心端口 + 全局重排) | 现在做法(元形 v0.5.1 避障路由与跳弧) | 效率变化 |
|---|---|---|---|
| 多分支出线整理 | 3 条线挤在卡片右侧中心点重叠,看不出各自起点 | fromAnchor 沿边框错开锚定,分支归属一目了然 | 告别起点粘连 |
| 交叉连线核对 | 十字交叉线分不清先后流向,评审现场来回指认 | r=6 半圆跳弧 + 邻近胶囊桥自动隔离交叉路径 | 评审读图零歧义 |
| 局部加页改线 | 加一个新节点就重排全图,手调布局全部报废 | 仅重算受影响邻段,原页面位置与中间折点全保留 | 省去重复摆图返工 |
| 线上文字调整 | 删改线名要切右侧栏,拖标签容易飞到空白画布 | 原地回车即改,文字严格沿当前路径滑动并居中吸附 | 编辑与排版一步到位 |
总结
流程图画布最消耗精力的,往往不是最初画上去那几分钟,而是需求每改一轮,你就要把被自动排版打乱的卡片和互相打架的连线重新理一遍。
让每一条连线独立避开页面卡片、在交叉点用 r=6 跳弧交代层级、把边框锚点和手调折点稳稳留下来——工具只负责算清受影响的局部,把整体版面控制权还给画图的人,流程画布才真正经得起反复迭代。
开源原型工作台 元形 (yuanxing) 已更新至 v0.5.1,如果你也在用 Coding Agent 画中后台流程图与可交互原型,可以直接在项目目录装入试试:
# 一键安装元形 Skill 到当前 AI 助手工作区
npx skills add JasperLin2333/yuanxing --skill yuanxing
大家在画多分支产品流程图时,最头疼的是连线穿卡片、交叉看不清,还是每次改需求都被自动重排打乱布局?欢迎在评论区或 GitHub Issue 聊聊。