自动化排版：AWPortrait-Z生成图片+文字组合-程序员充电站

自动化排版：AWPortrait-Z生成图片+文字组合

1. 快速开始

启动 WebUI

在使用 AWPortrait-Z 进行人像美化与图像生成之前，首先需要正确启动其 WebUI 界面。推荐通过脚本方式一键启动，确保依赖环境已配置完成。

方法一：使用启动脚本（推荐）

cd /root/AWPortrait-Z ./start_app.sh

该脚本会自动激活 Python 虚拟环境、加载模型并启动服务，适合大多数用户。

方法二：直接启动

cd /root/AWPortrait-Z python3 start_webui.py

适用于调试或自定义参数场景。

访问界面

服务成功启动后，可通过浏览器访问本地或远程接口：

http://localhost:7860

若部署在远程服务器上，请将localhost替换为实际 IP 地址，并确保防火墙开放 7860 端口。

停止服务

当使用完毕需关闭服务时，可通过以下命令操作：

查看进程 PID：

lsof -ti:7860

停止服务：

kill <PID>

或使用管道简化操作：

lsof -ti:7860 | xargs kill

此方法可快速终止占用 7860 端口的进程，避免端口冲突。

2. 界面介绍

整体布局

AWPortrait-Z 的 WebUI 采用清晰直观的双栏式设计，结合现代卡片风格，提升用户体验和操作效率。整体结构如下所示：

┌─────────────────────────────────────────────────┐ │ AWPortrait-Z 人像生成 │ ← 标题区（紫蓝渐变） ├─────────────────────────────────────────────────┤ │ webUI二次开发 by 科哥 │ ← 副标题区（版权信息） ├──────────────────────┬──────────────────────────┤ │ 输入面板 │ 输出面板 │ │ - 提示词输入 │ - 生成结果图库 │ ← 主内容区（左右双栏） │ - 参数预设按钮 │ - 状态信息 │ │ - 高级参数设置 │ │ │ - 生成按钮 │ │ ├──────────────────────┴──────────────────────────┤ │ 历史记录（折叠面板） │ ← 历史记录区 └─────────────────────────────────────────────────┘

区域说明

标题区
显示主应用名称“AWPortrait-Z 人像生成”，背景为紫蓝色渐变，视觉突出。
副标题区
展示开发者信息：“webUI二次开发 by 科哥”，用于标识来源及维护者。
输入面板（左栏）
白色卡片容器，包含：
- 正面/负面提示词输入框
- 预设参数按钮（如写实人像、动漫风格等）
- 高级参数折叠区域
- “🎨 生成图像”主控按钮
输出面板（右栏）
实时展示生成结果，包括：
- 图像缩略图网格（默认 3x2 布局）
- 当前生成状态信息（进度条、耗时、完成提示）
历史记录区（底部折叠面板）
可展开查看过往生成记录，支持点击缩略图恢复对应参数，便于复现与优化。

3. 基础功能

3.1 文本生成图像

AWPortrait-Z 支持基于文本描述生成高质量人像图像，核心流程如下：

输入正面提示词
在“正面提示词”文本框中输入英文描述语句，建议结构清晰、细节丰富。
示例：
```
a professional portrait photo, realistic, detailed, high quality, soft lighting
```
输入负面提示词（可选）
排除不希望出现的内容，提高生成质量。
示例：
```
blurry, low quality, distorted, ugly, watermark
```
点击生成按钮
点击“🎨 生成图像”触发推理过程。
查看输出结果
生成完成后，图像自动显示在右侧图库中，同时状态栏更新为✅ 生成完成！共 1 张。

提示：英文提示词语义更准确；多用逗号分隔关键词以增强解析效果。

3.2 使用参数预设

系统内置多种常用预设，帮助用户快速获得理想效果，无需手动调参。

预设名称	适用场景	分辨率	推理步数	特点
写实人像	真实感人像照片	1024x1024	8 步	高质量、自然光影
动漫风格	二次元角色	1024x768	12 步	风格化强、色彩鲜明
油画风格	艺术画作	1024x1024	15 步	笔触感明显、艺术氛围浓
快速生成	快速预览	768x768	4 步	速度快、适合初筛

使用方法：

点击任意预设按钮（如“写实人像”）
所有相关参数自动填充至输入面板
可在此基础上微调后生成

3.3 批量生成

