Cursor OpenDesign

用 Cursor
在 OpenDesign
做设计。

如何在 OpenDesign 中用 Cursor 设计界面:用 Design Mode 在真实代码上进行可视化编辑,以 Figma 作为输入,一个从 brief 到经过评审的文件的定价页任务,以及开始前需要了解的限制。

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

一个完整的 Cursor 设计任务

一个 Cursor 设计任务:从简报到界面

本示例追踪一个任务:从你交付的简报和约束,到 Cursor 返回的产物,再到你在认定完成之前仍需运行的检查。下方界面是为本页面构建的说明性示例,并非录制的 Cursor 运行。

1设计 Brief 与约束条件

Brief

为开发者工具设计一个定价页面,包含三个套餐和月度/年度切换。将中间套餐设为推荐项,并让对比易于浏览。桌面端和手机端。

  • 设计系统现有的应用 token;Albert Sans;单一绿色强调色
  • 断点1440px 桌面端与 390px 移动端,无横向滚动
  • 交互计费切换、套餐 CTA 状态、FAQ 链接,以及切换控件的键盘焦点
  • 输出一个单一的自包含 HTML 文件,带有稳定的 data-od-id 钩子

2谁做什么:你、Cursor 和 OpenDesign

  • 你

    编写简报,选择设计系统,并定义验收标准。

  • Cursor

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

  • OpenDesign

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

  • 审查

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

3Cursor 产物:1440px 和 390px 下的定价页面

Cursor 产物:1440px 和 390px 下的定价页面 — 桌面端
示意性示例

4交付前审查

Layout

网格与间距

8px 网格上的三个等宽列;推荐套餐通过边框而非尺寸来突出。

Hierarchy

视觉层级

先价格,再套餐名称,然后功能;强调色出现在一个徽章和一个主按钮上。

Responsive

移动端布局

在移动端,套餐堆叠排列,推荐套餐位于最前;切换控件在顶部仍然可触达。

Interaction

交互检查

切换计费开关,使用 Tab 遍历每个 CTA,并打开一个 FAQ 链接。

Fit

Cursor 适合哪里——以及不适合哪里

Cursor 适用于

  • 设计模式。 通过点击、绘制或语音描述 UI 更改,Cursor 会编辑源代码——基于真实代码的视觉编辑。如果你正在决定 Cursor 应该被替换,还是与设计工作区搭配使用,请阅读OpenDesign 与 Cursor 的对比。
  • Figma → 代码。 Figma MCP 服务器向 Cursor 提供真实布局和 token,因此它基于设计而非截图来构建。OpenDesign 与 Figma 的对比 解释了画布到仓库的归属边界。
  • 双向 Figma。 一些 MCP 服务器让 Cursor 既能以编程方式读取和修改 Figma 设计,而不只是消费它们。
  • 设计到代码循环。 常见模式:在可视化工具中起草,将其带入 Cursor,然后用智能体细化和扩展。

选择其他工作流的场景

  • 你需要可编辑的矢量文件。 产物是 HTML,而不是可编辑的设计文档。对于需要矢量的资产格式,请寻找单独的矢量工作流。
  • 你没有参考,也没有约束。 没有设计系统或示例,输出会趋向通用外观;在开始之前先写简报。
  • 你没有此智能体所需的凭据。 必需:一个 Cursor 账户(使用你自己的提供商密钥)。OpenDesign 既不提供也不代理凭据。
  • 你的团队使用 Claude Code 或 Antigravity。 那些智能体有自己的页面;工作区是共享的,但设置不同。参见相关智能体。

兼容性

使用 Cursor 前的要求

本页将 Cursor 视为附加到 OpenDesign 桌面应用的智能体;它并不涵盖 Cursor 的每项功能。已发布的参考资料于 2026 年 9 月 6 日核查。

工具范围Cursor,由 Cursor 出品

Cursor 是一个基于 VS Code 的 AI 优先代码编辑器,内置智能体可在项目中跨文件编辑。这里的主题是通过 OpenDesign 使用该 Cursor 智能体进行界面设计,而不是 Cursor 自身的 UI。OpenDesign 的 设置说明 列出了可用的智能体。

账户与身份验证Cursor 账户(使用你自己的服务商密钥)

凭据:Cursor 账户(使用你自己的提供商密钥)。这些密钥由 Cursor 直接使用——OpenDesign 不会代理它们。此处不承诺任何配额或价格。

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

