roop for StableDiffusion —— StableDiffusion AUTOMATIC1111 图片人脸替换扩展
roop 是 s0md3v 开发的 StableDiffusion AUTOMATIC1111 web-ui 扩展，基于 roop 项目但独立开发，用于在图片中替换人脸。仓库目前已归档并停止开发，作者表示出于对该类软件二阶影响的重新评估而终止项目，归档目的是阻止新的 Pull Request。扩展内置检查以阻止在不合适媒体上运行，并要求使用者遵守当地法律、在被替换真人面部时取得同意并标注 deepfake。
社区作者 · zZz
它解决什么问题
roop for StableDiffusion 是一个面向 StableDiffusion AUTOMATIC1111 web-ui 的扩展，功能是在图像中做人脸替换（face-replacement）。它基于 roop 项目，但作者说明将与原项目分开独立开发。
项目状态：该仓库已被归档（archived），开发已停止。作者说明最初把项目当作生成式媒体的技术实验，发布后不久对该类软件更广泛的二阶影响改变了看法，因此选择停止开发并归档；后续更新说明归档是为了阻止 Pull Request。
免责声明（来源原文要点）：开发者认为本软件可为快速增长的 AI 生成媒体行业作出生产性贡献，帮助艺术家完成诸如为自定义角色制作动画、或把角色作为服装模特等任务；开发者知晓其可能被用于不道德用途，并承诺采取预防措施，软件内置检查会阻止程序在不合适的媒体上工作；项目可能因法律要求而关停或在输出中加入水印；使用者需遵守当地法律，如果使用真人面部，建议取得当事人同意并在网上发布内容时明确说明这是 deepfake；开发者不对终端用户的行为负责。
功能定位：在 web-ui 中通过 roop 下拉菜单导入含人脸的图像并启用 Enable 后，生成的图片会使用所选人脸。仓库提供了示例图片（配图 1）。
适用对象：已部署 StableDiffusion AUTOMATIC1111 web-ui、希望在本地完成图片人脸替换实验与创作的用户；由于已归档，需要自行解决安装与运行中的问题。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
来源给出的安装步骤（按原顺序保留）：
准备环境：
- 首先，如果因为某些原因无法安装，不要在本仓库提 issue，请自行搜索报错信息（Google your errors）。
- Windows 系统：下载并安装 Visual Studio；安装过程中务必勾选包含 Python 和 C++ 的组件包。
安装步骤：
步骤 1 · 运行命令：
pip install insightface==0.7.3- 在 web-ui 中进入 “Extensions” 标签页，在 “install from URL” 中输入并使用该 URL：https://github.com/s0md3v/sd-webui-roop
- 关闭 webui 并重新运行。
- 首次运行常见问题：如果遇到 'NoneType' object has no attribute 'get' 错误，下载 inswapper_128.onnx 模型并放入 <webui_dir>/models/roop/ 目录。
- 其他错误请自行搜索解决（Good luck）。
使用步骤（来源：Usage）：
- 在 “roop” 下拉菜单中导入一张包含人脸的图像。
- 勾选 “Enable” 复选框。
- 完成，之后生成的结果就会带上你选择的人脸。
效果与排错提示（来源：Tips）：
- 获得高质量结果：首先确保开启 “Restore Face” 选项；还可以尝试 “Upscaler” 选项，或为更精细的控制使用 “Extras” 标签页中的放大器。
- 想进一步提升质量：使用 img2img，把 denoise 设为 0.1，逐步提高，直到在质量和相似度之间取得平衡。
- 只替换特定人脸：如果图像中有多张人脸，使用 “Comma separated face number(s)” 选项选择要替换的人脸编号。
- 人脸没有替换成功：确认是否点击了 “Enable”；如果点了且控制台没有任何错误，说明 roop 检测到图像为 NSFW，或完全没有检测到人脸。
来源教程配图
