sage-design · diagram gallerysage-design · 图示案例库

Quiet diagrams. One green. 安静的图，一处绿。

Eight hand-built SVG figures in the sage-design language. Cream tints carry the grouping, hairlines carry the structure, indigo is the ink — and a single sage green carries the story. Every caption names the green's owner. Copy any of them. 八张手工 SVG 图。米色 tint 承担分组，hairline 承担结构，靛蓝当墨——唯一的鼠尾草绿承担叙事。每条图注都点名绿色给了谁。每张都可直接复制。

01 · Structure & flow01 · 结构与流程

Structure & flow 结构与流程

Architecture, flows, pipelines. Grouping comes from cream tints, never saturated fills; the green path is the one you are meant to follow. 架构、流程、流水线。分组靠米色 tint 而不是饱和填充；绿色路径就是你该跟随的那条。

01 · PRESENTATION user-facing surfaces Web browser client Mobile iOS · Android CLI terminal tools API REST · SDK 1 02 · APPLICATION coordination & policy Router match & dispatch Orchestrator plan · collect · merge Gateway tool calls · rate limits Guard allow · deny · confirm 2 03 · DOMAIN business logic Billing invoices · ledger Catalog products · pricing Identity accounts · roles Reporting rollups · exports 3 04 · INFRASTRUCTURE runtime substrate Database Postgres cluster Storage objects · backups Network LB · CDN · DNS Queue async jobs
Architecture · layers架构 · 分层 Four tinted zones, hairline cards; the green is spent on the request path and the Orchestrator's focus border. Template: templates/diagrams/architecture.svg. 四层 tint 分区、hairline 卡片；绿色花在请求主路径和 Orchestrator 焦点卡的边上。模板：templates/diagrams/architecture.svg。
FLOW · INGEST PIPELINE pass fail · retry Valid? Fetch input pull raw events Verify schema + checksum Process transform · enrich Publish emit downstream 1 2 3 4
Flow · decision流程 · 决策 The green belongs to the happy path and the decision diamond's edge; the fail loop returns in dashed gray, the badges stay indigo. Template: templates/diagrams/flow.svg. 绿色属于 happy path 和决策菱形的边；失败回流走灰色虚线，编号徽章全是靛蓝。模板：templates/diagrams/flow.svg。
ERROR LANE 1 2 3 4 mydev_probe(pdev) devm_kzalloc(ctx) sizeof(*ctx) · GFP_KERNEL ioremap registers MMIO window · res->start request_irq(irq, handler) IRQF_SHARED · dev_id = ctx register chardev misc_register(&ctx->mdev) ctx == NULL? base == NULL? ret < 0? yes yes yes no no no ret = -ENOMEM ctx alloc failed ret = -ENOMEM mmio map failed iounmap(base) unwind mmio mapping return 0 return ret platform_driver · drivers/misc/mydev.c happy path error path · dashed success exit
Function flowchart · error lane函数流程图 · 错误车道 A driver probe() walks down in green to return 0; errors step into the tinted lane on dashed gray, and the green's last touch is the success-exit dot. Template: templates/diagrams/function-flowchart.svg. 驱动 probe() 沿绿色一路走到 return 0；错误让进 tint 车道走灰色虚线，绿色的最后一笔给成功出口的圆点。模板：templates/diagrams/function-flowchart.svg。
LINUX KERNEL · BUILD PIPELINE make ARCH=arm64 Image.gz dtbs make dtbs · runs in parallel .config + Kconfig gcc -c *.o ld vmlinux objcopy Image.gz *.dts dtc *.dtb mkimage FIT boot.itb build configuration compile per-TU object files ELF + symbols strip to binary gzip-compressed board source devicetree compiler flattened blob kernel + dtb pack bootable image 1 2 3 4 tool step artifact main path devicetree branch
Build · pipeline编译 · 流程链 Kernel build from .config to boot.itb; the devicetree branch merges in quiet gray, and the green goes to the main chain plus the boot.itb deliverable card. Template: templates/diagrams/build-pipeline.svg. 内核编译从 .config 到 boot.itb；设备树分支以灰色安静汇入，绿色给主链和 boot.itb 交付物焦点卡。模板：templates/diagrams/build-pipeline.svg。
02 · Hardware02 · 硬件

Hardware 硬件

Registers, SoC blocks, waveforms. Cell lattices are hairline grids — the same hairline as the card edges — and the green goes to the one field or signal the figure is about. 寄存器、SoC 框图、波形。单元格阵列是 hairline 格栅——和卡片边同一语法——绿色只给图要讲的那一个字段或信号。

