Z-Image Turbo 本地部署与使用指南
Z-Image Turbo 是一款基于 Diffusers 官方推理管道深度定制的轻量级 AI 绘画工具，核心目标是实现快速、稳定、准确的本地生成。相比云端方案，本地部署能提供更好的数据隐私、响应速度和长期成本控制。
1. 为什么选择本地部署？
1.1 性能优势
Z-Image Turbo 采用 Turbo 架构，对去噪路径进行了重新设计。普通 SD 模型可能需要 20 步才能出轮廓，而 Z-Image Turbo 在 4 步即可完成构图，8 步达到细节峰值。实测在 RTX 4060 上，768×768 分辨率平均耗时仅 3.2 秒。
1.2 稳定性保障
通过三重加固解决常见部署问题：全链路 bfloat16 计算防止数值溢出；CPU Offload 自动卸载不活跃层；内置显存碎片整理器实时回收空闲显存。这使得即使在显存较小的设备上也能稳定运行。
1.3 中文友好与风格聚焦
针对大量高质量国风数据做了提示词空间对齐。输入'青绿山水，北宋范宽笔意'，模型能精准还原山石皴法与绢本质感，无需复杂的英文提示词工程。
2. 三步完成本地部署
2.1 下载镜像并解压
获取官方发布的预构建镜像包（注意认准 Gradio + Diffusers 字样）。下载后得到一个 .zip 压缩包，例如 z-image-turbo-local-v1.2.0.zip。
解压到任意目录，例如 D:\AI\Z-Image-Turbo (Windows) 或 ~/Documents/AI/Z-Image-Turbo (macOS/Linux)。解压后主要包含以下文件夹：
├── models/ # 预置模型权重
├── webui/ # Gradio 前端界面
├── launch.bat # Windows 一键启动脚本
├── launch.sh # macOS/Linux 一键启动脚本
└── requirements.txt # 依赖清单
2.2 运行启动脚本
进入解压目录，根据操作系统执行对应脚本：
- Windows：双击
launch.bat - macOS/Linux：打开终端，执行
chmod +x launch.sh && ./launch.sh
脚本会自动检测系统环境、启动虚拟环境、加载模型并启动 Gradio 服务。默认监听地址为 http://127.0.0.1:7860。
2.3 界面初体验
首次打开页面，左侧为提示词区域，中间为实时预览窗，右侧为参数控制区。所有高频功能均在显眼位置，无需复杂配置。
3. 基础使用流程
3.1 编写提示词
支持中英文混输。建议遵循'主体 + 氛围 + 风格 + 质感'的结构。 示例：
一位撑油纸伞的少女，站在青石板小巷口，细雨如丝，空气湿润，水墨淡彩风格，留白构图，吴冠中笔意
3.2 调整参数
三个关键滑块影响结果最大：
- 步数 (Steps)：设为 8。Turbo 模型的黄金步数，平衡速度与质量。
- 引导系数 (CFG)：设为 1.8。平衡提示词遵循度与艺术自由度。
- 分辨率 (Resolution)：选 768×768。日常创作的完美平衡点。
3.3 生成与保存
点击【生成】按钮，图片自动保存到 文件夹。文件名包含时间戳与提示词关键词。支持放大查看、下载 PNG、复制提示词等操作。
