全部指南
指南

制作时序图:消息、回复与累计时间

将已审核请求与响应步骤制作成可编辑时序图。核对累计时间、修改消息,再导出 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、1020、100、140、150
A shorter conversation(较短对话)25、50、1525、75、90
The order of events(事件顺序)25、50、75、1525、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 文档,关系使用系统图,带时间戳的观察及未解决证据使用事故复盘。各文档的声明应限定在实际输入范围内。

全部指南