waoowaoo

环境要求

• 操作系统与 CPU 架构在 Release 支持范围内
• Docker Engine 或 Docker Desktop 已安装可用
• Docker Compose v2、Git、flock 已安装
• 磁盘可写入新的安装目录，且需保留已有容器与数据
• 浏览器所在主机可导入本地根证书（自签 Caddy 证书）

安装与启动步骤

1. 1克隆仓库读文档

   README 明确完整安装步骤在 docs/INSTALL.md，先克隆仓库并阅读该文档与所选 Release 说明，再动手安装。

   git clone https://github.com/waooAI/waoowaoo.git
   cd waoowaoo
   cat docs/INSTALL.md

   复制

2. 2检查并补齐依赖

   检查系统与 CPU 架构、Docker Engine/Desktop、Compose v2、Git、flock；缺失项用对应系统工具安装，安装器可能需你手动授权或启动 Docker Desktop。

3. 3准备目录与密钥

   使用一个全新的安装目录，保留已有容器、文件和数据；生成唯一本地密钥写入 .env，过程中不要打印或上传任何密钥。

4. 4启动 Release 容器

   按 docs/INSTALL.md 与所选 Release 的 Compose 方式启动预构建镜像，应用与 Codex runtime 都固定到该 Release 的不可变镜像 digest，并包含同一 Release 的 docker/c

5. 5信任本地证书

   Compose 会自动启动 Caddy，仅导出 root.crt 并说明信任影响、取得明确同意后再在浏览器所在系统信任；Windows 与 WSL 需分别处理，禁止导出 root.key 或跳过 TLS 校验。

6. 6填 Key 并验证

   打开应用后在个人资料的 API configuration 中填入自己的 OpenRouter API Key，不要在聊天或支持日志中传递密钥；未获批准不要启动付费生成。

关键配置

如何确认成功

浏览器打开 https://localhost:1443 无证书告警、使用 h2 且多标签页事件流正常，容器健康、应用可打开；端口 13000 只做 HTTP 跳转。

常见问题

注意事项

• 当前为预览版，仍在快速迭代，可能存在 bug 和粗糙之处。
• 所有命令与参数以所选 Release 的 docs/INSTALL.md 为准，不要自创第二条启动路径。
• SSE 标签页并发数不等于 AI 任务并发上限。
• 项目数据与媒体存本地数据库和私有 MinIO，提示词与参考素材会按任务发送给 provider。