Community图像github.com

shootpack

一键处理房地产拍摄文件夹(DJI 无人机和/或索尼 A1 II 等相机,混搭亦可),输出客户交付物——基于原始包围曝光的 HDR 照片(LightCraft)、精选/备用照片,以及一段 60 秒 Rec.709 调色视频。当用户指向一个拍摄文件夹时使用(如“处理这个拍摄”、“打包 Maginot”、“对 ~/Desktop/X 运行 shootpack”)。

shootpack 是什么?

shootpack 是一个面向房地产摄影师的 AI 代理技能,能够自动化端到端的拍摄后期处理流水线。它接受包含来自 DJI 无人机(如 Mavic 4 Pro)、索尼 A1 II、富士 X-E4 和 DJI Osmo 360 II 等设备的混合照片和视频的文件夹,执行从原始文件开发、HDR 合并、智能筛选到 60 秒调色视频剪辑的所有任务。该技能使用设备特定的配置来检测相机,并根据 EXIF 数据、视频内容或用户提供的参数(如高度限制、目标照片数量或地理坐标)应用适当的处理。它支持 DJI 官方 LUT 和自定义创意调色方案,集成 Epidemic Sound 进行音乐添加,并生成包括 HDR DNG、联系表和总结的交付物。关键独特功能包括自动太阳检测和筛选、基于信号的日志曲线识别以及双卡冗余处理。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattgiss/shootpack/tree/main/skill

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

shootpack 是做什么的?

流水线位于 ~/shootpack(Git 仓库)。入口点:shootpack <文件夹> [--ceiling M] [--picks N] [--length S] [--log CURVE] [--latlon LAT,LON] [--plan]。使用 --plan 开始新拍摄(盘点、筛选和编辑计划,不导出)。

设备

每个文件的相机通过 EXIF 厂商/型号、视频编码器/型号标签、侧边栏文件等检测,并使用 devices/<id>.json 中的配置文件读取;未知相机使用 devices/generic.json。第一行日志会列出检测到的内容(devices: DJI Mavic 4 Pro (200 张照片, 8 个片段), Sony A1 II (...))——请检查。

  • DJI Mavic 4 Pro (dji_mavic4pro):XMP 无人机几何数据 → 太阳检测、构图感知筛选、高度标记、高度感知视频;SRT 遥测,LRF 代理。
  • Sony A1 II (sony_a1ii, EXIF 型号 ILCE-1M2):ARW 包围曝光(+ JPG/HEIF 配对,跨卡)按曝光补偿 + 驱动模式分组;片段 XML 侧边栏 (C0001M01.XML) 给出开始时间、帧率、伽马和色域;SUB/ 代理。无相机几何数据:无自动太阳配置文件(在 cull.json 中手动设置 "sun"),筛选基于图像内容(几乎相同的帧 = 重复),并按镜头命名照片(24mm,70mm-portrait)。
  • Fujifilm X-E4 (fujifilm_xe4,EXIF 型号 X-E4 在 RAF、JPG 和 MP4 上):单帧,RAF + JPG 配对。JPG 是配方渲染(Classic Chrome 等;配方在 RAF 的 EXIF 中,参见 photo.recipe_tags);LightCraft 自己的 RAF 开发是暗且平坦的,忽略配方,因此在导出前为相机 JPEG 拟合一个开发配置文件。同一 DCIM 文件夹中的片段,无侧边栏;胶片模拟片段为 Rec.709(仅外观,无技术 LUT),F-Log 从信号中检测。卸载:shootpack offload <卡> --device XE4(放入文件夹 Drops/XE4/)。开发:使用拍摄自己的配对运行 recipe_fit.py fit LUT.npz RAF=JPG,...(按捕捉时间配对 RAF 和 JPG:编号可能相差 1),然后运行 fuji_develop.py batch LUT.npz cull.json <DCIM 目录> Deliverables/Photos(cull.json 键是 JPEG 编号 -> {raf, jpg, name})。相机时钟可能使用家乡时间(一次婚礼拍摄:-06:00,本地 = +8 小时)。带现场声音的事件片段:clip_edit.py edits/<规格>.json Video/<名称>_4K.mp4(无音乐,L-cut 音频;除非 motion.py 证明有益,否则稳像保持关闭)。参见 agent-docs/photos/fuji-recipe.md。
  • DJI Osmo 360 II (dji_osmo360ii,.OSV 通过 MP4 编码器标签 Osmo 360 II 找到):两个鱼眼流,因此其片段被搁置(日志显示 "N 360 片段... 使用 osmo360.py 渲染它们")并且永远不会进入房地产编辑。osmo360.py CLIP.OSV Deliverables/Video 写入一个已调色的平面重新构图(关键帧移动)和一个已调色的等距柱状投影 360 视频。拼接未校准,地平线未调平;镜头在重叠区域进行了增益匹配。从图像圆内的信号读取色彩模式(Normal 色彩 vs D-Log M,已在真实片段上验证两种模式)。D-Log M 使用一个临时 LUT(luts/interim_dlogm_to_709_osmo360ii.cube)拟合到相机自己的代理,直到 DJI 的 Osmo 360 D-Log M LUT 位于 luts/official/。--spec edits/osmo_car_v1.json 渲染一个长片段的关键帧摘录(汽车测试中驾驶员的紧密、曝光提升裁剪)。一个平面裁剪具有 18.6 x h_fov 真实像素宽度:紧密裁剪的 4K 被放大(agent-docs/video/osmo360.md)。相机有内部存储和 SD 卡(两个卷)。卸载:shootpack offload <卡> 自行找到它(Drops/Osmo360/)。
  • 双槽录音:检测到两张卡上的相同文件(名称 + 捕捉时间 + 大小,然后哈希),使用插槽-1 副本;日志说明跳过了多少。
  • 无 GPS 任何地方(仅相机拍摄):会话按本地时钟时间命名(Morning < 10:00, Midday < 15:00, Afternoon < 17:30, Evening),调色跟随名称(Midday/Afternoon:正午外观;否则为 golden)。传递 --latlon 改为按太阳命名。索尼照片没有几何数据,因此太阳照片不会获得自动太阳配置文件:在 cull.json 中手动设置 "sun": {"G18": "A"}(自动开发提升一个穿过玻璃的暗太阳帧为平坦)。
  • 新相机:复制最接近的配置文件,更改 detect.models、传感器/FOV、包围规则和日志曲线。

