Stable Diffusion WebUI 集成 Lingyuxiu MXJ LoRA 插件方案

对于显存≤12GB 的用户（如 RTX 3060 12G），建议搭配--medvram启动参数，并将采样步数控制在 20 步以内，同样可获得风格准确、五官清晰的输出效果。

3. 三步完成集成：无需改代码，不碰配置文件

本方案以Stable Diffusion WebUI 插件形式交付，全程图形界面操作，零命令行依赖。以下是完整集成流程：

3.1 插件安装（1 分钟）

1. 打开你的 Stable Diffusion WebUI 根目录（如 stable-diffusion-webui/）；
2. 进入 extensions/ 子目录；
3. 新建文件夹，命名为 sd-webui-lingyuxiu-mxj；
4. 将项目提供的 main.py、scripts/、locales/ 等全部文件复制到该文件夹内；
5. 重启 WebUI（或点击界面右上角'Reload UI'按钮）。

成功标志：WebUI 左上角出现'MXJ'图标，左侧提示词区域下方新增'Lingyuxiu MXJ LoRA'控制面板。

3.2 权重准备（30 秒）

1. 访问项目官方发布页（如 GitHub Releases），下载最新版 lingyuxiu_mxj_sdxl_v*.safetensors 文件；
2. 将其放入 WebUI 标准 LoRA 路径：models/Lora/lingyuxiu_mxj/（若目录不存在，请手动创建）；
3. 确保文件名含明确版本号（如 lingyuxiu_mxj_sdxl_v2.10.safetensors）。

注意：请勿将 LoRA 文件放在 models/Lora/ 根目录或其他子目录，否则无法被自动识别。

3.3 启动与验证（1 分钟）

1. 启动 WebUI（webui-user.bat 或 ./webui.sh）；
2. 浏览器访问 http://127.0.0.1:7860；
3. 在文生图（txt2img）界面：
   • 左侧"Prompt"框输入示例：1girl, solo, lingyuxiu style, soft lighting, detailed face, photorealistic, masterpiece;
   • 'Negative prompt'框保持默认（已预置 NSFW 过滤）；
   • 下方'MXJ LoRA 版本选择器'中选择任意一项（如 1. v2.10）；
   • 点击'Generate'，观察控制台日志是否出现 [MXJ] Loaded lingyuxiu_mxj_sdxl_v2.10.safetensors；
   • 查看生成图：应呈现柔焦肤质、清晰瞳孔纹理、自然发丝分缕，无明显畸变。

验证通过：你已成功接入 Lingyuxiu MXJ LoRA 创作引擎。

4. 提示词实战指南：让风格还原更精准

Lingyuxiu MXJ 不是'万能滤镜'，它的表现力高度依赖提示词与 LoRA 的协同。以下为经实测验证的高效组合策略：

4.1 正面 Prompt 构建公式（推荐直接套用）

[主体] + [Lingyuxiu MXJ 核心关键词] + [细节强化词] + [质量保障词]

• [主体]：明确人物数量、姿态、视角 推荐：1girl, solo, portrait, close up, upper body 避免：multiple people, full body in landscape（易导致构图失衡）
• [Lingyuxiu MXJ 核心关键词]：触发风格解码器 必加：lingyuxiu style, soft lighting, photorealistic, detailed face 可选强化：delicate skin texture, natural blush, subtle eyelash, cinematic depth
• [细节强化词]：引导 LoRA 专注优化方向 示例：
  • 强调妆容 → light makeup, nude lipstick, defined eyebrows
  • 强调发质 → silky black hair, soft wavy hair, sunlit highlights
  • 强调光影 → rim light, gentle fill light, shallow depth of field
• [质量保障词]：兜底生成稳定性 推荐：masterpiece, best quality, 8k, ultra-detailed, sharp focus

真实有效示例： 1girl, solo, lingyuxiu style, close up, soft lighting, detailed face, delicate skin texture, light makeup, silky black hair, rim light, masterpiece, best quality, 8k

4.2 负面 Prompt 精简原则：少即是多

系统已内置强效 NSFW 与低质过滤（含 nsfw, low quality, bad anatomy, ugly, text, watermark, deformed face, blurry skin, unnatural body），因此无需额外添加常规负面词。过度堆砌反而可能抑制 LoRA 对'柔光''细腻'等正向特征的学习。

仅在以下情况建议补充：

• 若生成图出现轻微面部扭曲 → 加 asymmetrical face, uneven eyes；
• 若背景虚化不足 → 加 busy background, distracting elements；
• 若肤色偏黄/偏灰 → 加 yellowish skin, grayish skin。

5. 常见问题与解决方案（来自真实部署反馈）

5.1 问题：切换 LoRA 版本后，生成图风格无变化？

原因分析：

• LoRA 文件未放入正确路径（models/Lora/lingyuxiu_mxj/）；
• 文件名不含数字版本号（如 mxj.safetensors 无法被自然排序识别）；
• WebUI 未重启，插件未加载。

解决步骤：

1. 检查路径与文件名，确认为 models/Lora/lingyuxiu_mxj/lingyuxiu_mxj_sdxl_v2.10.safetensors；
2. 点击 WebUI 右上角'Reload UI'；
3. 查看控制台日志，确认有 [MXJ] Scanning ... found X files 日志；
4. 再次切换版本并生成。

5.2 问题：生成图出现严重面部畸变或肢体错位？

原因分析：

• 提示词中混入了与 Lingyuxiu MXJ 风格冲突的强约束词（如 anime, 3d render, cyberpunk, extreme pose）；
• 使用了不兼容的 ControlNet 预处理器（如 OpenPose 对复杂姿态鲁棒性差）。

解决建议：

• 删除所有非写实类风格词，专注 photorealistic, realistic, portrait；
• 如需姿态控制，优先选用 reference_only 或 tile ControlNet，避免使用 openpose 或 depth；
• 尝试降低 CFG Scale 至 5–7，减少模型对提示词的过度响应。

5.3 问题：显存爆满（CUDA out of memory），即使只加载一个 LoRA？

原因分析：

• 未启用--medvram或--lowvram启动参数；
• 同时启用了多个高显存消耗插件（如 ADetailer、Inpaint Anything）；
• 分辨率设置过高（如 2048×2048）。

优化方案：

• 启动脚本中加入 --medvram 参数；
• 关闭非必要插件，或在'Settings → User Interface'中禁用 ADetailer 自动启用；
• 生成分辨率建议：1024×1024（SDXL 推荐尺寸），如需更高清，先生成 1024×1024，再用 ESRGAN 放大。

6. 总结：让专业人像风格真正属于你

Lingyuxiu MXJ LoRA 集成方案，不是给 Stable Diffusion 加一个'美颜开关'，而是为你搭建了一条通往特定美学表达的确定性通道。它用三个关键词定义价值：

• 轻量：LoRA 独立挂载，不侵入底座，24G 显存稳跑，12G 显存可调优；
• 稳定：本地缓存锁定，断网可用，版本隔离，杜绝风格漂移；
• 即用：自然排序 + 动态热切换，选中即生效，对比即决策，把风格调试变成所见即所得的操作。

你不需要成为 LoRA 训练专家，也不必深究矩阵分解原理。你只需要记住：把 LoRA 放进对的文件夹，选对版本，写好提示词——然后，专注去描述你想画出的那个她。