Mistral Vibe OpenDesign

用 Mistral Vibe
在 OpenDesign
做设计。

如何在 OpenDesign 中用 Mistral Vibe CLI 设计界面:一个可本地运行或使用你自己密钥的 Devstral 模型,一项从 brief 到审核完成文件的产品页任务,以及开始前需要了解的限制。

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

一个完整的 Mistral Vibe 设计任务

从需求简述到界面:一个 Mistral Vibe 设计任务

你提供需求简述和约束条件;Mistral Vibe 返回一个产物;随后你完成剩余的检查,才能称其完成。下面的界面是为本页面创建的示例性示例,并非一次实际记录的 Mistral Vibe 运行。

1设计 Brief 与约束条件

Brief

为一家陶艺工作室商店创建一个产品页面:大图、价格、数量和釉色选项、一个加入购物车控件,以及三件相关作品。本地模型,本地文件。桌面端和手机端。

  • 设计系统OpenDesign 纸感画布 —— Albert Sans,单一绿色强调色
  • 断点1440px 桌面端和 390px 移动端,无横向滚动
  • 交互图库、釉色选择、数量,以及加入购物车
  • 输出单个自包含的 HTML 文件,带有稳定的 data-od-id 钩子

2各自负责什么:你、Mistral Vibe 和 OpenDesign

  • 你

    你撰写需求简述、选择设计系统并设定验收标准。

  • Mistral Vibe

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

  • OpenDesign

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

  • 审查

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

3Mistral Vibe 产物:1440px 和 390px 下的店铺页面

Mistral Vibe 产物:1440px 和 390px 下的店铺页面 — 桌面端
示意性示例

4交付前审查

Layout

网格与间距

图片和信息都落在 8px 网格上;图片在所有宽度下都保持 4:5 比例。

Hierarchy

视觉层级

名称和价格领先;强调色只出现在加入购物车按钮上。

Responsive

移动端布局

先是照片,然后是名称与价格、釉色标签、一个全宽按钮;相关作品可滚动查看。

Interaction

交互检查

选择一种釉色,更改数量,加入购物车,滚动浏览相关作品。

Fit

Mistral Vibe 适合的场景 —— 以及不适合的场景

Mistral Vibe 适合以下情况

  • Devstral 编码模型。 经过编码调优的智能体式模型可以在真实的前端代码库中进行编辑,而不是输出孤立的代码片段。
  • 开放权重且对本地友好。 Devstral Small 2 可在消费级硬件上运行,因此设计工作可以完全在本地和离线完成。
  • config.toml + MCP。 项目配置承载着智能体的接线方式;Figma MCP 服务器将真实的设计上下文引入代码。
  • 开放且原生支持 ACP。 采用 Apache-2.0 许可并构建于 Agent Client Protocol 之上,通过 Mistral API 支持 BYOK。

选择其他工作流的场景

  • 你需要可编辑的矢量文件。 该产物是 HTML,而不是可编辑的设计文档。若你需要特定的素材格式,请考虑单独的矢量工作流。
  • 没有参考图也没有约束条件。 缺少设计系统或示例时,输出往往趋于千篇一律;请先写好 brief。
  • 您没有此 Agent 所需的凭证。需要:Mistral API key(自带密钥)或本地模型。OpenDesign 不提供也不代理凭证。
  • 你的团队使用 OpenCode 或 Aider。 这些智能体各有自己的页面;设置方式因智能体而异。请参阅相关智能体。

兼容性

开始之前 Mistral Vibe 需要满足哪些要求

本指南介绍通过 OpenDesign 桌面应用连接的 Mistral Vibe。所查阅的公开参考资料日期为 2026 年 9 月 6 日。

工具范围Mistral Vibe,由 Mistral AI 提供

Mistral Vibe CLI 是 Mistral AI 的开源(Apache-2.0)终端编码智能体。它会扫描项目文件和 Git 状态、编辑代码、搜索、运行命令,并通过自然语言任务处理版本控制。本页面讨论的是通过 OpenDesign 使用 Mistral Vibe 进行界面设计,而非 Mistral Vibe 自身的界面。OpenDesign 的设置说明列出了可用的智能体。

账户与身份验证Mistral API key(BYOK)或本地模型

Mistral API 密钥(BYOK)或本地模型。使用你的 Mistral API 密钥(BYOK)或本地模型进行身份验证 —— 凭据保留在你的机器上。本页面不承诺任何配额或价格。

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

