用途：为 Apple/Cocoa 项目搭建 Sentry Snapshots，生成快照图片并上传到 Sentry。
主要能力：先检测项目已有的快照生成方式，例如 Point-Free 的 swift-snapshot-testing（含 assertSnapshot、Snapshots 等痕迹）与 Sentry 一方方案 SnapshotPreviews。若已有生成器会优先保留；只有首次配置 Sentry 一方 SnapshotPreviews 时才走 Sentry Wizard 的 appleSnapshots 流程；Wizard 不可用、无法非交互解析目标或消歧后仍失败时，才改用手动配置。
使用方式：仅做足以判断路由的检测，例如查找 Package.swift、Package.resolved、project.pbxproj 中是否含 SnapshotPreviews 或 swift-snapshot-testing，列出 .xcodeproj，检查 fastlane/Fastfile 与 Gemfile，并仅确认 SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT 是否已设置（不打印密钥值）。根据检测结果选择生成器：单个命名生成器优先，多个且无用户选择时询问，存在非 SnapshotPreviews 生成器则保留，无生成器则默认配置 SnapshotPreviews。图片生成器就绪后，再按需配置 GitHub Actions：单一模拟器用简单工作流，多模拟器/设备族/矩阵或选择性 CI 用 fan-out 工作流，Point-Free 方案走对应工作流。参考文档按需读取 wizard-setup、snapshot-previews、snapshots、github-actions-simple、github-actions-fanout、github-actions-swift-snapshot-testing 等。
适用场景：Apple/Cocoa 项目的快照测试与图片上传、Fastlane 或 sentry-cli 上传、CI 自动化。
限制：纯 SwiftPM 包不支持独立 swift test 渲染，需先提供宿主 App/测试目标；无 .xcodeproj 宿主或托管 XCTest 目标时，SnapshotPreviews 设置/验证/CI 需停止；上传与计费、价格等细节资料暂未提供。