用途
asc-experiments 用于管理 App Store 产品页优化测试（Product Page Optimization），即对图标、截图和预览图进行 A/B 测试。测试会向一部分 App Store 访客展示最多三个备选产品页（称为“处理组”/treatments），以衡量哪个版本转化效果更好。Apple 的 API 称这些为 appStoreVersionExperiments，而 CLI 中称为 experiments。
主要能力
- 列出与查看实验：支持按状态过滤、限制数量、表格输出。
- 创建实验：指定名称、流量比例（1–100）和平台（默认 ios）。
- 管理处理组：最多三个，可创建、更新、删除，并可通过 --app-icon-name 指定应用内打包的备选图标资源，实现图标 A/B 测试。
- 管理处理组本地化：为每个处理组选择适用的区域设置（locale），未包含在其中的商店区域用户会被排除在测试之外。
- 更新、启动、停止、删除实验：启动需实验已获批准（状态为 ACCEPTED/APPROVED），停止用于结束运行中的测试。
- 状态感知操作建议：JSON 输出中提供 affordances，只展示当前状态下合法的下一步操作，避免执行 Apple 会拒绝的变更。
- REST 接口：所有命令也可通过 asc web-server 提供的 REST 端点访问，查询参数与 CLI 标志对应。
使用方式
基本命令示例：
asc experiments list --app-id <APP_ID> [--state APPROVED] [--limit N] [--pretty]
asc experiments get --experiment-id <EXP_ID>
asc experiments create --app-id <APP_ID> --name "Icon test" --traffic-proportion 30 [--platform ios|macos|tvos|visionos]
asc experiment-treatments create --experiment-id <EXP_ID> --name "Blue icon" [--app-icon-name AppIcon-Blue]
asc experiment-treatment-localizations create --treatment-id <TRT_ID> --locale en-US
asc experiments start --experiment-id <EXP_ID>
asc experiments stop --experiment-id <EXP_ID>
典型工作流：先确认存在可分发版本（asc versions list），再创建实验、添加处理组和本地化、提交审核并轮询直到 canStart 为 true，然后启动测试，获得结果后停止。
适用场景
适用于需要对 App Store 产品页进行 A/B 测试的开发者，尤其是希望测试不同图标、截图或预览图对转化率影响的场景。
限制
- Apple 要求应用在目标平台上有处于 READY_FOR_DISTRIBUTION（或预购就绪）状态的版本，否则创建会失败并返回 STATE_ERROR.PPO_CREATE_ONLY_ALLOWED_WITH_APP_STORE_DISTRIBUTION。
- 测试最长运行 90 天或直到手动停止。
- 处理组越多，达到统计显著性所需时间越长；--traffic-proportion 在多个处理组之间平均分配（例如三个处理组时 30% 意味着每个 10%）。
- 处理组的截图/预览集挂在其本地化下，CLI 暂未暴露该功能。
- 启动实验需先获得批准（状态为 ACCEPTED/APPROVED）。
- 状态语义：isEditable 对应 PREPARE_FOR_SUBMISSION、READY_FOR_REVIEW、REJECTED；isPendingReview 对应 WAITING_FOR_REVIEW、IN_REVIEW；isApproved 对应 ACCEPTED、APPROVED；isFinished 对应 COMPLETED、STOPPED。canStart 表示已批准且 startDate 为空；isRunning 表示已批准、startDate 已设置且 endDate 为空。