02 · 安装：桌面版与三行命令
两条路：下一个打包好的桌面应用，或者从源码跑。前者三分钟，后者需要你机器上有对版本的 Node。功能上没有大差别——桌面版本身就是把同一套 daemon 和 web 界面包进了 Electron 壳。
路线一：桌面版（推荐第一次用）
去 open-design.ai/download，选对应的包：
| 平台 | 包 | 大小 | 系统要求 |
|---|---|---|---|
| macOS · Apple Silicon | DMG | 约 367 MB | macOS 11 Big Sur 或更新 |
| macOS · Intel | DMG | 约 379 MB | macOS 11 Big Sur 或更新 |
| Windows | 安装包（也有 portable zip） | 约 400 MB | Windows 10 / 11，x64 |
装完直接开。它会扫你的 PATH，把已经装好的 Agent CLI 找出来，不用配 Node，不用配 pnpm，也不用写配置文件。
下载页在手机上打不开
它是桌面应用，官网在移动端会直接提示你换电脑打开。手机上收藏一下链接就行。
路线二：从源码跑
适合两种人：想改技能或者加设计系统的，以及公司电脑不让装未签名应用的。
先确认环境
| 依赖 | 版本 | 说明 |
|---|---|---|
| Node.js | 24 | Node 22 不支持，这是硬要求 |
| pnpm | 10.33.2 | 通过 Corepack 启用，跟着 lockfile 走 |
| git | 任意近期版本 | |
| 一个 Agent | Claude Code / Codex / Cursor / Gemini CLI / OpenCode / Qwen 任选 | 没有 Agent 装上也跑不出东西 |
bash
nvm install 24 && nvm use 24
corepack enable
node -v # 应该是 v24.x三行命令
bash
git clone https://github.com/nexu-io/open-design
cd open-design
pnpm install然后起服务。tools-dev 是唯一的生命周期入口，别绕过它自己起 node：
bash
pnpm tools-dev健康的输出长这样：
text
→ 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浏览器打开它打印的那个 web 地址。端口默认稳定，但别在脚本里写死——用 --daemon-port 和 --web-port 能改。
几个日常命令
bash
pnpm tools-dev check # 体检：环境缺什么它会直接列出来
pnpm tools-dev status # 现在有什么在跑
pnpm tools-dev stop # 全停
pnpm tools-dev run web # 只起 web 那一路第一次跑不通的时候，先跑 check。它比读日志快。
命令行直接出货
装好之后还有一个 od 命令，可以完全不开界面：
bash
od skill run open-design-landing --output ./artifact.html这条路适合塞进 CI，或者你本来就习惯在终端里干活。
装不上的时候
| 症状 | 原因 | 怎么办 |
|---|---|---|
pnpm install 报 EBADENGINE | Node 大版本不对 | 切到 Node 24 |
Windows 上 better-sqlite3 编译卡住 | Node 24 上的已知情况 | 先装 Visual Studio Build Tools，再重来 |
| 端口被占 | 上一次没停干净 | pnpm tools-dev stop，或者加 --daemon-port / --web-port |
| 界面里看不到 Agent | CLI 不在 PATH 里，或者凭据没配 | 见 03 · 接上 Agent |
| 一直弹权限确认 | 环境没配全 | pnpm tools-dev check 会告诉你缺哪一项 |
更长的排错清单在 参考 / 排错手册。
Windows 用户的额外一句
社区里有相当一部分人是在 WSL 里跑源码版的，尤其是原生 Windows 上 better-sqlite3 编译不过的时候。如果你只是想用，不打算改代码，Windows 安装包省事得多。
懒人路线
其实还有第三条路：把仓库地址甩给你的 Agent，让它按 dev 模式帮你装。社区教程里不少人是这么干的——毕竟你手上就有一个会读文档、会跑命令的东西。
下一步
03 · 接上 Agent — 21 个适配器怎么挑，key 放哪，以及怎么做到一个 key 都不暴露。