第39章 Agent 缺失的设计词汇:Impeccable Live Mode 教程
在浏览器中迭代 在页面上对比各种改动,保留你想要的版本。本页共 9 个小节
大多数 agent 使用 /impeccable,在 Codex 中使用 $impeccable。
选中要改进的标题、卡片或区块,或在对话中指名它。本教程会带你描述一个改动、在页面上对比多个方案,并保留其中一个写入项目源码。
截图来自一个虚构读书会页面的真实 Live Mode 会话。示例重新组织了活动卡片,让日期更易扫读,预约按钮也紧挨着活动详情。内容和视觉风格保持不变。
开始前的准备
需要先安装 Impeccable,有一个能在你项目上工作的 agent 会话,以及一个本地运行的网页。Live Mode 支持常见开发服务器和静态 HTML。如果还没安装,参见 getting started。
页面上要有足够的真实内容才能判断效果。init 和 document 保存的上下文能帮 agent 保持你的产品和视觉决策。没有这些文件也可以先用 generate 试试,它会从当前页面读取风格特征。
从书面需求开始
如果明确知道自己要改什么,直接在 agent 对话中说:
/impeccable generate 3 layout variants of the event card. Make the date easier to scan and keep the reservation button with the event details.
Impeccable 会连接页面、找到卡片并开始生成备选方案。保持 agent 会话活跃,然后直接跳到下文的“对比各方案”。对比和接受操作完全相同。
给命令一个方向和一个元素;数量可选,默认为三个。更多示例参见 generate 参考文档。想自己选中并标注元素,请按下面的 Live Mode 步骤操作。
1. 启动 Live Mode
在 agent 对话中运行:
/impeccable live
Impeccable 连接项目并打开带工具栏的页面。使用控件期间请保持 agent 会话活跃。
首次设置时会发生什么?
Impeccable 会识别你的开发服务器提供的页面,并准备 Live Mode 配置。一个本地辅助程序把浏览器控件连接到你的 agent。
有些项目的 Content Security Policy 会阻止这个连接。如果需要调整,Impeccable 会说明原因并在修改策略前先征求同意。具体改动取决于你的框架,某些配置需要手动调整。
打开你的应用 URL。辅助服务器的地址是另一个服务,不是你正在编辑的页面。
2. 选中要修改的部分
在工具栏中启用 Pick,然后点击标题、卡片或区块。选中处会高亮显示,旁边出现请求输入框。
本例中选择整个活动卡片,输入:
Make the next event easier to scan and the reservation action easier to find. Keep all event details, fonts, and colors.
选择整个卡片,让 Impeccable 可以重新排布其内容。区块标签显示选中的容器。点开图片可查看完整大小的控件。
你可以选择 layout、bolder 等动作来聚焦工作方向。评论和手绘线条可以指向选区中的特定部位。一句简单的需求就足以开始。
按下标记为 Generate variants 的生成箭头。备选方案准备期间让 agent 继续工作。
3. 对比各方案
用上一个/下一个控件切换备选方案,计数器显示当前查看的是哪一个。
同一个活动重新组织后:介绍在左,日期、时间和预约在右。日期更容易找到,操作按钮也和做出决定所需的信息归在一起。
结合上下文审视结果:视线被什么引导、占用多少空间、是否仍与页面整体协调。方案默认会保留你的设计风格。想要不同的风格时,明确要求重新设计即可。
某些选区会提供 Tune 控件,用于调整间距或强调程度等特性,无需再生成一轮。本例中可以调整各分组之间的间距和标题字号。
如果所有方案都不理想,丢弃这一组,换一个更具体的需求重试。
4. 保留一个并检查
点击 Accept 保留当前方案。Impeccable 会把结果写入真实源码并移除临时预览代码。丢弃整组则会恢复原始选区。
清理、退出 Live Mode 并刷新页面后的结果。新的排布保留了下来,因为它已经是源码的一部分。
检查源码 diff 并试用受影响的界面。检查窄屏以及视觉对比未覆盖到的交互行为。如果页面是由其他文件生成的,按照 source-mapping 提示操作,确保改动落到原始文件。
5. 结束会话
接受或丢弃当前一组方案后,用退出控件或直接让 agent 停止 Live Mode。它会停掉辅助程序并移除临时连接。项目配置会保留,供下次会话使用。
如果是从 generate 开始的,Impeccable 会在处理完你的选择后关闭 Live Mode 连接。开发服务器会带着已接受的结果继续运行。
尝试页面级调控
要修改不止一个选区,用工具栏中的 Steer。输入或说出方向,比如"让整个页面的活动日期都更容易找到"。agent 会直接处理这个需求,而不是先生成一组元素变体。
你也可以直接插入新元素或编辑文本并应用到源码。详见 Live Mode 参考文档。
遇到问题时
没有工具栏:查看 agent 的设置消息,确认你打开的是应用 URL。可以让 agent 检查连接以及是否有策略阻止连接。
生成无响应:保持 agent 会话活跃。如果会话被中断,让它恢复 Live Mode 并在重新开始前检查待处理的会话。
结果不符合品牌风格:检查需求内容和项目记录的上下文。刷新过期的上下文,并明确指出当前设计中要保留的部分。
找不到源码:按照 agent 的说明操作。不要强行改动下次构建就会被覆盖的生成产物。
如果想获得改进方向的建议,可以用 critique,或直接向 Impeccable 描述一个全新页面。