DeepFaceLab-WEBUI

DeepFaceLab-WEBUI 是一套面向 Windows 与 NVIDIA GPU 的本地 DeepFaceLab 工作台。它把素材整理、提帧、切脸、质量检查、XSeg、训练、模型诊断、合成和视频导出放进同一条可视化流程；命令仍在本机运行，素材不会因为使用 WebUI 而上传到云端。

请只处理你拥有或已获授权的素材，并遵守适用的隐私、肖像权和内容标识规定。

DeepFaceLab-WEBUI

单文件下载启动器

仓库提供轻量原生启动器的构建源码，用户使用的 EXE 只放在 GitHub/Gitee Release，不再提交到源码根目录。发布产物只有一个 DeepFaceLabSN.Launcher.exe； 它内嵌首次配置页、常态启动页、依赖引导脚本、 WebView2 宿主和 ConPTY 终端桥，不需要把 DLL 或前端文件放在 EXE 旁边。

如果系统缺少 Microsoft Edge WebView2 Runtime，EXE 会先显示不依赖 WebView2 的原生安装窗，只从 Microsoft 官方地址下载安装器，校验 Authenticode 签名后静默 安装并自动继续。

项目仓库现为 DeepFaceLab-WEBUI。 已有安装配置继续兼容；下载 EXE 文件名暂保留旧名称。GitHub 与 Gitee 仓库均使用 DeepFaceLab-WEBUI，新版启动器已内置对应的更新清单与下载地址。

首次安装的依赖暂存区位于项目内的 .launcher-install/runtime，源码克隆暂存区也在 .launcher-install 内；网络失败后可继续重试。每次运行的完整日志与独立错误日志 分别写入 .launcher-install/logs/<时间>-<会话>.log 和 *.errors.log。选择安装目录 之前的启动日志保存在 %LocalAppData%DeepFaceLabSNLauncherlogs，开始安装时会 复制该会话日志到项目内。Git 等工具的正常 stderr 进度不会被当作错误；非零退出码 及异常会记录到两份日志中。

所有运行时和镜像配置都保存在项目内，不修改系统 PATH，也不写用户全局 npm/pip 配置。自动模式会优先探测国内 npm、pip 与 Node 镜像，失败后回退官方源；每个下载 文件仍必须通过清单中的固定 SHA-256。

Python 运行时： 当前清单已启用可复现 wheelhouse：官方 CPython 3.7.1、 97 个固定 wheel 与 1 个经 SHA-256 校验的源码包。下载阶段优先使用清华 PyPI 镜像， 失败后回退官方文件源；安装阶段强制 --no-index --no-deps，不会临时解析新版依赖。 已有且通过完整文件、版本和导入校验的 _internal/python_common 会直接复用。 锁定清单、安全边界与维护流程见 launcher/python-runtime/README.md。

构建命令：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File launcheruild-host.ps1

启动器会优先使用整合包内的便携 Node.js 24。若运行时缺失或版本不兼容，会自动从整合包内置的离线安装包补齐；离线安装包也不存在时，才从 Node.js 官方站下载并校验 SHA-256。整个过程不需要管理员权限，也不会修改系统 PATH。首次使用精简版整合包时需要联网下载约 37 MB。

如果 WebUI 无法启动，可使用 传统命令菜单.bat 进入兼容菜单。传统 BAT 已集中到 legacy-cli，日常使用不需要运行初始化 BAT。

工作区会直接预览两段素材并显示时长、分辨率、大小和修改时间；同时汇总视频帧、aligned 人脸、XSeg、训练模型、merged 序列和输出文件的就绪状态。更换 SRC 或 DST 时，旧素材会自动进入各自的“恢复历史”，恢复旧版本前也会先归档当前素材，因此可以继续撤回。顶部磁盘条显示空闲空间、固定 5 GB 安全余量和实际可用于任务的容量；已知大小的导入若会突破余量，会在写入前拒绝。“归档已完成任务”只整理已结束任务的日志，不会删除素材、模型或输出。完整工作流

界面分为三层：左侧栏按功能域切换页面，顶部流程按制作顺序导航，底部终端标签是任务队列与日志的唯一入口。终端折叠后仍固定在窗口底部，已结束会话可隐藏、关闭或恢复，不会无限堆积。后台任务统一显示在右下角悬浮进度卡中，因此进度条出现或消失不会挤动主界面。

1. 提帧、切脸与清洗

“隔离”和“恢复区”位于数据集命令栏右侧。恢复区与工作区采用相同的“缩略图列表 + 大图属性”结构，可先隔离问题样本再复核恢复。大图下方还提供 XSeg 编辑入口，以及处于“规划中”的清晰增强、单图合成和 AI 图像编辑入口。

进一步进入“工具 → 数据审计”，可按清晰度、曝光、重复、姿态与遮罩状态筛选。审计页会显示样本总量、可用数量、问题数量和高风险数量，并允许逐张检查原图、质量指标、源帧、遮罩判定和姿态信息。

