真实透明背景

要解决的具体问题

很多生成图会用棋盘格或扁平中性色来模拟“透明背景”，但这类文件仍然带有不透明像素。放到合成、设计稿或视频图层里时，边缘会残留灰白底，白边、棋盘格和背景色块看起来明显不干净。更麻烦的是，如果用 AI 重新生图去“去掉背景”，可能连主体轮廓、毛发、线稿和半透明光晕一起改掉。

技能如何工作

real-transparent-background-skill 面向这个固定问题，把已有棋盘格/假背景转成真正的 RGBA PNG。核心入口是脚本 scripts/checkerboard_to_alpha.py。它会从图像边框像素估计背景色，只对从画布边缘连通的背景区域做 flood fill，再把这部分转成 Alpha，从而保留前景内容基本不变。

工作时有几个关键点：

• 默认非破坏保存，通常生成 name-transparent.png 这类同名文件，而不是直接覆盖原图。
• 对彩色光晕、灯泡、halo、aura 等需要半透明保留的效果，使用 --soft-colored-edges。
• 对胡须、白色线稿等细且浅的前景细节，不加 --soft-colored-edges，避免把本来有颜色的前景误处理掉。
• 支持多文件批量；--output-dir 指定目录，--suffix 控制命名，--overwrite 只在明确要替换时使用。
• 若输出位置在当前工作区之外，应先请求文件系统权限，再保存。

处理完成后，脚本会按文件输出 JSON 行，包含输出路径、尺寸、调色板估计、Alpha 计数和角点 Alpha 采样。用这些结果做收尾校验很关键：确认输出是 RGBA，四角 alpha 为 0，前景采样点仍为 255。

适用边界与注意点

这个脚本的前提是“假背景可识别、且能从画布边缘到达”。它不是通用抠图模型，不会重绘前景细节。若背景不连通图像边界、场景复杂、背景色与主体颜色大量重叠，或需要补出缺失的前景像素，应改用真正的分割或模型原生透明流程。如果流程可能改动主体，先向用户确认，再切换到生成式或 API 回退方案。