手绘白板(本地场景模型)
用图形+箭头+中文文字组成确定性场景;提供两个预置示例、.excalidraw 导入/序列化往返、显式本地草稿、确认式替换、48px 品牌条与安全策略审计。
输入与参数
action— 动作presetId— 预置场景sceneText— .excalidraw 文本(导入/场景输入)draftAction— 草稿子动作svgText— 任意 SVG 文本(只扫描,不注入 DOM)confirm— 已确认替换(勾选前先导出备份)
真实示例
action=roundtrip, presetId=flow-sketch
输入场景:矩形「开始」(80,120,160×72)、矩形「整理需求」(320,120)、矩形「评审结束」(560,120)、箭头 flow-a1 points=[[0,0],[80,0]]、中文文字「流程草图:需求 → 整理 → 评审」。
→ serializeScene → parseSceneDocument → {"positionsEqual":true,"elementCount":9,"chinesePreserved":true,"arrowPointsPreserved":true};重新导入后 (80,120) 与箭头 points 完全一致。
限制与失败处理
真实 Excalidraw React/Canvas 引擎、真实手绘笔迹、PNG 栅格化、字体自托管、390/768/1440 宽度与真机手势均未集成/未实测;本操作只提供确定性场景模型与可测试契约。PNG 未注入栅格化器时抛 PNG_RASTERIZER_UNAVAILABLE,不伪造图像。
FAQ
两个预置场景分别是什么?
flow-sketch(流程草图:开始→整理需求→评审结束,9 元素)与 product-idea(产品想法:目标用户/核心价值/关键流程/风险与验证,15 元素),均含中文与绑定箭头。
导入含远程图片的文件会怎样?
files 被丢弃并记录 REMOTE_FILES_DROPPED;image 元素校验返回 REMOTE_IMAGE_REJECTED,不发起任何抓取。
草稿键会影响其它站吗?
不会,键空间为 al:draw:v1:*,清理只匹配该前缀;测试验证其它站键保持原值。