2026-07-01 · GitHub
cclank/lanshu-animated-architecture-diagram
An AI-assisted editorial analysis of this GitHub repository, based on the source information and signals available on 2026-07-01.
Analysis
将 JSON 规格渲染为黑底手绘动画架构图的 Codex 技能与本地管线
lanshu-animated-architecture-diagram 是一个 Codex 技能兼本地渲染器,它把一份 JSON 规格变成黑底、手绘风格的动态架构图,同时输出可编辑的 Excalidraw 源文件、静态 PNG 和真正带有流动高光与脉冲效果的 GIF。它的用户是那些需要为技术文章、系统说明或工作流配图,但又不想在多个设计工具之间来回折腾的开发者。
现在开发者要制作一张带动画的架构图,常见路径是先在 Excalidraw 里手绘,再录屏或逐帧导出,最后用 ScreenToGif 或 ffmpeg 合成动画。也有人用 Mermaid 或 PlantUML 生成静态结构,然后拖进 Figma 加高光动效,或者干脆用 Python Pillow 一帧一帧写脚本。这些流程的卡点很具体:Excalidraw 本身没有动画导出能力,录屏方案依赖浏览器环境和稳定的窗口尺寸,手绘风格的一致性全靠个人手感,而 Pillow 直接绘图虽然灵活,但产出不了可二次编辑的矢量源文件,改一处就得重新跑脚本。
这个项目切入的是设计表达层里“技术图表的程序化动画生成”这一环。它不替代 Excalidraw 的画布,而是在 Excalidraw 的 JSON 格式之上,叠加了一套动画描述规范,再用纯 Python 渲染出 GIF。旧方案中,Excalidraw 插件或手动操作卡在动画制作太碎,Mermaid 等文本绘图工具卡在只能出静态图且风格固定,浏览器自动化方案则卡在环境依赖和稳定性。lanshu 用一个 JSON spec 同时驱动三种输出,渲染完全本地化,不需要安装 Excalidr...