Image Assets

核心判断

• 最终 APP 素材抠图优先用 rmbg2 (briaai/RMBG-2.0)；无授权或要对比时用 birefnet。
• 默认使用 --background-mode auto 从四角识别白色或其他均匀纯色背景，自动去除对应色边，并用 --shadow-mode auto 恢复主体附近被分割模型忽略的渐变投影。
• 复杂背景只使用模型分割结果，不自动反推边缘颜色。已知背景色时用 --background-color '#RRGGBB'；需要完全关闭背景色后处理时用 --background-mode off --shadow-mode off。
• 尺寸修改、WebP/AVIF/JPEG/PNG 转码压缩优先走 sharp/libvips，缩放默认 Lanczos3。
• 默认压缩以保留色彩和细节为先：optimize 默认质量 90，APP 派生图默认质量 92，web-optimized 默认质量 88；JPEG 使用 4:4:4 色度抽样。
• 透明主资产保留 PNG；分发或包体优化再生成 WebP/AVIF/JPEG 派生版本。
• N 宫格像素素材生成动画时优先用 grid-gif --cutout-mode color：自动识别分隔线，按边缘连通区域去除纯色背景，避免模型破坏像素轮廓。复杂背景再切 rmbg2 或 birefnet。
• 处理 N 宫格 GIF，或排查动画抖动、主体透明洞、分隔线残留、换底和播放顺序问题前，读取 references/sprite-sheet-gif.md；其中记录完整流水线、验收清单和已否决方案。
• 深色背景搭配深色主体时使用保守换底：默认容差 12，只把边缘连通的背景替换成唯一洋红键色后精确设透明。不要直接把容差提高到 20 以上，否则黑色衣裤可能被一并删除。
• GIF 各帧必须保留统一画布，并默认用 --anchor feet 将脚部中心与最低接地点对齐；锚点检测先过滤孤立边缘噪点，再只取前景底部 8%，避免尾巴或衣摆污染横向坐标。不要逐帧独立紧裁。像素画放大使用整数 --scale 和最近邻缩放，避免动画抖动或像素发糊。
• 连续动作默认 --playback forward，播放为 12341234...；起止姿势需要平滑往返时用 --playback ping-pong，播放为 1234321...，首尾端点不会重复编码导致停顿。
• 日常优先用 preset，只有用户明确要控制模型、尺寸、质量、格式时再展开高级参数。
• 用户不知道应该使用什么尺寸、格式、质量，或图片将用于 iOS、iPadOS、macOS 原生应用时，先读取 references/apple-native-assets.md，根据目标平台、显示点值和资产类型选择方案，再执行处理。
• 从彩色 App Icon 派生 macOS 菜单栏 / 状态栏图标时，先读 references/apple-native-assets.md 的「从彩色 App Icon 提炼菜单栏模板图标」；默认提炼语义轮廓并重绘透明单色资产，不把整张彩色图机械阈值化。