face-lora-qwen-image/tools/使用说明.md

face_checker 使用说明（素材自动审核 + 智能选图工具）

这是什么

训练脸部 LoRA 前的素材质检员 + 选图助手：

• 自动检查每张照片：分辨率、清晰度、人脸数量、人脸大小、正侧脸角度、遮挡、重复图
• 红黄绿三档判定：✅合格 / 🟡警告 / ❌不合格，附具体原因
• 智能选图：从一堆照片里自动挑出多样化组合（覆盖特写/半身/全身、不同角度、不同风格），你只需要删掉重复的

快速开始

用哪个 Python：musubi-tuner 的虚拟环境

# 场景一：审核照片，生成报告
& "D:\AI\sd\musubi-tuner\.venv\Scripts\python.exe" "D:\F\NewI\opencode\daily-workspace\projects\脸部LoRA训练-Qwen-Image\tools\face_checker.py" check "照片目录"

# 场景二：智能选图（推荐 20 张）
& "D:\AI\sd\musubi-tuner\.venv\Scripts\python.exe" "...\tools\face_checker.py" pick "照片目录" --count 20

# 场景三：审核 + 把合格照片整理成训练集
& "...\face_checker.py" batch "照片目录" --out "训练集目录"

提示：可以把工具路径存成 PowerShell 变量或做个小 .bat，避免每次打长路径（我可以帮你做）。

输出

命令	产出
check	素材审核报告.html（浏览器打开看图片墙+判定）+ 素材审核结果.json
pick	智能选图推荐_N张.html（推荐清单+构图标签）+ 智能选图结果.json
batch	报告 + 训练集文件夹（img_001.jpg 重命名、EXIF 修正、统一 JPG）

判定规则（快查）

检查项	合格	警告	不合格
分辨率	短边 ≥1024	-	短边 <1024（微信压缩图）
清晰度	人脸区域锐利	偏糊	明显模糊
人脸	1 张	多张脸 / 占比小 / 侧脸 / 疑似遮挡	没检测到脸
重复	-	与另一张高度相似	-

老莫的操作流程

1. 把候选照片全部丢进一个文件夹（几十张也没关系，不用自己先筛）
2. 跑 pick --count 20 → 打开推荐报告看一眼，删掉不喜欢的
3. 跑 batch --out 训练集目录 → 自动整理成 img_001.jpg...
4. 把训练集目录交给我，我负责打标 caption 和训练

注意事项

• iPhone 的 HEIC 照片：工具不支持，先转成 JPG（微信发一遍自己或格式转换工具）
• 照片别用微信压缩过的（分辨率不够会被判不合格）
• 想多选就 --count 25，想少选就 --count 15（推荐 15-25 张）
• 重复判定基于视觉相似度，AI 判断可能有漏网，报告里的人工确认最重要

参数速查

check <目录> [--out 报告目录]
pick <目录> [--count N] [--out 报告目录]
prepare <目录> --out <训练集目录>
batch <目录> --out <训练集目录>
crop <目录> --out <裁切目录> [--scale 1.8]   ← 合影处理：按最大人脸裁切单人

合影与背景处理（老莫须知）

• 合影：用 crop 命令或 GUI 前先裁切——按最大人脸裁出单人（1.8 倍放大）。裁完短边 <1024 的放弃
• 背景：不要处理！保持自然多样（室内/户外/墙/街景），caption 写清场景即可。不要抠图换纯色背景（会导致 LoRA 把纯色背景和脸绑定，出图全是纯背景）
• 禁止：磨皮美颜、加水印边框文字
• face_checker 的 prepare/整理会自动处理 EXIF 方向 + RGB 转换