制作时序图:消息、回复与累计时间
将已审核请求与响应步骤制作成可编辑时序图。核对累计时间、修改消息,再导出 SVG、PNG 和 CSV,无需付费 API。
快速开始
让 AI 助手帮你完成
将这段提示粘贴到你正在使用的 AI 助手中:
使用 Sequence Story 说明已审核请求与响应流程。询问参与者、有序消息、耗时语义和来源。从虚构示例开始,独立核对 150 ms,再将 80 改为 120,并在 SVG、CSV 和 analysis 中核对 190 ms。明确标注重叠跨度和未知时间。保存项目 JSON 及可编辑交付。不采集真实追踪、不调用付费 API,也不声称生产性能。
这个时序图技能能制作什么?
Sequence Story v1.1.0 根据已审核步骤制作参与者生命线与有序请求/响应箭头。在现代浏览器中打开完整内容包的 editor.html,即可编辑并导出 SVG、2560 × 1440 PNG、CSV、项目 JSON 或可编辑 HTML。内容包售价 US$4.99。浏览器编辑器无需安装依赖、服务商账号或付费 API。
适合说明小型 API 对话或交接顺序。它是示意时序图,不是分布式追踪采集器、并发模拟器或延迟基准工具。填写的耗时是输入;计算出总值并不代表真实生产测量。
定义参与者及每段耗时的含义
从已审核 API 约定、事故记录或明确标注的虚构示例开始。提供二至五个名称不同的参与者,以及一至八条在不同已知参与者之间传递的消息。每条消息需包含 from、to、简短 label、0 至 100000 的数值 ms,以及 true/false 的 reply 标志。保持来源说明可见。
编辑器按消息顺序累加 ms,箭头标签显示该条消息后的累计时间。使用总值前,确认来源是否代表不重叠的连续步骤耗时。重叠跨度、绝对时间戳及分位数不能当作连续步骤相加。Reply 改变虚线箭头样式,不会自动匹配消息或推断等待时间。
替换数据前核对三套示例
打开 editor.html,依次选择命名起点。阅读 Calculated result,将导出 CSV 同表中的独立求和结果对照。三套示例均为虚构。Report、Stage 和 Print 改变表现方式,不改变算术结果。源内容包包含 examples/default.json、examples/second.json 和 examples/third.json。
| 例子 | 步骤耗时,单位 ms | 累计标签,单位 ms |
|---|---|---|
| A request, end to end(完整请求) | 20、80、40、10 | 20、100、140、150 |
| A shorter conversation(较短对话) | 25、50、15 | 25、75、90 |
| The order of events(事件顺序) | 25、50、75、15 | 25、75、150、165 |
修改一处,并核对实际导出
- 选择 A request, end to end,将第二条消息耗时从 80 改为 120,再点击 Apply changes。累计标签应变为 20、140、180、190 ms,消息数量仍为四条。
- 通过 Add item 或 Remove item 修改记录。复制行后核对两个参与者名称。无效参与者、自发消息或负耗时必须阻止更新;应修正输入,不应删除校验。
- 导出 analysis 和 CSV,核对最终 190 ms 总值。导出 SVG 与 PNG,在目标展示尺寸检查标签。导出会先应用待处理修改。关闭前保存项目 JSON 或可编辑 HTML;编辑器不是云存储。
重建可复现的本地交付
需要重复生成文件时,在完整安装目录使用 Node.js 24.15 及以上运行此命令,选择新的输出目录。它生成 index.html、result.svg、result.csv、project.json、analysis.json、README 与许可证文件,并提供含 SHA-256 哈希的 manifest.json。此命令不渲染视频,也不调用外部 API。
制作修改后的交付时,先从编辑器保存项目 JSON,将下载文件路径传给 --input,并指定另一个新的 --output。确认新 result.svg、result.csv 和 analysis.json 与浏览器一致。将输入、来源说明和清单同成果一起保留。可选视频渲染是需要 FFmpeg 与固定 npm 依赖的独立流程;浏览器预览不等于已导出 MP4。
node scripts/build.mjs --input examples/default.json --output ./sequence-practice按问题选择下一步工作流
用时序图说明谁按什么顺序发送什么;端点与数据结构使用 API 文档,关系使用系统图,带时间戳的观察及未解决证据使用事故复盘。各文档的声明应限定在实际输入范围内。