拾景纸刊实况全流程 v1.0（实况版）是一个把单张照片转化为可导入 Apple 实况照片（Live Photo）ZIP 的工作流技能。它通过两个严格分离的模块运作：先用内置的 static-poster-v1-9 模块生成静态海报，再仅对海报上的一层平面覆盖纸做撕开动画，最后把最终帧配对为 Apple Live Photo 的 JPG/MOV 组合并打包成一个 ZIP。
用途 该技能面向需要从一张照片出发，产出静态海报并进一步生成 Apple 实况照片 ZIP 的场景。它强调静态视觉决策与动画的严格分离：内置的 static-poster-v1-9 模块是所有静态视觉决策的唯一来源，动画阶段不得修改它。
触发模式
- 完整流程 / 导入：源照片 → v1.9 海报 → 实况 ZIP → 导入器交接。
- 仅生成 ZIP：源照片或成品 v1.9 海报 → 实况 ZIP，使用 --no-import。
- 仅静态海报：直接遵循 references/static-poster-v1-9/SKILL.md，并在动画前停止。
对于既定的完整流程工作流，会跳过预览影片、联系表、视觉审查关卡、元数据报告和审批暂停。除非某一步返回明确错误，否则自动继续。最终视觉检查由用户完成。
阶段一：冻结海报 如果输入是原始照片：读取并遵循完整的内置模块 references/static-poster-v1-9/SKILL.md；使用其要求的图像生成路径生成方向匹配的海报；将扁平化结果保存在当前项目输出目录中。如果输入已经是成品 v1.9 海报，则直接从它开始。此阶段之后，成品海报被视为不可变的底板。动画期间不得重新上色、锐化、澄清、重新生成、裁剪、非等比缩放、修饰人脸、添加细节或以其他方式重新设计它。每个完全显露的帧区域都必须直接来自这张冻结的海报。
阶段二：选择撕开路径 仅在看到成品海报后才构思撕开路径。需阅读 references/adaptive-path-selection.md 和 references/adaptive-tear-boundary.md。始终组合一条源自画面的自定义路径，包含 3–7 个归一化点。不要从预设方向中选择。从安静的纸张开始，建立环境或线索，接着揭示结构关系，在中间三分之一把主要主体带入视野，最后结束于清晰的视觉停留点。遵循真实的脊线、海岸线、屋顶线、道路、视线、空间深度过渡或主体之间的关系。补充海报的引导色，但不要描摹它。避免从上到下和从下到上的揭示、一条僵硬的直线对角线、人脸、身体、文字和定义性物体。可见开口遵循一条场景感知的全局路径。其边界使用宽幅、高振幅、低频的起伏，小的不等缺口，变化的开口宽度，以及狭窄的暖色纤维边缘。拒绝干净的数字擦除、均匀锯齿、规则之字形、卷曲纸张和 3D 深度模拟。
阶段三：构建实况 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 是本工作流唯一需要的持久交付产物。所有渲染帧、未配对媒体和回执都保持临时状态。
阶段四：导入器交接 当用户要求完整自动化流程或要求把结果放入“照片”时，省略 --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 是否接受了导入器交接，并简要描述所构思的叙事路径。除非用户明确要求，否则不要展示中间文件。
适用场景与限制 该技能适用于 macOS（Apple 芯片）环境，依赖内置的 static-poster-v1-9 模块、构建脚本和实况照片导入器应用。它不负责照片图库插入、权限或 iCloud 同步，这些由导入器处理。动画阶段严格限制为平面覆盖纸的撕开效果，不包含镜头运动、主体运动、重新打光、视差或内部动画。ZIP 内容有严格契约，不得包含额外文件。若导入器缺失，流程会保留 ZIP 并报告错误，而不会重新生成海报或动画。