常见问题 FAQ
基础
OpenDesign 是什么
一个开源的 AI 设计工作台，来自 nexu-io/open-design 项目。它把你本地的编码 Agent——Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Qwen 之类——变成一台设计引擎，由可组合的技能和可移植的「DESIGN.md」设计系统驱动。
它是官方的吗
规范站点是 open-design.ai，源码在 github.com/nexu-io/open-design。OpenDesign、Open Design、open-design、opendesign、Open Design AI、OD，指的都是同一个项目。维护方是 Powerformer, Inc.。
它跟 Claude Design 有什么区别
Claude Design 是托管产品，绑一家厂商。OpenDesign 本地优先、Apache-2.0 开源、BYOK——Agent、凭据、设计系统都是你自己的。详见 快速上手 01。
什么是 vibe design workspace
官方的说法：一个你通过向 AI 描述意图来做设计的地方，从提示词直接到原型、网页、幻灯片或者 HTML 视频，而不是手动摆放每一个元素。
钱
要花多少钱
应用本身免费，Apache-2.0，没有 OpenDesign 订阅这回事。你付的是模型费用——用哪家就进哪家的账单。BYOK 让凭据和花费都留在你这边。
托管套餐是可选的，买的是「不用自己管 key」加云端部署。详见 进阶 08。
我已经在付 Claude Code 的钱，还要再付吗
不用。设计任务和写代码任务共用同一个额度池。这是这个工具最实在的省钱点。
托管套餐值不值
看用量。Pro 档 $100 换 $120 模型额度，Max 档 $200 换 $300——用量本来就在这个量级的话比自己买 API 划算。用量小的话，免费版加自己的 key 更好。
数据与隐私
我的数据会被发给 Anthropic / OpenAI / Google 吗
只有你的提示词和技能上下文会发给你自带 key 的那一家。OpenDesign 自己没有服务器接这个流量，daemon 直接跟厂商通信。生成的产物是你项目目录里的文件，不在任何厂商的云上。
能不能完全不暴露 API key
能。指向你本机已经登录的 CLI（Codex、Claude Code、Cursor、OpenCode），生成走的是那个 CLI 的凭据，key 从头到尾没离开你的机器。
客户项目能用吗
这正是它的一个主要卖点。全部本地运行，资料不过第三方，对合规敏感的机构友好。但你自己接的那个模型厂商仍然会收到提示词内容，这一点要跟客户说清楚。
安装与运行
需要什么环境
桌面版：macOS 11 或更新（Apple Silicon 或 Intel），或者 Windows 10 / 11 x64。装完就能用。
源码版：Node.js 24（Node 22 不支持）、pnpm 10.33.2（通过 Corepack）、git，外加至少一个 Agent CLI。
能不能不装桌面版也不装 CLI
目前不行。OpenDesign 是本地优先设计的，最低配置是一个本地 daemon 加一个 Agent。托管沙箱在路线图上但不是优先级。
能自托管或者 fork 吗
能。代码是 Apache-2.0。可以 fork 仓库、改技能、加自己的设计系统，或者把 daemon 跑在自己的机器上。daemon 能跑在任何有 Node 24 的地方。
Windows 上装不上
最常见的是 better-sqlite3 在 Node 24 上编译卡住。先装 Visual Studio Build Tools。或者用 WSL，社区里不少人这么做。更简单的办法是直接用 Windows 安装包。
使用
支持哪些 Agent
官方 FAQ 说 17 个一方 BYOK 适配器，Agent 页面列了 21 个。列表在增长，两处更新节奏不同。完整对照见 参考 / Agent 适配器。
换 Agent 要重做吗
不用。技能和设计系统跟 Agent 无关，同一份「SKILL.md」在任何支持的适配器上都能跑。换 Agent 是改 daemon 里的一行配置。
怎么把我们的品牌搬进来
把截图或者 Figma 导出丢进界面，让 Agent 抽出一份「DESIGN.md」，存到仓库的 design-systems/<你的品牌>/ 下。之后每个技能都在这套品牌下渲染。详见 案例 04。
生成出来太「AI」怎么办
三件事按顺序做：认真填需求表单、选一个品牌级设计系统、生成完跑一次自我批判。详见 进阶 05。
能导出成能编辑的 PPTX 吗
能。pptx-generator 导出的是带原生形状和可编辑文本的真 .pptx，不是每页一张图。但复杂的 HTML 视觉、Three.js 场景、依赖 JS 的交互转换时会退化。详见 PPT 第 10 步。
团队
团队怎么用
最简单的做法是用 git：品牌系统、技能、产物都放一个仓库，每个人自带 Agent 订阅。免费版就够。
Team 套餐买的是产品内的协作体验（实时共同编辑、统一用量）。Team Basic 那一档不含模型额度，纯粹卖协作。
有企业版吗
有。包含共享团队设计系统、实时协作、多人共同编辑、统一账单与用量、SSO / SAML、优先支持。联系 support@open-design.ai。
项目本身
路线图在哪
在 GitHub 仓库的 docs/roadmap.md，每周的发布说明走 GitHub Releases。官方提到的下一阶段主题：更多 Agent 适配器、更丰富的模板族（3D、视频、音频）、以及一个可选的共享 daemon 模式。
怎么参与
插件库是社区可扩展的。写好你的模板、技能或者设计系统，给 nexu-io/open-design 提 PR，或者先开 issue 提议。合并之后会自动出现在网站目录和产品里。
讨论在 GitHub Issues 和 Discord。
这本书是官方的吗
不是。这是一份非官方的社区教程，内容整理自 open-design.ai 的公开资料与实测记录。遇到不一致时以官方说明为准。来源清单见 参考来源与致谢。