用途:为 Next.js 文档绘制与已发布配图风格一致的示意图,输出浅色与深色 2x PNG,供 mdx 中 <Image>(srcLight、srcDark)引用。
主要能力与用法:
- 先读 mdx,从 <Image> 获取文件名、尺寸与 alt 文案,并按正文色例说明确定配色,只画简报提到的内容。
- 从文档拉取 2–3 张同类参考图(浅色与深色),例如使用 grep -rhoE 'srcLight="[^"]+"' docs | sort -u 列出已有图,再用 curl 下载参考。
- 在仓库外的临时目录复制 scripts/,新增 diagrams/<name>.mjs,导出 name、width、height 与 draw(t, lib, {width, height}),用 lib 原语组合;窗口页面用 pageLayout,条形用 grid。缺少的形状应加入 lib.mjs 并保持同一风格,不得硬编码颜色。
- 在临时目录执行 ./render.sh 生成 light/<name>.png 与 dark/<name>.png;过程中可用 node gen.mjs <name> 单独重绘。非 macOS 或 Chrome 路径不同时设置 CHROME=/path/to/chrome ./render.sh。
- 按 review-checklist.md 与参考图核对两张 PNG,运行 python3 scripts/measure.py light/<name>.png 检查边距(上下相等、左右相等,允许 4px 误差)。
- 交付 PNG 及像素尺寸与对应 mdx 路径;上传 blob 存储由维护者手动完成。若改了 lib.mjs,需回提交或交 diff。
适用场景:文件树与 URL、文件到组件层级、浏览器窗口骨架 UI、区域徽章图、zone 图等文档配图。产品截图(DevTools、打包分析器等)不适用。画布默认宽 1600 CSS px,颜色在同一图内语义唯一。字体为 Geist Mono 与 Inter,Geist Mono 需本地安装。分类与更多限制细节暂未提供。