Open Design 快速开始。

环境要求

• Node.js 24 — 通过系统包管理器或 nodejs.org 安装。不支持 Node 22。
• pnpm 10.33.2 — 通过 Corepack 启用，使用 lockfile 固定版本。
• git — 任意较新的版本即可。
• 一个 Agent — Claude Code、Codex、Cursor、Gemini CLI、OpenCode 或 Qwen。

三条命令开始交付

在一个干净 shell 中运行：

1. 克隆并安装. 克隆 open-design 仓库，并用 pnpm 安装 workspace 依赖。需要 Node 24 和 pnpm 10.33.2。

   git clone https://github.com/nexu-io/open-design
   cd open-design
   pnpm install

2. 启动 daemon 和 Web UI. 运行 tools-dev 启动本地 daemon 与 Web runtime。这是唯一的本地生命周期入口。

   pnpm tools-dev

3. 生成第一个 artifact. 打开 Web UI，从目录里选择一个 Skill，让你的 Agent 渲染。也可以直接用 od CLI 驱动 daemon。

   od skill run open-design-landing --output ./artifact.html

完整说明见 QUICKSTART.md。

你应该看到什么

当 pnpm tools-dev 正常时，终端会显示 daemon、Web runtime 和 sidecar IPC namespace 已 ready：

# tools-dev — startup
→ daemon  listening on http://127.0.0.1:17456 (namespace tools-dev/main)
→ web     listening on http://127.0.0.1:17573 (proxy → daemon)
→ sidecar /tmp/open-design/ipc/tools-dev-main/daemon.sock
→ ready in 1.4s

实际端口由 tools-dev 参数决定（--daemon-port、--web-port）；默认值在多次运行中保持稳定。

排障

• pnpm install 出现 EBADENGINE: Node 大版本不对，请切到 Node 24。
• Windows 上 better-sqlite3 编译卡住: 这是 Node 24 上的预期行为，请先安装 Visual Studio Build Tools。
• 端口被占用: 传入 --daemon-port 与 --web-port，或停止之前的运行。
• Agent 没出现: 检查 /agents/ 以及 .od/media-config.json 中的凭据。
• 权限提示反复出现: 运行 pnpm tools-dev check 检查环境并输出缺失项。

下一步

• 浏览 Skill 目录 — 选择一个工作流开始渲染。
• 选择 DESIGN.md 系统 — 让生成 artifact 继承品牌。
• 比较 Open Design — 了解它和 Claude Design、Figma Make、v0、Lovable 的差异。
• 订阅 GitHub Releases — 获取新版本。