步骤

  1. 运行它。 在后台运行 shootpack "<文件夹>" --ceiling <用户的 LAANC/空域天花板高度,默认 120>(照片约每包围 25 秒,视频约 4 分钟)。它将所有内容缓存在 <文件夹>/Deliverables/_shootpack/ 中。
  2. 视觉检查筛选结果 - 打开 Deliverables/_shootpack/<session>/all_stations.jpg 和每个 Deliverables/Photos/<session>/Picks_contact_sheet.jpg。自动筛选无法看到内容,因此检查并修复:
    • 房屋在帧边缘被裁剪 → 移至拒绝
    • 场景中有人(通常是穿高可见度背心的飞行员)→ 备用,注明 "PERSON-IN-FRAME"
    • 接近重复 / 无聊的重复 → 备用;留在备用中的强片 → 精选
    • 超过天花板高度的镜头已在备用中标记 — 提及它们,不要隐藏 编辑 <session>/cull.json(键 G01...;值是简短名称),删除受影响的输出,使用 --only photos 重新运行。 太阳照片 被自动检测(太阳在帧内通过太阳几何 + 在最暗包围中仍然高光裁剪)并使用太阳配置文件开发:A = 太阳是主体(比自动低 -1.9 档),C = 房屋是主体(-0.6 档,房屋保持明亮)。在 cull.json 中每张照片覆盖:"sun": {"G21": "A", "G07": "off"}。 星芒: 如果包围帧在可见太阳盘周围显示清晰的衍射射线(查看每一帧中的太阳),添加 "starburst": {"G21": "0209"}(帧号)并重新运行 --only photos --redo;切勿用于云后的太阳(那些射线是太阳光束,已经在合并中幸存)。检查太阳照片是否有粉红色高光云彩。
  3. 检查视频 - 打开 Deliverables/Video/*_storyboard.jpg(每 3 秒一帧)。通过编辑 Deliverables/_shootpack/edit.json(片段、开始、长度、速度、以档为单位的曝光)替换起飞/着陆、飞行员、过暗或重复的镜头,并重新运行 --only video。使用片段的代理(DJI .LRF,索尼 SUB/)和 DJI .SRT(rel_alt,position)找到更好的时刻。相机片段没有遥测,因此起飞/着陆修剪和高度波段不适用;24p/30p 片段从不放慢(只有 50p+ 可以喂入慢动作)。
  4. 调色 - 使用 ~/shootpack/luts/official/ 中的 DJI 官方 LUT(Maginot:"DJI Mavic 4 Pro D-Log to Rec.709 V1.cube"),每个镜头获得 DJI 的 LUT 作为技术基础,再加上我们的创意外观:luts/looks/ dlog_golden_*(黄金时段:更暖,更平静的蓝色,打开的阴影)或 dlog_midday_*(更多对比度/冲击力)。luts/looks/make_looks.sh 重建它们(build_look.py:_input.cube = 应用了曝光的官方 LUT,用于 FilmCraft 的 Input 插槽;_look.cube = Rec.709→Rec.709 用于 Creative 插槽;_composed.cube = 两者,用于 ffmpeg)。将曝光提升放在官方 LUT 之前(--pre-exposure,以 log 中的档为单位):DJI 的 LUT 比其自己的 JPEG 更暗,之后提升会裁剪天空(由于这个原因,Maginot 的第 5 版出现了 30-50% 过暗)。如果没有官方 LUT,则使用基于曲线的 warm_print_v6 / warm_print_midday_v2。始终验证新的官方 LUT 是否与素材的配置文件匹配(见下文)。
  5. 音乐(预告片) - 通过用户的 OAuth 连接器(绝没有 API 密钥)使用 Epidemic Sound。搜索乐器 "build" 曲目,其小节长度匹配蒙太奇剪辑(75 BPM = 3.2 秒小节),并读取每个波形的能量曲线:您想要一个安静的引子、一个长的构建和一个大高潮。DownloadRecording(WAV,FULL)放入 Deliverables/Music/,然后 music.analyze(wav, given_bpm):检查高潮是否落在强拍上(网格的 on/off-beat 相位来自鼓/贝斯,小节相位来自最大的低频跳跃)。选择跳跃 X→Y,其中 bar_Y 对 bar_X+1 的 bar_chroma 相似度 >= 0.9(相同和弦,无 audible splice)。在小节网格上以整帧计时画面(模板:edits/make_trailer_v7.py):剪辑在强拍上,结局在高潮上,结束卡在释放上。trailer.py 将 spec["music"] 混入每个输出;--music-only 重新编辑和重新混音而不重新渲染;--size 1920x1080 制作一个 5 分钟的计时检查(在 6K 渲染前测量剪辑与节拍)。客户品味(参考拍摄,v8-v11):全 16:9 无 letterbox("letterbox": null),无文字卡,无溶解或黑场过渡,在节拍上硬切,以最后一帧结束(在音乐尾声中允许 1 秒 "end_fade")。平滑镜头使用 "stabilize":一个数字 = 以秒为单位的高斯 sigma(1-2),{"poly": 2} = 一个均匀的运动。没有 letterbox,每个垂直校正都会消耗缩放,因此保持 sigma 适中(参考拍摄的结局:1.25 = 6.6% 缩放,2.0 将是 12%);"reframe_y" 只有带 letterbox 才有帮助。为了在运动结束时保留更多房屋,减慢镜头使其更早结束运动。测量预览上的抖动(stabilize.track)前后;无人机自己的停止和反转只能被软化(更重的 sigma + 0.85x),无法消除。 Epidemic 的 EditRecording 在设置 requiredRegionsAtOffsets 时返回无编辑,并且其无约束的 60 秒编辑完全丢弃了高潮(2026 年 10 月),因此我们自己剪辑曲目。客户工作需要商业 Epidemic 计划;请询问。
  6. 交付 - 使用 SendUserFile 发送精选联系表、720p 预览(<30 MB)和故事板;从 Deliverables/SUMMARY.md 总结(计数、标记、临时内容)。将任何可复用的代码更改提交到仓库。

显示进度

对于每个更改,提供前后对比:更新 review_site/<拍摄>/progress/*/manifest.json(调色 / 照片 / 细节 / 剪辑 / 音乐)并使用 progress_page.py 重建(progress_music.py 绘制音乐适配图);使用 SendUserFile 发送一个适合手机的单页或堆叠对比视频。