桌面版构建请参阅下载页面。源码快速开始中的 Node.js 和 pnpm 要求适用于从源码运行,而不适用于安装桌面软件包。最低兼容的 Mistral Vibe 版本:此处未经验证。

连接检查成功的标志

按照你所安装版本显示的连接说明操作,然后运行一个小任务。确认 Mistral Vibe 已处理该任务,并且产物可以打开。仅下载并不代表已建立可用的连接。

从桌面应用开始

三步设置 Mistral Vibe

先下载,针对你所安装的版本完成 Mistral Vibe 设置,然后检查一个小结果。此路径无需从源码构建 OpenDesign。

  1. 1

    下载 OpenDesign 桌面应用

    选择适合你电脑的软件包,安装并打开应用。

    下载 OpenDesign
    检查点
    桌面应用打开。已经安装过?进入下一步;无需重新下载。
  2. 2

    准备你的 Mistral Vibe 连接

    按照你已安装版本中的 Mistral Vibe 说明操作。使用你的 Mistral API key(BYOK)或本地模型进行身份验证——凭据保留在你的设备上。

    mistral-vibe README 与设置说明(GitHub)
    # 1. Install Mistral Vibe CLI
    uv tool install mistral-vibe
    # or: pip install mistral-vibe
    
    # 2. Run the setup wizard to register your API key
    vibe --setup     # saves config to ~/.vibe/config.toml and ~/.vibe/.env
    #    or set it directly:  export MISTRAL_API_KEY=...

    摘自已发布指南中的 Mistral Vibe 设置说明;请查阅厂商文档以获取当前命令。

    检查点
    确认目标智能体和账户。如果不可用,请先检查兼容性,再尝试更大的任务。
  3. 3

    运行一个小型 Mistral Vibe 任务

    让需求简述保持简短,以便你能判断完整的循环,包括一次修改。

    入门 brief

    构建一个设置页面,包含个人资料表单和保存确认提示。使用我的设计规则。在桌面和移动端宽度下进行检查。

    检查点
    打开结果,测试保存状态,并提出一项具体的修改。生成只是评审的开始,并不代表评审已完成。

若要从源代码运行 OpenDesign,请参阅技术快速入门。

Mistral Vibe 设计工作流

Mistral Vibe 设计任务的五个步骤

一个店铺页面,从书面需求简述一路走到你已验证过的文件。每个步骤都指明你的输入、Mistral Vibe 的工作、OpenDesign 的贡献,以及仍需你完成的检查。

  1. 1

    设计 Brief

    三到六句平实的句子。说明这个屏幕为谁服务、它必须完成什么,以及它需要支持哪些平台。

    • 您起草需求简述。如果有参考截图,一并附上。
    • Mistral Vibe结合项目说明文件解析需求简述,并在行动前就任何含糊之处进行询问。
    • OpenDesign提供项目、提示界面,以及与产物类型相匹配的技能。
    • 检查检查需求简述是否明确写清了验收标准;在这里把它们写清楚,比事后修复输出代价更低。
  2. 2

    设计约束

    一套设计系统加上几条明确的规则。正是这种组合让输出符合品牌调性,而非千篇一律。

    • 您选择一套设计系统,指明断点,并列出必须出现的任何组件。
    • Mistral Vibe在写下任何一行代码之前,先将 DESIGN.md 令牌和基调规则拉入上下文。
    • OpenDesign提供设计系统库,并将你的选择绑定到技能模板中。
    • 检查对照你的品牌验证令牌:单一强调色、正确的字体、正确的圆角。
  3. 3

    生成界面

    Mistral Vibe 输出的是一个自包含的 HTML 文件 —— 布局、样式、交互和稳定的钩子。

    • 您无需配置。等待即可,或者如果有澄清问题就回答它。
    • Mistral Vibe规划各个区块,编写 HTML、CSS 和 JavaScript,执行该文件,并修复任何失败之处。
    • OpenDesign将产物存储在项目文件夹中并为其建立索引,以便可以预览。
    • 检查先别急。要在文件渲染之后评判它,而不是去读源代码。
  4. 4

    预览

    在 OpenDesign 里,文件会按你指定的宽度渲染——被评判的是那份渲染结果,而不是代码。

    • 你在不同宽度之间切换,试用各项交互,并对单个元素发表评论。
    • Mistral Vibe收集你的预览评论,并安排好下一轮修订。
    • OpenDesign渲染预览,并暴露 data-od-id 目标,用于锚定评论和编辑。
    • 检查层级、对比度、390px 下的溢出、焦点状态,以及强调色是否保持克制。
  5. 5

    修订与验证

    指着预览中的元素即可提出修改。每次修订都会生成一个新文件——任何东西都不会在你没看到的情况下被覆盖。

    • 你把评论转化为请求,并宣布任务完成。
    • Mistral Vibe就地应用所请求的修改,然后重新运行该文件。
    • OpenDesign把各版本并排展示,最后导出图片或 HTML。
    • 检查先单独复查改动过的区域,再按每个断点完整过一遍整个页面。