支持一次生成多张图像，提升探索效率。

操作步骤：

展开“高级参数”面板
调整“批量生成数量”滑块（范围：1–8）
点击“生成图像”
所有图像以网格形式展示于输出区

典型应用场景：

对比不同随机种子下的构图差异
快速筛选最佳候选图像
参数固定时测试多样性输出

3.4 查看历史记录

所有生成图像均自动保存至本地outputs/目录，并可在界面中查看历史缩略图。

操作流程：

点击底部“历史记录”折叠面板
点击“刷新历史”按钮加载最新记录
缩略图按时间倒序排列（最新在前），最多显示 16 张（8x2 网格）

3.5 从历史恢复参数

点击任意历史缩略图，系统将自动还原生成该图像时的所有参数配置，包括：

正面/负面提示词
图像尺寸
推理步数
引导系数
随机种子
LoRA 强度

此功能极大提升了迭代效率，特别适用于：

复现满意结果
在已有基础上进行微调
学习优秀参数组合模式

4. 高级功能

4.1 高级参数调整

展开“高级参数”面板后，可对以下关键参数进行精细化控制。

图像尺寸

高度/宽度：支持 512–2048 像素范围内调节
默认值：1024×1024（正方形适配多数人像比例）
推荐配置：
- 1024×768：横向全身像
- 768×1024：纵向半身特写
- 更高分辨率需注意显存占用

推理步数

范围：1–50 步
建议区间：
- 4–8 步：快速预览，适合初步筛选
- 8–15 步：平衡质量与速度（推荐）
- 15+ 步：细节更丰富，但边际收益递减
特别说明：Z-Image-Turbo 模型针对低步数优化，8 步即可达到良好效果

引导系数 (Guidance Scale)

取值范围：0.0–20.0，默认为 0.0
行为特征：
- 0.0：自由生成，创造性强
- 1.0–5.0：轻度引导，保留一定随机性
- 5.0–10.0：严格遵循提示词
- 10.0：可能导致伪影或过饱和
建议：对于 Z-Image-Turbo 模型，0.0 引导系数表现最优

随机种子 (Seed)

特殊值-1：每次生成新随机种子，输出多样化
固定值：相同参数下可复现完全一致的结果
用途建议：
- 初期探索：使用-1
- 微调优化：固定种子对比参数影响

LoRA 强度

范围：0.0–2.0，默认 1.0
效果梯度：
- 0.0：仅使用基础模型
- 0.5–1.0：轻微风格迁移
- 1.0–1.5：标准美化增强（推荐）
- 1.5：可能过度修饰导致失真
注意事项：若 LoRA 模型未正确加载，此参数无效

批量生成数量

最大支持：8 张/次
性能权衡：数量越多越消耗显存，建议普通设备控制在 4 张以内

4.2 实时进度反馈

生成过程中提供动态进度条，提升等待体验。

显示内容：

当前步骤 / 总步数（如4/8）
进度百分比（如50%）
进度条动画
预估剩余时间（部分版本支持）

示例：

生成中: 4/8 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 50%

4.3 状态信息反馈

位于输出面板下方的“状态”文本框实时反馈系统消息：

成功提示：✅ 生成完成！共 X 张
错误提示：❌ 生成失败：CUDA out of memory
参数加载：✅ 已加载预设：写实人像

有助于快速定位问题和确认操作结果。

5. 参数说明

5.1 提示词编写技巧

正面提示词结构建议

[主体] + [风格] + [质量词] + [细节描述]

完整示例：

a young woman, professional portrait photo, realistic, detailed, soft lighting, natural skin texture, sharp focus, 8k uhd, dslr

常用质量词

high quality,masterpiece,best quality
detailed,intricate details,fine details
sharp focus,8k uhd,dslr,professional
realistic,photorealistic,lifelike

常见风格词分类

类型	关键词
写实	`realistic`,`natural`,`studio lighting`
动漫	`anime`,`cel shading`,`vibrant colors`
油画	`oil painting`,`impressionism`,`brush strokes`
素描	`pencil sketch`,`charcoal drawing`,`monochrome`

负面提示词推荐

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

5.2 参数组合建议

根据不同需求推荐三类典型配置：

快速预览模式

尺寸: 768x768 步数: 4 引导系数: 0.0 LoRA 强度: 0.8

适用于草图构思、快速验证想法