桌面版构建出现在下载页面。Node.js 和 pnpm 要求属于从源码运行 OpenDesign,而不是安装桌面包。本页未核实最低 Cursor 版本。

连接检查成功的标志

使用你安装的版本所显示的连接步骤,然后通过 Cursor 发送一个小任务。检查 Cursor 是否处理了它,以及生成的文件是否能打开。仅下载并不能证明连接可用。

从桌面应用开始

三步完成 Cursor 设置

安装桌面应用,完成你所拥有版本的 Cursor 连接步骤,然后用一个小结果验证。遵循此路径不需要从源码构建 OpenDesign。

  1. 1

    下载 OpenDesign 桌面应用

    选择与你的机器匹配的桌面包,安装并启动 OpenDesign。

    下载 OpenDesign
    检查点
    OpenDesign 启动。如果已经安装,继续下一步——不要再次下载。
  2. 2

    准备您的 Cursor 连接

    执行你的已安装版本所显示的 Cursor 设置。Cursor 直接使用你的提供商密钥;OpenDesign 不会代理它们。

    # .cursor/rules/design.mdc
    ---
    description: Project design conventions
    alwaysApply: true
    ---
    
    - Reuse existing design-system tokens and components; never hardcode hex or spacing.
    - At most two typefaces and one accent color.
    - Brand-first hierarchy; restrained motion. No hero cards, no oversized rounded corners.
    - Build responsive by default; verify desktop and mobile in the preview before finishing.

    取自已发布指南中的 Cursor 设置说明;当前命令应对照供应商文档进行检查。

    检查点
    确保所选智能体是 Cursor,并且账户是预期账户。如果 Cursor 不可用,在尝试更大任务之前查看兼容性。
  3. 3

    运行一个小型 Cursor 任务

    选择一个紧凑的首次请求,一个你能通过完整循环来评判的请求,包括一次修改。

    入门 brief

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

    检查点
    打开渲染后的文件,测试保存状态,并请求一个具体更改。生成的产物只是审查的开始,而不是结束。

对于基于源码的 OpenDesign 安装,请改用 技术快速入门。

Cursor 设计工作流

Cursor 的设计循环:从简报到已审查文件的五个步骤

跟随定价页面的流程,从简短简报开始,经过 Cursor 的 Agent 模式和编辑器内预览,到一份已审查的文件。每一步都说明你的输入、Cursor 的职责、OpenDesign 的贡献,以及你执行的检查。

  1. 1

    设计 Brief

    保持简洁明了——大约三到六行。说明该界面的服务对象、必须完成什么,以及面向哪些平台。

    • 您起草简报,并在有参考截图时附上。
    • Cursor读取 brief 和项目的说明文件;遇到不明确之处会提出询问。
    • OpenDesign提供项目、用于提示的聊天界面,以及与产物类型匹配的技能。
    • 检查检查简报是否包含验收标准。在生成之前确定它们,比事后修复成本更低。
  2. 2

    设计约束

    带上一个设计系统和几个明确约束。正是这些上下文让输出不偏离为通用外观。

    • 您选择设计系统,然后指明断点以及必须复用的任何组件。
    • Cursor在编写任何标记之前,Cursor 会将 DESIGN.md 的 token 和姿态规则读入上下文。
    • OpenDesignOpenDesign 承载设计系统库,并将你的选择绑定到技能模板中。
    • 检查根据你的品牌验证 token:单一强调色、正确的字体、正确的圆角。
  3. 3

    生成界面

    Cursor 生成一个自包含的 HTML 文件——包括布局、样式、交互和稳定钩子。

    • 您稍等,或者如果 Cursor 提出澄清问题就回复。这里无需配置。
    • CursorCursor 规划各个部分,编写 HTML、CSS 和 JavaScript,运行文件,并修正失败之处。
    • OpenDesignOpenDesign 将产物存储在项目文件夹中并为其建立索引,以便预览可以打开它。
    • 检查还不行。等到文件渲染后,再评判结果,而不是源代码。
  4. 4

    预览

    OpenDesign 会按你指定的宽度渲染文件。设计在此处——预览中——接受评判。

    • 你更改视口宽度,逐一测试每个交互,并直接在元素上留下评论。
    • CursorCursor 会读取你在预览中留下的评论,并准备下一版修订。
    • OpenDesignOpenDesign 渲染预览,并暴露 data-od-id 目标,供评论和编辑使用。
    • 检查检查层级、对比度、390px 下的溢出、焦点状态,以及强调色是否保持克制。
  5. 5

    修订与验证

    在预览中指向元素即可请求更改。每次修订都会生成为新文件——不会发生静默覆盖。

    • 你将你的评论转化为请求,并决定任务何时完成。
    • CursorCursor 会就地进行更改,并再次运行该文件。
    • OpenDesignOpenDesign 会将各版本并排保留,并在你完成时导出图片或 HTML。
    • 检查先只检查改动区域,然后在每个断点各完整查看整页一次。

