From 59dc73ec7ca29ed1690822511a3bf24e62949526 Mon Sep 17 00:00:00 2001 From: weichen Date: Sun, 13 Sep 2026 18:24:27 +0000 Subject: [PATCH] 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 --- ...13-document-revision-overlay-transition.md | 45 ++++++++++++++++++ .doc/ops/CURRENT.md | 6 ++- ...ocument-revision-e2e-overlay-transition.md | 46 +++++++++++++++++++ 3 files changed, 95 insertions(+), 2 deletions(-) create mode 100644 .doc/audit/2026-09-13-document-revision-overlay-transition.md create mode 100644 .doc/ops/short-term/2026-09-13-document-revision-e2e-overlay-transition.md diff --git a/.doc/audit/2026-09-13-document-revision-overlay-transition.md b/.doc/audit/2026-09-13-document-revision-overlay-transition.md new file mode 100644 index 00000000..8427f795 --- /dev/null +++ b/.doc/audit/2026-09-13-document-revision-overlay-transition.md @@ -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` diff --git a/.doc/ops/CURRENT.md b/.doc/ops/CURRENT.md index 975b2f75..7bf9391b 100644 --- a/.doc/ops/CURRENT.md +++ b/.doc/ops/CURRENT.md @@ -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/` 或 `fix/`，**禁止** `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) | diff --git a/.doc/ops/short-term/2026-09-13-document-revision-e2e-overlay-transition.md b/.doc/ops/short-term/2026-09-13-document-revision-e2e-overlay-transition.md new file mode 100644 index 00000000..7754080a --- /dev/null +++ b/.doc/ops/short-term/2026-09-13-document-revision-e2e-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)