sentry-snapshots-cocoa

用途：为 Apple/Cocoa 项目生成快照图像并上传到 Sentry Snapshots，覆盖本地生成、验证与 GitHub Actions CI 上传流程。主要能力：先检测项目内已有快照方案，优先保留可输出 PNG/JPEG 的既有生成器（如 Point-Free swift-snapshot-testing，保留 Snapshots、assertSnapshot 等路径）；仅在配置 Sentry 一方 SnapshotPreviews 时使用 Sentry Wizard 的 appleSnapshots 流程；Wizard 不可用或非交互解析失败时改用手动配置。路由规则：已有命名生成器优先；多个生成器且用户未选择时先询问；无生成器时默认配置 SnapshotPreviews。若使用 SnapshotPreviews 但没有 .xcodeproj 宿主应用或托管 XCTest 目标，则在配置、验证与 CI 前停止。仅支持 Package.swift 的 SwiftPM 项目需先询问宿主应用/测试目标，不支持独立 swift test 渲染。CI 仅在已有图像生成器后进行：单模拟器无矩阵时用简单 GitHub Actions 流程，多模拟器/设备族/矩阵/选择性 CI 用 fan-out 流程，swift-snapshot-testing 用对应参考文档。完成检查：生成器已记录并保留或配置；测试日志出现快照生成；导出目录含 .png 及可能的 .json 附属文件；上传成功并打印 Sentry URL 或 snapshot id；基线分支为全量上传，选择性 PR 上传需包含完整图像名清单。检测阶段只做路由所需的最小检测，认证信息仅判断 SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT 是否设置，绝不打印密钥值。限制：资料未提供具体收费、价格、平台支持范围及详细使用步骤，缺失信息暂未提供。