Grok OpenDesign

用 Grok
在 OpenDesign
做设计。

如何在 OpenDesign 中使用 Grok Build 设计界面:以活动海报为参照,在改动前先制定计划,从 brief 到审阅完成的落地页任务,以及开始前需要了解的限制。

本页内容 示例
  1. 示例
  2. 适用场景
  3. 兼容性
  4. 环境搭建
  5. 工作流
  6. 资源
  7. 局限性
  8. 常见问题

一个完整的 Grok 设计任务

一个 Grok 任务:简报、产物、审阅

本页通过一个任务,走一遍你交出的简报与约束、Grok 返回的产物,以及你在宣布完成之前仍需做的检查。下方展示的界面是为本页制作的示例,并非截取自真实的 Grok 运行。

1设计 Brief 与约束条件

Brief

使用所附的海报图片,为一个为期两天的开发者大会设计落地页:日期与场地、日程预告、讲师,以及购票行动号召。需覆盖桌面端和手机端。

  • 设计系统OpenDesign 纸感画布:Albert Sans,单一绿色强调色
  • 断点桌面端 1440px、移动端 390px,且无横向滚动
  • 交互购票 CTA、日程日期切换,以及讲师卡片
  • 输出一个自包含的 HTML 文件,带有稳定的 data-od-id 挂钩

2谁做什么:你、Grok、OpenDesign

  • 你

    你的职责:撰写简报、选择设计系统,并设定验收标准。

  • Grok

    Grok 规划布局,编写 HTML、CSS 和 JavaScript,然后按需修改。

  • OpenDesign

    OpenDesign 提供设计系统与技能,渲染预览,并将每个版本保存为项目文件。

  • 审查

    交付之前,你检查视觉层级、8px 网格上的间距、两个断点,以及每一项交互。

3Grok 产物:1440px 与 390px 下的活动页面

Grok 产物:1440px 与 390px 下的活动页面 — 桌面端
示意性示例

4交付前审查

Layout

网格与间距

主视觉、赛道和佐证内容对齐 8px 网格;海报图采用裁剪,而非挤压。

Hierarchy

视觉层级

日期和标题在前,购票按钮紧随其后,强调色只出现在该按钮上。

Responsive

移动端布局

标题、日期和购票按钮位于主视觉之上;赛道按顺序堆叠。

Interaction

交互检查

打开购票流程,切换日程日期,并跟进一张讲师卡片。

Fit

Grok 适合哪里——又不适合哪里

适合使用 Grok 的情形

  • 能识别图像的截图 → UI。 Grok 模型接受图像输入,因此参考图可以变成响应式标记,成品也能对照它来检查。
  • 改动前先进入计划模式。 Grok 会在文件变更之前起草一份结构化计划供你批准,让设计意图在前期就得到审阅,而不是在 diff 之后。
  • AGENTS.md + MCP。 你的约定存放在上下文文件中,同时 Figma MCP 服务器会把真实的设计上下文引入代码。
  • 用你的账户登录。 通过 SuperGrok 或 X Premium+ 使用 OAuth,或提供 xAI API 密钥(BYOK)用于无头运行。

选择其他工作流的场景

  • 你需要可编辑的矢量文件。 Grok 的产物是 HTML,而非可编辑的设计文档;这类素材格式请使用单独的矢量工作流。
  • 你没有参考素材,也没有约束。 没有设计系统或示例时,输出容易趋于千篇一律——先写好简报。
  • 你没有该 agent 所需的凭据。 必需项:xAI SuperGrok OAuth(`grok login`)。OpenDesign 既不提供也不代理凭据。
  • 你的团队使用 Hermes 或 Codex。 那些 agent 有各自的页面;即便共用同一工作区,安装方式也各不相同。参见相关 agent。

兼容性

开始前的 Grok 要求

此处范围是通过 OpenDesign 桌面应用连接的 Grok。所引用的已发布资料核查于 2026 年 9 月 6 日。

工具范围Grok,由 xAI 提供

Grok Build 是 xAI 的终端编码 agent,以 Grok Build 之名发布。它可以读取你的代码库、编辑文件、运行 shell 命令,并在行动之前规划多步工程工作。本页讲的是通过 OpenDesign 使用 Grok 进行界面设计,而非 Grok 自身的界面。OpenDesign 的安装说明列出了可用的 agent。

账户与身份验证xAI SuperGrok OAuth(`grok login`)