资源

Mistral Vibe 设计资源

限制

Mistral Vibe 的局限、人工检查与回退方案

  • 范围以下内容涵盖的是接入 OpenDesign 的 Mistral Vibe agent——而非该 CLI 发布的全部功能。
  • 使用限制成本与用量限制取决于你自带哪种凭据——Mistral API 密钥或本地模型。此处不对免费额度作任何声明。
  • 网络仅有本地项目文件并不等于推理是离线的。在提交敏感输入之前,请检查提供商设置与数据政策。
  • 输出为 HTML返回的是一个 HTML 文件,而不是矢量设计文件。
  • 人工审查无障碍性、真实内容、品牌契合度与交互正确性都需要你在预览中自行审查;agent 执行的任何自检都只算第一遍。
  • 后备方案当 agent 无法连接或任务失败时,请查阅你所安装版本的连接说明与身份验证。在改动配置之前,先保留错误文本和最后一个可用产物。

常见问题

关于 Mistral Vibe 与 OpenDesign 的常见问题

Mistral Vibe CLI 真的能胜任设计工作吗?
是的 —— 在拥有美学 skill、设计系统以及上下文中的真实参考资料的情况下,Vibe CLI 能生成可用于生产环境的响应式 UI,其 Devstral 模型可以在真实的前端代码库中进行编辑。如果没有这些上下文,它往往会默认输出通用外观,这正是 OpenDesign 填补的空白。
如何验证 Vibe CLI 的身份?
运行 vibe --setup 启动设置向导,注册 Mistral API key(可从 Mistral 控制台获取),或在环境变量中设置 MISTRAL_API_KEY。它也可以在完全离线的情况下针对本地或兼容模型运行。无论哪种方式,OpenDesign 都不会代理您的凭据。
Vibe CLI 在设计方面具体有哪些优势?
它是一个 Apache-2.0 协议下的原生 ACP Agent,由 Mistral 的开放权重 Devstral 编程模型驱动 —— 因此您可以在本地运行它来处理隐私敏感的工作,并在真实代码库中进行编辑。但审美判断仍然来自您提供的设计系统、skill 和参考资料。
前端设计该选 Vibe CLI 还是 Claude Code?
两者都很出色。Claude Code 以具体、了解代码库的设计决策著称;Vibe CLI 的优势在于可本地运行的开放权重 Devstral 技术栈以及 Apache-2.0 许可证。许多团队会同时使用两者 —— OpenDesign 让您可以切换 Agent 而不必改变设计工作流。
如何将 Vibe CLI 连接到 Figma?
在 config.toml 中以 [[mcp_servers]] 条目的形式添加 Figma MCP 服务器。这样 Vibe 就能获取真实的设计上下文 —— 组件、变量、布局数据 —— 使生成的代码与源文件一致,而不只是近似还原。
具体来说,Mistral Vibe CLI 是什么
Mistral Vibe CLI 是 Mistral AI 为终端推出的开源(Apache-2.0)编程智能体。它提供交互式聊天界面,并配有文件操作、代码搜索、版本控制和命令执行工具,还会自动扫描项目的文件结构和 Git 状态,为智能体提供相关上下文。它由 Mistral 的 Devstral 编程模型驱动——能根据自然语言任务进行规划与验证,而不只是补全代码行。

就设计工作而言,有两点格外突出。它运行在 Mistral 的开源权重 Devstral 系列(Devstral 2 以及更小的 Devstral Small 2)之上,因此你既可以让智能体对接云端的 Mistral API,也可以对接本地模型——这对隐私敏感或离线的设计工作很有用。它还支持 Agent Client Protocol,因此同一个智能体可以驱动编辑器和各种工具,而不局限于一个终端会话。

配置文件:Vibe CLI 通过 config.toml 文件配置(项目级为 ./.vibe/config.toml,回退路径为 ~/.vibe/config.toml)。这里是把服务商、模型选择和项目设置写下来的实用位置。

