admin
237a09a5b0
一、问题（本轮实测）
`draw-ui` 与 `oil-motion` 目录里**各自带一个内嵌 `.git`** ⇒ 上一次提交把它们记成了 **gitlink（子模块指针）**
⇒ 仓库里只存了一个不属于任何远端的 commit id，**别人克隆下来这两份是空的** ✗（`git status` 显示 ` m draw-ui` / ` m oil-motion` ＝ 子模块内容有改动）。
二、处置（可回退）
· 把两处的 `.git` **挪走**（⛔ 不是删除）⇒ `归档/内嵌git-20261008/{draw-ui,oil-motion}.git`；
· `git rm --cached` 掉那两个 gitlink，再 `git add` 两个目录 ⇒ **按正常文件入库**（内容才真的进仓库）。
三、副作用（如实记）
挪走 `.git` 后，这两个技能**不能再原地 `git pull` 取上游更新**（要更新得重新拉一份覆盖）；
如需恢复其本地仓库，把 `归档/内嵌git-20261008/` 里的 `.git` 挪回原处即可。
4.7 KiB
参考素材与透明度验收
确定素材是否可用
先检查原始文件、项目资源和局部裁图的清晰度、背景与边缘；合格就复用。素材有效像素应覆盖最终显示需求，例如 150 CSS px 宽、DPR 2 的标识至少需要 300 有效像素宽，大面积留白不算图形分辨率。插值放大不会恢复细节。
品牌标识优先原始 SVG 或高清文件；缺少原稿且任务已授权重建时才使用实际 Logo 参考，锁定轮廓、字样与图文比例，不重新设计品牌。生成 PNG 和 SVG 包裹位图都不能冒称原始矢量文件。
确需生成时
- 明确输入用途：整页提供布局上下文，局部图提供主体参考，需要保留内容的原图是编辑目标。实际图片输入的核验按 生成工具 处理。
- 按容器确定宽高比、主体位置、裁切余量和像素需求；写清保留与变化范围。被遮挡内容的补全属于推断，不承诺恢复原图。
- 沿用主流程选定的工具生成。大插画、Logo 与小图标分开；只有确需统一风格且能规则切割的小图标才合成素材板，明确行列数、留白和不重叠。
- 保留原始输出与提示词，再将可用版本放回页面，检查实际尺度、裁切和遮挡。只完成素材检查时不声称页面还原通过。
提示词按需填写，不固定品牌、风格或背景色：
任务：从参考图重建独立的[素材对象]，用于[页面容器]。
保留：[轮廓、姿态、视角、颜色、字样或构图关系]。
改变或移除：[页面正文、控件、外框、指定背景]；保留[素材内部需要的环境]。
规格：[宽高比、主体位置、必须完整的部分、裁切余量、目标像素]。
背景：[真实透明／指定纯色／保留环境]，根据用途和当前工具能力选择。
输出：只包含该素材，不添加无关文字或页面 UI。
透明度检查
需要透明时，仅使用实际接口支持的参数请求真实 alpha。当前调用链没有结论可先尝试；同一任务已验证失败且调用方式未变时，不逐素材重复试。保留失败原图与检测结果；只有明确可修正的问题才至多重试一次，之后使用已授权后处理或报告限制。
对原始输出及后处理结果分别运行（依赖 Pillow）：
python3 scripts/check_asset_alpha.py /path/to/asset.png --require-transparency
- 返回码 2：没有有效透明像素或整图不可见，不作为透明素材交付。
- 返回码 0：同时存在透明像素和可见内容，只通过结构检查；仍需检查背景是否完整移除、主体有无误删、细线和毛发是否残留色边。
PNG 扩展名、RGBA 模式、画入的棋盘格都不能证明透明；调色板透明元数据也应由程序识别。透明度少量通过不等于边缘质量通过，直接透明与后处理透明分别记录。
条件性后处理
仅在需要且当前任务及生成 Skill 允许时使用。背景色应避开主体颜色，也可采用可靠分割方案；照片内部环境需要保留时不要一并删除。以下参数是起点，先检查样本，不作为全部素材的默认值：
| 素材条件 | 可选处理 | 重点检查 |
|---|---|---|
| 白底上的深色标识或细线 | 白底转 alpha | 主体浅色部分与抗锯齿白边；细线避免收缩边缘 |
| 主体与单色背景可明确分离 | 按背景色抠图 | 同色主体、半透明区域与残留色边；主体含绿时不用绿幕 |
| 毛发、柔光或背景与主体混色严重 | 可靠分割、重新准备素材或拆层 | 是否损失细节，简单阈值是否足够 |
白底示例：
python3 scripts/prepare_image_asset.py input-white.png output-alpha.png --alpha --threshold 248 --feather 10 --padding 16
主体不含绿色时的绿幕示例：
python3 scripts/prepare_image_asset.py input-green.png output-alpha.png --key-color '#00ff00' --key-threshold 28 --feather 12 --despill --padding 10
输出使用新路径，保留输入。--no-trim 保留画布，--edge-contract 会收缩边缘，仅在样本确认需要时使用；--despill 针对绿色污染。后处理完成后重新检查 alpha，并在目标深浅底、实际显示尺寸下查看边缘。
放回页面与交付
文件属性由程序检查，主体、品牌拼写、构图和裁切由实际画面判断。尺寸或构图不适合容器时回到规格，不靠反复移动图片修补互相冲突的裁切。混合模式不会改变源文件透明度，使用时还须检查堆叠上下文与矩形底色。
独立保存资产并注明来源、尺寸、背景、适用底色与重建差异；细字和边缘的页面验收按 测量与校准 执行。