xAI SuperGrok OAuth(`grok login`)。使用 SuperGrok 账户或 xAI API 密钥(BYOK)登录;凭据始终留在你的机器上。此处不承诺任何配额或价格。

系统与版本桌面应用或源码

桌面版构建请查看下载页面。源快速入门中列出的 Node.js 和 pnpm 要求,仅在从源码运行时适用,安装桌面版软件包时不适用。最低兼容的 Grok 版本:此处未验证。

连接检查成功的标志

使用你已安装版本所显示的连接说明,然后试一个小任务。确认 Grok 已处理该任务,且产物能够打开;仅下载本身并不能证明连接可用。

从桌面应用开始

三步完成 Grok 设置

从下载开始,完成你所安装版本的 Grok 设置,然后检查一个小结果。这条路线无需从源码构建 OpenDesign。

  1. 1

    下载 OpenDesign 桌面应用

    选择适合你机器的软件包,安装并启动应用。

    下载 OpenDesign
    检查点
    桌面应用成功启动。已经安装过?继续下一步——无需再次下载。
  2. 2

    准备你的 Grok 连接

    使用你已安装版本中显示的 Grok 说明。用 SuperGrok 账户或 xAI API 密钥(BYOK)进行身份验证;凭据绝不会离开你的机器。

    xAI 模型文档
    # 1. Install Grok Build (Grok Build) on macOS/Linux
    curl -fsSL https://x.ai/cli/install.sh | bash
    
    # 2. Start it in your project and authenticate on first run
    cd your-project
    grok login   # opens your browser; sign in with SuperGrok / X Premium+
    #   or, for headless / CI use, set an xAI API key:
    #   export XAI_API_KEY=xai-...

    来源:已发布指南中的 Grok 设置说明;请在厂商文档中确认当前命令。

    检查点
    确认目标 agent 和账户。若其中任一不可用,请先查阅兼容性,再尝试更大的任务。
  3. 3

    运行一个小型 Grok 任务

    让首个简报保持小巧,以便判断完整闭环,包括一次修改。

    入门 brief

    创建一个设置界面,包含个人资料表单和保存确认。遵循我的设计规则。在桌面端和移动端宽度下验证。

    检查点
    打开结果,操作保存状态,并提出一个精确的修改要求。生成的文件只是开启审阅,并不代表审阅结束。

若要从源码运行 OpenDesign,请改用技术快速入门。

Grok 设计工作流

Grok Build 设计任务的五个步骤

跟随一个活动页面任务,从简报走到检查完毕的文件。每一步都说明你的输入、Grok 的动作、OpenDesign 的部分,以及你执行的检查。

  1. 1

    设计 Brief

    保持为几行朴素文字——三到六行。说明这个界面面向谁、必须做什么,以及哪些平台重要。

    • 您起草简报,并在有参考截图时附上。
    • Grok解析简报和项目的 AGENTS.md 指令文件;若有细节不清楚,会提出问题。
    • OpenDesign提供项目、提示框,以及与产物类型匹配的技能。
    • 检查确保简报明确写出验收标准。在生成之前确定它们,比事后返工代价更低。
  2. 2

    设计约束

    一套设计系统加上几条硬性规则。这样的组合能让输出保持品牌一致,而不会退回到千篇一律的样子。

    • 您选择一套设计系统,然后指定断点和必须出现的组件。
    • Grok在编写任何标记之前,把 DESIGN.md 的 token 和姿态规则拉入上下文。
    • OpenDesign提供设计系统库,并将你选定的系统接入技能模板。
    • 检查检查 token 是否符合品牌:单一强调色、预期的字体、正确的圆角。
  3. 3

    生成界面

    Grok Build 产出一个自包含的 HTML 文件——布局、样式、交互和稳定的钩子。

    • 您等待计划,或回答一个澄清问题。无需任何配置。
    • Grok起草区块计划,编写 HTML、CSS 和 JavaScript,运行文件并修复失败。
    • OpenDesign将产物存入项目文件夹,并为其建立预览索引。
    • 检查先别急。评估渲染后的文件,而不是源代码。
  4. 4

    预览

    OpenDesign 会按你指定的宽度渲染文件。这一刻正是设计决策接受评判的时刻。

    • 你调整视口宽度,逐一测试每个交互,并把评论附加到具体元素上。
    • Grok读取你的预览评论,并准备下一版修订。
    • OpenDesign渲染预览,使 data-od-id 目标可用于评论和编辑。
    • 检查检查层级、对比度、390px 下的溢出、焦点状态,以及强调色是否保持克制。
  5. 5

    修订与验证

    通过在预览中指向元素来提出修改。每次修订都会成为一个新文件;不会有任何内容被悄悄覆盖。

    • 你把评论转化为请求,并判定任务何时完成。
    • Grok就地应用修改,并重新运行文件。
    • OpenDesign将各版本并排保留,并在你完成时导出图片或 HTML。
    • 检查只重新检查改动过的区域,然后每个断点完整检查一次整页。

