46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
# AI 空间风格工作台
|
||
|
||
这是一个以户型为约束、以布局与风格决策为核心的 Agent 型室内概念设计工作流。
|
||
|
||
第一阶段不追求施工图、真实商品匹配或精确报价，而是建立三个可持续修改的核心状态：
|
||
|
||
- `Plan State`：墙、门窗、房间、比例、图层和置信度。
|
||
- `Scene State`：家具布局、相机、锁定对象和 3D 白模。
|
||
- `Style State`：色板、材质、灯光、造型语言、禁用项和已锁定决策。
|
||
|
||
## 仓库结构
|
||
|
||
```text
|
||
apps/web Next.js 风格工作台
|
||
services/api FastAPI 工作流与集成接口
|
||
contracts 前后端共享的数据协议说明
|
||
docs 架构与工作流设计
|
||
11-2-104-模型.pdf 真实测试图纸
|
||
```
|
||
|
||
## 本地启动
|
||
|
||
推荐使用 Docker：
|
||
|
||
1. 在 PowerShell 运行 `./scripts/bootstrap.ps1 -Force`，自动生成数据库和 Redis 密码。
|
||
2. 运行 `docker compose up -d --build`。
|
||
3. 打开 `http://localhost:3000`，首次进入会自动显示“系统设置”。
|
||
4. 在网页中填写 MinIO、百度 OCR 和模型 API，并逐项点击测试。
|
||
|
||
日常使用不需要编辑 `.env`。它只保留应用启动前必须存在的基础参数，模型密钥等运行期配置会在网页中填写并加密保存。
|
||
|
||
需要单独开发前后端时：安装前端依赖 `pnpm install`，启动前端 `pnpm dev`；创建 Python 虚拟环境并运行 `pip install -e "services/api[dev]"`，随后使用 `uvicorn app.main:app --app-dir services/api --reload --port 8000` 启动 API。
|
||
|
||
前端默认访问 `http://localhost:3000`，API 文档默认位于 `http://localhost:8000/docs`。
|
||
|
||
## 当前垂直切片
|
||
|
||
- 显示样例户型与图层开关。
|
||
- 展示从导入、清洗、白模到风格方向和多轮修改的阶段状态。
|
||
- 提供结构化 Style DNA 面板。
|
||
- 提供可验证的工作流状态机和命令接口。
|
||
- 预留 MinIO、百度 OCR、GPU Worker 和多模型路由适配器。
|
||
- 提供分类设置中心、连接测试、必填检查和工作流就绪门禁。
|
||
|
||
详见 [架构设计](docs/architecture.md)、[工作流定义](docs/workflow.md) 与 [系统设置](docs/settings.md)。
|