SuperAPI AI 工具集

visual-edit

设计与创作

查看项目

更新于 10-15 20:09

技能介绍

用途:Visual Edit(/visual-edit)用于在不生成独立 HTML 的前提下,可视化查看并协作编辑真实运行的本地应用。事实来源是运行中的 localhost 应用及其路由 URL,Design 将路由以 iframe 屏幕形式呈现在无限画布上。编辑器托管于 https://design.agent-native.com,本地只运行目标应用与桥接。

主要能力:每个屏幕是 URL 支撑的 iframe 而非复制 HTML,保留 connectionId、routeId、path、url、bridgeUrl、title、viewport 等元数据。画布支持平移缩放,Interact 保留导航、滚动、链接与控件。支持 Alt 拖拽复制帧、按视口重复路由、展示空/加载/错误/弹窗等状态。共享 /visual-edit/:designId?share=1 链接渲染经过清理的惰性快照,访客无法访问拥有者 localhost,编辑在应用前保持待处理。支持 get-visual-edit-prompt、get-visual-edit-pending、acknowledge-visual-edit-pending 等交接流程。

使用方式:安装用 npx @agent-native/core@latest skills add visual-edit(含托管 Design MCP 连接器),或 npx skills@latest add BuilderIO/agent-native --skill visual-edit(仅指令)。不要安装到目标应用或启动本地 Design 服务器。本地启动前需确认目标 URL 可响应;如需自启 Agent-Native 应用,使用 AUTH_DISABLED=1 配合正常开发命令。路由发现可用 npx @agent-native/core@latest design connect --url http://localhost:5173 --root . --json;持久桥接用 AGENT_NATIVE_BRIDGE_TOKEN="<token>" npx @agent-native/core@latest design connect --url http://localhost:5173 --root . --daemon。用户给出明确路径时跳过路由清点。

适用场景与限制:适用于检查、共享或编辑本地运行应用的界面。画布默认建议 3-7 帧,除非用户明确要求穷尽审计,否则不要展开所有路由或视口。本地编辑代理在应用自身源站 Cookie、WebSocket/HMR、SSE 和非 GET API 上可能不完全等价。共享链接与公共 /design/:id 保持只读;浏览器能力不能执行账户级写入,生成、保存到账户、分享仍需认证。不要输入或索取密码、cookie、token 或验证码,也不要绕过页面同意对话框。资料未提供定价与平台支持细节。