🚀 快速开始

前提条件：安装 Docker Desktop

下载 docker-compose.yml

curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml

方式二：克隆仓库 + Docker 构建（完全控制）

git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
docker compose up -d

更新版本：

git pull
docker compose down && docker compose up -d --build

复制环境变量配置文件（必须在 npm install 之前完成）

cp .env.example .env

注意：docker-compose.yml 将服务映射到非标准端口，.env.example 已按此预设

mysql:13306 redis:16379 minio:19000 docker compose up mysql redis minio -d

启动所有服务

docker compose up -d

> ⚠️ 当前为测试版，版本间数据库不兼容。升级请先清除旧数据：

启动后请清空浏览器缓存并重新登录，避免旧版本缓存导致异常。

只启动基础设施

初始化数据库表结构（首次必须执行，跳过会导致启动后报错）

npx prisma db push

启动开发服务器

npm run dev

> [!WARNING]
> 跳过 `npx prisma db push` 会导致所有数据库表不存在，启动后报错 `The table 'tasks' does not exist`。请务必先运行此命令再启动开发服务器。

---

访问 [http://localhost:13000](http://localhost:13000)（方式一、二）或 [http://localhost:3000](http://localhost:3000)（方式三）开始使用！

> 首次启动会自动完成数据库初始化，无需任何额外配置。

> [!TIP]
> **如果遇到网页卡顿**：HTTP 模式下浏览器可能限制并发连接。可安装 [Caddy](https://caddyserver.com/docs/install) 启用 HTTPS：
> 

---

⚠️ 编辑 .env，填入你的 AI API Key（NEXTAUTH_URL 默认已是 http://localhost:3000，无需修改）

npm install

🔧 API 配置

启动后进入设置中心配置 AI 服务的 API Key，内置配置教程。

💡 注意：目前仅推荐使用各服务商官方 API，第三方兼容格式（OpenAI Compatible）尚不完善，后续版本会持续优化。

---