用途：为 Apple/Cocoa 项目生成快照图片并上传到 Sentry Snapshots。
主要能力：先检测项目中已有的快照生成方案，例如 Sentry 一方 SnapshotPreviews 或 Point-Free swift-snapshot-testing，并在已能产出 PNG/JPEG 时保留原有生成器；仅在首次配置 Sentry SnapshotPreviews 时使用 Sentry Wizard 的 appleSnapshots 流程；支持通过 Fastlane、sentry-cli、清单文件与 CI 上传快照，并提供单目标与多目标 GitHub Actions 工作流参考。
使用方式：按路由顺序处理。检测使用 find 与 grep 查找 Package.swift、Package.resolved、project.pbxproj 中的 SnapshotPreviews 或 swift-snapshot-testing 等标志，并用 find 定位 .xcodeproj。Sentry 认证仅检测存在性，不打印密钥值，例如 [ -n "$SENTRY_AUTH_TOKEN" ] && echo "SENTRY_AUTH_TOKEN=set" || echo "SENTRY_AUTH_TOKEN=unset"。若已有命名生成器则优先使用；多个生成器且无用户选择时询问；非 SnapshotPreviews 生成器保留；已有 SnapshotPreviews 直接使用；没有生成器则默认配置 SnapshotPreviews。
适用场景：iOS/macOS 等 Apple 项目的快照测试与 Sentry 上传；已有快照方案的迁移或保留；CI 中按单模拟器或多设备矩阵执行并上传。
限制：遇到纯 SwiftPM 包时须停止并询问宿主应用或测试目标，独立的 swift test 渲染不受支持；无 .xcodeproj 宿主应用或无托管 XCTest 目标时，SnapshotPreviews 配置、验证与 CI 均需停止；仅在向导不可用或明确消歧后仍失败时才改用手动配置；多模拟器、设备族、矩阵或选择性 CI 时使用 fan-out 参考；基础分支上传为全量，PR 选择性上传须包含完整图片名清单。具体命令与参考文件内容以原始资料为准，其他未提供信息暂未说明。