资源

Grok 设计资源

限制

Grok 的局限、人工检查与回退路径

  • 范围本页将 Grok 视为连接到 OpenDesign 的智能体;它并不涵盖 Grok 的每一项功能。
  • 使用限额使用限额和费用取决于你所使用的凭据(xAI SuperGrok OAuth(`grok login`))。此处不对免费额度作任何声明。
  • 网络让项目文件保留在本地并不会使推理变为离线。在提供敏感输入之前,请检查你所使用智能体的提供商设置和数据政策。
  • 输出为 HTML这些工件是 HTML 文件,而不是矢量设计文件。
  • 人工审查你需要在预览中审查无障碍性、真实内容、品牌契合度和交互正确性。把智能体自身的检查只当作第一遍。
  • 后备方案当智能体不可用或任务失败时,请查阅你所安装版本的连接说明和身份验证。在改动配置之前,保留错误信息和最后一个可用的工件。

常见问题

关于 Grok 与 OpenDesign 的常见问题

Grok Build 真的能完成设计工作吗?
可以——在具备审美 skill、设计系统以及上下文中真实的参考图片的情况下,Grok Build 能产出生产级、响应式的 UI,其具备图像理解能力的 Grok 模型也有助于对照参考图核验输出。若缺少这些上下文,它往往会退回到通用样式,这正是 OpenDesign 所填补的空白。
如何验证 Grok Build 的身份?
你通过浏览器使用 SuperGrok 或 X Premium+ 订阅登录(`grok login`),因此无需管理 API key。若用于无头环境或 CI,你也可以改用 xAI API key。无论哪种方式,OpenDesign 都不会代理你的凭据。
具体来说,是什么让 Grok Build 特别适合设计?
两点:其计划模式让你可以在任何更改落地之前审查方案,其 Grok 模型支持图像输入,因此能很好地读取参考截图。两者都有帮助——但审美仍来自你提供的设计系统、skill 与参考资料。
前端设计该用 Grok Build 还是 Claude Code?
两者都很出色。Claude Code 以具体、了解代码库的设计决策著称;Grok Build 的优势在于计划模式审查与具备图像理解能力的 xAI 模型。许多团队同时使用两者——OpenDesign 让你可以切换 Agent,而无需改变设计工作流。
如何将 Grok Build 连接到 Figma?
将 Figma MCP 服务器添加到你的 MCP 配置中。之后 Grok 便可拉取真实的设计上下文——组件、变量、布局数据——从而使生成的代码匹配源文件,而非仅是近似还原。
Grok Build 究竟是什么
Grok Build 是 xAI 的终端编码代理,以 Grok Build 之名发布。它会读取你的代码仓库、编辑文件、运行 shell 命令,并根据自然语言任务规划多步骤的工程工作,而不仅仅是补全代码行。它围绕 xAI 的 Grok 模型构建——在 xAI API 上以 grok-build 模型系列提供——并通过你的 xAI 账户进行身份验证,因此代理和模型来自同一家供应商。

对于设计工作,有两个特性尤为突出。它有一个计划模式,可以在任何更改落地之前起草一份结构化的方案供你批准、评论或重写——当你在迭代 UI 时,这是一个有用的关卡。而且它的 Grok 模型接受图像输入,因此你可以给它一张参考截图,它会根据实际布局进行推理,而不是根据文字描述猜测。

上下文文件:Grok Build 会读取 AGENTS.md 文件以获取持久的项目上下文——这是编码你的设计规范、设计令牌和审查清单的自然位置。它遵循 Codex 和其他代理所使用的相同的开放 AGENTS.md 约定。

工具、MCP 和子代理:它可以编辑文件、运行 shell 命令,并支持 MCP 服务器以添加外部上下文,例如实时的 Figma 文件;对于较大的任务,它可以委派给并行的子代理,同时进行研究、构建和审查。

