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