2. XSeg 遮罩

未闭合多边形不会被写入 JPG；刷新、切换素材、切换页面或关闭窗口前若有未保存修改，界面会请求确认，避免静默丢失标注。

3. 模型训练

训练真正运行后，“总览”才会显示 Trainer 生成的真实预览，以及迭代、速度、SRC / DST 损失、显存、温度和损失曲线。没有运行中的训练时预览区保持明确的空状态，不使用演示图冒充训练结果。首次只想验证流程时，可在 DFL 问答中选择较低模型分辨率（例如 128）；正式项目再根据显存、脸部占比和目标质量逐步提高。

训练期间建议：

• 先确认预览中的 SRC、DST 和转换结果方向正确，再长时间运行。
• 定期保存模型和评估快照；安全停止会在退出前请求保存。
• 百分比、已处理数量或可推导总量的任务会显示真实进度和预计剩余时间；无法推导总量时会明确显示“处理中”，不会伪造百分比。
• 显存不足时，优先降低 batch size、模型分辨率或网络维度，不要同时大幅修改多个参数。
  

两者职责不同，不能互相替代：

• 姿态图谱检查训练数据是否覆盖正脸、侧脸、抬头和低头，以及 SRC 与 DST 的姿态分布是否匹配。它主要回答“训练前的数据够不够、缺哪类角度”。
• 训练诊断在相同模型、评估清单、指标版本和模型结构下比较两个训练快照。它主要回答“继续训练后是否真的变好，是否出现锐度、身份、遮罩或颜色回归”。
  

尚未建立训练评估上下文时，诊断页会直接说明缺少的前置条件，并提供返回模型训练的入口，避免新手面对空白页面。

DeepFaceLab-WEBUI

完成训练诊断后再进入“模型应用”。先生成少量合成帧检查边缘、肤色、遮挡和运动稳定性，再运行全量合成。最后在“视频导出”中封装 MP4，并核对音频、帧率与时长。

DeepFaceLab-WEBUI

“工具”页补充主流程之外的复核和修复能力：

• 数据质量审计：筛查模糊、遮挡、重复、异常姿态与遮罩问题。
• 提取覆盖复核：确认视频各时间段和角度都有足够人脸样本。
• 合成复核：以 SRC、DST、合成结果三联画检查质量。
• 视频时间线：场景识别、分段提帧、失败片段重跑。
• 元数据与打包：检查 DFL 图片元数据和 PackedFaceset。
• 模型导出：DFM 导出前检查模型、空间和依赖条件。
• 姿态图谱与覆盖清单：定位 SRC / DST 中缺少的角度与表情。
• 图像工具：清晰增强、单图合成和 Gemini / GPT Image 临时编辑的界面入口；当前明确标记为“规划中”，不会伪装成已完成能力。
• 命令目录：查看 WebUI 允许执行的固定命令及其用途。
  

进度、日志与失败恢复

• 右下角悬浮进度卡优先显示真实百分比、当前步骤、已处理数量和预计剩余时间；无法推导总量时明确显示“处理中”，不会伪造百分比。
• 底部终端保留 DFL 原始输出；程序等待参数时，可直接在终端输入并发送。终端标签同时承担任务队列，已结束会话可关闭、隐藏和恢复。
• 任务失败时先阅读失败原因和建议动作，再查看完整日志。不要在任务仍运行时强制关闭窗口。
• “安全停止”适用于训练等长任务；已完成的模型和中间文件仍保留在工作区。
• 后台分析在本地服务重启后会标记为“已中断”，不会伪装成成功；可取消任务只在右下角唯一进度卡中显示取消按钮。
• “设置 → 导出诊断摘要”只生成本机 JSON 状态摘要，不包含绝对路径、命令参数或终端内容，便于排障前先检查将要分享的信息。
  

顶部显示“本地服务离线”怎么办？

导入后看不到人脸？

诊断页提示没有可比较快照？

Trainer 预览长时间不更新？

Trainer 区域为什么是空的？

合成结果在哪里？

数据与安全

• WebUI 与 Runtime 默认在本机通信，素材和模型保存在当前工作区。
• 只允许执行内置白名单命令，路径会经过工作区边界校验。
• 质量清洗优先使用可恢复隔离；执行批量操作前请确认选中数量和目标目录。
• 视频更换使用事务式素材归档，磁盘写入保留 5 GB 安全余量；恢复操作不会静默覆盖当前素材。
• 诊断摘要默认排除绝对路径、命令参数和终端日志；对外发送前仍应由用户自行复核内容。
• 迁移或重装前请备份整个 workspace，尤其是 model、aligned、merged 和项目记录。
  

本项目沿用仓库中的原始授权与第三方组件许可；分发或商用前请自行核对相应许可条款。

DeepFaceLab-WEBUI

DeepFaceLab-WEBUI

DeepFaceLab-WEBUI

DeepFaceLab-WEBUI

DeepFaceLab-WEBUI

DeepFaceLab-WEBUI

DeepFaceLab-WEBUI