使用你的账户登录:你通过在浏览器中使用 SuperGrok 或 X Premium+ 订阅登录来进行身份验证;你也可以提供 xAI API 密钥用于无头环境和 CI 使用。

凭据:xAI SuperGrok OAuth(`grok login`),或用于无头使用的 xAI API 密钥(BYOK)

模型:xAI Grok 模型(xAI API 上的 grok-build 系列),支持图像输入

供应商:xAI
为什么计划模式和图像感知模型适合设计工作
Grok Build 的设计优势来自两个特性——但和每个代理一样,品味仍然需要由你提供。

图像感知推理:因为 Grok 模型接受图像输入,代理会读取参考截图——将其渲染输出与图像进行比较,而不是根据文字描述猜测。

更改落地前的计划模式:计划模式会先起草一份结构化的方案供你批准,然后文件才发生变化,因此设计意图是在前期审查,而不是在 diff 之后才发现。

在 AGENTS.md 中编写规范:AGENTS.md(加上 Figma MCP 服务器)将代理指向你的令牌、组件和真实规格,使其针对品牌而非默认外观进行工作。

品味来自你提供的三个输入:设计系统、技能和真实的参考图像。

教训与每个代理所教的一样:Grok Build 默认没有品味。当你给它约束——一个设计系统、一项美学技能和具体的参考资料时,它才能产出好的设计。OpenDesign 恰好打包了这些输入,这就是为什么两者能很好地配合(下文详述)。
从零开始为设计工作设置 Grok Build
设置顺序:安装 → 认证 → 配置 AGENTS.md → 添加技能 → 启用浏览器验证。

编码你的设计规则:将你的令牌、原始值和约定放入 AGENTS.md,并让 Grok 指向它们,这样输出就会符合品牌,而不是默认为通用外观。

添加浏览器验证:连接 Playwright 或浏览器 MCP,让 Grok 在真实浏览器中渲染,并跨断点检查其输出,而不仅仅是确认构建通过。

使用当前的设置章节查看命令和特定版本的详细信息,这些信息可能会变化。

# 1. Install Grok Build (Grok Build) on macOS/Linux curl -fsSL https://x.ai/cli/install.sh | bash # 2. Start it in your project and authenticate on first run cd your-project grok login # opens your browser; sign in with SuperGrok / X Premium+ # or, for headless / CI use, set an xAI API key: # export XAI_API_KEY=xai-... # 3. Add project context # create an AGENTS.md at the repo root with your design conventions # 4. Wire the Figma MCP server (optional, for design handoff) # add it to your MCP server configuration
历史命令示例来自之前的指南;请在链接的供应商文档中验证当前语法。
把截图变成 UI
使用 Grok Build 进行设计的最有效循环是将参考图像转化为可用的响应式 UI,并不断迭代直到匹配——依靠计划模式来商定方法,以及图像感知模型将输出与参考进行比较。

从你拥有的最清晰的视觉参考开始——并包含多种状态(桌面端和移动端、悬停、空状态、加载状态),而不仅仅是一张主图。

在提示中要具体;即使使用强大的模型,模糊的提示也会产生通用的 UI。

将你的设计系统和约定保存在 AGENTS.md 中,并告诉 Grok 令牌和规范原语的位置。

使用计划模式审查方法,然后运行开发服务器,让 Grok 在真实浏览器中渲染,调整到断点以检查结果。

通过让 Grok 将其实现与截图进行比较来迭代——而不仅仅是确认它能构建。

附上你的参考图像并给出具体的约束:

保持提示小而集中,提交好的迭代并回退差的迭代(回退时告诉 Grok),这样每次迭代都建立在干净的基础上。

grok # in the prompt (attach reference-desktop.png and reference-mobile.png): > Implement this design in React + Vite + Tailwind + TypeScript. Reuse my existing design-system components and tokens from AGENTS.md. Match spacing, layout, and hierarchy; make it responsive. Show me the plan first, then render it in the browser and iterate until it matches the references across breakpoints.
历史命令示例来自之前的指南;请在链接的供应商文档中验证当前语法。
AGENTS.md、MCP 和子代理
三个扩展点让 Grok Build 在持续设计工作中变得实用,并且这三个扩展点都能清晰地映射到开放式设计工作流上。

AGENTS.md 上下文:项目规则存放在仓库根目录的 AGENTS.md 中。它是设计规范的持久化家园,每次运行都会读取——并且它是其他智能体都能理解的同一种开放格式,因此这些规则会随你而行。

