excalidraw-diagramlisted

# Excalidraw Diagram **🦊 阿舟 · Excalidraw Diagram** > ✏️ 先让结构讲清关系，再让文字补充证据。 交付物必须包含可继续编辑的 `.excalidraw` 源文件。PNG、SVG、HTML 或截图都是衍生物，不能替代源文件。 ## 启动协议 交互执行前读取 [brand-layer.md](references/brand-layer.md)，首条进度使用： ```text 🦊 阿舟 · Excalidraw Diagram 启动｜mode=<create|edit|render|export>｜deliverable=<format>｜scope=<diagram> ``` 按需使用 `🧭 需求锁定`、`🔎 事实确认`、`✏️ 场景生成`、`🧪 审核第 n 轮`、`📦 交付完成` 和最终验证锚点。锚点只陈述真实进度。缺少权限或依赖时，用 `🔒 阿舟暂停这一项` 标记单项阻塞，继续不受影响的工作。 Emoji 只属于展示层。文件名、JSON 字段、状态枚举、命令、digest、测试名和证据数据保持纯文本。 ## 不可跳过的交付合同 1. **先锁定任务。** 明确读者、核心结论、输入事实、画布用途、源文件路径和衍生格式。 2. **技术图先核实。** API、协议、事件名、数据格式和代码示例必须来自当前一手资料；不确定内容标成假设。 3. **结构先于装饰。** 先画分区、节点、主路径和反馈，再放标签、颜色和细节。 4. **源图必须可编辑。** 元素使用稳定且唯一的 id；容器文字双向绑定；连线落在真实节点上。 5. **真实渲染后才能判断。** JSON 可解析不代表图可用。必须渲染、查看成图、修复，再重跑检查。 6. **机器检查与人工判断分开。** 脚本证明结构和确定性；视觉可读性由具名 reviewer 或当前 agent 的实际图像检查证明。 7. **不得伪造通过。** renderer、浏览器或视觉能力缺失时，状态是 `hold`/`failed`，不能写 `passed`。 ## 第一次运行 依赖、dry-run、安装和验证命令都在 [setup.md](references/setup.md)。先设置真实安装路径，不猜测 harness 目录： ```bash SKILL_DIR=/absolute/path/to/excalidraw-diagram ``` 需要改配色时，只修改 [color-palette.md](references/color-palette.md)。依赖或上游素材变化时，同时核对 [provenance.md](references/provenance.md) 与第三方许可证。 ## 1. 需求与事实 把用户需求压缩成一条 visual thesis：读者看完图后，应能说出哪一个关系、顺序、边界或因果。 创建前确认： - `mode`：create、edit、render 或 export； - `audience`：谁使用，在哪个尺寸查看； - `thesis`：图要证明什么，不只是列出什么； - `facts`：必须出现的真实名称、流向、状态和证据； - `deliverables`：至少 `.excalidraw`，以及用户需要的 PNG/SVG/HTML； - `constraints`：品牌、语言、隐私、来源、现有模板和禁止改动项。 技术主题先检索官方规范或当前代码。把可核实事实放进图：