Perfect Pixel Studio

一个用于像素画网格校正、颜色精修和导出的原生 Windows 桌面工具。界面无需浏览器，处理全部在本机完成。

下载 Windows 版

下载最新版 PerfectPixel.exe

单文件版本无需安装 Python。若 Windows SmartScreen 提示未知发布者，请确认下载地址来自本仓库后再继续运行。

网页版

打开 Perfect Pixel 网页版

网页版位于 web/，界面和桌面版保持一致，图片只在浏览器本地处理，不会上传到服务器。支持选择、拖入或粘贴图片，处理后可下载原尺寸 PNG、放大 PNG 或完整 ZIP。

仓库当前使用 GitHub Pages 的 main / (root) 发布方式。根目录的 index.html 会自动进入完整网页版，推送到 main 后由 Pages 自动更新。

本地预览：

python -m http.server 8000 --directory web

然后访问 http://localhost:8000。

主要能力

• 自动检测像素网格；手动填写时严格输出指定宽高
• 支持从 Windows 资源管理器直接拖入图片，也可点击选择或粘贴
• 中心、中位数、多数色和主导色采样
• OKLab / RGB 颜色量化、色阶降低
• 孤立像素、抗锯齿残留和背景透明处理
• 独立保存原尺寸 PNG 或放大 PNG
• 一键导出 ZIP，内含两种尺寸图片和处理说明
• 后台处理，界面不会因计算而卡死
• 浅色、深色主题可手动切换，默认跟随 Windows 应用主题

直接运行

.venv\Scripts\python.exe app.py

构建 Windows EXE

在 PowerShell 中运行：

.\build_exe.ps1

脚本会安装构建依赖、生成应用图标，并创建单文件版本：

dist\PerfectPixel.exe

最终用户只需要这个 EXE，不需要另外安装 Python。首次启动单文件 EXE 时，Windows 会先解压运行文件，因此可能比之后启动稍慢。

使用流程

1. 把图片拖进窗口，也可以点击选择或按 Ctrl + V 粘贴。
2. 选择快速预设，必要时展开高级设置。
3. 点击“开始精修”，在原图、放大预览和原始像素之间切换。
4. 选择“保存原尺寸 PNG”“保存放大 PNG”或“导出全部 ZIP”。

快捷键

快捷键	功能
Ctrl + O	选择图片
Ctrl + V	粘贴图片
Ctrl + Enter	开始处理
Ctrl + S	保存放大 PNG

核心网格算法来自 theamusing/perfectPixel，采用 MIT License。