内置工具 + MCP:它自带文件、搜索、版本控制和命令执行工具,并支持 MCP 服务器(在 [[mcp_servers]] 段落下配置),用于引入实时 Figma 文件之类的外部上下文。

BYOK 或本地:用 Mistral 控制台的 Mistral API 密钥完成认证,或者将它指向本地/兼容模型,从而完全离线运行。

凭据:来自 Mistral 控制台的 Mistral API 密钥(BYOK),或本地/兼容模型

厂商:Mistral AI

许可证:Apache-2.0,开源
为什么开源权重的编程智能体适合设计
Vibe CLI 在设计上的优势来自它的开源权重模型系列和协议覆盖面——但和每一个智能体一样,品味仍然得由你来提供。

Devstral 编程模型:Vibe 运行在 Mistral 的 Devstral 系列之上,这些是为智能体式、多文件工作而打造的编程调优模型——因此智能体会在真实的前端代码库中跨文件修改,而不是输出孤立的代码片段。

开源权重、对本地友好:Devstral Small 2 足够小,可以跑在消费级硬件上,因此设计工作可以完全本地、离线进行——参考素材和代码永远不必离开你的机器。

config.toml 中的约定 + 上下文:项目配置和你自己的指令会把智能体引向你的 token、组件和真实规格,因此它是围绕某个品牌来工作,而不是套用默认外观。

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

这里得到的教训和每一个智能体教给我们的都一样:Vibe CLI 默认没有品味。只有当你给它约束——一套设计系统、一项审美技能和具体的参考图——它才能产出好的设计。OpenDesign 正好把这几项输入打包好了,这正是两者契合的原因(详见下文)。
从零开始把 Vibe CLI 配置到可用于设计工作
搭建顺序:安装 → 认证 → 配置 config.toml → 添加技能 → 启用浏览器验证。

把你的设计规则写下来:把 token、基础组件和约定放在智能体能读到的地方,并让 Vibe 指向它们,这样输出就会贴合品牌,而不是退回通用外观。

加入浏览器验证:接入 Playwright 或浏览器 MCP,让 Vibe 在真实浏览器中渲染,并在各个断点检查自己的输出,而不是只确认构建通过。

具体的命令和版本相关细节请以当前“安装设置”章节为准,这些内容可能会变化。

# 1. 安装 Mistral Vibe CLI uv tool install mistral-vibe # 或:pip install mistral-vibe # 2. 运行设置向导以注册你的 API 密钥 vibe --setup # 将配置保存到 ~/.vibe/config.toml 和 ~/.vibe/.env # 或直接设置:export MISTRAL_API_KEY=... # 3. 在你的项目中启动 Vibe cd your-project vibe # 4. 接入 Figma MCP 服务器(可选,用于设计交接) # 在 config.toml 中添加一个 [[mcp_servers]] 条目
这是上一版指南中的历史命令示例;请到所链接的厂商文档中核对当前语法。
把参考素材转化为 UI
用 Vibe CLI 做设计,回报最高的一环是把一张清晰的参考图变成可用、响应式的 UI,并不断迭代直到它吻合——依靠智能体的工具来渲染、检查并修正自己的输出。

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

提示词要具体;即便模型再强,含糊的提示也只会产出千篇一律的 UI。

把你的设计系统和约定放在 Vibe 能读到的地方,并告诉它 token 和标准基础组件在哪里。

启动开发服务器,让 Vibe 在真实浏览器中渲染,并调整到各个断点来检查结果。

迭代的方式是让 Vibe 把自己的实现与参考图对照——而不只是确认它能构建成功。

用 @ 引用文件(Vibe 会自动补全文件路径),用 / 驱动斜杠命令,然后给出具体的约束:

让提示保持简短、聚焦,把好的迭代提交、把差的回滚(回滚时也告诉 Vibe),这样每一轮都建立在干净的基线上。

vibe # 在提示词中: > @design-spec.md @tokens.css Implement this design in React + Vite + Tailwind + TypeScript. Reuse my existing design-system components and tokens. Match spacing, layout, and hierarchy; make it responsive. Run the dev server, render it in the browser, and iterate until it matches the references across breakpoints.
这是上一版指南中的历史命令示例;请到所链接的厂商文档中核对当前语法。
config.toml、MCP 与 ACP
有三个扩展点让 Vibe CLI 能胜任长期的设计工作,而且这三者都能干净地映射到开放的设计工作流上。

