这是一个用于生成“岚叔风格”手绘动态架构图的 Codex Skill 和本地 Python 渲染工具。它可以从一份 JSON 规格文件生成可编辑的 Excalidraw 文件、静态 PNG 预览图以及真正带动画效果的 GIF，适合技术文章、系统架构、流程说明和黑底手绘风格的技术图解。
适用领域
技术写作 / 系统架构可视化 / 架构图生成 / 动画 GIF 生成 / Excalidraw / 开发者工具 / AI/Codex Skill / 内容创作
配置难度
中等。基础使用只需 Python 环境和命令行即可运行；如果只是修改默认 JSON 模板生成图，难度较低。但若要扩展布局、动画效果、图标系统或深度定制渲染逻辑，需要阅读 Python 脚本和 spec 格式，具备一定开发能力。
商业价值
对技术内容生产和开发者关系团队有较高价值。它可以显著降低制作高质量架构图和动态图解的成本，让技术文章、产品说明、方案文档和社交媒体内容更具表现力。对于技术博主、AI 产品团队、SaaS 公司和开发者工具团队，这类工具可以提升内容传播效果、增强品牌辨识度，并提高技术解释的效率。
01
技术亮点
- 从单个 JSON spec 同时生成 .excalidraw、.png 和 .gif
- GIF 不是简单静态图封装，而是包含移动光点、模块脉冲等真实动画效果
- 生成的 Excalidraw 文件可编辑，便于后续人工微调
- 完全本地渲染，不依赖远程 API、浏览器自动化、ImageMagick 或外部图标库
- 默认输出尺寸和风格统一，适合批量生成高质量技术图
- 内置 --verify 可检测帧差异，证明 GIF 存在真实运动
- 内置 --check 可校验 PNG、GIF、Excalidraw 输出契约
- MIT License，便于个人和商业项目使用
- 对中文技术内容创作者友好，README 中提供了中文提示词示例
02
目标用户
- 技术博主
- 架构师
- 后端工程师
- AI 应用开发者
- DevRel / 技术布道师
- 产品技术文档作者
- 需要制作技术文章配图的开发者
- 使用 Codex Skills 工作流的用户
03
配置要求
- Python 3.9 或更高版本
- Pillow 10.0.0 或更高版本
- 需要通过 requirements.txt 安装 Python 依赖
- 输入规格文件为 JSON，例如 assets/default-spec.json
- 主要可配置字段包括 signature、title.prefix、title.highlight、title.subtitle、inputs、core.cards、decision、output、left_panel、center_panel、right_panel
- 支持的内置图标 key 包括 folder、file、scan、shield、db、hash、package
- 可选安装 ffprobe，用于检查 GIF 媒体参数
- 可选使用 Excalidraw Web 或编辑器插件，对生成的 .excalidraw 文件进行手工调整
04
适用场景
- 将技术文章内容整理成黑底手绘风格的动态架构图
- 为系统设计文档生成可编辑的 Excalidraw 架构图
- 为公众号、博客、技术分享生成高质量 PNG 和 GIF 配图
- 制作流程图、数据流图、模块交互图和系统架构图
- 通过 JSON 模板快速批量生成统一风格的技术图
- 在 Codex 中通过自然语言调用 Skill 自动生成图解素材
05
部署与配置
- 克隆仓库：git clone https://github.com/cclank/lanshu-animated-architecture-diagram.git
- 进入项目目录：cd lanshu-animated-architecture-diagram
- 安装依赖：python3 -m pip install -r requirements.txt
- 运行示例渲染：python3 scripts/render_animated_diagram.py --spec assets/default-spec.json --outdir outputs --basename sample --verify
- 如果作为 Codex Skill 使用，将目录放到 ${CODEX_HOME:-$HOME/.codex}/skills/lanshu-animated-architecture-diagram
- 在 Codex 中通过类似提示词调用：用 $lanshu-animated-architecture-diagram 把这篇文章整理成岚叔动态架构图，输出 GIF、PNG 和 Excalidraw。
06
风险与注意事项
- 视觉系统相对固定，适合统一风格输出，但不适合高度自由的复杂定制设计
- 目前主要依赖 JSON spec 手动配置，非 Codex 用户需要理解模板结构
- 支持的图标集合有限，复杂业务领域可能需要扩展脚本或自行绘制
- 动画时长、帧数、布局结构默认较固定，深度定制可能需要修改 Python 渲染代码
- 项目 star 数中等，生态和社区插件可能不如 Mermaid、Excalidraw 等成熟工具丰富
- 如果用于正式品牌物料，可能还需要设计师进一步审校视觉一致性
2026-07-03
第12名
新收录 · github_search
2026-07-02
第14名
新收录 · github_search
2026-07-01
第13名
新收录 · github_search
2026-06-30
第18名
新收录 · github_search
2026-06-29
第30名
新收录 · github_search
