1. 快速入门

打开编辑器后,画布上默认有两个参与者:Actor(火柴人)和 System(矩形)。

创建消息

把鼠标移到参与者的生命线上,生命线会高亮成蓝色粗线、光标变成十字。此时直接在生命线上按住并拖拽到另一个参与者的生命线,松手即创建一条消息。

编辑标签

双击消息线或选中后按 Enter,可直接在画布上编辑标签内容。

修改属性

点击任意元素,右侧会弹出属性面板,可调整颜色、线型、字体等。

2. 参与者

SeqDraw 支持 5 种参与者类型:

  • System — 显示器图标,表示后端系统
  • Actor — 火柴人,表示用户
  • Service — 齿轮图标,表示微服务
  • Database — 圆柱图标,表示数据库
  • Queue — 信封图标,表示消息队列

点击参与者头部可拖动调整水平位置。右键参与者头部可复制或删除。

3. 消息类型

支持四种消息类型:

  • 同步 (Synchronous) — 实线 + 实心箭头,表示同步调用
  • 异步 (Asynchronous) — 实线 + 开放箭头,表示异步消息
  • 返回 (Return) — 虚线 + 开放箭头,表示返回值
  • 自循环 (Self) — 参与者发给自己的折线消息

右键消息线可快速切换类型。

自循环消息

在生命线上按住后主要向下拖拽(纵向幅度大于横向)就会切换成自循环预览,松手即创建 —— 不需要先选类型。

4. 分组片段

分组片段(Fragment)用于表示条件分支、循环等结构化逻辑:

  • alt — 条件分支(if/else)
  • opt — 可选片段
  • loop — 循环片段
  • par — 并行执行

点击工具栏的 alt/opt/loop/par 按钮进入框选模式,在画布上拖拽矩形区域即可创建片段。alt/par 类型支持右键添加分割线(分支)。

5. 键盘快捷键

快捷键操作
Delete删除选中元素
Ctrl+Z撤销
Ctrl+Shift+Z / Ctrl+Y重做
Enter编辑选中消息的标签
Ctrl+D复制选中参与者
Ctrl+S手动保存到本地
Escape取消选中

6. 导出与保存

工具栏右侧提供三种导出方式:

  • PNG — 位图,适合贴进文档、wiki、PR 描述
  • SVG — 矢量图,可无损放大,适合印刷或二次编辑
  • Mermaid — 文本格式(.md 文件),可提交进 git,也能导回来继续编辑

工具栏上还有一个「导入 Mermaid」按钮:把 Mermaid 文本读回画布(会替换当前图)。 它与导出配对使用,是当前唯一能把图存成文件、之后再恢复编辑的方式。

⚠️ Mermaid 是有损格式:参与者图标、配色与尺寸、消息颜色与字体、标签位置、 分组的自由尺寸不会保留。但结构是完整的(参与者、消息、激活条、分组都在)。

导出的图片会带 SeqDraw.com 署名水印:中间、左下、右上三处斜向浅色标注,不遮挡图形。

⚠️ 数据只保存在你自己的浏览器里(localStorage),刷新页面不丢失, 但清除浏览器数据、换浏览器或使用无痕模式都会永久丢失, 当前版本不提供无损的文件导出备份 —— 重要内容请用 Mermaid 文本导出一份可再编辑的副本, 同时用 PNG / SVG 留存一张成品图。

点击工具栏的保存按钮或按 Ctrl+S 可手动触发一次保存。