如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

构建响应式前端界面

根据截图和视觉参考资料构建响应式界面,并对照原图检查效果。

难度 Intermediate
时间跨度 1h

使用 Codex 根据截图和设计说明编写符合代码仓库设计系统的前端代码。然后使用 Playwright 对照您的参考资料,检查界面在不同屏幕尺寸下的显示效果,并按需调整,直到符合设计预期。

最适合

  • 从零开始创建前端项目
  • 根据截图,在现有代码库中实现已设计好的界面或交互流程

目录

    ← 所有使用场景

    构建响应式前端界面

    根据截图和视觉参考资料构建响应式界面,并对照原图检查效果。

    使用 Codex 根据截图和设计说明编写符合代码仓库设计系统的前端代码。然后使用 Playwright 对照您的参考资料,检查界面在不同屏幕尺寸下的显示效果,并按需调整,直到符合设计预期。

    Intermediate
    1h

    使用 Codex 根据截图和设计说明编写符合代码仓库设计系统的前端代码。然后使用 Playwright 对照您的参考资料,检查界面在不同屏幕尺寸下的显示效果,并按需调整,直到符合设计预期。

    Intermediate
    1h

    相关链接

    最适合

    • 从零开始创建前端项目
    • 根据截图,在现有代码库中实现已设计好的界面或交互流程

    技能与插件

    • 在真实浏览器中打开应用,验证实现效果,并逐步调整布局和交互行为。
    技能 使用理由
    Playwright 在真实浏览器中打开应用,验证实现效果,并逐步调整布局和交互行为。

    起始提示词

    请以我提供的截图和说明为准,在当前项目中实现这个界面。 要求: - 复用现有设计系统中的组件和设计令牌。 - 使用代码仓库现有的工具和组件模式还原截图中的界面,避免另建一套体系。 - 尽量还原设计中的间距、布局、视觉层级和响应式行为。 - 遵循代码仓库现有的路由、状态管理和数据获取方式。 - 确保页面能适配桌面设备和移动设备。 - 如果截图中的某个细节不明确,请选择符合整体设计方向的最简单实现方式,并简要说明所作的假设。 验证: - 对照提供的截图,检查完成后的界面外观和交互行为。 - 使用 $playwright-interactive 检查界面是否与参考资料一致。如有差异,请继续调整,直到一致。
    请以我提供的截图和说明为准,在当前项目中实现这个界面。 要求: - 复用现有设计系统中的组件和设计令牌。 - 使用代码仓库现有的工具和组件模式还原截图中的界面,避免另建一套体系。 - 尽量还原设计中的间距、布局、视觉层级和响应式行为。 - 遵循代码仓库现有的路由、状态管理和数据获取方式。 - 确保页面能适配桌面设备和移动设备。 - 如果截图中的某个细节不明确,请选择符合整体设计方向的最简单实现方式,并简要说明所作的假设。 验证: - 对照提供的截图,检查完成后的界面外观和交互行为。 - 使用 $playwright-interactive 检查界面是否与参考资料一致。如有差异,请继续调整,直到一致。

    简介

    您可以把截图、简短的设计说明或几份提供灵感的参考资料交给 Codex。它可以据此实现响应式界面,并沿用项目已有的设计和实现方式。

    使用 Playwright 技能后,Codex 可以在真实浏览器中打开应用,将不同屏幕尺寸下的实际界面与您提供的截图逐一对照,再反复调整布局或交互行为,让结果更接近目标设计。

    提供设计参考

    请向 Codex 提供最能清楚展示目标界面的参考资料。对于范围较小的任务,一张截图可能就够了。如果能展示多种布局和状态,Codex 就能更准确地理解需求。例如,您可以提供桌面端和移动端布局、悬停或选中状态,以及需要关注的空状态或加载视图。

    参考资料不必是精细的设计稿。只要能清楚呈现您想要的视觉层次、元素间距和整体设计方向,Codex 就不用猜测您的意图。

    明确交互和风格要求

    您对预期交互方式和视觉风格描述得越具体,效果就越好。 模型通常会采用常见的交互模式和设计风格。如果您想要不同的效果,但参考资料没有清楚体现这一点,生成的界面可能会显得千篇一律。 您提供的设计参考越丰富,或给出的指令越具体,就越有可能得到有特色的界面。

    准备设计系统

    如果目标代码仓库已有结构清晰的组件层,Codex 的表现会更好。它可以自动复用您现有的组件和设计系统,无需从头构建。

    必要时,例如项目采用了非标准技术栈,请告诉 Codex 应复用哪些基础组件、设计令牌存放在哪里,以及代码仓库对按钮、输入框、卡片、文字排版和图标有哪些标准做法。

    如果您从现有代码库入手,Codex 通常能自行判断如何使用其中的组件和设计系统。如果您从零开始,最好明确说明这些约定。

    请让 Codex 以截图为视觉目标,并使用项目现有的工具函数、组件封装、配色体系、排版层级和间距令牌来实现界面,同时遵循项目的路由、状态管理和数据获取方式。

    使用 Playwright

    Playwright 很适合用来帮助 Codex 反复完善界面。Codex 可以用它在真实浏览器中打开应用,将实际界面与您提供的截图进行对照,并据此调整布局或交互行为。

    Codex 还可以调整浏览器窗口大小,模拟不同的屏幕尺寸,检查各个断点下的布局。

    请确保您已在 Codex 中启用 Playwright 交互技能。详情请参阅技能文档。

    迭代调整

    第一版界面的整体效果应该已经接近参考截图。如果布局或交互较复杂,或者界面中有大量动画,通常还需要调整几轮。

    除了检查页面能否成功构建,还要让 Codex 将实际界面与参考截图进行对照。如果截图与项目规范存在冲突,Codex 应优先使用代码仓库中设计系统的令牌,并且只对间距或尺寸做必要的微调,以保留设计的整体视觉效果。

    如果一张图无法清楚展示某些状态,您可以补充截图或简短说明。

    建议的后续提示词

    [current implementation image] [reference image] 当前界面的效果不太对。请对照参考图调整,让实际界面尽可能贴近参考图。 [if needed, specify what is different]

    相关使用场景