UART_CTRL offset 0x04 · reset 0x0000_0301 reserved bits read as 0 · write as 0 31302928 27262524 23222120 19181716 — BAUD_DIV 15141312 111098 7654 3210 — PARITY STOP DATA8 FIFO_TH — TX_EN RX_EN BAUD_DIV RW bits 23:16 · baud = PCLK / (16 · div) PARITY RW bits 11:10 · 00 none · 01 even · 10 odd DATA8 RW bit 8 · 1 = 8 data bits · 0 = 7 data bits RX_EN RW bit 0 · receiver enable · 1 at reset · focus field
Register · bit fields寄存器 · 位域 Fields tell apart by tint, access chips stay indigo, and the green marks one field only — RX_EN, with tint, edge and the 4px top bar. Template: templates/diagrams/register-bitfield.svg. 字段靠 tint 区分，访问权限 chip 用靛蓝，绿色只标一个字段——RX_EN，tint 加绿边加 4px 顶色条。模板：templates/diagrams/register-bitfield.svg。
QUARTZ-3550 SoC · BLOCK DIAGRAM arm64 · 12 nm LP · 0.8 V core rail 01 · CPU SUBSYSTEM DynamIQ cluster · 1.8 GHz 02 · CLOCK & RESET 24 MHz xtal 03 · MEMORY AXI slaves 04 · HIGH-SPEED PERIPH DMA masters 05 · LOW-SPEED PERIPH via APB clk · rst Cortex-A55 ×2 L2 512K GIC-600 PLL ×3 CRU AXI NoC · 64-bit @ 800 MHz APB bridge DDR4 ctrl + PHY SRAM 256K Boot ROM PCIe Gen3 x2 USB 3.0 GbE MAC UART ×4 I2C ×3 SPI ×2 GPIO L1 32K I/D per core unified · ECC interrupt distributor core · ddr · peri gate · reset system interconnect · QoS arbitration · 4 masters AXI-to-APB · 100 MHz DDR4-3200 · 32-bit + ECC on-chip scratch 64K mask root complex · MSI-X xHCI DRD RGMII · TSO 16550A 400 kHz FM mode 0-3 4 banks ×32 1 2 main data path · CPU → NoC → DDR4 clk / rst secondary bus
SoC · block diagramSoC · 框图 Five tinted zones, seventeen hairline IP cards; the green belongs to the Cortex-A55 focus card and the CPU → NoC → DDR4 main data path. Clock and reset fan out in dashed gray. Template: templates/diagrams/soc-block.svg. 五个 tint 分区、十七张 hairline IP 卡；绿色属于 Cortex-A55 焦点卡和 CPU→NoC→DDR4 主数据路径。时钟复位用灰色虚线散出。模板：templates/diagrams/soc-block.svg。
SPI mode 0 · CPOL=0 CPHA=0 MX25L6433F · JEDEC ID read command phase · MOSI drives data phase · MISO drives SCLK 25 MHz · bit period 40 ns SCLK CS_N MOSI MISO 0x9F 0x00 0xC2 0x20 tCSS tSU ≥ 5 ns t0 t1 t2 t3 t4 t5 t6 t7 t8 MOSI data-valid MISO data-valid high-Z (not driven) sampling edge · SCLK rising CS_N · focus signal
Waveform · SPI timing波形 · SPI 时序 Signal lanes tell apart by ink shades; the green is the CS_N focus signal and the tint behind its active window. Timing notes like tCSS and tSU stay gray. Template: templates/diagrams/hw-timing-waveform.svg. 信号道靠墨阶区分；绿色是 CS_N 焦点信号和它 active 窗口的 tint。tCSS、tSU 这类时序参数标注留灰。模板：templates/diagrams/hw-timing-waveform.svg。
03 · Runtime03 · 运行时

Runtime 运行时

Scheduler traces. Ink marks the events, neutral tints mark the other tasks; the green follows the one task being tracked. 调度追踪。靛蓝标事件，中性 tint 标其他任务；绿色只跟着被追踪的那一个任务。

SCHED · CFS RUN VIEW · 12 MS WINDOW trace-cmd record -e sched_switch -e sched_migrate_task CPU 0 CPU 1 CPU 2 IRQ eth0 rx app: render irq/eth0 idle preempted by irq/eth0 idle kworker/u8 idle kworker/u8 idle kworker/u8 idle migrate (load balance) idle app: render idle 0 2 4 6 8 10 12 ms app: render · tracked CFS task kworker / irq · other tasks idle threaded IRQ marker IRQ
Scheduler · timeline调度 · 时间线 Three CPU lanes; other tasks sit in neutral tint, the IRQ marker is indigo, and the green follows app: render — its run blocks and the migration arrow to CPU 2. Template: templates/diagrams/sched-timeline.svg. 三条 CPU 车道；其他任务用中性 tint，IRQ 标记用靛蓝，绿色只跟着 app: render——它的运行块和迁移到 CPU 2 的箭头。模板：templates/diagrams/sched-timeline.svg。