marvis-lanshu-diagram

生成黑底手绘风格架构图并导出可编辑 .excalidraw、.png 与动画 .gif。

把技术架构画成黑底手绘风格，交付可编辑的 Excalidraw 源文件、静态 .png 和带流动高亮的 .gif 动画，方便演示与修改。适合做架构可视化、技术说明或产品演示时用。特点是既有艺术化的手绘外观，又保留可编辑源和动态高亮，方便讲解数据流和模块交互。

# Marvis Lanshu Animated Architecture Diagram

创建黑底手绘技术架构图，交付三件套：`.excalidraw`（可编辑源文件）、`.png`（静态预览）、`.gif`（动画，含流动光点与模块脉冲高亮）。

## 依赖安装

```bash
pip install Pillow>=10.0.0
```

渲染脚本还需 `ffprobe`（FFmpeg 自带），用于验证 GIF 动画质量。

## 工作流

1. **提取图表内容**：从文章或参考图中识别核心架构、角色、阶段、数据流、决策与输出。
2. **创建 spec JSON**：基于 `assets/default-spec.json` 模板，标签需简短。字段细节参考 `references/spec-format.md`。
3. **渲染输出**：

```bash
python F:\AI-DATA\User\oAN1i2ZFVAt9uJ7swj8vlOM9HSDY\skills\market\marvis-lanshu-diagram\scripts\render_animated_diagram.py `
  --spec <spec.json路径> `
  --outdir <输出目录> `
  --basename <文件名前缀> `
  --verify `
  --check
```

4. **验证**：
   - 用 `ffprobe` 确认 GIF 尺寸、FPS、帧数、时长。
   - `--verify` 输出应显示帧间非零像素变化（证明非静态）。