Safari用户注意:unet WebUI可能存在布局错位问题说明
1. 功能概述
本工具基于阿里达摩院 ModelScope 的 DCT-Net 模型,支持将真人照片转换为卡通风格。
支持的功能:
- 单张图片卡通化转换
- 批量多张图片处理
- 多种风格选择(当前支持标准卡通风格)
- 自定义输出分辨率
- 风格强度调节
- 多种输出格式 (PNG/JPG/WEBP)
2. 界面说明
启动后访问http://localhost:7860,主界面包含三个标签页:
2.1 单图转换
用于单张图片的卡通化处理。
左侧面板:
- 上传图片- 支持点击上传或粘贴图片
- 风格选择- 选择卡通化风格
- 输出分辨率- 设置输出图片最长边像素值 (512–2048)
- 风格强度- 调节卡通化效果强度 (0.1–1.0)
- 输出格式- 选择保存格式 (PNG/JPG/WEBP)
- 开始转换- 点击执行转换
右侧面板:
- 转换结果- 显示卡通化后的图片
- 处理信息- 显示处理时间、图片尺寸等信息
- 下载结果- 下载生成的图片
提示:首次运行需加载模型权重,后续转换速度会显著提升。
2.2 批量转换
用于同时处理多张图片。
左侧面板:
- 选择多张图片- 可一次选择多张图片上传
- 批量参数- 与单图转换相同的参数设置
- 批量转换- 点击开始批量处理
右侧面板:
- 处理进度- 显示当前处理进度
- 状态- 显示处理状态文本
- 结果预览- 以画廊形式展示所有结果
- 打包下载- 下载所有结果的 ZIP 压缩包
建议:单次批量处理不超过 20 张图片,避免内存占用过高导致中断。
2.3 参数设置
高级参数配置界面。
输出设置:
- 默认输出分辨率- 设置默认的输出分辨率
- 默认输出格式- 设置默认的输出格式
批量处理设置:
- 最大批量大小- 限制一次最多处理的图片数量 (1–50)
- 批量超时时间- 批量处理的最大等待时间
3. 使用流程
3.1 单张图片转换
1. 点击「上传图片」选择照片 ↓ 2. 调整「输出分辨率」和「风格强度」 ↓ 3. 点击「开始转换」按钮 ↓ 4. 等待约 5–10 秒(取决于图片大小) ↓ 5. 查看结果,点击「下载结果」保存参数建议:
- 分辨率: 1024(平衡画质和速度)
- 风格强度: 0.7–0.9(自然卡通效果)
- 输出格式: PNG(无损质量)
3.2 批量图片转换
1. 切换到「批量转换」标签 ↓ 2. 点击「选择多张图片」上传多张照片 ↓ 3. 设置统一的转换参数 ↓ 4. 点击「批量转换」 ↓ 5. 等待全部处理完成 ↓ 6. 点击「打包下载」获取 ZIP 文件注意事项:
- 批量处理会依次处理每张图片
- 建议单次不超过 20 张图片
- 处理时间 ≈ 图片数量 × 8 秒
4. 参数说明
4.1 风格选择
| 风格 | 效果描述 |
|---|---|
| cartoon | 标准卡通风格,适合大多数人像 |
未来将支持更多风格:日漫风、3D风、手绘风、素描风、艺术风
4.2 输出分辨率
| 设置 | 适用场景 |
|---|---|
| 512 | 快速预览、低分辨率输出 |
| 1024 | 推荐设置,平衡质量和速度 |
| 2048 | 高清输出、打印用途 |
4.3 风格强度
| 强度 | 效果 |
|---|---|
| 0.1 – 0.4 | 轻微风格化,保留较多原图细节 |
| 0.5 – 0.7 | 中等风格化,推荐范围 |
| 0.8 – 1.0 | 强烈风格化,卡通效果明显 |
4.4 输出格式
| 格式 | 优点 | 缺点 |
|---|---|---|
| PNG | 无损压缩,支持透明通道 | 文件较大 |
| JPG | 文件小,兼容性好 | 有损压缩 |
| WEBP | 现代格式,压缩率高 | 旧设备可能不支持 |
5. 常见问题
Q1: 转换失败怎么办?
A:检查以下几点:
- 确认上传的是有效图片文件
- 检查图片格式是否支持 (jpg/png/webp)
- 查看浏览器控制台是否有错误信息
Q2: 处理时间过长?
A:可能原因:
- 图片分辨率过高 — 尝试降低输出分辨率
- 系统资源不足 — 关闭其他占用程序
- 首次运行需要加载模型 — 后续会更快
Q3: 效果不满意?
A:调节建议:
- 增强/减弱「风格强度」
- 尝试不同的「输出分辨率」
- 确保输入照片人物面部清晰可见
Q4: 批量处理中断?
A:已处理的图片会保存在输出目录,可以:
- 重新处理剩余图片
- 在 outputs 文件夹查看已生成结果
Q5: 输出文件在哪里?
A:默认保存位置:
项目目录/outputs/文件名格式:outputs_年月日时分秒.png
6. 输入图片建议
推荐:
- 清晰的人物正面照片
- 光线均匀,面部无遮挡
- 分辨率不低于 500×500
- JPG/PNG 格式
不推荐:
- 模糊、低质量照片
- 侧脸、遮挡严重
- 过暗或过曝的照片
- 多人合影(可能只转换一张脸)
7. 快捷操作
| 操作 | 快捷方式 |
|---|---|
| 上传图片 | 直接拖拽到上传区域 |
| 粘贴图片 | Ctrl+V (剪贴板) |
| 下载结果 | 点击结果下方的下载按钮 |
8. 技术支持
- 开发者: 科哥
- 微信: 312088415
- 项目: 基于 ModelScope cv_unet_person-image-cartoon 模型
开源承诺: 本项目承诺永远开源使用,但请保留开发者版权信息。
9. 更新日志
v1.0 (2026-01-04)
- ✅ 支持单图卡通化转换
- ✅ 支持批量处理
- ✅ 可调节分辨率和风格强度
- ✅ 多种输出格式支持
- ✅ WebUI 界面优化
即将推出
- 更多卡通风格选择
- GPU 加速支持
- 移动端适配
- 历史记录功能
10. Safari 浏览器兼容性说明
近期收到部分用户反馈,在使用 Safari 浏览器访问本工具 WebUI 时,页面存在布局错位问题,主要表现为:
- 左右面板错层或重叠
- 按钮位置偏移
- 图片预览区域显示异常
- 批量处理进度条无法正常渲染
10.1 问题原因
经排查,该问题是由于 Safari 对现代 CSS Flexbox 和 Grid 布局的部分实现差异所致。当前 WebUI 使用了 Gradio 框架构建,其默认样式在 Safari 上可能出现渲染偏差,尤其是在 macOS 和 iOS 系统中表现不一致。
10.2 临时解决方案
建议 Safari 用户采取以下任一方式获得最佳体验:
切换至 Chrome / Edge / Firefox 浏览器
- 推荐使用 Chromium 内核浏览器以确保完整兼容性
启用 Safari 开发者模式并刷新页面
- 路径:Safari → 偏好设置 → 高级 → 勾选“在菜单栏中显示开发菜单”
- 使用“响应式设计模式”重新加载页面
清除缓存并强制刷新
- 快捷键:Cmd + Shift + R(Mac)或通过开发菜单刷新
10.3 长期修复计划
我们已在 GitHub 提交 issue 并联系 Gradio 社区推动跨浏览器兼容性优化。下一版本将引入以下改进:
- 添加 Safari 特定 CSS 修复补丁
- 降级关键布局为兼容性更强的浮动方案
- 增加浏览器检测提示机制
提醒:功能逻辑不受影响,仅 UI 显示异常。即使界面错位,上传图片和转换功能仍可正常使用。
获取更多AI镜像
想探索更多AI镜像和应用场景?访问 CSDN星图镜像广场,提供丰富的预置镜像,覆盖大模型推理、图像生成、视频生成、模型微调等多个领域,支持一键部署。