标准生成模式

尺寸: 1024x1024 步数: 8 引导系数: 0.0 LoRA 强度: 1.0

平衡速度与质量，日常使用首选

高质量精修模式

尺寸: 1024x1024 步数: 15 引导系数: 3.5 LoRA 强度: 1.2

用于最终输出，细节更丰富

6. 常见问题

Q1: 生成图像质量不理想？

解决方案：

丰富提示词，加入更多细节描述
提升推理步数至 12–15 步
调整 LoRA 强度至 0.8–1.5 区间
使用“写实人像”等高质量预设
固定随机种子后微调其他参数

Q2: 生成速度太慢？

优化建议：

降低分辨率至 768x768
减少推理步数（尝试 4–8 步）
单次批量数量控制在 1–2 张
检查日志是否启用 GPU（应显示使用设备: cuda）

Q3: 提示词似乎不起作用？

可能原因及对策：

引导系数为 0.0：适当提高至 3.5–5.0 加强控制
提示词过于简略：补充具体描述词
正负提示冲突：检查是否存在矛盾描述
LoRA 未加载成功：查看日志确认模型加载状态

Q4: 无法访问 WebUI 页面？

排查步骤：

查看启动日志：tail -f webui_startup.log
检查端口占用：lsof -ti:7860
确认防火墙策略是否放行 7860 端口
远程访问时使用服务器公网 IP 替代 localhost

Q5: 历史记录为空或不刷新？

解决办法：

点击“刷新历史”按钮手动加载
检查outputs/目录是否存在且可读写
确认outputs/history.jsonl文件存在
尝试重新生成一张图像以触发保存机制

7. 使用技巧

技巧 1: 渐进式优化工作流

采用分阶段优化策略，高效达成理想效果：

使用“快速生成”预设（4 步，768x768）快速出图
观察构图与姿态，选定满意结果并记录种子
固定种子，切换至标准参数（1024x1024，8 步）
微调提示词与 LoRA 强度
最终使用高质量参数（15 步）输出成品

优势：大幅减少资源浪费，加快迭代节奏

技巧 2: 批量对比法

利用批量生成功能一次性获取多个候选方案：

设置批量数量为 4–8
使用随机种子（-1）
生成一组图像进行横向比较
选择最优结果，通过历史记录恢复参数继续优化

价值：突破单次生成局限，提升成功率

技巧 3: 参数实验对照

通过控制变量法系统评估参数影响：

步数实验：固定其他参数，测试 4/8/12/15 步效果
LoRA 强度实验：分别设置 0.5/1.0/1.5/2.0 观察风格变化
引导系数实验：对比 0.0/3.5/7.0/10.0 下的提示词遵从度

意义：建立个人经验数据库，形成稳定产出能力

技巧 4: 提示词模板复用

构建标准化提示词模板，提升一致性与效率。

人像通用模板：

[年龄] [性别], [表情], [服装], [发型], professional portrait photo, realistic, detailed, soft lighting, natural skin texture, sharp focus, high quality, 8k uhd, dslr

风景摄影模板：

[场景描述], [时间/天气], [光线效果], landscape photography, realistic, detailed, wide angle, dramatic lighting, vibrant colors, high quality, 8k uhd

艺术创作模板：

[主体], [艺术风格], [色彩描述], [画家名字] style, masterpiece, detailed, intricate details, fine art, museum quality

技巧 5: 历史记录管理规范

合理组织生成成果，便于长期使用：

定期清理不满意的历史图像
对重要作品手动重命名归档
截图保存优质参数组合
按风格创建子目录分类存储（如/outputs/anime,/outputs/realistic）

8. 快捷操作与技术支持

快捷键支持

Enter 键：聚焦生成按钮后回车即可启动生成
F5 键：在历史记录区域刷新页面

常用运维命令汇总

启动服务：

cd /root/AWPortrait-Z && ./start_app.sh

查看运行日志：

tail -f /root/AWPortrait-Z/webui_startup.log

停止服务：

lsof -ti:7860 | xargs kill

清理输出缓存：

rm -rf /root/AWPortrait-Z/outputs/*

技术支持信息

开发者：科哥
联系方式：微信 312088415
项目承诺：永久开源免费使用，但须保留版权信息

反馈渠道：

微信私聊开发者
GitHub Issue 提交问题
分享使用案例与改进建议

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