$setWindowFields 是 MongoDB 5.0 引入的聚合阶段，用于在排序后数据子集上计算窗口函数（如滑动平均、累计求和、排名），仅添加字段而不改结构，须配合 $sort 和可选 $partitionBy，且需显式指定 window 与 sortBy 才能正确执行。
什么是 $setWindowFields，它能做什么
$setWindowFields 是 MongoDB 5.0 引入的聚合阶段，专用于在分组（或按指定字段排序后）的数据子集上计算窗口函数。它不改变文档结构，只向每个文档添加新字段，比如滑动平均、累计求和、排名等。
它不能单独使用——必须配合 $sort 和（可选）$partitionBy，否则窗口边界无意义，结果不可控。
滑动平均必须显式指定 window 和 sortBy，否则报错
常见错误是直接写 { $avg: "$value" } 而不声明窗口范围，MongoDB 会抛出 "window is required for accumulator $avg"。
滑动平均依赖时间/顺序上下文，所以 sortBy 是强制项；window 必须用 { documents: [n, n] } 或 { range: [n, n] } 明确指定前后偏移量。
-
documents: [-2, 0]表示“当前行及前两行”，共 3 个点的平均值 -
documents: [-1, 1]是标准的 3 点中心滑动平均（含前一行、当前行、后一行） - 若用
range，需字段为数值型且有明确度量意义（如时间戳转毫秒），否则结果易失真
实际更新文档要用 $merge 或 $out，$setWindowFields 本身不写库
$setWindowFields 只存在于聚合流水线中，不会修改原集合。想把滑动平均值存回文档，必须接后续阶段：
- 用
$merge写回原集合（推荐）：指定on: "_id"，避免重复插入；注意设置whenMatched: "replace"或仅更新特定字段 - 用
$out会覆盖整个目标集合，风险高，仅适合导出新集合做验证 - 不能用
$set直接套在$setWindowFields外面——语法非法，聚合阶段顺序不可乱
示例片段（补全关键部分）：
[
{ $sort: { timestamp: 1 } },
{
$setWindowFields: {
sortBy: { timestamp: 1 },
output: {
moving_avg_3: { $avg: "$value", window: { documents: [-1, 1] } }
}
}
},
{ $merge: { into: "metrics", on: "_id", whenMatched: "replace" } }
]
性能和数据边界要手动处理，MongoDB 不自动填充
窗口计算默认跳过越界位置（如首行没有前一行），$avg 在窗口内遇到 null 或缺失字段时返回 null，不会降级为可用点数的平均值。
如果你需要首尾补零或复制边界值，得额外加逻辑：
- 用
$cond+$size判断窗口实际长度，再决定是否 fallback - 对时间序列，建议先用
$fill（5.3+）补缺失时间点，但 5.0 不支持，只能预处理 - 大数据量下，
$setWindowFields无法利用索引加速排序，$sort阶段可能成为瓶颈，务必确保sortBy字段有索引
最容易被忽略的是：窗口函数按 $sort 后的顺序执行，而 $sort 若未指定方向（如 { timestamp: 1 }），结果完全不确定——哪怕数据看着有序，也不能省略。