重要事实

  • 始终从 原始文件 开发(DJI DNG,索尼 ARW);JPG 仅为元数据/参考。仅 ARW 的照片从原始文件中提取一个参考 JPEG 到 _shootpack/previews/。LightCraft 使用适配到索尼自己 JPEG(不是柔和的 neutral 回退)的外观渲染 ARW,但没有索尼镜头配置文件:畸变/渐晕保持原样。其对 ARW 的 HDR 合并写入一个没有色彩矩阵或白平衡的 DNG(开发为绿色):流水线写入相机的校准(ColorMatrix1 来自 LibRaw 通过 rawpy 的 Adobe 派生表,AsShotNeutral 来自照片)并开发该文件,因此来自索尼包围的 HDR_DNG/ 文件在任何原始编辑器中以正确的颜色打开。
  • LightCraft 将 *-HDR.dng 写入其源文件旁边;流水线将它们移动到 Deliverables/HDR_DNG/。绝不修改原始文件。
  • DJI MP4 以旋转方式存储(rotation=-90);ffprobe 报告纵向尺寸,但它们以横向方式播放。
  • 索尼卡:每个插槽复制整个 DCIM/ + PRIVATE/ 树(Finder 无法在 MTP 模式下挂载相机 - 使用读卡器或 USB 大容量存储);如果没有 M01.XML 侧边栏,片段的伽马/色域将仅由信号决定。
  • SRT DiffTime: 16ms = 59.94p → 半速符合至 29.97 以实现平滑轨道。
  • 日志曲线每片段根据信号决定:检查大约 10 帧的亮度码值分布(p95 = 白色所在位置),对照配置文件中每个曲线的波段,然后是相机的标签(DJI SRT color_md,索尼 XML CaptureGammaEquation),然后是 --log。信任顺序:显式的 --log,然后信号,然后标签。每个不一致都是日志和 SUMMARY.md 中的 WARNING — 在渲染前阅读。D-Log vs D-Log M:在日光下,D-Log 将白色保持在约 0.55 码值(超级白色以上用于天空/太阳;Maginot p95 0.44-0.69);D-Log M 将它们放在接近 0.8+。D-Log M LUT 应用于 D-Log 素材会使白色渲染为约 50% 灰度(平坦、暗淡)— Maginot 是 D-Log。太暗(夜间)或介于波段之间 = 不确定 → 由标签决定。_shootpack/log/*.json 缓存统计数据。
  • 每设备/曲线/色域的 LUT 匹配:luts/official/ 中的官方 LUT 通过标准化文件名标记("D-Log M" 计为 D-Log M;Mavic 4 Pro LUT 优先于其他 DJI LUT)。DJI 无官方 LUT:基于曲线的暖印调色。索尼 S-Log3:FilmCraft 内置的 builtin:slog3-sgamut3cine-to-rec709(或 -sgamut3-,来自 XML 的 CaptureColorPrimaries),导出到 luts/builtin/;我们的 D-Log 外观在其上重新组合为 luts/looks/slog3_*_composed.cube,并匹配前置曝光,使得 18% 灰度落在 DJI 的输入 LUT 放置它的位置(混合 DJI + 索尼编辑匹配)。S-Cinetone/Rec.709/HLG 片段不需要解码:仅使用 _look.cube。
  • edit.json 中的曝光是根据片段曲线的码值每档提升(lift:D-Log 67,S-Log3 79)。
  • LightCraft 太阳照片:保持 light.whites 为 0 且 light.highlights 为 -60 或更温和;更强的恢复或洋红色调会将高光云彩拉到白色以下,使其渲染为粉红色。
  • 6K 渲染:trailer.py 分段渲染(在硬切和黑场过渡处分割)— 14 个并行 6K 解码会在 16 GB 内存上耗尽。
  • 注意可用磁盘空间:每个 HDR DNG 约 300 MB;流水线在剩余空间低于 5 GB 时停止。

相关技能