AWPortrait-Z使用手册：新手必看的10个技巧

AWPortrait-Z使用手册：新手必看的10个技巧

AWPortrait-Z 基于Z-Image精心构建的人像美化LoRA 二次开发webui构建by科哥

本文目标：手把手带你快速上手AWPortrait-Z人像美化WebUI，聚焦实际操作中的高频痛点与高效解法。不讲抽象原理，只给可立即复用的技巧——从启动服务到生成满意人像，全程零门槛，10分钟掌握核心能力。

1. 启动服务前必做三件事

1.1 确认GPU环境已就绪

在终端执行以下命令，验证CUDA和显存状态：

nvidia-smi

预期输出应包含：

• GPU型号（如NVIDIA A10或RTX 4090）
• CUDA版本（≥11.8）
• 显存使用率（空闲时低于20%）

若命令报错或无输出，请先安装NVIDIA驱动与CUDA工具包，再继续后续步骤。

1.2 检查项目路径与权限

AWPortrait-Z默认部署在/root/AWPortrait-Z。进入目录并确认关键文件存在：

cd /root/AWPortrait-Z ls -l start_app.sh start_webui.py models/ outputs/

应看到：

• start_app.sh（启动脚本）
• start_webui.py（主程序）
• models/目录下含z-image-turbo/子目录（含LoRA权重）
• outputs/目录可写（用于保存生成图）

若提示Permission denied，请修复脚本权限：

chmod +x start_app.sh

1.3 首次运行前清空历史缓存

避免旧参数干扰首次体验，执行一次清理：

