描述
nvzhuang是一个GitHub仓库，提供一个虚拟试衣网站，利用AI生成女性服装参考图像。该项目包含1407张AI生成的参考图像，并支持英语和中文搜索查询，使其对广泛的用户群体可访问。它与流行的AI图像生成服务如OpenAI Images、Google Gemini和Doubao集成，并为用户提供配置自定义基础URL、API密钥和模型的灵活性。
阅读更多
nvzhuang项目的核心关注点是安全性和强大的部署能力。`AGENTS.md`文档概述了AI代理和协作者的严格安全指南，强调“零泄漏原则”。这包括绝对禁止将真实的API密钥、私有令牌、密码或证书密钥提交到Git仓库。相反，只允许包含空或占位符密钥字段的模板配置文件。个人隐私和敏感信息在代码、注释、提交信息或PR描述中也被严格禁止。
后端服务使用GoFrame构建，采用防御性编码实践。它确保多层回退机制，例如，如果未明确创建`config.yaml`，则自动加载`config.example.yaml`。当未配置时，服务端口硬编码为`8000`，防止随机高端口分配。Dockerfile和Docker Compose配置旨在即开即用，确保在构建和编排阶段模板配置到位。
前端用户配置，包括个人模型设置和历史生成记录，存储在用户的浏览器中（localStorage/IndexedDB），并不会被后端持久化到磁盘或服务器日志中。该项目还对外部输入和URL参数实施严格验证，仅允许同源或本地回环（`127.0.0.1`/`localhost`）用于敏感参数，如`?tryon=`。这防止了请求的静默劫持和私有API密钥或用户照片向不受信任的第三方域的外泄。公共远程地址严格要求使用HTTPS进行凭证传输。
提供了Docker Compose、Docker Run和直接命令行执行的部署说明，所有说明都强调内置回退到端口8000。前端优先考虑用户设置、全局变量和安全验证的URL参数的后端地址，并在本地访问时回退到`http://127.0.0.1:8000`。该项目旨在提供一个安全、灵活且易于部署的AI驱动虚拟试衣体验解决方案。
- 类别AI 产品摄影
- 定价模式开源
- 部署云端, 自托管
- 平台网页版
nvzhuang的核心功能
1407张AI生成的女性服装参考图像
虚拟试衣网站功能
支持英语和中文搜索
与OpenAI Images集成
与Google Gemini集成
与Doubao（豆包）集成
可自定义的基础URL、API密钥和AI模型
针对AI代理和协作者的严格安全指南
禁止将真实API密钥提交到Git仓库
对外部URL参数（例如，`?tryon=`）的严格验证
如果缺少`config.yaml`，自动回退到`config.example.yaml`
默认后端服务端口设置为8000
前端用户配置存储在浏览器本地
公共远程后端地址强制使用HTTPS
nvzhuang入门
克隆仓库：从GitHub仓库获取项目文件。
配置环境变量：将`backend/.env.example`复制到`backend/.env`并填写您的API密钥（例如，`ARK_API_KEY`、`OPENAI_API_KEY`、`GEMINI_API_KEY`）。
使用Docker Compose部署：运行`docker compose up -d`以构建并启动后端容器，默认监听端口8000。
使用Docker Run部署（替代方案）：使用`docker run`命令，配合适当的环境变量和端口映射。
直接从源代码运行（替代方案）：导航到`backend`目录，设置环境变量并执行`go run main.go`。
访问前端：前端静态页面将自动连接到后端，优先考虑用户设置、全局变量或本地回退。
nvzhuang的使用案例
- 虚拟服装试穿
- AI图像生成探索
- 时尚设计灵感
- 安全的AI应用开发
- 开源AI项目部署
