Agent 使用指南

创建与修改 UX

低保真可以省略装饰，不能省略会影响判断的交互信息。交付应让下一位读者看懂目标、必要内容、行为和结果。

1. 先明确用户目标、入口、前置条件与完成结果；读取已有项目概览，定位当前修订和受影响页面。
2. 补齐主路径与相关分支。必要字段、页面状态、操作条件和返回后的数据保留应写进完整页面与备注。
3. 常规修改只编辑“页面 JSON”；多页和共享逻辑使用“局部变更”。先预览差异和关联用例，再保存；分组、情境与入口设置也可通过变更包提交。保留已有页面与内容块 ID。
4. 保存后实际体验主路径、取消与关键失败恢复，交付项目／修订、预览入口、受影响页面和待确认事项。

读取与使用 UX

先理解已有设计，再用于视觉方案、开发、测试或评审。读取任务默认不修改项目。

1. 确认项目与当前修订，先读概览，再按任务读取完整页面、设计备注及关联动作／条件／前后路径。
2. 总览卡片可能只显示部分内容，截图也可能只有一种状态；字段与逻辑是否缺失，应回到完整数据核对。
3. 沿相关路径理解入口、状态、结果和恢复。区分已确认、示例假设、待确认与暂不模拟；发现冲突先列出差异。
4. 视觉 Agent 保留字段、动作和状态约束，可重新设计布局与样式；交付页面 ID 到视觉画板的映射和必要状态。改变流程的想法单独列为建议，取得相应授权后再改源。

低保真的灰框、字体、颜色和坐标不是正式视觉规范。结构检查通过，也不代表设计已获批准或真实服务已实现。

打开项目与查阅格式

项目只在当前浏览器中可见。如果你使用另一个浏览器或远程环境，请让用户提供导出的项目文件，修改后返回完整 JSON 供用户导入。网址里的项目 ID 无法跨浏览器传递数据。

无需安装 Skill 或 MCP。首次创建可使用空白或设备连接示例；已有项目先读取概览与相关页面。主工作台低频技术操作（文本新建、导入修改、图标目录）位于“更多工具”中；项目卡片突出“打开项目”，其余操作在“更多”内；小屏通过“页面与分组”展开导航。

Agent 工作台

浏览器 Agent 可以直接操作此表单，不需要调用额外接口。更新前重新加载项目；项目发生变化时会阻止旧数据覆盖。

能力与约定

支持固定导航、滚动正文与底栏，常用容器、表单、图片、列表与轮播，以及 Sheet、Dialog、菜单和区域反馈。动作区分跳转、同页更新、打开与关闭弹层；集合支持选择、筛选、排序及声明式修改。完整格式和边界见“页面与交互组件”，未支持的能力写入设计备注，不添加运行脚本。

稳定保留页面和内容块 ID。页面内容与动作共用一份数据，连线从动作生成。只把用户确认的要求写成确定设计；建议与待定规则放入备注。