SuperAPI AI 工具集

excalidraw-use

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:处理 Excalidraw 白板中手工操作繁琐的部分,包括把大量已有图片整齐放到画布上、把幻灯片转成逐页图片、检查 .excalidraw 文件。它不根据文字描述生成图表;若需求是“画架构图/流程图”,应使用其他图表生成工具。

主要能力与用法:

  1. 构建图片托盘:python3 scripts/build_scene.py --out tray.excalidraw --cols 6 --template-from ~/path/to/their-board.excalidraw --exclude already-placed.png images/*.png。输出需出现 verified 行才可用。建议用 --template-from 复制现有白板中的图片元素字段;--exclude 按图片内容去重;--cell 为缩放最长边,--pitch 为格心距,间距为 pitch-cell。场景超过约 15 MB 时用 split_scene.py 拆分。
  2. 幻灯片转图片:适用于在 src/slides/index.ts 注册幻灯片的 Vite/React 项目。先 npx vite build --outDir /tmp/deck-dist --emptyOutDir 并静态服务构建产物,再运行 node scripts/shoot_deck.mjs --index <deck>/src/slides/index.ts --url http://127.0.0.1:8080/index.html --out shots/ --advance pdf(或 keys)。需能解析 puppeteer;--advance 二选一,不可同时用。
  3. 检查场景:python3 scripts/inspect_scene.py board.excalidraw --images,只读报告元素数量、嵌入体积、图片内容与键是否匹配、占用范围。

限制:不要写入用户正在使用的白板文件;应生成独立场景文件让用户粘贴。excalidraw.com 的 Open 和拖放会替换整个当前场景,应使用剪贴板粘贴方式。粘贴内容落在当前视口位置,需提示用户先滚动到空白处。若出现图片空白、重叠、粘贴无效或幻灯片缺内容,按资料中的排查表处理。