docs: claim UI-07 transition sampling gap in_progress

Link the archived ninth-round mid-transition failure; do not mark
the task done before a real UI rerun.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
weichen
2026-09-13 18:24:27 +00:00
co-authored by Cursor
parent 9f676273df
commit 59dc73ec7c
3 changed files with 95 additions and 2 deletions
@@ -0,0 +1,45 @@
---
title: "UI-07 在 CSS transition 中间帧采样纯净阅读"
status: in_progress
created: 2026-09-13
updated: 2026-09-13
severity: high
---
# UI-07 在 CSS transition 中间帧采样纯净阅读
## 现象
第九轮真实 UI(schema 30):
- UI-00~UI-06 **PASS**
- 切到纯净阅读后,全部 `data-overlay-kind` 已空
- 取样到 `background rgba(51,41,15,0.294)`、`boxShadow` alpha `.294` / 位移 `.589549px`
- 断言「纯净阅读必须无装饰」FAIL
## 根因分析
| 层 | 问题 |
|---|---|
| 产品 | `BlockRenderer` 块 wrapper 有 `transition: background/box-shadow 0.2s ease` |
| 脚本 | 上一轮去掉 `waitForTimeout(400)` 后,overlay 响应与 `data-overlay-kind` 清空即采样 |
| 时序 | 属性已达终态,computed style 仍是琥珀→透明的中间帧 |
这是 **采样过早**,不是纯净模式仍保留装饰。禁止禁用产品 transition,也禁止放宽无装饰断言。
## 严重度
`high`
## 关联整改
- Short-term: [../ops/short-term/2026-09-13-document-revision-e2e-overlay-transition.md](../ops/short-term/2026-09-13-document-revision-e2e-overlay-transition.md)
- 分支: `fix/document-revision-e2e-overlay-transition`
## 证据
- Evidence root(已归档、本轮勿提交):`.doc/test-reports/assets/2026-09-13-document-revision-runtime-ui/schema30-ui07-css-transition-sampling-failure/`
## 开放问题
- 占槽后真实 UI-07/08/09 重跑;本任务保持 `in_progress`,不得标 `done`
+4 -2
View File
@@ -1,11 +1,11 @@
# 当前焦点
**更新**: 2026-09-13
**production_ready**: no(DOCREV:schema **30**;第八轮 UI-07 纯净阅读取样失败;不操作容器)
**production_ready**: no(DOCREV:schema **30**;第九轮 UI-07 transition 中间帧取样;不操作容器)
## 焦点
1. **DOCREV-RT**: [E2E 纯净阅读按 document-block 取样 overlay](short-term/2026-09-13-document-revision-e2e-overlay-selector.md)(`fix/document-revision-e2e-overlay-selector`:禁止 class*=block;不重跑 E2E / 不操作容器;仍 `in_progress`)
1. **DOCREV-RT**: [E2E 等 overlay CSS transition 结束后再取样](short-term/2026-09-13-document-revision-e2e-overlay-transition.md)(`fix/document-revision-e2e-overlay-transition`:禁止短 sleep / 禁 transition;不重跑 E2E / 不操作容器;仍 `in_progress`)
2. **CHAT**: [刷新恢复整改已实施](short-term/2026-09-13-chat-history-refresh-remediation.md)(待合 dev + PI E2E 补录)
3. **CI**: `TEST_DATABASE_URL` + 真实 PI E2E 实录;INTENT 发布 blocker 见 conversation-intent short-term
@@ -25,6 +25,7 @@
| Cursor-Auto | document-revision-e2e-block-selector | fix/document-revision-e2e-block-selector | - | document-revision-block-selector | in_progress |
| Cursor-Auto | document-revision-e2e-save-selector | fix/document-revision-e2e-save-selector | - | document-revision-save-selector | in_progress |
| Cursor-Auto | document-revision-e2e-overlay-selector | fix/document-revision-e2e-overlay-selector | - | document-revision-overlay-selector | in_progress |
| Cursor-Auto | document-revision-e2e-overlay-transition | fix/document-revision-e2e-overlay-transition | - | document-revision-overlay-transition | in_progress |
> 新任务开始前登记。`branch` 必须为 `feature/<slug>` 或 `fix/<slug>`,**禁止** `dev` / `test` / `main`。同一 `mutex` 同时仅一个 `in_progress`。
@@ -67,3 +68,4 @@
| UI-06 块选择器失败审计 | [../audit/2026-09-13-document-revision-block-selector.md](../audit/2026-09-13-document-revision-block-selector.md) |
| UI-06 保存选择器失败审计 | [../audit/2026-09-13-document-revision-save-selector.md](../audit/2026-09-13-document-revision-save-selector.md) |
| UI-07 纯净阅读取样失败审计 | [../audit/2026-09-13-document-revision-overlay-selector.md](../audit/2026-09-13-document-revision-overlay-selector.md) |
| UI-07 transition 中间帧取样审计 | [../audit/2026-09-13-document-revision-overlay-transition.md](../audit/2026-09-13-document-revision-overlay-transition.md) |
@@ -0,0 +1,46 @@
---
title: "E2E:等 overlay CSS transition 结束后再取样"
status: in_progress
created: 2026-09-13
updated: 2026-09-13
owner: Cursor-Auto
branch: fix/document-revision-e2e-overlay-transition
worktree: "-"
mutex: document-revision-overlay-transition
---
# E2E:等 overlay CSS transition 结束后再取样
## 目标
第九轮 UI-07 首错:`data-overlay-kind` 已空,但采样落在 200ms transition 中间帧。用 Playwright 轮询 computed style 直到稳定且达到无装饰目标后再取样。不得将本任务标 `done`。
## 范围
- `web/e2e/document-revision-runtime.spec.ts`(pure/manual/all 均等样式 settle)
- 文档:audit / CURRENT
## 非目标
- 不禁用产品 `transition`;不固定极短 sleep;不放宽纯净无装饰断言
- 不触碰/提交 `.doc/test-reports/assets`;不操作容器;本轮不重跑 E2E
- 不改 FEATURE-MATRIX;不合 `dev`
## 步骤
1. [x] 认领 CURRENT(mutex `document-revision-overlay-transition`)
2. [x] `expect.poll` 连续两帧相同且达到 mode 目标后再采样
3. [ ] 占槽后真实 UI 重跑(本轮不做)
## 验收标准
- [x] 纯净阅读仍要求透明底 + `box-shadow:none` + 无 overlay-kind
- [x] manual/all 也等 transition 完成
- [x] web tests + `tsc`/build + `git diff --check` + Go 门禁
- [ ] 真实 UI-07/08/09 PASS 后才可将本任务标 `done`
## 相关链接
- Audit: [../../audit/2026-09-13-document-revision-overlay-transition.md](../../audit/2026-09-13-document-revision-overlay-transition.md)
- Evidence: [../../test-reports/assets/2026-09-13-document-revision-runtime-ui/schema30-ui07-css-transition-sampling-failure](../../test-reports/assets/2026-09-13-document-revision-runtime-ui/schema30-ui07-css-transition-sampling-failure)
- 前序: [2026-09-13-document-revision-e2e-overlay-selector.md](./2026-09-13-document-revision-e2e-overlay-selector.md)