资源

Cursor 设计资源

限制

Cursor 的限制、手动检查与回退方案

  • 范围本页将 Cursor 视为通过 OpenDesign 连接的智能体;它并不涵盖 Cursor 的每一项功能。
  • 使用限额成本和使用限制取决于实际使用的凭据(Cursor 账户(使用你自己的提供商密钥))。此处不作任何免费额度声明。
  • 网络将项目文件保存在本地并不会让推理在离线状态进行。在发送敏感输入之前,请检查该智能体的提供商设置和数据政策。
  • 输出为 HTMLCursor 返回的是 HTML 产物,而非可编辑的矢量设计文件。任何与 Figma 的往返都通过 Cursor 自有的 Figma 集成完成。
  • 人工审查在预览中,你是可访问性、真实内容、品牌契合度和交互正确性的审查者。智能体的自检只算作第一遍检查。
  • 后备方案当 Cursor 不可用或任务失败时,请查阅你所安装版本的连接说明和身份验证。在更改配置之前,请保留错误信息和最后一个可正常工作的产物。

常见问题

关于 Cursor 与 OpenDesign 的常见问题

Cursor 能交付真正的设计工作吗?
可以——在上下文中提供 skill、设计系统和真实的参考图片后,Cursor 能生成生产级质量的响应式 UI,其编辑器内预览功能可让你直观地验证与调整。若缺少这些上下文,它往往会默认输出通用外观,而这正是 OpenDesign 所填补的空白。
这是官方 Cursor 产品吗?
不是。OpenDesign 是一个独立的开源项目,将 Cursor 作为 Agent 集成其中。它以本地优先、开放的 skill 与设计系统库对 Cursor 进行补充。
用 Cursor 设计需要 Cursor 订阅吗?
你可以使用 Cursor 账户 / 订阅,也可以携带自己的模型密钥(BYOK)。无论哪种方式,OpenDesign 都不会代理你的凭据——它们直接由你的 Agent 使用。
前端设计:Cursor 与 Claude Code 对比?
两者都很强大。Claude Code 以做出具体且了解代码库的设计决策而知名;Cursor 的优势在于编辑器内紧密的“构建—查看”循环与实时预览。许多团队会同时使用两者——OpenDesign 让你在不改变设计工作流的前提下切换 Agent。
Cursor 如何连接 Figma?
在 Cursor 中添加官方 Figma MCP 服务器,然后将 Figma frame 链接粘贴到聊天中,让 Cursor 实现它。该服务器会暴露真实的组件、变量和布局数据,使生成的代码与源设计保持一致。
Cursor 的根基:AI 优先的 VS Code 分支
Cursor 是 Anysphere 打造的 AI 优先代码编辑器。它是 VS Code 的分支,因此保留了熟悉的编辑器、扩展和快捷键,但把工作流围绕一个 AI 智能体重建:这个智能体能读取你的整个项目、编辑多个文件、执行命令,并在循环中与你一起迭代。

就设计工作而言,关键界面包括 Agent 模式(你描述想要的结果,Cursor 规划并跨文件编辑)、用于快速微调的行内编辑与 Tab 补全、让你无需离开窗口就能看到运行中 UI 的编辑器内预览/浏览器,以及让它能引入实时 Figma 文件等外部上下文的 MCP 支持。

项目规则:Cursor 会读取项目指令文件——`.cursor/rules` 下带版本管理的 `.mdc` 规则,以及一份普通的 `AGENTS.md`——这样你就能把设计规范写在智能体每次运行都会读取的地方。

模型:Cursor 在模型选择上很灵活:它通过你的订阅提供前沿模型,同时也支持自带模型密钥,因此同一个编辑器工作流背后的引擎由你来定。

