用途：指导完成两个相关流程——在留存分析中创建指标；以及先创建留存指标，再把它加入事件分析报表，从而将留存分析模型合并到事件分析模型。
使用场景：用户询问如何创建留存指标、如何把留存分析模型合并进事件分析模型、如何按已有留存报表配置留存指标时触发。不适用于：校验留存数据是否正确或排查留存与事件分析数据差异、留存趋势/流失/LTV 分析、选择分析模型、单纯的查询或查看报表。
必要用法：所有平台操作只使用 ae-cli。执行前需阅读对应参考文件，它们是字段、枚举值与命令模板的依据：创建留存指标读 references/retention_metric_create.md；定位或查看报表读 references/report_cli_workflow.md；把指标加入事件报表读 references/retention_metric_in_event_report.md。
创建指标：创建前须与用户确认指标定义（同显 ROI/LTV/LT、留存用户数、留存率、流失率或流失用户数）与 Day-N 的 unitNum（如 3、7、30），不得使用默认值；确认项目 ID、初始事件与回访事件名称（须取自实际项目元数据，禁止编造）、分析主体（#user_id 为预设，但 taIdMeasureVo 必须匹配项目分析主体）。创建命令形如：ae-cli analysis-meta metric create --project-id <project_id> --metric-name <metric_name> --metric-desc '<metric_display_name>' --model-type retention --metric-events '<metric_events_definition>' --metric-params '<metric_params_definition>'；随后用 ae-cli analysis-meta metric get --project-id <project_id> --metric-id <metric_id> 验证落库。若基于已有留存报表创建，先用 report list 定位、report get 查看配置并映射字段，仍需与用户确认定义和 unitNum。
加入事件报表：写入前确认是加入已有报表还是新建报表；做时间粒度预检，留存指标仅支持按日、按周、按月，若目标报表为总计或其他不支持粒度须停止并说明，不得提议改成不支持的值；粒度不一致时须确认对齐哪一侧，确认后再写。已有报表用 report list 唯一定位、report get 取当前版本与完整定义，保留全部 metrics[] 条目后追加留存指标条目，再以 report update 和最新 --report-version 写入（乐观锁）；新报表用 report create 并直接设定 time_particle_size。写后用 report get 确认该条目解析为指标，并用 report-data run 做有界预览；用 asset url-get 取报表链接。
限制：不提交原始 QP 定义；不编造事件名、属性名、指标字段、枚举值或命令参数；SIM_STAT 指标需在 type-3 条目创建时带 init_date_stat_first: false；ae-cli 不可用或权限/能力报错时须停止并报告，不得伪造结果。缺失项目 ID、事件名或分析主体时询问用户，不要猜测；DATA_ALREADY_UPDATED 时重新 report get 取最新版本重组后重试一次，仍失败则停止排查；指标列全为 - 时先确认查询成功再检查观察窗口，历史不足时 N 日指标可能为空；临时验证资产仅在用户明确确认后删除。回复须与用户使用同一语言。