Z-Image-Turbo WebUI 本地部署与使用指南
Z-Image-Turbo WebUI 是一个基于容器化技术的本地 AI 绘画工具，旨在简化环境配置流程。它预装了 Conda、PyTorch 及 CUDA 依赖，用户无需手动处理版本冲突或驱动问题，即可实现离线运行。
1. 快速启动
镜像最大的优势在于将部署过程压缩为一条命令。无论本地是否安装 Conda 或 Python，脚本会自动处理环境激活与模型加载。
1.1 执行启动脚本
在终端（Linux/macOS）或 WSL（Windows）中进入镜像根目录，执行：
bash scripts/start_app.sh
该脚本位于镜像内部，无需额外下载。执行后会自动激活 Conda 环境并启动服务。
启动成功时，终端会输出如下信息：
================================================== Z-Image-Turbo WebUI 启动中... ================================================== 模型加载成功！启动服务器：0.0.0.0:7860 请访问：http://localhost:7860
注意：模型已在后台静默加载完毕，服务就绪后即可响应请求，无需等待漫长的编译提示。
1.2 访问界面
浏览器地址栏输入 http://localhost:7860 即可访问。脚本已自动检测端口占用情况，通常无需修改 hosts 或 IP。
提示：首次访问可能需要数秒加载前端资源，后续刷新速度较快。
1.3 底层优化逻辑
该镜像并非简单的打包，而是针对性能做了三项关键调整：
- 环境固化：基于
miniconda3 + torch28 + CUDA 12.4定制，规避 Python 包冲突。 - 模型预热：内置
model.warmup()逻辑，首次生成前完成显存分配与计算图编译。 - 轻量路由：精简版 Gradio 后端，移除多余 API 与监控埋点，专注功能本身。
2. 核心操作
WebUI 界面简洁，主要包含三个标签页，日常使用集中在图像生成页。
2.1 中文提示词输入
正向提示词（Prompt）框支持原生中文语义理解，无需翻译或添加权重模板。
例如输入：
一只橘猫趴在窗台边，阳光斜射，毛发泛金光，高清摄影风格
点击右下角绿色闪电图标生成。默认输出为 1024×1024 高清图，细节表现稳定。
2.2 尺寸与风格预设
底部提供常用尺寸一键切换，避免手动计算宽高倍数：
1024×1024：默认高清方形，适合海报、印刷。横版 16:9：适配 B 站封面、PPT 背景。竖版 9:16：匹配手机锁屏、短视频平台。512×1024：快速草稿模式，测试提示词效率更高。
实测同一提示词下，512×512 模式耗时约 4 秒，1024×1024 约 16 秒，画质均满足发布需求。
2.3 负向提示词优化
新手常忽略负向提示词的作用，其实它能有效过滤常见缺陷。
建议粘贴以下通用负面描述：
低质量，模糊，扭曲，多余手指，畸形肢体，文字水印，边框，签名
