输出文件在哪找？默认保存路径和命名规则说明

你刚用「unet person image cartoon compound人像卡通化构建by科哥」这个镜像完成了几张照片的卡通化处理，点击“下载结果”按钮后，图片顺利保存到了电脑里——但你有没有想过：如果没点下载，或者批量处理时想直接去文件夹里翻看所有结果，这些文件到底藏在哪儿？叫什么名字？能不能改？

这个问题看似简单，却直接影响你的使用效率和后续流程衔接。本文不讲模型原理、不跑代码、不调参，就专注回答一个最实际的问题：输出文件的物理位置、生成逻辑、命名方式，以及如何按需调整。

1. 默认保存路径：固定位置，无需猜测

无论你是在单图转换页上传一张自拍，还是在批量转换页一次性拖入20张合影，所有生成的卡通化图片，默认都统一保存在镜像容器内的固定目录下：

/root/outputs/

这是该镜像在启动时预设的输出根目录，也是WebUI界面背后实际写入文件的位置。

验证方法：在浏览器中打开http://localhost:7860后，打开开发者工具（F12 → Console），执行以下命令（需已启用终端访问权限）：
docker exec -it <容器名或ID> ls -l /root/outputs/
你会看到类似outputs_20250412153248.png的文件列表。

这个路径设计有明确考量：

隔离性：与模型权重（/root/models/）、WebUI源码（/root/gradio/）等核心目录分离，避免误删；
可访问性：位于容器用户主目录下，无需sudo权限即可读写；
一致性：无论单图/批量/重试，全部落在此处，便于脚本批量处理或定时归档。

2. 文件命名规则：时间戳+格式后缀，清晰可追溯

镜像不会给文件起“我的自拍_v2_cartoon”这类人工命名，而是采用严格的时间戳命名机制，确保每张输出唯一、有序、可回溯：

2.1 命名格式解析

所有生成文件均遵循统一模板：

outputs_年月日时分秒.格式后缀

例如：

outputs_20250412153248.png→ 2025年4月12日15点32分48秒生成的PNG图
outputs_20250412153302.jpg→ 同一分钟后生成的JPG图
outputs_20250412153315.webp→ 再过13秒生成的WEBP图

2.2 时间精度说明

精确到秒级：不包含毫秒，避免命名过长且无实际必要；
24小时制：无AM/PM歧义，排序天然符合时间流（如outputs_20250412153248<outputs_20250412153302）；
零填充对齐：04月、09时、05分等均补零，保证字符串长度一致，利于Shell脚本按字典序排序。

2.3 为什么不用原图名？

镜像设计者（科哥）明确规避了“保留原文件名”的做法，原因很务实：

防冲突：多张同名图（如IMG_001.jpg）同时上传时，不会因覆盖导致丢失；
防乱码：中文、空格、特殊符号在Linux路径中易引发权限或编码问题；
可审计：时间戳即操作记录，无需额外日志即可还原处理序列。

注意：该命名规则仅适用于WebUI界面生成的文件。若你通过API调用或命令行脚本直接调用模型函数，命名逻辑可能不同（需查阅对应接口文档）。

3. 批量处理的文件组织：平铺存放，无子目录

当你在「批量转换」标签页上传15张照片并完成处理后，所有结果不会按原图分组存入子文件夹，而是全部平铺在/root/outputs/目录下：

/root/outputs/ ├── outputs_20250412153248.png ├── outputs_20250412153302.jpg ├── outputs_20250412153315.webp ├── outputs_20250412153328.png ├── outputs_20250412153341.jpg ... └── outputs_20250412153522.png

这种设计带来两个关键优势：

下载轻量：打包ZIP时无需遍历嵌套结构，压缩速度快；
脚本友好：find /root/outputs -name "outputs_*.png" | head -n 10可直接提取最新10张PNG，无需路径拼接。

小技巧：若需区分批次，可在每次批量处理前，先手动清空/root/outputs/（执行rm -f /root/outputs/outputs_*），再开始上传——这样该目录下的所有文件即为本次任务产出。

