数据保留期

90 天明细边界

运行与引用明细按小时清理：早于当前时间 90 天的行被软删。GET /v1/runs、/v1/runs/{id} 与 /v1/citations 等明细端点排除软删行。需要长期留存原始回答或逐条引用时，应在 90 天内同步进自己的数仓。

响应中的边界

"meta": {
  "retention_start_ms": 1780339200000,
  "retention_days": 90
}

运行、引用等受 90 天保留期约束的明细响应透出 retention_start_ms 与 retention_days。不要在客户端写死「今天减 90 天」：以响应发布的边界为准，它能处理服务端时钟与策略变化。提示词不受该保留期约束，因此不返回这组元数据。

聚合与明细不对称

可见度时间序列与 SoV 聚合沿用产品内部趋势口径，包含软删行；明细不包含。查询早于 retention_start_ms 的窗口时，这些聚合仍可能返回历史趋势，而明细端点返回空集合。可见度矩阵是例外：它读取保留期内未软删的最新明细，并随响应返回 retention meta。

窗口语义

所有 since/until 都是 Unix 毫秒，采用半开区间 [since, until)：包含 since，排除 until。显式 since=0 表示从 Unix epoch 开始，不会被当成缺省值；是否有默认窗口只取决于参数是否省略。相邻窗口应让前一段的 until 等于后一段的 since，这样不会重叠或留缝。

长期归档请同步明细；长期分析可直接使用聚合。两种出口服务的是不同需求。