项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 106854
使用教程
环境要求
- 已安装 Docker 与 Docker Compose(Docker 部署方式)
- 能访问 GitHub 以克隆仓库
- 源码方式需 Node ~24 与 pnpm 10.33.x
- macOS / WSL2 用户需先确认 od 命令不被系统占用
安装与启动步骤
-
1克隆仓库
把 OpenDesign 源码拉到本地,命令需能正常访问 GitHub。
git clone https://github.com/nexu-io/open-design.git -
2进入部署目录
docker compose 文件与环境变量模板都放在 deploy 子目录中。
cd open-design/deploy -
3生成环境文件
从 .env.example 复制出 .env,供后续写入访问令牌等配置。
cp .env.example .env -
4写入访问令牌
用 openssl 生成 32 字节随机十六进制串,作为 OD_API_TOKEN 追加到 .env。
echo "OD_API_TOKEN=$(openssl rand -hex 32)" >> .env -
5启动容器
后台拉起服务,首次执行会拉取镜像,请耐心等待完成。
docker compose up -d
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OD_API_TOKEN | 是 | 访问 OpenDesign 服务的令牌,写入 deploy/.env 文件 | OD_API_TOKEN=9f2c1d4e8a7b6c5d4e3f2a1b0c9d8e7f |
OPEN_DESIGN_ALLOWED_ORIGINS | 否 | 自定义公开/共享部署时限制可访问的来源域名 | https://your-domain.com |
如何确认成功
Docker 方式容器正常运行即启动成功;源码方式运行后会打印访问 URL,打开该地址即可看到 OpenDesign 界面。
常见问题
Q:终端里的 od 命令不是 OpenDesign 的怎么办?
A:macOS 上 /usr/bin/od 是系统八进制转储工具,会遮蔽 OpenDesign 的 od。桌面应用用户请在 Settings → MCP server 中复制客户端专用配置片段,该片段使用绝对路径,不依赖裸 od 命令。
Q:WSL2 或原生 Windows 下安装失败怎么办?
A:WSL2 用户请先按 docs/wsl-setup.md 完成设置;原生 Windows 用户请参考 docs/windows-troubleshooting.md 排查。
Q:源码运行时端口是固定的吗?
A:不是。开发端口由 tools-dev 动态分配,除非你显式传入端口参数,启动后按它打印的 URL 访问即可。
Q:没有图形界面能用吗?
A:可以。把 OpenDesign 作为 skill、插件或 MCP server 装进 Claude Code、Codex、Cursor 等编码代理即可,无需打开 GUI。
Q:除了 Docker 还有别的部署方式吗?
A:有。可用 Sealos 应用商店模板部署已发布的 Docker 镜像,自带持久化工作区存储并在公开代理上启用 Basic Auth。
注意事项
- 不打开 GUI 时,可用 README 给出的 `od mcp install <agent>` 把 OpenDesign 接入你正在使用的编码代理。
- 自定义公开或共享的 Docker 部署,请遵循 deploy/README.md 中的反向代理与 OPEN_DESIGN_ALLOWED_ORIGINS 说明。
- 运行 pnpm install 前需先执行 corepack enable,源码启动命令为 pnpm tools-dev run web。
- 项目支持 BYOK 自带密钥,也可使用 OpenDesign Cloud 官方模型服务。
核心亮点
- 本地优先的桌面应用,支持多种设计产物(原型、落地页、仪表盘、幻灯片、图片和视频)的生成与导出,覆盖场景广
- 深度集成主流编码代理(Claude Code、Codex、Cursor 等20+ CLI),通过BYOK模式灵活调用,降低使用门槛
- 导出格式丰富(HTML/PDF/PPTX/MP4),直接产出真实文件,便于交付和二次编辑
不足之处
- 文档/社区待观察:项目较新,生态和最佳实践尚在积累中
- 依赖外部编码代理和API密钥,离线或受限环境下功能可能受限
适用场景
- 快速生成设计原型或落地页,适合前端开发者或独立开发者
- 制作演示文稿或数据仪表盘,适合产品经理或技术团队内部汇报
- 生成营销图片或短视频,适合内容创作者或市场人员
替代项目
v0、Bolt.new、Lovable
上一篇:没有了!
下一篇:open-codesign
同类项目推荐
cuneus
开源
写计算着色器像写脚本,热重载+多通道+音视频输入,实时出片
Engine for creating compute shader apps. easy multi pass pipelines, hot reload, audi···
simple-ai
开源
复制粘贴即用的 AI 界面组件,快速搭出好看对话产品
A collection of beautifully designed AI interface components that you can copy and p···
Phil-design-skills
开源
文章丢进去,配图风格一秒生成一套
19 套可直接生图的视觉风格 Skills,为 gpt-image-2 编写。把文章、主题、产品或已有视觉资···
DungeonTemplateLibrary
开源
用 C++ 快速生成多样地下城地图,省去手动设计关卡
: Dungeon free resources (terrain & roguelike generation)
book-mdpc
开源
用代码写电影,让创意在命令行里放映
Il cinema tra le righe... di codice!
sketchy
开源
用 Go 写代码,轻松生成惊艳的生成艺术
A framework for creating generative art in Go
transitions.dev
开源
复制即用的精致 UI 过渡,AI 帮你按场景生成动效
UI motion agent, a library of 43+ crafted transitions, a skill that fits your workfl···
Scrapstyle
开源
粘贴网址就扒全套风格,换皮改版省一半功夫
Paste a URL, get a design system. AI-ready style guides for Cursor & Lovable.
intent
开源
把设计方法论装进 AI agent,按体验设计流程出方案
Design with Intent: A collection of specialized AI agents and skills for experience ···