4. 如何修改默认保存路径？（进阶操作）

虽然默认路径稳定可靠，但某些场景下你可能需要变更：

将输出自动同步到NAS共享目录；
避免容器重启后/root/outputs/数据丢失；
与现有工作流（如Photoshop批处理脚本）路径对齐。

4.1 容器启动时挂载新路径（推荐）

在运行镜像时，通过-v参数将宿主机目录挂载到容器内目标路径：

docker run -d \ --name cartoon-app \ -p 7860:7860 \ -v /your/host/path/cartoon_outputs:/root/outputs \ unet-person-cartoon:latest

此时，所有输出将实时写入宿主机的/your/host/path/cartoon_outputs/，容器内/root/outputs/只是该目录的映射视图。容器重启、重装均不影响历史文件。

4.2 修改WebUI配置（不推荐新手）

镜像基于Gradio构建，理论上可通过修改launch.py中的output_dir参数实现路径变更。但该操作需：

进入容器修改Python源码；
重新启动Web服务；
失去镜像版本一致性，升级困难。

除非你有定制化部署需求，否则强烈建议优先使用挂载方式——安全、可逆、无需改代码。

5. 常见疑问直答：关于文件位置的高频问题

Q1：我点了“下载结果”，但没找到文件，它到底存在哪？

A：浏览器默认将文件保存至系统“下载”文件夹（如 Windows 的C:\Users\用户名\Downloads，macOS 的~/Downloads）。这不是镜像的输出路径，而是浏览器的本地保存行为。若需直接访问原始文件，请始终前往/root/outputs/目录查看。

Q2：批量处理中断了，已生成的文件还在吗？

A：在。镜像采用“逐张处理+即时落盘”策略。即使第8张失败，前7张已成功写入/root/outputs/，文件名仍为对应时间戳，可直接提取使用。

Q3：能自定义文件名前缀吗？比如改成`cartoon_20250412_xxx.png`？

A：当前WebUI版本不支持前缀自定义。命名逻辑固化在后端Python代码中。如确有此需求，可向开发者科哥提Issue（微信：312088415），或自行fork项目修改inference.py中的save_path生成逻辑。

Q4：输出目录满了怎么办？会自动清理旧文件吗？

A：不会自动清理。/root/outputs/是纯写入目录，无生命周期管理。建议：

定期手动清理：rm -f /root/outputs/outputs_202503*（删除3月所有文件）；
或在挂载的宿主机目录上设置定时任务（如Linuxcron）自动归档。

6. 实用建议：让文件管理更高效

基于上述路径与命名规则，这里给出3条即刻可用的实践建议：

6.1 快速定位最新生成图（Linux/macOS终端）

# 进入容器，查看最新5个输出文件 docker exec -it cartoon-app ls -t /root/outputs/ | head -n 5 # 直接显示最新PNG的完整路径（方便复制） docker exec -it cartoon-app find /root/outputs -name "outputs_*.png" -type f | head -n 1

6.2 批量重命名适配工作流（示例：添加前缀）

若需将所有输出改为cartoon_开头，可在宿主机挂载目录下执行（假设挂载到/mnt/cartoon）：

cd /mnt/cartoon for f in outputs_*.png; do mv "$f" "cartoon_${f#outputs_}" done

执行后outputs_20250412153248.png→cartoon_20250412153248.png。

6.3 与外部工具联动（如用Python自动处理）

import os import glob from pathlib import Path # 指向挂载的输出目录 output_dir = Path("/mnt/cartoon") # 获取最近1小时内生成的所有PNG recent_pngs = [ f for f in glob.glob(str(output_dir / "outputs_*.png")) if (os.path.getmtime(f) > (time.time() - 3600)) ] print(f"发现 {len(recent_pngs)} 张新卡通图，准备批量处理...") # 此处插入你的图像处理逻辑（如加水印、转Base64等）