延伸阅读
Gemini 延伸阅读
发布指南中列出的、使用 Gemini 进行设计的教程、文档与操作演示。
Gemini 
OpenDesign 用 Gemini
在 OpenDesign
做设计。
如何在 OpenDesign 中使用 Gemini CLI 设计界面：以白板照片作为参考，以 GEMINI.md 作为规则手册，一个从 brief 到审核完成文件的运营仪表盘任务，以及开始之前需要了解的局限。
从 brief 到界面01 / Gemini
您带来想法↗
“从一张白板照片
到一个可读的仪表盘。”
一个完整的 Gemini 设计任务
一个 Gemini 设计任务：从 brief 到界面
完整呈现一个任务：你提交的 brief 与约束条件、返回的产物，以及在完成之前你仍需运行的检查。下方界面是为本页面制作的示例说明，并非 Gemini 的实际运行记录。
1设计 Brief 与约束条件
Brief根据附带的白板照片设计一个运营仪表盘：四个关键数字、一张每周量图和一个事件队列。桌面端为单屏，手机端为可滚动摘要。
- 设计系统OpenDesign 纸感画布：Albert Sans，单一绿色强调色
- 断点1440px 桌面端与 390px 移动端，无横向滚动
- 交互日期范围、事件筛选、通过键盘在队列中导航
- 输出一个自包含的 HTML 文件，带有稳定的
data-od-id挂钩
2分工：你、Gemini 与 OpenDesign
- 你
撰写 brief，选择设计系统并定义验收标准。
- Gemini
规划布局，编写 HTML、CSS 和 JavaScript，并按要求进行修改。
- OpenDesign
提供设计系统与 skill，渲染预览，并将每个版本作为文件存储在项目中。
- 审查
在交付前，检查视觉层级、8px 网格上的间距、两个断点以及每一项交互。
3Gemini 产物：1440px 与 390px 下的运营看板
4交付前审查
Layout
网格与间距
四张卡片、图表和队列共用一套 8px 网格；在 1440 或 390 下均不出现重叠。
Hierarchy
视觉层级
先读到关键数字，再是图表，然后是队列；强调色只标出一根柱子和一个关键状态标签。
Responsive
移动端布局
每行两个数字，图表在下方，队列以列表呈现；日期范围收进一个抽屉面板。
Interaction
交互检查
切换范围、筛选关键项，用方向键在队列中移动。
Fit
Gemini 适合什么任务，不适合什么任务
Gemini 适合的场景
- 多模态截图转 UI。强大的图像理解能力可将参考图转换为响应式标记，并对照原图检查结果。
- 1M-token 上下文。整个设计系统、组件库和参考素材可一次性容纳，因此输出会复用您真实的基础组件。
- GEMINI.md + MCP。上下文文件承载您的约定；Figma MCP 服务器将真实设计上下文引入代码。
- 开放且可免费开始使用。基于 Apache-2.0 协议，通过 Google 账号提供充足的免费额度，并支持通过 Gemini API 使用 BYOK。
选择其他工作流的场景
- 你需要可编辑的矢量文件。 产物是 HTML，而非可编辑的设计文档。请查看其他矢量工作流以获取所需的资源格式。
- 没有参考图也没有约束条件。 缺少设计系统或示例时，输出往往趋于千篇一律；请先写好 brief。
- 您没有此 Agent 所需的凭据。所需：Google 账户（免费层级）或 Gemini API key（自带 key）。OpenDesign 不提供也不代理凭据。
- 您的团队使用 Antigravity 或 Claude Code 工作。这些 Agent 有各自的页面；工作区相同，配置不同。参见相关 Agent。
兼容性
开始使用 Gemini 前的准备事项
本指南介绍通过 OpenDesign 桌面应用连接的 Gemini。已核实的公开参考资料截至 2026 年 9 月 6 日。
工具范围Gemini，由 Google 打造
Gemini CLI 是 Google 开源（Apache-2.0）的终端 AI Agent。它可以读取你的代码库、编辑文件、运行命令、抓取网页内容，并使用 Google 搜索为回答提供依据。本页介绍如何通过 OpenDesign 使用 Gemini 设计界面，而非 Gemini 自身的界面。OpenDesign 的设置说明列出了可用的 Agent。
账户与身份验证Google 账户（免费层级）或 Gemini API
Google 账户（免费层级）或 Gemini API key（BYOK）。使用你的 Google 账户或 Gemini API key（BYOK）进行身份验证——凭据保留在你的本机上。本页不承诺配额或价格。
系统与版本桌面应用或源码
请查看下载页面获取桌面版构建。源代码快速入门中列出的 Node.js 和 pnpm 要求适用于从源代码运行，而非安装桌面版软件包。最低兼容 Gemini 版本：本文未验证。
连接检查成功的标志
按照你安装版本中显示的连接说明操作，然后运行一个小任务。确认 Gemini 已处理该任务，且产物可以打开。仅下载并不能建立可用的连接。
从桌面应用开始
三步完成 Gemini 设置
先下载，为你安装的版本完成 Gemini 设置，然后检查一个小结果。按照此路径操作，你不需要从源代码构建 OpenDesign。
- 1
下载 OpenDesign 桌面应用
选择适合您电脑的软件包，安装并打开该应用。
下载 OpenDesign检查点桌面应用会打开。已经安装过？请进入下一步；无需再次下载。 - 2
准备你的 Gemini 连接
按照你安装版本中的 Gemini 说明操作。使用你的 Google 账户或 Gemini API key（BYOK）进行身份验证——凭据保留在你的本机上。
Gemini CLI 文档# 1. Install Gemini CLI (Node 20+) npm install -g @google/gemini-cli # or run without installing: npx https://github.com/google-gemini/gemini-cli # 2. Start it in your project and authenticate on first run cd your-project gemini # sign in with your Google account, or set GEMINI_API_KEY摘自已发布指南中的 Gemini 设置说明；请查阅供应商文档以获取当前命令。
检查点确认目标 Agent 与账户。如果不可用，请在尝试更大任务之前先检查兼容性。 - 3
运行一个小型 Gemini 任务
使用一个小 brief，以便您评估整个流程，包括一次修改。
入门 brief构建一个设置页面，包含个人资料表单和保存确认提示。使用我的设计规则。在桌面和移动端宽度下进行检查。
检查点打开结果，测试保存状态，并提出一个具体的修改请求。生成的文件是评审的开始，而不是结束。
若要从源代码运行 OpenDesign，请参阅技术快速入门。
Gemini 设计工作流
五步完成 Gemini 设计工作流
同一个运营看板任务，从 brief 到通过验证的文件全程记录。每一步都列出你提供的内容、Gemini 所做的工作、OpenDesign 贡献的部分，以及你需要检查的内容。
- 1
设计 Brief
用简明语言写三到六行，说明目标受众、该界面要完成的任务，以及适用的平台。
- 您撰写 brief；如有参考截图，请附上。
- Gemini读取 brief 和项目的指令文件；遇到模糊之处会提出询问。
- OpenDesign提供项目、prompt 界面，以及对应产物类型的 skill。
- 检查确认 brief 中已写明验收标准。现在补充比生成之后再补充成本更低。
- 2
设计约束
一套设计系统加几条硬性规则。正是这些将符合品牌调性的产出与千篇一律的效果区分开来。
- 您选择一个设计系统；说明断点及必须使用的组件。
- Gemini在写下第一行代码之前，将 DESIGN.md 中的 token 和风格规则加载到上下文中。
- OpenDesign提供设计系统库，并将所选设计系统绑定到 skill 模板中。
- 检查确认 token 与您的品牌相符：单一强调色、正确的字体、正确的圆角。
- 3
生成界面
Gemini 编写一个自包含的 HTML 文件：布局、样式、交互和稳定的 hooks。
- 您等待即可，或回答澄清性问题。无需进行任何配置。
- Gemini规划各个部分，编写 HTML、CSS 和 JavaScript，运行文件并修复失败之处。
- OpenDesign将产物保存到项目文件夹中，并为预览建立索引。
- 检查此步骤暂无需检查。请在文件渲染后进行判断，而非查看源代码。
- 4
预览
文件会以你要求的宽度在 OpenDesign 中渲染。设计的好坏就在这里被检验。
- 你切换宽度，点击交互，在元素上留下评论。
- Gemini读取你在预览上的评论，并准备下一版修订。
- OpenDesign渲染预览，暴露
data-od-id目标以供评论和编辑。 - 检查层级结构、对比度、390px 下的溢出、焦点状态，以及强调色是否使用得克制。
- 5
修订与验证
通过在预览中指向元素来请求修改。每次修订都是一个新文件，绝不会被静默覆盖。
- 你把评论转化为请求；决定任务何时完成。
- Gemini就地应用更改并重新运行文件。
- OpenDesign将各版本并排保留；完成后导出图片或 HTML。
- 检查只重新检查发生变化的区域，然后在每个断点上完整检查一次整页。
资源
Gemini 设计资源
限制
Gemini 的局限、人工检查与回退方案
- 范围本页介绍的是作为连接到 OpenDesign 的 Agent 的 Gemini，而非 Gemini 的全部功能。
- 使用限额使用限额与费用取决于你使用的凭证（Google 账户免费额度或 Gemini API key）。本页对免费额度不作任何承诺。
- 网络本地项目文件并不代表离线推理。在分享敏感输入之前，请检查你的 Agent 供应商设置和数据政策。
- 输出为 HTML产物是 HTML 文件，而非矢量设计文件。
- 人工审查可访问性、真实内容、品牌契合度和交互正确性均由你在预览中审查。将 Agent 的任何自检视为初步检查。
- 后备方案如果 Agent 不可用或任务失败，请检查所安装版本的连接说明和身份验证。在更改配置前，请保留错误信息和最后一个可用的产物。
常见问题
关于 Gemini 与 OpenDesign 的常见问题
Gemini CLI 真的能胜任设计工作吗？
可以——只要在上下文中提供审美 skill、设计系统和真实参考图片，Gemini CLI 就能产出可用于生产的高质量响应式 UI，其强大的多模态模型会根据参考图核对输出结果。缺少这些上下文时，它往往会退回到通用外观，这正是 OpenDesign 要填补的空白。
使用 Gemini CLI 进行设计需要付费吗？
不需要——使用 Google 账户登录即可获得较为宽裕的免费额度，你也可以自带 Gemini API key（BYOK）或使用 Vertex AI。无论哪种方式，OpenDesign 都不会代理你的凭证。
Gemini CLI 在设计方面具体有什么优势？
主要有两点：其模型具有很强的多模态能力，能很好地读取参考截图；同时 1M-token 的上下文可以一次性容纳整个设计系统和参考集。这两点都有帮助——但审美最终仍来自你提供的设计系统、skill 与参考资料。
前端设计该选 Gemini CLI 还是 Claude Code？
两者都很出色。Claude Code 以贴合代码库的具体设计决策著称；Gemini CLI 的优势在于多模态理解能力，加上超大上下文和免费额度。许多团队会同时使用两者——OpenDesign 让你在不改变设计工作流的情况下自由切换 Agent。
如何将 Gemini CLI 连接到 Figma？
在 ~/.gemini/settings.json 的 mcpServers 下添加 Figma MCP 服务器。之后 Gemini 就能拉取真实的设计上下文——组件、变量、布局数据——使生成的代码与源文件保持一致，而不是仅做近似还原。
用 Gemini 开始你的第一个设计任务
从一个小任务开始，评估往返效果，然后再提交真实的 brief。请选择与您的环境相符的选项；本页不会自动检测。