用途:生成浅色背景、从左到右、带动画的 AWS 架构 SVG。适合表示请求、事件、任务、数据流动的架构/系统/基础设施图;若用户明确需要纯静态可编辑的 .drawio 源文件或官方仓库静态 PNG,则改用 draw.io。
主要能力:使用官方 AWS 服务图标(品牌色底白色字形)、正交连接线(蚂蚁线流动)、沿真实请求路径移动的彩色圆点、编号主干步骤、虚线包含边界(AWS Cloud 区域 ⊃ VPC / 事件驱动框)。输出单个 .svg 文件,无外部资源,可在任意浏览器打开,并能在 GitHub README 图片嵌入中动画播放。
使用方式:编写小型 JSON 规格(nodes + edges + groups + journeys),由捆绑生成器计算 SVG,无需手写 SVG XML。可复制 references/example-chatops-agent.json 并编辑。渲染命令:python3 scripts/gen_arch.py <spec>.json <out>.svg。必须验证:用无头 Chrome 渲染为 PNG 并查看,检查标签无裁切、连接线全正交、边界完全包含成员、边标签不重叠;通过编辑 JSON 修复后重新渲染,通常 2–4 轮。交付 .svg,并告知用户可在任意浏览器打开并动画播放。
规格要点:fs/ts 为图标出口/入口边(l r t b);mids 为正交路径点,每段必须水平或垂直;flow 决定颜色与动画(request 蓝、reply 青、schedule 绿、ambient 紫、garden 琥珀、tool 天蓝、aux 灰),static:true 画安静虚线用于横切依赖;journeys 是动画圆点,reverse:true 使圆点沿正向边反向移动,共 3–5 个。布局采用固定网格、共享 x/y 对齐、外部系统置于区域框外。
图标:icon 为 icons/ 中的文件名键,捆绑 56 个官方 AWS 图标,常见键包括 lambda、apigateway、agentcore、bedrock、dynamodb、s3、cloudwatch、ecr、cloudfront、xray、eventbridge、secretsmanager、sqs、stepfunctions、ec2、ecs、eks、rds、kms、iam、cognito、vpc、route53、elb、nat、sagemaker、opensearch、glue、athena、waf、guardduty、efs、ebs、connect。非 AWS 节点使用内置 tile:lark、tile:gateway、tile:external、tile:generic。AgentCore Runtime 与 Memory 均使用 agentcore 图标,靠标签区分,Memory 不可画成数据库圆柱。
边界:region 为琥珀/青虚线,subnet 为紫色虚线(嵌套于 region 内),event 为粉色点线;边界需在各方向超出成员至少 20px。
限制:GitHub README 嵌入()可动画;在 github.com 打开独立 .svg blob 页面通常为静态,因 GitHub 会清理 SMIL,应嵌入 markdown 而非让用户点击原始文件查看动画;本地或任意浏览器可完整动画。规格 JSON 是构建中间产物,README 只需 .svg。