scenes-gathered-zine-live-flow-v1-0

拾景纸刊实况全流程 v1.0（实况版）

将一张提供的照片转换为一个可直接导入的实况照片 ZIP，分为两个严格隔离的模块：

1. 使用冻结的捆绑模块 references/static-poster-v1-9/SKILL.md 制作完成的海报。
2. 仅让一张平面覆盖纸从完成的海报上撕开。
3. 将确切的最终帧配对为 Apple 实况照片 JPG/MOV 文件对。
4. 仅将该文件对打包进一个 ZIP。
5. 收到导入请求时，通过 macOS 文件打开功能将 ZIP 交给“实况照片导入器”，然后停止。

不要修改捆绑的 static-poster-v1-9 模块。它仍然是所有静态视觉决策的唯一事实来源。

触发模式

• **完整流程／导入：**源照片 → v1.9 海报 → 实况 ZIP → 交接给导入器。
• **仅 ZIP：**源照片或完成的 v1.9 海报 → 使用 --no-import 生成实况 ZIP。
• **仅静态：**直接遵循 references/static-poster-v1-9/SKILL.md，并在动画前停止。

对于既定的完整流程，跳过预览影片、联系表、视觉审核关卡、元数据报告和审批暂停。除非某个步骤明确报错，否则自动继续。最终视觉检查由用户完成。

阶段 1：冻结海报

如果输入是原始照片：

1. 阅读并遵循完整的捆绑模块 references/static-poster-v1-9/SKILL.md。
2. 使用其指定的图像生成流程，生成方向匹配的海报。
3. 将扁平化结果保存到当前项目输出目录中。

如果输入已经是完成的 v1.9 海报，则直接从该海报开始。

此阶段完成后，将完成的海报视为不可变的底板。动画过程中不得重新着色、锐化、增强清晰度、重新生成、裁切、非等比例缩放、修饰面部、添加细节或以其他方式重新设计。每个完全显露的帧区域都必须直接来自这张冻结的海报。

阶段 2：选择撕裂路径

只有在看到完成的海报后，才能设计撕裂路径。阅读：

• references/adaptive-path-selection.md
• references/adaptive-tear-boundary.md

始终使用源图像设计一条包含 3–7 个归一化点的自定义路径。不要从预设方向中选择。从安静的纸面区域开始，呈现环境或线索，接着揭示结构关系，在中间三分之一处让主体显露，最后停在清晰的视觉落点。

沿着真实的山脊、海岸线、屋顶线、道路、视线方向、空间深度转换或主体间的关系展开。与海报的引导色形成呼应，但不要沿着它描摹。避免从上到下或从下到上的显露方式、单一僵硬的直线对角线，以及面部、身体、文字和标志性物体。

可见开口沿着一条符合场景特点的全局路径展开。边界应有宽阔、高振幅、低频率的起伏、不均匀的小缺口、不断变化的开口宽度，以及窄窄的暖色纤维毛边。不要使用干净的数字擦除效果、均匀的锯齿、规则的之字形、卷曲的纸张或 3D 深度模拟。

阶段 3：生成实况 ZIP

使用 scripts/build_live_zip_and_import.py，并提供冻结的海报、选定的方向和可选的自定义路径。可接受的动态配置固定如下：

• 时长 3.0 秒，帧率 30 fps；
• 短暂的完全覆盖停留；
• 裂口扩展；
• 两侧非对称展开，边界呈宽阔、圆润的低频变化；
• 从 2.7 秒起直至最后停留，画面均为完全不变的海报；
• 不进行镜头运动、主体运动、重新布光、视差或内部动画。

仅生成 ZIP 的示例：

python3 scripts/build_live_zip_and_import.py \
  --input /absolute/path/to/final-poster.png \
  --output-zip /absolute/path/to/GatheredScenesLivePhoto.zip \
  --direction custom \
  --path-points "0.04,0.72;0.26,0.60;0.52,0.44;0.76,0.34;0.98,0.24" \
  --no-import

阅读 references/apple-live-photo.md，了解配对约束。ZIP 规范严格如下：

• 顶层恰好有一个文件夹；
• 该文件夹内恰好有一对配对的 .JPG 和一个配对的 .MOV；
• ZIP 内不得包含海报、收据、联系表、预览文件、源文件或旁置文件；
• ZIP 是此工作流所需的唯一持久交付物。

所有渲染帧、未配对媒体和收据都必须保留为临时文件。

阶段 4：导入器交接

当用户要求完整的自动化流程或要求将结果放入“照片”时，省略 --no-import。阅读 references/importer-handoff.md，并让构建脚本使用 bundle id com.zeejay.live-photo-importer 打开已完成的 ZIP。

此技能包含可直接运行的 Apple 芯片版 macOS 导入器，位于 assets/实况照片导入器.app。构建脚本会自动检查明确指定的应用、用户已安装的副本，然后检查此处捆绑的副本。不要要求用户单独下载导入器。

不要模拟拖放操作，也不要操作“照片”应用。成功将 ZIP 提交给“实况照片导入器”即为停止点。导入器负责验证配对、处理权限、插入“照片”图库以及后续的 iCloud 同步。

如果找不到导入器，请先确认捆绑的应用存在且完好。否则保留已完成的 ZIP，并报告交接错误。不要重新生成海报或动画。只有在已知另一个确切的应用路径时，才使用 --importer-app /absolute/path/实况照片导入器.app。

响应约定

对于仅 ZIP 模式，返回 ZIP 的绝对路径。对于完整流程模式，返回 ZIP 的绝对路径，说明 macOS 是否接受了导入器交接，并简要描述合成的叙事路径。除非用户明确要求，否则不要展示中间文件。