MCP:它支持 Model Context Protocol(模型上下文协议),因此外部服务器——最相关的就是 Figma MCP 服务器——会成为该智能体的一等上下文。

凭据:Cursor 账户 / 订阅(Hobby / Pro / Business),或你自己的模型密钥(BYOK)

形态:AI 优先的代码编辑器(VS Code 分支),内置编辑器内智能体与预览

厂商:Anysphere
Cursor 的设计优势:紧密的构建—查看闭环
Cursor 在设计上的优势并非某个单一功能,而在于“构建—查看”循环的紧凑程度。有三点让它更像一件设计工具,而不是通用的代码生成器。

紧凑的“迭代—观察”循环:你给出提示,Cursor 跨文件编辑,编辑器内预览立即渲染结果——于是你能在几秒内调整间距、层级和动效,而不必在单独的终端和浏览器之间来回折腾。

直接的视觉编辑:除了聊天,Cursor 还允许你在预览中选中元素并微调样式,让细小的视觉修正更像设计编辑,而不是代码考古。

项目规则与 MCP 上下文:借助 `.cursor/rules`(或 `AGENTS.md`)以及 Figma MCP 服务器,智能体依据你的设计令牌、组件和真实设计规格来工作,而不是靠猜。

品味来自你提供的三项输入:一套设计系统、一项技能,以及真实的参考图。

这个教训每个智能体都在反复教同一遍:Cursor 默认并没有品味。只有当你给出约束——一套设计系统、一项美学技能和具体的参考——它才会产出好的设计。OpenDesign 打包的恰恰就是这些输入,这也是两者能契合的原因(下文详述)。
从零开始为设计设置 Cursor
从 cursor.com 安装 Cursor,用你的 Cursor 账户登录,或者在设置中配置你自己的模型密钥(BYOK)。

打开项目,在聊天 / Agent 面板中选择一个模型。

添加项目规则:若要结构化的、按 glob 作用域生效的约定,就创建 `.cursor/rules/*.mdc`;若只是简单、易读的指令,就用一份普通的 `AGENTS.md`。

连接 Figma MCP 服务器(可选),让智能体能够读取实时的设计上下文。

启动你的开发服务器,并用编辑器内预览在迭代过程中查看和验证 UI。

配置顺序:安装 → 认证 → 配置项目规则 → 添加一项技能 → 启用预览验证。

一份最小的项目规则文件就能让智能体按品牌来设计,而不是默认滑向千篇一律的样子。把它放在 Cursor 每次运行都会读取的位置:

把你的设计规则写下来:把设计令牌、基础构件和约定放进 `.cursor/rules` 或 `AGENTS.md`,并让 Cursor 指向它们,这样产出就会契合品牌,而不会默认滑向千篇一律的样子。

让提示保持小:Cursor 的紧凑循环偏好聚焦的请求——一次只迭代一个组件或一种状态,并在每轮之间观察预览。

命令和特定版本的细节请以当前的配置章节为准,它们可能会发生变化。

# .cursor/rules/design.mdc --- description: Project design conventions alwaysApply: true --- - Reuse existing design-system tokens and components; never hardcode hex or spacing. - At most two typefaces and one accent color. - Brand-first hierarchy; restrained motion. No hero cards, no oversized rounded corners. - Build responsive by default; verify desktop and mobile in the preview before finishing.
此处为上一版指南中的历史命令示例;当前语法请以文末链接的厂商文档为准。
从预览到 UI 的工作流
用 Cursor 做设计,杠杆最高的循环就是把一张参考图变成能运行、可响应的 UI,并在编辑器里不断迭代直到与之吻合——全程盯着实时预览,而不是靠猜。

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

提示要具体;含糊的提示只会产出平庸的 UI。

准备好一套设计系统,并告诉 Cursor 设计令牌和标准基础构件放在哪里。

让编辑器内预览保持打开、开发服务器保持运行,这样每次编辑都会在你关心的断点上立即渲染。

通过把渲染出来的 UI 与参考图反复比对来迭代——小范围的视觉修正就用预览里的元素直接选中来改。

把图片附到聊天里来提供参考,然后用具体的约束来下提示:

好的迭代就提交,坏的迭代就回滚(回滚时告诉 Cursor),这样每一轮都建立在干净的基础上——这也是防止任何智能体循环跑偏的同一套纪律。

