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星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