MCP 服务器:配置 MCP 服务器以引入设计上下文和外部工具,最相关的是 Figma MCP 服务器——这是将真实规格传入代码的可移植方式,适用于所有智能体,而不仅仅是 Grok。

子智能体和内置工具:Grok Build 可以同时生成并行子智能体来进行研究、构建和审查,而它的文件、shell 和搜索工具让它能够收集参考资料并运行验证循环,无需离开终端。

这些都是可移植的多智能体能力——正是 OpenDesign 设计来编排的那种东西,而不是每个项目都重新创建。
用于设计的 Grok Build vs Codex vs Claude Code vs Cursor vs Gemini CLI
在设计工作中没有单一的赢家——每个智能体都有不同的优势,经验丰富的团队会将它们组合使用。一个公正的总结:

Grok Build — 更改落地前进行计划模式审查,支持图像识别的 Grok 模型,以及并行子智能体;使用你的 SuperGrok 账户登录 — 适合由 xAI 模型参与的、经过审查的、计划优先的 UI 构建

Codex — 凭借前端技能实现强大的视觉打磨;沙箱化异步构建 — 适合委托式异步构建和可移植的 AGENTS.md 规则

Claude Code — 具体的设计决策(十六进制色值、间距、字体)以及代码库感知的 UX — 适合前端推理和大上下文重构

Cursor — 带实时预览和内联编辑的可视化构建并查看循环 — 适合在 IDE 内进行紧密的迭代观察式 UI 工作

Gemini CLI — 强大的多模态图像理解能力和非常大的上下文;开源并提供免费层级 — 适合截图密集型工作以及在上下文中容纳整个设计系统

社区反复得出的结论是品味来自人类:没有技能、参考资料和约束条件时,它们都会默认呈现通用的美学。这才是真正需要解决的问题——而且它是设计工具形态的问题,而非模型形态的问题。

智能体 — 设计优势 — 最适合
陷阱,以及如何避免“AI 垃圾”外观
关于 AI 生成设计最常见的抱怨是它看起来千篇一律——柔和的渐变、漂浮的面板、过大的圆角、夸张的阴影,以及一种 Inter 字体配紫色的氛围,简直“一眼就能看出是 AI 做的”。其他被报告的问题包括移动端布局损坏以及指令泄漏到 UI 文案中。这些都不是 Grok Build 独有的;任何智能体在没有经过策划的设计上下文下运行时都会出现这种情况。

添加美学技能:经过策划的设计技能会迫使智能体致力于真正的方向,而不是默认外观。

在真实浏览器中验证:跨断点渲染并自检,这样布局就不会在移动端悄悄损坏。

提供设计令牌和参考:真实的设计令牌和参考截图是提高输出质量的最大杠杆。

将规则写入 AGENTS.md:将“无英雄卡片、最多两种字体、品牌优先的层级”这类规则放在智能体每次运行都会读取的地方。

请注意,每一项缓解措施都是关于为智能体提供经过策划的设计上下文。逐个项目手动维护该上下文,正是 OpenDesign 所消除的苦差事。
在 OpenDesign 中使用 Grok Build 进行设计
OpenDesign 是上述工作流一直在需要的开源设计层。它将 Grok Build 视为第一方适配器,并用经过策划的技能和设计系统库、结构化的渲染管线以及本地桌面 UI 对其进行包装——因此使 Grok 表现出色的设计上下文从第一次运行起就已存在,而不是每次手动拼凑。OpenDesign 是独立的、基于 Apache-2.0 许可,并在你自己的机器上运行,这使得这种搭配天作之合。

使用你的 SuperGrok 账户或 xAI API 密钥(BYOK)进行身份验证——凭据保留在你的机器上,绝不会通过我们代理。

选择一个设计系统和一个技能,然后以一致的品味生成演示文稿、原型和着陆页。

每个工件和 DESIGN.md 文件都存放在你自己的仓库中,而不是托管云。

同样的 Grok Build 智能体,同样的凭据——外加一个真正、可移植、开源的设计工作流环绕其中。它是本地优先的并基于 Apache-2.0,因此你的工作或凭据的任何信息都不会离开你的机器。

安装 OpenDesign 并选择 Grok Build 作为你的智能体。
OpenDesign 是否与 xAI 有关联?
否。OpenDesign 是独立的;Grok 是 xAI 的商标。