/bin/bash /root/run.sh重启技巧：服务恢复实战
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 压缩包
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. 服务管理与重启技巧
10.1 启动与重启命令
当服务异常退出或需要更新配置时，可通过以下命令重新启动应用：
/bin/bash /root/run.sh该脚本负责：
- 激活 Python 虚拟环境
- 安装缺失依赖（首次运行）
- 启动 Gradio Web 服务
- 绑定到本地 7860 端口
- 自动加载预训练模型
10.2 何时需要重启？
以下情况建议执行重启操作：
- 修改了
config.yaml或参数设置 - 模型加载失败或报错
- Web 页面无法访问或白屏
- 批量任务卡住无响应
- 添加新功能或更新代码后
10.3 重启前的检查清单
在执行/bin/bash /root/run.sh前，请确认：
端口占用情况
检查 7860 端口是否被占用：lsof -i :7860若已被占用，可终止进程或修改启动端口。
磁盘空间充足
确保/root和/tmp分区有足够的临时空间：df -h模型文件完整
检查models/目录下是否存在dct_net.pth等核心权重文件。权限正确
确保run.sh具备可执行权限：chmod +x /root/run.sh
10.4 重启后的验证步骤
重启成功后，按以下顺序验证服务状态：
观察终端输出是否出现：
Running on local URL: http://localhost:7860打开浏览器访问
http://localhost:7860，确认页面正常加载。上传一张测试图片，点击“开始转换”，观察是否能在 10 秒内返回结果。
查看
outputs/目录是否有新生成的文件。检查日志中是否有
ERROR或WARNING提示。
10.5 自动化重启建议
为提升稳定性，可设置定时健康检查脚本。例如创建health_check.sh：
#!/bin/bash if ! curl -s http://localhost:7860 | grep -q "Cartoon"; then echo "Service not responding, restarting..." pkill -f "gradio" sleep 3 /bin/bash /root/run.sh & fi配合 crontab 每 5 分钟检测一次：
*/5 * * * * /bin/bash /root/health_check.sh10.6 故障排查技巧
如果/bin/bash /root/run.sh执行后立即退出：
- 查看输出日志中的第一条错误信息
- 确认 Python 环境中已安装
torch,gradio,numpy等依赖 - 检查模型路径是否正确挂载
- 尝试手动运行 Python 启动脚本调试：
python app.py --port 7860 --share False
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
