For AI agents: the complete documentation index is available at https://lazygophers.github.io/pamphlet/llms.txt, the full documentation bundle is available at https://lazygophers.github.io/pamphlet/llms-full.txt, and this page is available as Markdown at https://lazygophers.github.io/pamphlet/write/diagrams/dataflow.md.
  • 简体中文
  • 数据流图

    这是什么

    数据从哪来、经过哪几步加工、存到哪、最后给谁。

    什么时候用

    画一条数据链路、画一次请求的处理过程。

    怎么写

    Pamphlet 自己的写法——先列声明、再列关系,十七种图共用这副骨架:

    :::dataflow[编译一份文档]
    nodes:
      author = "作者"
      parse = round "解析"
      render = round "画图"
      cache = cylinder "图表缓存"
      reader = "读者"
    flows:
      author -> parse : 方案.md
      parse -> render : AST
      cache -> render
      render -> reader : 方案.html
    :::

    这种写法在 GitHub 上不会渲染。要 GitHub 也能看,用数据流图的 Mermaid 围栏写法,画出来是同一张图。

    出来是什么样

    编译时就画成 SVG 内联进产物,读者那边不下载任何绘图库、也不联网。颜色跟着主题走,可以滚轮缩放、按住拖动、双击复位。

    坑

    • 块名固定是 nodes: 和 flows:——和流程图的 edges: 不同,这里叫 flows:
    • 形状和流程图共用那六个:box 是外部的人或系统、round 是处理步骤、cylinder 是存起来的东西
    • 箭头上的字是流过去的数据(方案.md、AST),不是动作
    • 不写 {dir=...} 时默认 LR,和流程图的 TD 不一样