Mermaid 数据包图生成器

解决协议文档中的结构表达难题

在编写网络协议文档、技术规范或进行教学演示时，纯文本描述往往难以直观展现数据包内部的字段位宽、边界以及相对位置。直接阅读 RFC 文档中的位偏移表格不仅理解成本高，使用传统绘图工具手动绘制结构图也极易在字段错位、位宽计算上出现偏差，且后期协议字段调整时修改繁琐。

核心能力与生成步骤

该技能通过解析用户提供的自然语言或结构化描述，自动生成 Mermaid 数据包图代码，将抽象的位结构转化为可视化的图形。其核心工作流程包含四个关键步骤：

• 理解需求：解析协议字段名称、位宽或精确位置，确认是否需要标题。
• 生成代码：根据字段复杂度选择合适的语法。支持精确指定位偏移的 范围语法，以及利用 + 从前一字段自动计算起始位的 位计数语法（推荐用于高可维护性场景）。
• 组装代码块：将生成的代码包裹在 `mermaid 代码块中，确保渲染引擎正确识别。
• 验证结构：检查位范围是否重叠、连续，并确保字段标签清晰。

此外，支持通过 Mermaid 配置文件自定义图形外观，如调整 rowHeight、bitWidth 或 bitsPerRow 等参数。

适用场景与注意点

此技能适用于 TCP、UDP、IP 等标准协议头展示，也可用于自定义协议规范定义及网络数据包调试分析。在实际使用时需注意：

• 遵循 RFC 惯例，默认使用 32 位行宽展示。
• 优先使用 位计数语法 以降低后续字段修改的维护成本。
• 对于 1 位的标志位（如 TCP 的 URG/ACK/PSH），建议每个标志位独占一行。
• 确保所有位范围连续且无意外间隙，避免渲染异常。