# comfy **Repository Path**: darrenliu/comfy ## Basic Information - **Project Name**: comfy - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-21 - **Last Updated**: 2025-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AI 换装生成平台 **项目名称**：AI 换装生成平台 **项目版本**：v1.0 **最后更新**：2025-11-17 **AI 开发注意事项**：请勿创建过多说明文档, 除非我要求 --- ## 📖 项目简介 AI 换装生成平台是一个基于 AI 技术的智能换装生成系统，用户可以上传服装图片，选择模特和背景，通过 ComfyUI 工作流自动生成专业的换装效果图。 ### 核心价值 - **降低成本**：无需实际拍摄，节省摄影、场地、模特成本 - **提高效率**：几秒内生成多种效果，快速预览不同搭配 - **灵活多样**：支持多种模特、背景组合，满足不同场景需求 - **AI驱动**：利用 ComfyUI 工作流，实现专业级图像生成 --- ## 🏗️ 技术架构 ```text ┌─────────────┐ ┌──────────────┐ ┌─────────────┐ │ PC Web前端 │ ───> │ FastAdmin后端 │ ───> │ ComfyUI AI │ │ (Vue/React) │ <─── │ (PHP API) │ <─── │ (Python) │ └─────────────┘ └──────────────┘ └─────────────┘ │ ▼ ┌─────────────┐ │ MySQL DB │ └─────────────┘ ``` ### 技术栈 - **前端**：Vue 3 + Vite / React 18 + Vite - **后端**：FastAdmin（基于 ThinkPHP 5） - **AI引擎**：ComfyUI（Python） - **数据库**：MySQL 5.7.26 - **缓存**：Redis（可选） --- ## 🔄 主要业务流程 ### 1. 用户上传服装图片 ```text 用户上传图片 → 后端接收并存储 → 自动触发抠图处理 → 返回透明背景图 ``` ### 2. 选择素材 ```text 浏览模特库 → 选择模特 → 浏览背景库 → 选择背景 ``` ### 3. 创建换装任务 ```text 配置生成参数 → 提交任务 → 后端调用 ComfyUI → 任务进入队列 ``` ### 4. 任务处理 ```text ComfyUI 执行工作流 → 实时更新进度 → 生成结果图片 → 存储到数据库 ``` ### 5. 查看结果 ```text 前端轮询任务状态 → 显示生成进度 → 展示结果图片 → 支持下载 ``` --- ## 📦 主要功能模块 ### 前端模块（PC Web） 1. **用户认证模块** - 用户注册、登录 - 个人资料管理 2. **图片上传模块** - 服装图片上传（支持拖拽） - 自动抠图处理 - 图片智能识别与打标 2. **智能抠图模块**（独立功能） - 图片上传（支持拖拽） - AI智能抠图处理（BiRefNet模型） - 实时处理进度显示 - 原图与结果对比展示 - 结果下载 3. **素材选择模块** - 模特库浏览与选择（支持筛选） - 背景库浏览与选择（支持分类） 4. **任务生成模块** - 任务配置与提交 - 实时进度查看 - 结果展示与下载 5. **历史记录模块** - 换装历史查看 - 上传图片管理 6. **抠图历史模块** - 抠图任务历史查看 - 结果图片管理 ### 后台管理模块 1. **用户管理** - 用户列表与详情 - 用户状态管理 2. **资源素材管理** - 模特库管理（增删改查） - 背景库管理（增删改查） - 用户上传图片管理 3. **任务管理** - 任务列表与监控 - 任务详情与日志 - 任务重试与删除 4. **工作流管理** - 工作流配置与同步 - 工作流测试 - 多工作流支持 5. **系统监控与统计** - 数据统计仪表盘 - 日志查看 --- ## 📁 项目目录结构 ```text comfy/ ├── README.md # 项目说明文档（本文件） ├── docs/ # 详细文档目录 │ ├── 图库项目技术方案及实施详细步骤.md │ └── ai-matting-implementation-plan.md │ ├── fastadmin/ # FastAdmin 后端项目 │ ├── application/ # 应用目录 │ │ ├── admin/ # 后台管理模块 │ │ │ ├── controller/ # 控制器 │ │ │ ├── model/ # 模型 │ │ │ └── view/ # 视图 │ │ ├── api/ # API 接口模块 │ │ │ └── controller/ # API 控制器 │ │ ├── common/ # 公共模块 │ │ │ ├── library/ # 类库（ComfyUI 对接等） │ │ │ └── model/ # 公共模型 │ │ └── command/ # 命令行工具 │ │ └── ProcessOutfitJobs.php # 任务处理脚本 │ ├── doc/ # FastAdmin 文档 │ │ ├── INSTALL.md # 安装部署指南 │ │ ├── DATABASE_CONFIG.md # 数据库配置 │ │ ├── OUTFIT_README.md # 换装功能说明 │ │ └── ... │ ├── sql/ # SQL 脚本 │ │ ├── outfit_tables.sql # 业务表结构 │ │ └── menu_setup.sql # 菜单配置 │ └── public/ # 公共目录 │ └── uploads/ # 上传文件目录 │ ├── ComfyUI/ # ComfyUI AI 引擎 │ ├── main.py # 主程序入口 │ ├── server.py # Web 服务器 │ ├── execution.py # 工作流执行引擎 │ ├── nodes.py # 节点系统 │ ├── comfy/ # 核心 AI 模块 │ ├── comfy_api/ # API 接口模块 │ ├── input/ # 输入目录（符号链接） │ └── output/ # 输出目录（符号链接） │ └── services/ # 服务目录 └── ImageMatting/ # AI抠图服务（独立微服务） ├── app/ # FastAPI应用 │ ├── api/ # API接口 │ ├── models/ # 模型封装 │ ├── services/ # 业务逻辑 │ └── utils/ # 工具函数 ├── models/ # ONNX模型文件 ├── tests/ # 单元测试 └── scripts/ # 脚本工具 ``` ### 关键目录说明 - **fastadmin/application/api/controller/**：API 接口控制器 - **fastadmin/application/common/library/**：ComfyUI 对接类库 - **fastadmin/application/command/**：后台任务处理脚本 ## 🚀 快速开始 ### 环境要求 - PHP 7.1+ - MySQL 5.7.26 - Python 3.10+ - ComfyUI（已安装） ### 安装步骤 1. **启动 ComfyUI** ```bash cd ComfyUI python main.py ``` 2. **配置 FastAdmin** - 导入数据库：`fastadmin/sql/outfit_tables.sql` - 配置数据库连接：`fastadmin/application/database.php` - 配置 ComfyUI 地址：`fastadmin/application/extra/comfyui.php` 3. **配置符号链接** ```bash # Windows fastadmin/application/command/create_symlink_windows.bat # Linux fastadmin/application/command/create_symlink_linux.sh ``` 4. **访问系统** - 后台管理：`http://localhost/fastadmin/public/admin` - API 接口：`http://localhost/fastadmin/public/api` 详细安装说明请参考：[docs/INSTALL.md](fastadmin/doc/INSTALL.md) --- ## 📚 文档目录 所有详细文档保存在 `docs` 目录和 `fastadmin/doc` 目录中： ### 核心文档 - **技术方案**：[docs/图库项目技术方案及实施详细步骤.md](docs/图库项目技术方案及实施详细步骤.md) - **安装部署**：[fastadmin/doc/INSTALL.md](fastadmin/doc/INSTALL.md) - **数据库配置**：[fastadmin/doc/DATABASE_CONFIG.md](fastadmin/doc/DATABASE_CONFIG.md) - **API 接口文档**：[fastadmin/doc/OUTFIT_README.md](fastadmin/doc/OUTFIT_README.md) ### 其他文档 - **项目文档整理说明**：[fastadmin/项目文档整理说明.md](fastadmin/项目文档整理说明.md) - **ComfyUI 中文指南**：[ComfyUI/README_ZH.md](ComfyUI/README_ZH.md) - **符号链接说明**：[fastadmin/doc/符号链接使用说明.md](fastadmin/doc/符号链接使用说明.md) --- ## 👥 用户角色 ### 普通用户 - 注册、登录、修改个人资料 - 上传服装图片 - 浏览模特库、背景库 - 创建换装任务 - 查看生成历史记录 - 下载生成的图片 ### 管理员 - 所有普通用户权限 - 用户管理 - 模特库、背景库管理 - 工作流管理 - 任务监控 - 系统统计 --- ## 🔧 开发说明 ### 后端开发 - **API 接口**：`fastadmin/application/api/controller/` - **后台管理**：`fastadmin/application/admin/controller/` - **ComfyUI 对接**：`fastadmin/application/common/library/Comfyui.php` ### 前端开发 - 前端项目独立开发（Vue/React） - API 接口文档：`fastadmin/doc/OUTFIT_README.md` - 前端开发指南：参考技术方案文档第九章 ### 任务处理 - 后台任务处理脚本：`fastadmin/application/command/ProcessOutfitJobs.php` --- ## 📝 许可证 本项目采用相应的开源许可证，详见各子项目的 LICENSE 文件。 --- ## 🙏 致谢 - [FastAdmin](https://www.fastadmin.net/) - 后台管理框架 - [ComfyUI](https://github.com/comfyanonymous/ComfyUI) - AI 图像生成引擎 - [ThinkPHP](https://www.thinkphp.cn/) - PHP 框架 --- **更多详细信息请查看 [docs](docs) 目录中的文档。**