huihuisang/localize-app-store-screenshots

本地化 App Store 截图

保留已批准的艺术图稿，仅本地化其营销文案。使用已安装的字体确定性地渲染最终文本，仅在批准的文案区域内进行合成，并使用 asc 的审核/应用功能进行远程交付。

工作流程

1. 盘点源 PNG 文件、顺序、尺寸、设备系列以及现有的远程截图。
2. 编写面向市场的地道文案。保留销售理念；当字面翻译使措辞生硬时，不要逐字翻译。保持换行符具有意图性。
3. 在编辑前检查每一张源图像。
4. 准备一个干净的母版，仅移除源营销文案。优先使用现有的已批准的干净母版。如果需要进行清理，使用紧密的遮罩并保护好其外部的每一个像素。
5. 使用 scripts/render_localized_text.py 渲染精确的本地化文案。使用已安装且确认字形覆盖范围的字体；绝不要使用图像生成来绘制最终文本。
6. 定义一个紧密的文本区域框，并验证最终位图与已批准的源文件仅在该区域内存在差异。
7. 检查带标签的联系表，然后以 100% 比例检查每个 CJK 标题，确认字形、拼写、换行、层级和清理接缝。
8. 验证尺寸、RGB 不透明度、文件数量、顺序、精确的清单文案，以及每个允许区域外零像素变化。
9. 生成 ASC 审核产物，检查它们，批准它们，并且仅在计划的应用分组与预期的语言环境/显示类型矩阵完全匹配时才执行 plan/apply 上传。未经明确授权，绝不要删除或替换远程截图。
10. 再次列出远程截图，并验证语言环境、设备系列、数量和处理状态。

图像生成边界

不要要求图像模型渲染最终的本地化文案。即使提示词中包含了确切的文字，生成的文本也可能包含替代字形、残留物或幻觉字符。

仅在无法本地生成干净的背景补丁时才使用图像生成，并且请求移除而非替换：

使用场景: precise-object-edit
资源类型: 本地化 App Store 截图的干净母版
输入图像: 编辑目标
主要请求: 仅移除现有的营销文案并重建背景。
约束条件: 保留背景、设备模型、透视、光照、每个产品屏幕像素、颜色、裁剪和宽高比。不要翻译或重绘产品 UI。
避免: 任何文本、字母、符号、水印、重新设计、设备更改、UI 更改或改变的产品图像。

如果合成或受保护的艺术图稿发生变化，则拒绝该结果。绝不要使用生成的完整位图；仅将经过审查的清理补丁合成到允许的区域内。

确定性合成

当源文案位于纹理背景上且内容较浅时，在本地准备一个干净的母版：

python scripts/prepare_clean_master.py \
  --source /path/to/approved.png \
  --output /path/to/clean-master.png \
  --box x,y,width,height

从 JSON 清单渲染精确文本：

python scripts/render_localized_text.py --manifest /path/to/text-manifest.json
python scripts/verify_localized_text.py --manifest /path/to/text-manifest.json

使用 references/manifest.md 中的模式创建 JSON 清单，然后运行：

python scripts/compose_localized_patch.py --manifest /path/to/manifest.json

该脚本将生成的编辑内容调整为精确的源尺寸，仅在允许的矩形区域加上羽化边缘内进行混合，写入不透明 RGB PNG，并验证允许区域外解码的像素是否与源文件完全相同。

不要为了掩盖模型漂移而放宽矩形框。应围绕营销文案收紧它。绝不要将产品 UI 包含在允许区域内。

App Store QA

• 保留源尺寸，除非目标是不同的 Apple 显示类型。
• 要求不透明 RGB 输出；拒绝带有 Alpha 通道的 PNG。
• 每个商店界面和显示类型维护一个有序的集合。
• 使用符合市场习惯的字体/字形，并目视检查 CJK 输出。
• 以缩略图比例确认每个标题，以 100% 比例确认每个副标题。
• 将可见文案与审核过的清单进行逐字符比较。OCR 可能有助于拉丁文字 QA，但绝不能替代 CJK 的目视检查。
• 拒绝残留的源文字母、重复笔画、替换字形、豆腐块、意外的标点符号或模型生成的文本。
• 将区域外像素零变化视为硬性不变规则。

ASC 上传安全

在上传前阅读已安装的 asc-shots-pipeline 和 asc-cli-usage 技能。使用 asc screenshots --help 和特定命令的 --help 确认当前标志。

推荐使用：

asc screenshots review-generate --framed-dir OUTPUT_ROOT --output-dir REVIEW_DIR
asc screenshots review-open --output-dir REVIEW_DIR
asc screenshots review-approve --all-ready --output-dir REVIEW_DIR
asc screenshots plan --app APP_ID --version VERSION --review-output-dir REVIEW_DIR --output json
asc screenshots apply --app APP_ID --version VERSION --review-output-dir REVIEW_DIR --confirm --output json

如果 plan/apply 无法表达预期的语言环境映射，请解析确切的版本-本地化 ID，并仅为该语言环境使用 asc screenshots upload。在上传前后列出截图。不要假设上传会替换现有截图；首先检查 CLI 行为和 Apple 的限制。

某些尺寸被多个 Apple 显示类型接受。例如，1290x2796 可能被验证为 APP_IPHONE_67 和 APP_IPHONE_69 两者。如果计划输出将相同文件重复到多个显示类型，请不要应用它。在执行匹配的试运行后，使用显式的 --device-type 运行应用范围的上传：

asc screenshots upload --app APP_ID --version-id VERSION_ID --path OUTPUT_ROOT --device-type APP_IPHONE_67 --dry-run
asc screenshots upload --app APP_ID --version-id VERSION_ID --path OUTPUT_ROOT --device-type APP_IPHONE_67

资源

• scripts/compose_localized_patch.py: 像素级锁定合成和验证。
• references/manifest.md: 清单模式和示例。