用途：通过 FigCraft 的结构化自动化接口操作该应用，执行矢量设计与编辑任务，同时保持用户要求的设计工作流和目标文件不变。
主要能力：
- 检查文档：document.inspect 可查看页面、图层树、选区、样式和撤销历史，支持 depth、fields、outline 限定输出；node.get 用于单个图层。engine.commands 用于发现命令 ID、参数和菜单。
- 编辑文档：通过 engine.execute 执行命令，创建命令返回 {"id": N}；可用 frame.create、node.create、node.set、shape.、text.、tool.set 以及 ui.pointer 手势；command.batch 可批量执行已知步骤，onError: "continue" 时仅失败步骤回滚，步骤可用 {"$ref": "name"} 或 {"$step": n} 引用先前结果；agent 参数可让评论活动标记为 AI 代理。
- 验证结果：ui.render 输出无界面的文档 PNG（无需窗口），ui.screenshot 截取整个窗口；file.open 和 file.import 返回摘要，材料导入警告需报告。
- 文件输出：保存为 .figcraft 原生可编辑文件，按需导出 SVG、PNG 或 PDF；events.poll 监视评论活动，需保留返回游标，reset 为 true 时重新读取评论。
使用方式：
- 桌面应用仅在 127.0.0.1 提供控制通道，启动方式：figcraft --control 7979 [file.figcraft|file.svg|image]；可直接驱动实时窗口，或通过附加的 MCP 服务器（figcraft-cli mcp --attach 7979）操作。
- 应用可多窗口显示文件；每个方法接受可选 window id（来自 window.list，0 为主窗口），缺省发往最前窗口；engine.execute、document.inspect、node.get、ui.render 还可接受可选 document（来自 doc.list 的打开文件 ID 或路径）以操作后台标签页。
- Web 构建在页面 URL 带控制查询入口时，于 window.figcraft 上以 Promise 暴露相同方法。
- 构造调用前应阅读 references/control-protocol.md 的相关章节；若安装行为不同，应通过 engine.commands 检查命令注册表，而非臆造参数。
- 坐标以页面单位、y 向下；node.set/node.create 中的 x/y 相对父画框；ui.pointer 接受页面坐标或屏幕像素（sx、sy）；ui.input 发送原始窗口输入（按下与释放分开调用）；ui.key 发送画布快捷键；ui.type 输入到正在编辑的文本（先 text.edit.begin {id} 或双击）；ui.menu.invoke 点击菜单项，可能打开对话框；ui.set 切换面板、标签和选择器。
适用场景：需要在 FigCraft 中程序化创建或修改矢量设计、管理图层与组件、维护样式、构建原型、批量执行设计命令、截图验证结果、导出设计文件，或监视设计评论活动时使用。
限制与注意事项：
- 请求为按行分隔的 JSON，逐行匹配 id；检查 ok。请求在下一帧开始时于 UI 线程执行。
- 60 秒超时回复用于区分请求已丢弃（未生效）与仍在运行（将生效，重试前先检查文档）；长请求如大型 command.batch 可用 timeoutMs 自行延长等待，最长 600000。
- 单行请求上限 32 MiB；最多 8 个连接，每个队列最多 8 个排队请求。最小化或被遮挡的窗口仍可响应状态方法，但在绘制前无法执行 ui.screenshot 或 ui.input。
- 通过 engine.execute 的程序化调用不会打开对话框；未知参数会报错而不会被忽略。
- FigCraft 0.7.0+ 的 --automation-read-root 与 --automation-write-root 将控制和注入输入限制在任务文件夹内：仅可写入写根内、仅可读取读根或写根内，受限期间拒绝网络协作；根内使用正斜杠路径，被拒绝路径属于普通错误（automation path rejected: …），不得用环境文件系统命令绕过。
- 本技能不安装 FigCraft，也不注册 MCP 服务器；若所需连接或可执行文件缺失，应报告具体前置条件。
- 文档快照为下载的上游协议（2026-11-02 捕获），采用捆绑 MIT 许可；快照内相对链接指向上游文档。