常見問題 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 的公開資料與實測記錄。遇到不一致時以官方說明為準。來源清單見 參考來源與致謝。