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 可手动触发一次保存。