快速上手
三條指令。 免註冊。
Open Design 只有一個入口:pnpm tools-dev。daemon 自動建一個隱藏的 .od/ 目錄,放 SQLite 專案庫和各專案的 artifact。沒有 od init 步驟。
前置
- · Node ~24 ——
nvm install 24 && nvm use 24或fnm install 24 && fnm use 24 - · pnpm 10.33.x ——
corepack enable && corepack pnpm --version - ·
PATH上至少裝一款支援的 coding-agent CLI —— Claude Code、Codex、Cursor、Gemini、OpenCode、Qwen、Copilot、Devin、Hermes、Kimi、Kiro、Vibe 或 Pi(也可以一個都不裝,走 BYOK 代理)
三條指令
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run web打開 tools-dev 列印的 Web URL。掀開歡迎彈窗,貼一個 Anthropic Key(只在走 BYOK 墊底時才需要),打一段 prompt,按送出。
首次執行的狀態
daemon 只管一個隱藏目錄。
.od/
├── app.sqlite ← 專案 · 對話 · 訊息 · 開啟的 tab
├── artifacts/ ← 一次性「儲存到磁碟」的渲染(帶時間戳)
└── projects/<id>/ ← 各專案的工作目錄,也是 Agent 的 cwd| 想幹嘛… | 這麼幹 |
|---|---|
| 看一下裡面有什麼 | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| 重設成乾淨的 | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| 挪到別的位置 | 暫不支援 —— 路徑寫死在倉庫相對位置 |
生命週期指令
全部歸在 pnpm tools-dev.
pnpm tools-dev start # 啟動 daemon + web(背景)
pnpm tools-dev run web # 前景對等指令
pnpm tools-dev stop # 全停
pnpm tools-dev status # 看哪個在跑、跑在哪
pnpm tools-dev logs # 跟隨 daemon + web 紀錄
pnpm tools-dev inspect # 透過 IPC 查看執行中的行程
pnpm tools-dev check # 健康檢查桌面 / 背景啟動、固定埠重啟、媒體生成分發(OD_BIN、OD_DAEMON_URL)的細節,看 GitHub 上的 QUICKSTART.md。
平台 · v0.5.0
三個平台, 三種狀態。
v0.5.0 直白地告訴你每個平台到了哪一步。挑你機器對應那一行。
| 平台 | 狀態 | 備註 |
|---|---|---|
| macOS | 穩定 | 僅 Apple Silicon(arm64),沒有 Intel build。macOS 11 Big Sur 及以上。 |
| Windows | 穩定 · 未簽名 | x64,Windows 10 / 11。SmartScreen 首次啟動會警告 —— 選 More info → Run anyway 跑過去。 |
| Linux | 僅 headless | v0.5.0 起 CLI 生命週期(install / start / stop)成頭等支持。GUI 包還沒出 —— 適合伺服器和 CI。詳見下文。 |
Linux · headless
在沒有 DISPLAY 的伺服器上跑 Open Design。
v0.5.0 加了一條不帶圖形的生命週期路徑。在 headless Linux 機器上把 daemon 和 web 起起來,然後從你筆電瀏覽器去打它。後端一模一樣,前面沒有 Electron 殼。
pnpm install
pnpm tools-pack linux install --headless # 一次性設好
pnpm tools-pack linux start --headless # daemon + web,無 Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # 跟隨 headless 紀錄Apt 套件、namespace 權限、FUSE 注意事項都在 tools/pack/README.md。Ubuntu 24.04 和 Arch Linux 上驗過。0.5.0 PR #686 落地。
自架 · v0.5.0
或者把它跑成 一個容器。
v0.5.0 給了正式的 Docker Compose 部署路徑。一個 Alpine 映像(docker.io/vanjayak/open-design)。daemon 同時管 API 和建好的 Next.js 靜態匯出 —— 不用單獨的 nginx,不用單獨的前端容器。
git clone https://github.com/nexu-io/open-design.git
cd open-design/deploy
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose pull
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose up -d --no-build
# → http://127.0.0.1:7456預設綁 127.0.0.1:7456,記憶體上限 384 MB,執行時 volume 掛在 /app/.od。不要直接把 daemon 暴露到公網 —— 對非瀏覽器客戶端,API 沒認證。前面套一層有認證的反向代理、SSH 隧道或 VPN。完整文件:deploy/README.md。映像設計上不打包 Claude / Codex / Gemini CLI —— 這些放到容器外面。
然後呢?
挑點東西渲染出來。
daemon 起來後,你需要一個 Skill(做什麼)、一套 設計系統(怎麼看),最好再有一個「好長什麼樣」的參考。