企业官网建设流程全解析

如何安装 Stable-diffusion-webui-pixelization：手把手完整教程（含3个必须手动下载的模型权重）

【免费下载链接】stable-diffusion-webui-pixelizationstable-diffusion-webui-pixelization项目地址: https://gitcode.com/gh_mirrors/st/stable-diffusion-webui-pixelization

Stable-diffusion-webui-pixelization 是一款为 Stable Diffusion WebUI 增加像素化（pixelization）图片处理能力的扩展插件：它能把你生成的 AI 图片一键转换成复古像素风，支持调节像素粒度，还能保持原始分辨率。本教程将带你完成 SD WebUI 像素化插件的一键安装，并重点讲清 3 个必须手动下载、放入 checkpoints 目录的模型权重文件。

一、插件功能简介：把图片一键变成像素风 🎨

• 基于开源 Pixelization 项目（c2pGen 网络），由主像素化生成器 + 抗锯齿网络两个模型协作，像素边缘更平滑，不毛糙
• 功能入口位于 WebUI 的Extras 标签页，出图后勾选一个选项即可完成像素风转换
• Pixel size（像素大小）可在 1~16 之间调节，数值越大像素越粗犷
• 处理时使用的像素大小会写入图片元数据（Pixelization pixel size），方便日后复现效果

核心处理逻辑位于scripts/postprocessing_pixelization.py，安装引导脚本为install.py。

二、安装前准备 ✅

• 已安装并能正常启动 Stable Diffusion WebUI
• 电脑可正常联网（首次安装时会自动拉取底层依赖代码库）
• 准备一个能访问 Google Drive 的下载环境（下一节要下载 3 个权重文件）

三、一键安装插件

方式一：Git clone（推荐）

在终端中进入 WebUI 的扩展目录，执行：

cd stable-diffusion-webui/webui git clone https://gitcode.com/gh_mirrors/st/stable-diffusion-webui-pixelization extensions/stable-diffusion-webui-pixelization

方式二：WebUI 扩展管理

打开 WebUI 的Extensions标签页，通过"从 URL 安装"或加载本地扩展目录，指向克隆下来的插件文件夹即可。

首次启动时，扩展会自动执行install.py完成两件事：

1. 将 Pixelization 底层代码库（固定 commit）克隆到扩展内部的pixelization/子目录
2. 删除pixelization/models/__init__.py，避免models目录被占用而导致 BLIP 等其他扩展出错

四、手动下载 3 个模型权重 ⬇️（关键步骤）

⚠️ 本扩展不会自动下载权重，需要你手动下载 3 个.pth文件，并全部放入扩展内的checkpoints/目录：

📌下载地址在哪里？官方README.md的Installation小节有一张表格，列出了这 3 个文件对应的 Google Drive 链接，复制后手动下载即可。之所以必须手动下载，是因为原项目 License 不允许作者重新托管模型，且 Google Drive 不支持程序自动下载。

放置位置如下（目录不存在时新建即可）：

<webui目录>/extensions/stable-diffusion-webui-pixelization/checkpoints/ ├── pixelart_vgg19.pth ├── 160_net_G_A.pth └── alias_net.pth

五、重启 WebUI 并使用像素化功能 ⚙️

1. 完整重启Stable Diffusion WebUI（让扩展加载成功）
2. 打开Extras标签页
3. 在后期处理区域找到Pixelization面板，勾选Enable pixelization
4. 按需配置：
   • Keep resolution：像素化后自动放大回原图分辨率
   • Pixel size滑块（1~16，默认 4）：数值越大，像素越粗
5. 对生成图执行后期处理，即可得到像素风版本

六、常见问题排查 ❓

Q：启动或首次使用时控制台提示 "Missing ... .pth - download it from ..."？A：说明 3 个权重文件缺失或放错位置。请把.pth文件全部放进扩展的checkpoints/目录，然后重启 WebUI。

Q：为什么不能自动下载权重？A：原 Pixelization 项目的授权限制无法镜像重传，请按README.md中 Installation 表格里的链接从官方 Google Drive 下载。

Q：会不会和 BLIP 等扩展冲突？A：不会。install.py已自动删除冲突的__init__.py文件，规避了models目录被占用的问题。

Q：Extras 标签页里找不到 Pixelization 选项？A：请确认插件位于webui/extensions目录下并已重启 WebUI；若扩展内的pixelization/子目录为空，可手动执行一次install.py补全依赖代码。

写在最后 🏁

整个安装流程就是：克隆扩展 → 手动放入 3 个权重 → 重启使用。完成后，你就能在 Stable Diffusion WebUI 里随时把任意 AI 生成图转换成复古像素风，配合 Pixel size 滑块轻松控制像素颗粒度。

【免费下载链接】stable-diffusion-webui-pixelizationstable-diffusion-webui-pixelization项目地址: https://gitcode.com/gh_mirrors/st/stable-diffusion-webui-pixelization