Lanshu 动态架构图 · AI 工具图鉴

📌 核心价值：把架构图当成「代码」来写，一键产出可编辑 Excalidraw + 静态 PNG + 真动态 GIF 三件套

还在为技术博客配图东拼西凑？cclank 开源的「岚叔动态架构图」Codex 技能，输入一个 JSON 文件就能渲染出黑底手绘风格的动态架构图，黑底 + 手绘感 + 真动效 + 全本地渲染，技术写作直接告别丑图。

封面图

🚀 什么是 Lanshu 动态架构图？

lanshu-animated-architecture-diagram 是一个 Codex 技能（Skill），它把架构图的"绘制过程"变成"配置驱动"：你只需要写一份 JSON Spec，运行渲染脚本，就会同时产出三份产物——可二次编辑的 .excalidraw、静态预览 .png、以及带高光流动 + 节点脉冲的真动态 .gif。

它默认采用 DailyDoseOfDS 同款的黑底手绘风格：黑画布 + 手写体标题 + 顶部输入条 + 中部核心流水线 + 底部源 / 层 / 包三层结构 + 右上角签名戳。这种"窄视觉系统"约束保证了不同主题的输出风格统一、出图不串味。

核心定位：Codex 内的「架构图即代码」技能，零账号零联网，3 行命令渲出专业级动态 GIF

✨ 核心功能一览

Lanshu动态架构图核心功能一览

🛠️ 快速上手：5 分钟跑通示例

安装 / 部署

项目提供两种使用方式：作为 Codex 技能安装到 ~/.codex/skills/，或者直接克隆仓库使用本地 CLI。

# 1. 克隆仓库
git clone https://github.com/cclank/lanshu-animated-architecture-diagram.git
cd lanshu-animated-architecture-diagram

# 2. 安装依赖（仅需 Pillow 一个包）
python3 -m pip install -r requirements.txt

# 3. 用自带模板跑一遍
python3 scripts/render_animated_diagram.py \
  --spec assets/default-spec.json \
  --outdir outputs \
  --basename sample \
  --verify

跑完后会在 outputs/ 目录看到三个文件：

sample.excalidraw   # 可在 excalidraw.com 二次编辑
sample.png          # 静态预览图（1210 x 1138）
sample.gif          # 真动态 GIF（20fps，41 帧，约 2.05 秒）

注意：--verify 标志会校验 GIF 帧间差异，零像素变化会告警，确保不是「伪动效」

核心代码示例：写一份自己的 Spec

Spec 文件就是一份结构化的 JSON，下面是最小可用模板（取自 assets/default-spec.json 的关键字段）：

{
  "signature": "made by Lanshu",
  "title": {
    "prefix": "My",
    "highlight": "Architecture",
    "subtitle": "Codex skill driven architecture diagram"
  },
  "inputs": [
    { "label": "User", "icon": "folder" },
    { "label": "Code", "icon": "file" },
    { "label": "Data", "icon": "db" }
  ],
  "core": {
    "cards": [
      { "title": "Parse", "highlight": "AST" },
      { "title": "Compile", "highlight": "IR" },
      { "title": "Execute", "highlight": "VM" }
    ]
  },
  "decision": "if valid -> proceed",
  "output": { "label": "Result", "icon": "package" }
}

把这份 JSON 保存为 work/my-diagram-spec.json，然后运行渲染脚本即可产出同款三件套。支持的内置 icon 键值：folder / file / scan / shield / db / hash / package，覆盖常见技术场景。

📊 与竞品对比

Lanshu动态架构图 vs 主流架构图工具对比

核心差异化：唯一同时支持「Excalidraw 可编辑源 + 黑底手绘质感 + 真动态 GIF + 纯本地渲染」的方案

💡 适用场景

场景 1：技术博客配图（Claude Loops 风格）

Claude Loops 动态架构图

功能说明：用 JSON Spec 描述一个循环执行架构（输入 → 处理 → 输出 → 回流），渲染出顶部输入条 + 中部 3 个 core 卡片 + 底部 source/layer/pack 三层结构，GIF 动画展示高光流动路径。

输入要求：JSON Spec 中至少包含 title / inputs / core.cards / output 四个字段 输出效果：同款 claude-loops.gif 风格的动态架构图 适用场景：解释循环、迭代、批处理等带"反馈环"的工作流

场景 2：系统分层架构（Memory Pack 风格）

Memory Pack 动态架构图

功能说明：把系统的多个内存 / 存储层（DB / Cache / Disk）展示为底部三层 panel，配中部核心流水线，GIF 动画高亮数据流动方向。

输入要求：JSON Spec 中配置 left_panel / center_panel / right_panel 三个底部结构 输出效果：同款 memory-pack.gif 风格的分层架构图 适用场景：解释分层存储、记忆系统、数据流水线

场景 3：流程节点图（自定义 Spec）

功能说明：除了仓库自带的两个示例，你完全可以写自己的 Spec 来描述任意流程——比如 Agent 推理循环、RAG 检索流程、CI/CD 流水线等。

输入要求：完整 JSON Spec（约 30-50 行） 输出效果：与官方示例风格完全一致的动态 GIF + PNG + Excalidraw 适用场景：任何需要「黑底手绘质感 + 真动效」的技术内容场景

用户群体总结

✅ 技术博主 / 自媒体作者：告别东拼西凑的工具截图，统一视觉风格
✅ AI 产品文档：用 GIF 动画直观展示 Agent / RAG / Agent Loop 等复杂流程
✅ 企业架构师：黑底手绘风格适合内部技术分享与汇报
✅ Codex / Claude Code 用户：作为 Skill 集成，自然语言即可生成架构图
❌ 不适合：需要 3D 立体效果、复杂阴影、照片级真实感的场景（这是手绘扁平风格）

💰 定价方案

完全开源、永久免费。

开源协议： MIT

💡 新用户福利：零成本启动——只需 Python 3.9+ 和 Pillow，5 分钟跑通第一个动效

🎯 总结

lanshu-animated-architecture-diagram 把"架构图即代码"理念做到了极致：一份 JSON Spec 同时产出 Excalidraw 可编辑源、静态 PNG、真动态 GIF，且风格统一、纯本地渲染、零账号门槛。

对于经常写技术博客、做技术分享的工程师来说，这相当于一个"黑底手绘风格"的架构图工厂——再也不用在 draw.io / Excalidraw / Mermaid 之间来回切换，再也不用担心 GIF 是不是"伪动效"（内置 --verify 帧差校验）。

最大亮点：Codex Skill 原生集成 + Pillow 纯本地 + MIT 协议，三者结合让"动态架构图"第一次成为可量产、可复用的技术写作资产

推荐指数： ⭐⭐⭐⭐⭐（满分 5 星）

适合人群： 技术博主 / AI 工程师 / 系统架构师 / Codex 用户

立即体验： Lanshu 仓库

GitHub 仓库： cclank/lanshu-animated-architecture-diagram

数据截至 2026-06-29，最新信息请以 GitHub 仓库为准。

配套媒体