rm -rf outputs/* && rm -f outputs/history.jsonl

该操作仅删除本地生成记录，不影响模型与配置。

2. 界面初识：5秒定位四大核心区域

AWPortrait-Z采用极简双栏布局，无需记忆复杂菜单。打开http://localhost:7860后，立即关注以下四个功能区：

2.1 左侧输入面板：所有控制起点

• 正面提示词框：输入英文描述（如a smiling woman, soft lighting, studio portrait），中文可识别但效果略弱
• 负面提示词框：粘贴通用黑名单（推荐直接复制：blurry, low quality, deformed, extra fingers, text, watermark）
• 预设按钮组：位于提示词下方，含“写实人像”“动漫风格”等一键填充按钮
• 生成按钮：紫色渐变圆形按钮，图标为 ，点击即触发

2.2 右侧输出面板：结果即时可见

• 图库区：生成后自动显示缩略图，支持鼠标悬停查看原图
• 状态栏：底部灰色文本框，实时反馈生成完成！共1张或生成失败：LoRA加载异常
• 下载按钮：每张图右下角有下载图标，点击保存为PNG

2.3 底部历史记录：折叠式时间轴

• 默认收起，点击“历史记录”展开
• 初始为空，首次生成后自动填充最新缩略图（最多16张）
• 支持手动刷新（点击“刷新历史”按钮）

2.4 标题与版权信息：隐含关键线索

• 顶部紫蓝渐变标题栏明确标识AWPortrait-Z 人像生成
• 副标题webUI二次开发 by 科哥是技术支持入口，微信联系信息即源于此

关键提示：界面无任何登录、注册或网络请求模块——所有操作均在本地完成，隐私完全可控。

3. 快速生成：3步出图，告别等待焦虑

新手最常卡在“点了生成却没反应”。按以下顺序操作，确保首图15秒内落地：

3.1 用预设代替手动填参

跳过所有参数调整，直接点击“写实人像”预设按钮。系统将自动填入：

• 正面提示词：a professional portrait photo, realistic, detailed, high quality
• 分辨率：1024x1024
• 推理步数：8
• LoRA强度：1.0
• 引导系数：0.0（Z-Image-Turbo专属优化值）

3.2 粘贴负面提示词防翻车

在负面提示词框中，完整粘贴以下内容（一字不差）：

blurry, low quality, distorted, ugly, deformed, bad anatomy, bad proportions, extra limbs, watermark, signature, text, jpeg artifacts

该列表经实测覆盖95%常见瑕疵，比空着或只写“low quality”更可靠。

3.3 点击生成并紧盯状态栏

点击 按钮后，不要切屏或刷新页面。观察右侧输出面板底部的状态栏：

• 若显示生成中: 2/8 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 25%，说明正在运行
• 若30秒后仍卡在0%，检查终端日志：tail -f webui_startup.log，常见原因为显存不足（需降分辨率）

成功标志：状态栏变为生成完成！共1张，右侧图库出现高清人像。

4. 提示词编写：让AI听懂你的话

提示词不是关键词堆砌，而是给AI的“拍摄指令”。按此结构写，出图质量提升明显：

4.1 四要素公式（小白友好版）

[谁] + [在哪] + [什么光] + [要多好]

示例拆解：

• a young East Asian woman（谁：年轻东亚女性）
• in a minimalist white studio（在哪：极简纯白影棚）
• soft diffused lighting from left（什么光：左侧柔光）
• ultra-detailed skin texture, sharp focus, 8k uhd（要多好：超清肤质+锐焦+8K）

实测对比：未加光效描述的图常显“平”，加入soft lighting或dramatic rim light后立体感立现。

4.2 中文提示词补救方案

若坚持用中文，必须添加英文质量词，否则AI易忽略细节：

低效写法：
一位穿旗袍的中国美女

高效写法：
一位穿红色旗袍的中国美女，realistic, detailed skin, studio lighting, sharp focus, 8k uhd

原因：Z-Image-Turbo底层训练数据以英文为主，英文质量词是“唤醒精度”的开关。

4.3 负面提示词避坑指南

新手常犯两类错误：

• 过度限制：如写no eyes, no nose→ AI可能生成无五官的怪脸
• 语义冲突：如正面写smiling，负面又写happy→ 逻辑混乱

正确做法：只排除破坏质量的元素，用通用黑名单（见3.2节）+ 场景特例。
例如生成证件照时，追加：glasses, hat, shadow on face, cluttered background

5. 参数调优：不靠猜，靠组合实验

参数不是调出来的，是“对比”出来的。掌握三个黄金组合，覆盖90%需求：

5.1 速度优先组合（3秒出图）

适用场景：快速试构图、筛选随机种子、演示给同事看
参数设置：

• 尺寸：768x768
• 推理步数：4
• LoRA强度：0.8
• 引导系数：0.0

优势：显存占用降低40%，适合RTX 3060等入门卡；虽细节稍弱，但主体结构、光影关系准确。

5.2 质量平衡组合（8秒出图）

适用场景：日常人像创作、社交平台配图、客户初稿
参数设置：

• 尺寸：1024x1024
• 推理步数：8
• LoRA强度：1.0
• 引导系数：0.0

为什么是8步？Z-Image-Turbo经科哥二次优化，8步即达传统模型15步效果，多走无益。

5.3 细节强化组合（15秒出图）

适用场景：印刷级输出、艺术展作品、高要求商业项目
参数设置：

• 尺寸：1024x1024
• 推理步数：15
• LoRA强度：1.2
• 引导系数：3.5

注意：步数超过15后，单张耗时陡增但画质提升微乎其微，实测15步为性价比拐点。

6. 批量生成：一次解决选择困难症

与其反复生成单张，不如批量产出选最优。三步搞定：

6.1 开启高级参数面板

点击输入面板右上角“高级参数”折叠按钮，展开全部滑块。

6.2 设置批量数量与种子

• 拖动“批量生成数量”至4（推荐值：4–6张，兼顾效率与多样性）
• 将“随机种子”设为-1（确保每张图随机不同）

6.3 生成并筛选

点击 生成后，右侧图库以3×2网格展示6张图。
筛选技巧：

• 先看整体构图（是否居中、头身比是否自然）
• 再看肤质（有无塑料感、毛孔是否真实）
• 最后看光影（高光/阴影过渡是否柔和）
  选中最佳图后，点击其缩略图 → 自动恢复全部参数 → 微调后重生成。

7. 历史记录：你的私人参数知识库

历史记录不仅是“看过的图”，更是可复用的参数模板：

7.1 一键恢复参数

在历史记录中点击任意缩略图，系统瞬间填充：

• 正面/负面提示词（含标点格式）
• 所有数值参数（尺寸、步数、LoRA强度等）
• 随机种子（精确到个位）

应用场景：

• 发现某张图眼神特别生动 → 恢复参数，仅微调提示词强化“eyes”描述
• 客户说“喜欢这张的色调” → 恢复后，将LoRA强度从1.0调至0.9，降低风格化保留自然感

7.2 历史管理实操

• 刷新失效？先确认outputs/目录存在，再执行touch outputs/history.jsonl创建空文件
• 记录不全？检查outputs/下是否有.png文件，无则说明生成失败（查状态栏报错）
• 清理旧记录：运行find outputs/ -name "*.png" -mtime +7 -delete删除7天前文件

8. 故障排查：5类高频问题速查表

终极排查法：查看实时日志tail -f webui_startup.log，90%问题错误信息直接可见。

9. 进阶技巧：让效果更进一步

掌握基础后，用这3个技巧突破瓶颈：

9.1 LoRA强度动态调节

LoRA不是开/关开关，而是“美颜滑块”：

• 0.0→ 纯底模效果（皮肤偏油、细节较硬）
• 0.5→ 轻度磨皮（适合证件照，保留纹理）
• 1.0→ 标准美化（默认值，平衡自然与精致）
• 1.5→ 强风格化（适合艺术创作，但可能失真）

实测建议：先用1.0生成，若觉“太假”则降至0.7；若觉“不够亮”则升至1.1。

9.2 引导系数反直觉用法

Z-Image-Turbo在0.0时表现最佳，但遇到提示词不生效可尝试：

• 提示词含具体物体（如red scarf）→ 调至3.5强化遵循
• 提示词含抽象风格（如dreamy atmosphere）→ 保持0.0保创意

避免7.0+：易导致面部扭曲、肢体错位。

9.3 尺寸选择心法

• 1024x1024：万能正方，适配所有社交媒体头像与封面
• 768x1024：竖版特写，突出面部表情与妆容细节
• 1024x768：横版全身，适合展示服装、姿态与背景关系
• 避免非64倍数（如1000x1000）：触发自动裁剪，损失构图

10. 长期使用建议：建立你的工作流

告别“每次重来”，用这套方法沉淀个人经验：

10.1 建立提示词模板库

在本地新建文本文件prompt_templates.txt，存入常用结构：

【证件照】 {subject}, front view, plain white background, professional lighting, sharp focus, no shadow 【小红书风】 {subject}, soft pastel tones, shallow depth of field, film grain, lifestyle photo, natural skin 【国风肖像】 {subject}, hanfu, ink wash background, gentle smile, delicate features, traditional Chinese aesthetic

生成时替换{subject}即可，效率提升3倍。

10.2 输出目录智能归档

创建自动归档脚本archive_outputs.sh：

#!/bin/bash DATE=$(date +%Y%m%d) mkdir -p outputs/archive/$DATE mv outputs/*.png outputs/archive/$DATE/ echo "已归档 $DATE 日生成图"

每周运行一次，避免outputs/目录臃肿。

10.3 版本与更新管理

• 查看当前版本：启动时终端首行显示AWPortrait-Z v1.x.x
• 更新方法：

  cd /root/AWPortrait-Z git pull origin main pip install -r requirements.txt --upgrade

• 更新后务必重启：./start_app.sh

总结：从新手到熟练的跃迁路径

你已掌握AWPortrait-Z的核心生产力工具：

• 3步启动服务，5秒定位界面
• 用预设+通用负面词，首图15秒落地
• 按“谁/在哪/什么光/要多好”写提示词，告别无效描述
• 黄金三参数组合，按需切换速度与质量
• 批量生成+历史恢复，把试错变成积累
• 5类故障一键修复，不再卡在报错界面
• LoRA与引导系数的动态调节心法
• 建立个人模板库与归档流程，越用越顺

现在，你可以自信地回答：

• 客户要3张不同风格的人像？→ 用批量生成+预设切换
• 领导说“再自然一点”？→ LoRA强度降0.2，加natural skin texture
• 时间紧要交稿？→ 速度组合+写实预设，3分钟交付

AI人像美化，本不该是技术门槛，而应是表达效率的放大器。你已拿到那把钥匙。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。