Implement this design in React + Vite + Tailwind + TypeScript. Reuse my existing design-system components and tokens. Match spacing, layout, and hierarchy; make it responsive. Keep the preview open — verify desktop and mobile match the references and iterate until they do.
此处为上一版指南中的历史命令示例;当前语法请以文末链接的厂商文档为准。
Cursor + Figma:通过 MCP 打通设计 ↔ 代码
Cursor 通过官方 Figma MCP 服务器连接 Figma,让智能体获得对实时 Figma 文件的结构化访问,而不是一张扁平截图。这让交付环节不再靠猜。

设计 → 代码:在 Figma 中复制某个画框的链接,粘贴到 Cursor 里,让它实现这个设计。MCP 服务器会暴露真实的设计上下文——组件、变量、布局数据、设计令牌——因此生成的代码是与源设计匹配,而不是近似模仿。

保持一致:当设计令牌、样式和组件在 Figma 中被一致地使用(在可用时结合 Code Connect),Cursor 的产出就能始终对应你真实的设计系统,而不是重新发明基础构件。

把远程 Figma MCP 服务器配置一次,它就会作为一等上下文对 Cursor 可用。由于 MCP 是开放标准,同一个服务器可以在 Cursor、Claude Code、Codex 和 VS Code 之间复用——这正是 OpenDesign 旨在编排的那种可移植、多智能体能力。
设计场景下 Cursor、Codex 与 Claude Code 的对比
在设计工作上并没有唯一的赢家——每个智能体各有所长,有经验的团队会把它们叠起来用。一个公允的总结:

Cursor — 可视化的“构建即所见”循环,带编辑器内实时预览与元素直接编辑 — 适合在 IDE 内做紧凑的“迭代—观察”式 UI 工作

Codex — 借助前端技能获得出色的视觉打磨;图像理解与沙箱化运行 — 适合委派的异步构建与可移植的 AGENTS.md 规则

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

社区反复得出的结论是:品味来自人。没有技能、参考和约束,这三者默认都会滑向平庸的审美。这才是真正要解决的问题——而它是设计工具层面的问题,不是模型层面的问题。

智能体 — 设计优势 — 最适合
避免“AI 味”外观:陷阱与修复方法
对 Cursor 生成的设计最常见的抱怨是:看起来千篇一律——柔和的渐变、悬浮的面板、过大的圆角、夸张的阴影,一股 Inter 字体加紫色的气息,“一看就是 AI 做的”。其他被反馈的问题还包括布局在移动端错乱,以及指令文字泄漏到 UI 文案里。

加入一项设计技能:一套精选的美学技能会迫使 Cursor 选定一个真实的方向,而不是落入默认样式。

用预览来验证:在编辑器内预览中跨断点渲染并自查,这样布局就不会在移动端悄无声息地崩掉。

提供设计令牌与参考图:真实的设计令牌和参考截图是对产出质量影响最大的单一杠杆。

把规则写进 `.cursor/rules`:把“不要主视觉卡片、最多两种字体、品牌优先的层级”这类规则放到智能体每次运行都会读取的地方。

注意,每一条缓解措施本质上都是给智能体一份精选的设计上下文。而逐项目、纯手工地维护这份上下文,正是 OpenDesign 要消除的苦差。
OpenDesign 中的 Cursor:设计层
OpenDesign 就是上文那套工作流一直在呼唤的开源设计层。它把 Cursor 当作一等适配器,并用精心挑选的技能与设计系统库、结构化的渲染流水线以及本地桌面 UI 将其包裹起来——于是让 Cursor 变好的那份设计上下文,从第一次运行起就已就位,而不是每次靠手工拼装。

用你的 Cursor 账户或你自己的模型密钥(BYOK)进行认证——凭据留在你的机器上,绝不会经由我们代理。

选一套设计系统和一项技能,然后生成品味一致的演示文稿、原型和落地页。

每一个产物和 DESIGN.md 文件都存放在你自己的代码仓库里,而不是托管在云端。

同一个 Cursor 智能体、同一把密钥——再加上围绕它的真实、可移植、开源的设计工作流。它本地优先并采用 Apache-2.0 许可,因此你的工作和凭据都不会离开你的机器。

安装 OpenDesign,并选择 Cursor 作为你的智能体。
OpenDesign 与 Cursor 有关联吗?
没有。Cursor 是 Anysphere 的产品;OpenDesign 是一个独立开源项目,仅将其作为一等适配器进行集成。