核心内容摘要
BitVision开发指南：贡献代码前你需要了解的架构与模块设计
UNet人脸融合结果保存在哪outputs目录说明你刚完成一次UNet人脸融合右侧面板上那张高清自然的融合图正静静展示着效果——但当你想把这张图永久保存下来、发给朋友或用于后续工作时却突然发现它到底存在服务器哪个角落别急这不是玄学问题而是每个初次使用unet image Face Fusion人脸融合人脸合成 二次开发构建by科哥镜像的用户都会遇到的真实困惑。
本文不讲原理、不堆参数只用最直白的语言带你彻底搞清融合结果究竟生成在哪儿outputs目录里藏着什么怎么快速定位、安全备份、批量管理我们从WebUI界面的一次点击出发层层拆解文件路径、命名逻辑和存储机制让你下次操作完“开始融合”后3秒内就能在终端里找到那张属于你的成果。
融合结果默认保存位置/root/outputs/是唯一真相所有通过Face Fusion WebUI生成的图片无一例外全部自动保存在容器内的/root/outputs/目录下。
这不是猜测不是经验而是镜像启动脚本与WebUI后端代码共同写死的硬编码路径。
关键确认点镜像文档明确指出“图片会自动保存到outputs/目录”启动指令为/bin/bash /root/run.sh说明整个应用以/root为工作根目录WebUI源码中所有文件写入操作均基于相对路径outputs/而当前工作目录即/root。
这意味着你不需要手动指定保存路径无需配置环境变量或修改配置文件每次点击“开始融合”系统就自动执行save_image(..., path/root/outputs/xxx.png)。
但请注意这个/root/outputs/是容器内部路径。
如果你在宿主机比如你的Mac或Windows电脑上运行Docker那么这个目录实际映射在宿主机的某个位置——而这个映射关系正是你能否顺利拿到图片的关键。
容器内外路径映射看清outputs/真实落点镜像本身不负责“暴露”目录它只按规则往/root/outputs/写文件。
真正决定你能否在本地看到这些图片的是Docker运行时的卷volume挂载配置。
1 默认行为未显式挂载时文件仅存于容器内如果你直接执行类似以下命令启动镜像docker run -p 7860:7860 -it unet-face-fusion-image那么/root/outputs/就是一个临时容器层目录。
一旦你docker stop并docker rm删除该容器里面所有融合结果将永久消失无法恢复。
这是新手最容易踩的坑兴高采烈做完10张融合图关掉终端再打开发现全没了。
2 正确做法必须挂载宿主机目录到/root/outputs要让融合结果持久化、可访问、可备份请务必在docker run时添加-v参数将宿主机的一个真实文件夹映射进去# Linux/macOS 示例将当前目录下的 outputs 文件夹挂载进去 docker run -p 7860:7860 -v $(pwd)/outputs:/root/outputs -it unet-face-fusion-image # Windows PowerShell 示例 docker run -p 7860:7860 -v ${PWD}\outputs:/root/outputs -it unet-face-fusion-image执行后效果是这样的容器内路径宿主机对应路径说明/root/outputs/你指定的宿主机路径所有融合图实时双向同步/root/outputs/
/outputs/
/按日期自动创建的子目录/root/outputs/
/face_fusion_
pngoutputs/
/face_fusion_
png实际生成的图片文件此时你在WebUI点10次“开始融合”宿主机的outputs/文件夹里就会立刻出现10张图关闭容器、重启镜像、甚至重装系统只要宿主机文件夹还在图片就永远安全你可以用任何看图软件、批量重命名工具、云盘同步服务直接操作这些文件。
outputs目录结构解析日期子目录 自动编号命名进入/root/outputs/或你挂载的宿主机对应文件夹你会看到一个清晰、有序、完全自动化管理的结构outputs/ ├──
/ │ ├── face_fusion_
png │ ├── face_fusion_
png │ └── face_fusion_
png ├──
/ │ ├── face_fusion_
png │ └── face_fusion_
png └──
/ └── face_fusion_
png
1 一级目录按年-月-日自动创建每天首次生成融合图时系统自动创建形如YYYY-MM-DD的子目录同一天的所有结果都归入该目录避免文件混杂目录名不含空格、特殊字符兼容所有操作系统和云服务。
2 文件命名face_fusion_XXX.png格式前缀固定为face_fusion_一眼识别用途后缀为三位数字编号001,002, ...按生成时间顺序递增扩展名统一为.png保证无损质量与透明通道支持不包含时间戳、哈希值或随机字符串——简洁、可读、易排序。
优势用文件管理器按名称排序就是按生成时间排序❌ 注意编号每天重置
/face_fusion_
png和
/face_fusion_
png是两张完全不同的图。
如何快速定位最新融合图三种高效方法不用翻文件夹、不用记路径三招直达最新成果
1 方法一终端命令Linux/macOS在宿主机挂载目录中执行假设挂载到~/my-fusion-outputs# 进入输出目录 cd ~/my-fusion-outputs # 查看最新生成的5个文件按修改时间倒序 ls -lt */face_fusion_*.png | head -n 5 # 或直接打开最新一张macOS open $(find . -name face_fusion_*.png -type f | sort -r | head -n
# 或直接打开最新一张Linux需安装 xdg-utils xdg-open $(find . -name face_fusion_*.png -type f | sort -r | head -n
1)
2 方法二WebUI界面右键下载最简单融合成功后右侧结果区会显示图片鼠标右键点击该图片 → “图片另存为...”浏览器会弹出标准保存对话框你可以选择任意本地路径保存适合单张快速导出无需接触终端注意此方式保存的是浏览器缓存副本非原始文件但画质完全一致。
3 方法三进入容器内部查看进阶调试当你需要确认容器内状态或挂载失效时排查问题# 查看正在运行的容器ID docker ps # 进入容器替换 container_id 为实际ID docker exec -it container_id /bin/bash # 在容器内直接列出最新文件 ls -lt /root/outputs/*/face_fusion_*.png | head -n 3此时你看到的路径就是绝对真实的/root/outputs/...可直接cat日志、stat文件属性精准定位问题。
高级技巧自定义保存路径与批量管理虽然默认路径足够好用但某些场景下你可能需要更灵活的控制。
1 修改保存根目录需重建镜像/root/outputs/是硬编码路径无法通过WebUI设置更改。
但如果你有二次开发需求可修改源码中的保存逻辑# 原始代码伪代码 output_dir os.path.join(/root, outputs, today_str) os.makedirs(output_dir, exist_okTrue) cv
imwrite(os.path.join(output_dir, fface_fusion_{idx:03d}.png), result_img)→ 改为读取环境变量output_root os.environ.get(FACE_FUSION_OUTPUT_ROOT, /root/outputs) output_dir os.path.join(output_root, today_str)然后启动时传入docker run -e FACE_FUSION_OUTPUT_ROOT/data/fusion-results -v /path/on/host:/data/fusion-results ...此操作需重新构建镜像仅推荐开发者或长期部署用户使用。
2 批量重命名与分类推荐脚本为方便归档可用以下Python脚本按融合比例、源图名等信息重命名#!/usr/bin/env python3 import os import glob from datetime import datetime # 遍历所有 outputs/ 下的 png 文件 for img_path in glob.glob(outputs/**/face_fusion_*.png, recursiveTrue): # 提取日期和序号 parts img_path.split(/) date_part parts[-2] # 如
base_name os.path.basename(img_path) # 如 face_fusion_
png # 构造新名日期_序号_融合比例.png示例 new_name f{date_part}_{base_name.replace(face_fusion_, )} # 重命名谨慎建议先测试 new_path os.path.join(os.path.dirname(img_path), new_name) os.rename(img_path, new_path) print(fRenamed: {img_path} → {new_path})运行前请务必备份原目录。
此类脚本可集成进CI/CD流程实现全自动归档。
6.
常见问题速查为什么找不到图怎么解决问题现象可能原因解决方案WebUI显示“融合成功”但 outputs 文件夹为空宿主机未挂载 volume或挂载路径错误检查docker run命令是否含-v确认挂载路径拼写正确用docker exec进容器验证/root/outputs/是否真有文件outputs 文件夹里有文件但全是黑图或损坏图显存不足导致图像写入失败或PNG编码库异常升级NVIDIA驱动降低输入图分辨率检查nvidia-smi确认GPU内存充足同一天生成多张图但编号跳变如 001→003中间某次融合因超时/报错中断编号仍递增属正常行为编号只增不减检查日志确认是否报错忽略跳号以文件修改时间为准想删除某天的所有图但担心误删其他数据outputs 是独立目录与其他功能隔离安全删除rm -rf outputs/
/不会影响模型、配置或WebUI运行
最佳实践
总结三步养成好习惯别再让成果“消失”在容器里。
只需坚持这三步从此融合结果尽在掌控启动必挂载每次docker run都加上-v /your/local/path:/root/outputs命名即归档利用outputs/YYYY-MM-DD/天然按日期分组每周压缩一次当周文件夹右键即备份对重要结果右键“图片另存为”到桌面或云盘双重保险。
记住技术工具的价值不在于它多强大而在于你能否稳定、可靠、零门槛地拿到结果。
/root/outputs/就是那个沉默却忠实的保管员——你只需给它一条通往现实世界的路它就把每一份创意稳稳交到你手上。