项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 2250
使用教程
环境要求
- 已安装 git
- 已安装 bun(仓库只使用 bun.lock 作为锁文件)
- 本机 Node 运行环境(服务端基于 Node 运行)
- 可选:Docker,用于生产镜像自托管
安装与启动步骤
-
1克隆仓库
把源码拉取到本地并进入项目目录。
git clone https://github.com/kgoedecke/doop && cd doop -
2安装依赖
用 bun 按 bun.lock 安装依赖,不要混用其他包管理器。
bun install -
3启动开发环境
同时启动 Web 应用与服务端,默认无需任何配置。
bun run dev -
4打开画布界面
浏览器访问 Web 端口;服务端 4400 承担 API、WebSocket 与 MCP。
-
5启用内置代理
如需内置 Doop Agent,在 .env 中填入模型密钥后重启。
cp .env.example .env -
6生产模式启动
不用 Docker 时先构建再启动,单端口 4400 提供全部服务。
bun run build && bun run start -
7Docker 自托管
生成鉴权密钥后用 compose 启动应用与 Postgres。
BETTER_AUTH_SECRET=$(openssl rand -hex 32) docker compose up -d
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
ANTHROPIC_API_KEY | 否 | 开启内置 Doop Agent,不填时其余功能照常可用 | sk-ant-xxxxxxxx |
DATABASE_URL | 否 | 连接外部 Postgres;不设则用内嵌 PGlite | postgres://user:pass@localhost:5432/doop |
BETTER_AUTH_SECRET | 是 | 鉴权签名密钥,生产环境需为长随机串 | dev-only |
BETTER_AUTH_URL | 是 | 服务对外访问的完整源地址 | https://doop.example.com |
TRUSTED_ORIGINS | 否 | 额外允许的来源,多个用逗号分隔 | https://a.example.com,https://b.example.com |
如何确认成功
浏览器打开 http://localhost:4300 能进入登录/主页;生产镜像可访问 GET /healthz 检查健康状态。
常见问题
Q:必须配置密钥才能用吗?
A:不是。默认零配置即可运行,数据写入 data/pg 的内嵌 Postgres;ANTHROPIC_API_KEY 只用于启用内置代理。
Q:数据存在哪里?
A:默认持久化到项目下 data/pg 的 PGlite。它适合单实例部署,多实例或正式环境应设置 DATABASE_URL 用外部 Postgres。
Q:两个端口分别做什么?
A:4300 是 Web 界面,4400 是 API、WebSocket 和 MCP 服务,Web 端口会把 /api、/ws、/mcp 反向代理过去。
Q:自己接的 AI 代理需要密钥吗?
A:通过 MCP 自行连接的代理不需要在 doop 里配模型密钥,只有内置 Doop Agent 需要。
Q:生产镜像怎么本地验证?
A:docker build -t doop . 后运行容器并映射 4400 端口,设置 BETTER_AUTH_URL 与 BETTER_AUTH_SECRET 即可访问。
注意事项
- 仓库只维护 bun.lock,请统一使用 bun 安装依赖。
- 生产部署务必设置 DATABASE_URL、BETTER_AUTH_SECRET 与 BETTER_AUTH_URL,不要依赖 PGlite 回退。
- 使用 Docker 自托管时,如需保留 PGlite 数据,应把持久卷挂载到 /app/data。
- 项目采用 AGPL-3.0 许可,二次分发或修改需遵守其条款。
核心亮点
- 内置 MCP,可直接对接 Claude、Codex 等代理操作画布
- 支持多人实时协同,人和 AI 在同一画布上并行工作
- TypeScript 实现,便于开发者阅读源码和二次开发
不足之处
- 早期项目,星标约 819,生态和插件体系尚不成熟
- 依赖外部 AI 代理与 MCP 配置,上手门槛偏高
适用场景
- 产品团队让 AI 代理批量生成界面初稿并人工微调
- 设计师与远程同事实时协作评审设计稿
- 开发者基于开源代码定制内部 AI 设计工具链
替代项目
Excalidraw、tldraw、Penpot
同类项目推荐
solid-glass
开源
给 AI 应用一套有质感、能直接用的界面设计系统
A design system for AI applications. Material, physical, tactile, technical.
claude-directory
开源
复制即用的 AI 生成界面组件,快速搭出炫酷落地页
AI-assisted design experiments with documented asset provenance, scoped licensing, a···
Tokokino
开源
浏览器里给截图和录屏加背景、设备框、文字,直接导出图片或视频
Browser-based screenshot & video beautifier — backgrounds, device frames, shadows, ···
ProcessingSketchs
开源
打开 Processing 草图库,快速上手创意编程。
Some Processing sketchs
anatomy
开源
一句话把技术想法变成可交互等距机械图
An agent skill for creating detailed, interactive isometric illustrations of real-wo···
OJO-Design-Skills
开源
给 AI 编码代理装上统一的设计规范
Reusable UI/UX design skills for AI coding agents — Codex, Claude Code, ZCode, and ···
craft
开源
想要啥布局说一声,手机电脑自动排好
craft is an AI-first, lightweight, flexible design system for building responsive la···
fractal-garden
开源
在浏览器里探索无限精细的数学分形之美
Zoom into the Mandelbrot set, fly through a Menger sponge and write your own L-syste···
img-fx
开源
给图片加载和揭示加动画,React 里几行代码搞定
Animated image generation loader and reveal effect for React