config.toml:项目规则和提供商/模型设置都放在 config.toml 里(项目级,并带有 ~/.vibe 回退)。它是智能体如何接入你的项目的长期归属地,每次运行都会被读取。

MCP 服务器:在 config.toml 中配置 MCP 服务器([[mcp_servers]],支持 HTTP、streamable-HTTP 和 stdio 传输)——这是引入设计上下文和外部工具的可移植方式,其中最关键的是 Figma MCP 服务器,它跨智能体通用,而不只适用于 Vibe。

Agent Client Protocol:Vibe 支持 ACP,因此同一个智能体可以从编辑器和其他 ACP 客户端驱动。OpenDesign 正是这样集成它的——通过 vibe-acp 二进制文件走 ACP。

这些都是可移植、跨多个智能体的能力——正是 OpenDesign 被设计来编排、而不是在每个项目里重复造的东西。
面向设计:Vibe CLI vs Codex vs Claude Code vs Cursor vs Gemini CLI
在设计工作上没有唯一赢家——每个智能体强项不同,有经验的团队会把它们组合起来使用。一个公道的总结:

Mistral Vibe CLI —— 可以本地运行的开源权重 Devstral 编程模型;Apache-2.0 且原生支持 ACP —— 隐私敏感或离线的设计工作,以及开源权重技术栈

Codex —— 配合前端技能有很强的视觉打磨能力;沙箱内的异步构建 —— 委派式异步构建和可移植的 AGENTS.md 规则

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

Cursor —— 配合实时预览和内联编辑的“边构建边看”循环 —— 在 IDE 内紧密地迭代并观察 UI 的工作

Gemini CLI —— 强大的多模态图像理解和极大的上下文窗口 —— 大量依赖截图的工作,以及把整套设计系统放进上下文

社区反复得出的结论是:品味来自人。如果没有技能、参考图和约束,它们全都会默认滑向千篇一律的审美。这才是真正要解决的问题——而且它是设计工具形态的问题,不是模型形态的问题。

智能体 —— 设计优势 —— 最适合
常见陷阱与如何避免“AI 味”
关于 AI 生成设计最常见的抱怨就是它看起来千篇一律——柔和的渐变、悬浮面板、过大的圆角、夸张的阴影,一股 Inter 加紫色的调调,让人“一眼就看出是 AI 做的”。其他被反馈的问题还包括移动端布局崩坏,以及指令文字泄漏到界面文案里。这些都不是 Vibe CLI 独有的;任何智能体在缺少精心设计上下文的情况下运行,都会这样。

加上一项审美技能:一项精心打磨的设计技能会迫使智能体选定一个真正的方向,而不是套用默认外观。

在真实浏览器中验证:让 Vibe 在各个断点渲染并自查,这样布局就不会在移动端悄无声息地崩掉。

提供 token 和参考图:真实的设计 token 和参考截图是影响输出质量的最大一个杠杆。

把规则写进配置和上下文:把“不要主视觉卡片、最多两种字体、品牌优先的层级”这类规则放在智能体每次运行都会读到的地方。

注意,每一条缓解措施都关乎给智能体一份精心设计的上下文。逐个项目手工维护这份上下文,正是 OpenDesign 消除的苦差事。
在 OpenDesign 中使用 Vibe CLI 做设计
OpenDesign 就是上述工作流一直在呼唤的那个开源设计层。它把 Mistral Vibe CLI 当作一等适配器——通过 vibe-acp 二进制文件走 ACP 来驱动它——并把它包进一套精心打磨的技能与设计系统库、一条结构化的渲染流水线和本地桌面 UI 之中。因此,让 Vibe 表现出色的那份设计上下文从第一次运行起就在那里,而不必每次手工拼装。两者都是开源、本地优先,这一搭配因此顺理成章。

安装 OpenDesign,并把 Mistral Vibe CLI 选为你的智能体。

用你的 Mistral API 密钥(BYOK)完成认证,或让 Vibe 指向本地模型——凭据始终留在你的机器上,绝不经过我们的代理。

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

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

同一个 Vibe CLI 智能体、同一把密钥——外加一套真实、可移植、开源的设计工作流。它是本地优先且 Apache-2.0 的,所以你的工作和凭据都不会离开你的机器。
OpenDesign 与 Mistral AI 有关联吗?
没有。OpenDesign 是独立的;Mistral 是 Mistral AI 的商标。