用途:把系统描述转成一张始终运行、像监控面板一样的架构图,也可输出 mp4 或可交互的实时网页。适用于架构、智能体树、组织图、数据流等需要流动感的视频、循环动画或实时页面,不适合需要交互、真实遥测或分步讲解的图示。
主要能力:单一 JSON 配置包含画布尺寸、颜色、文本盒、连线、数据包路径、侧栏触发、日志措辞与数字,模板无需改动。提供 terminal-dark 与 light-pastel 两套主题,以及 4:5(1200x1500)、3:4(1080x1440)、1:1(1080x1080)画布预设。可选择视图:循环对应 ring,逐级递减对应 funnel,关系/聚类对应 nebula,时间线对应 timeline,层级对应 tree;kpi 视图计划中。
使用方式:从最接近的示例开始,如 examples/codex-agents/config.json、examples/airbnb/config.json 或 examples/agent-architecture/config.json。可先写简短 spec,再运行 python3 scripts/scaffold.py --spec spec.json --out out/config.json 生成布局;也可复制示例后小步修改。渲染用 python3 scripts/render.py --config my.json --out my.mp4,需 Chrome/Chromium 与 ffmpeg,仅支持 Linux 与 macOS,Windows 需在 WSL 中运行;--html-out page.html 可保留自包含页面。用 python3 scripts/check_frames.py --config my.json --out-dir frames --repeat 检查文本溢出与重叠并导出 PNG。
限制:不要一次写入整份配置,应小步编辑并反复检查;不要在心算坐标或文本宽度上耗费过多时间。页面通过 window.seek(t) 实现确定性渲染,无墙钟、无 Math.random、无 CSS 动画。无真实来源的数字须标注为模拟或 illustrative。复用或再创作他人图片时,须在视频底部 credit 与发布内容中保留原作者与完整链接。