fix: improve shadow diagnostic matching

doc/algorithm-shadow/README.md

@@ -237,6 +237,8 @@ WHERE created_at >= '<测试开始时间>'
 ORDER BY created_at, decision_id;
 ```
 
+出库对比记录的 `reason` 会带出 `detail`、`project`、`product`、`tray`、`stock`、`snapshotSync`、`legacyMatches` 和 `shadowMatches`。其中 `legacyMatches` 是按 Legacy 有效库存条件计算的实时数量，`shadowMatches` 是影子快照中按项目/产品条件计算的数量；两者不一致时先检查快照同步时间，再判断业务映射。
+
 交付分析的数据包至少包括：
 
 - 决策日志导出文件，保持原始列名和时间字段；