paipiange/nvzhuang

选用指南

AI 根据 README 整理 · 2026/10/29 22:46:30

使用方式

前端为纯静态网站，可直接在线访问或本地启动；AI换装功能需自建后端服务并配置模型API。

查看 README 依据

> 🐧 **社区友链**：[LINUX DO (https://linux.do/)](https://linux.do/) ## ⏱️ 10 秒了解本项目 - 🆓 **免费使用（无需部署 / 无需 Key）**：1407 套 AI 服装参考图库浏览、分类筛选、中英双语双向检索、大图全屏查看、基础搭配台与同款跳转，由纯前端静态驱动，在线打开即可使用。 - ⚙️ **自选扩展（需自建后端 / 需自备 Key）**：真实 AI 试衣换装功能依赖 `backend/` 的 GoFrame 服务。需自行配置大模型（如 GPT Image 2、豆包 Seedream 或 Gemini）的 API Key 与 Base URL，调用将消耗对应的第三方模型配额。 - 📜 **完全可商用 · 免费开源**：基于 [MIT License](LICENSE) 全量开源，代码与图集资源完全开放，支持自由商用创作、设计参考及二次开发。详见 [合规审计报告](docs/LINUXDO_RELEASE_AUDIT.md)。 ## 📸 预览 | 中文模式 | 英文模式 | 关键词搜索 | |---|---|---|

### 🚀 后端部署（优先推荐 Docker） 后端推荐使用 **Docker / Docker Compose** 部署，无需在宿主机安装 Go 编译环境，开箱即用。 #### 方式一：Docker Compose（推荐，最省心） ```bash # 1. 复制环境变量模板并填入你的 Key（如国内免翻墙的豆包 ARK_API_KEY，或 OpenAI Key） cp backend/.env.example backend/.env # 2. 一键启动后端 docker compose up -d # 服务启动后监听在 http://localhost:8000 ``` #### 方式二：Docker Run 单命令运行 ```bash cd backend # 构建镜像 docker build -f manifest/docker/Dockerfile -t costume-tryon . # 运行容器（按需注入模型 Key，例如豆包或 OpenAI） docker run -d --name costume-tryon \ -p 8000:8000 \ -e ARK_API_KEY="你的豆包ArkKey" \ -e OPENAI_API_KEY="sk-你的OpenAIKey" \ costume-tryon ```

部署要求

AI换装后端推荐使用Docker部署，需自行准备大模型API Key（如OpenAI、豆包或Gemini）。

查看 README 依据

> 🐧 **社区友链**：[LINUX DO (https://linux.do/)](https://linux.do/) ## ⏱️ 10 秒了解本项目 - 🆓 **免费使用（无需部署 / 无需 Key）**：1407 套 AI 服装参考图库浏览、分类筛选、中英双语双向检索、大图全屏查看、基础搭配台与同款跳转，由纯前端静态驱动，在线打开即可使用。 - ⚙️ **自选扩展（需自建后端 / 需自备 Key）**：真实 AI 试衣换装功能依赖 `backend/` 的 GoFrame 服务。需自行配置大模型（如 GPT Image 2、豆包 Seedream 或 Gemini）的 API Key 与 Base URL，调用将消耗对应的第三方模型配额。 - 📜 **完全可商用 · 免费开源**：基于 [MIT License](LICENSE) 全量开源，代码与图集资源完全开放，支持自由商用创作、设计参考及二次开发。详见 [合规审计报告](docs/LINUXDO_RELEASE_AUDIT.md)。 ## 📸 预览 | 中文模式 | 英文模式 | 关键词搜索 | |---|---|---|

### 🚀 后端部署（优先推荐 Docker） 后端推荐使用 **Docker / Docker Compose** 部署，无需在宿主机安装 Go 编译环境，开箱即用。 #### 方式一：Docker Compose（推荐，最省心） ```bash # 1. 复制环境变量模板并填入你的 Key（如国内免翻墙的豆包 ARK_API_KEY，或 OpenAI Key） cp backend/.env.example backend/.env # 2. 一键启动后端 docker compose up -d # 服务启动后监听在 http://localhost:8000 ``` #### 方式二：Docker Run 单命令运行 ```bash cd backend # 构建镜像 docker build -f manifest/docker/Dockerfile -t costume-tryon . # 运行容器（按需注入模型 Key，例如豆包或 OpenAI） docker run -d --name costume-tryon \ -p 8000:8000 \ -e ARK_API_KEY="你的豆包ArkKey" \ -e OPENAI_API_KEY="sk-你的OpenAIKey" \ costume-tryon ```

已知限制

原尺寸PNG（约1GB+）未纳入仓库，下载原尺寸按钮指向原站资源。

查看 README 依据

│ └── img/ # 展示图（webp，弹窗放大用） ├── docs/ # 文档图片与试穿效果演示图 ├── backend/ # AI 换装后端（GoFrame v2，可选） │ ├── docker-compose.yml # 后端 Docker Compose 配置 │ ├── .env.example # 环境变量示例文件 │ ├── restart.bat / build.bat # Windows 本地一键启动/重新编译脚本 │ ├── manifest/config/config.yaml # 模型配置（Key / BaseURL / 模型名） │ ├── internal/logic/tryon/ # 模型适配器（openai / doubao / gemini） │ └── DEPLOY.md # 部署指南 └── .gitignore ``` > 注：原尺寸 PNG（约 1GB+）未纳入仓库，「下载原尺寸」按钮指向原站资源。 ## 🔗 URL 参数