diff --git a/.agents/skills/staging-ops.md b/.agents/skills/staging-ops.md index 58ca4b1e..2521c7e6 100644 --- a/.agents/skills/staging-ops.md +++ b/.agents/skills/staging-ops.md @@ -58,6 +58,7 @@ - API 就绪门:`deploy/smoke-test.sh`(只读 12 项)+ `--deep`(13 项含 generate 入队),含 CORS/鉴权(test1 token)验证。 - gotcha:feed item 的 `packageUrl` 恒 null,真实取包走 `GET /app-api/runtime/package/{versionId}`。 +- **feed 流端点语义(2026-07-05 真机坐实,防 R5 式假警报)**:主混合流 `GET /app-api/feed/stream` 只收 `cursor`+`size`、**无 zoneId 参**,恒服务 zone0;带 zoneId 的专区流是另一个端点 `GET /app-api/feed/zone/stream?zoneId=N`。给 `/feed/stream` 传 zoneId 会被静默忽略(曾据此误判「新游戏不在流」)。`size` 有 `@Max`(=20,**超限校验失败返空 `data` 而非报错**——排「流空」先核 size)。发布编排(创始人「汇入主混合流」)对每次发布**双写** zone0 主流基线 + 若创作者选非零专区再补写该专区(`PublishOrchestrationServiceImpl.writePublishBaseline`),故一款游戏可同时现于主流与其专区;新游戏 sort_score=0,排在已回灌的高分游戏之后、未刷分组之首。 - **API 全绿 ≠ UI 通**:编排器旁路会掩盖 UI 缺陷,用户可见波次收口前必须做一次真 UI 走查(见 [`ui-walkthrough-cdp.md`](./ui-walkthrough-cdp.md))。 ## 6. docker compose 部署到 mini-infra(观测栈第一波实战蒸馏,2026-07-05)