fix(chat): keep latest-turn actions under the reply (BUG-1042)
The BUG-930 pin spacer sat on the last assistant row, pushing its sibling .message-actions (and follow-ups / delivery card) below half a screen of empty space. Move the same min-height onto the last turn's entry (`:last-child:has(.message-assistant)`) with align-content: start so the rectification grid wrap does not stretch its rows. Hook logic unchanged. Records BUG-1043 / BUG-1044 (pre-existing, investigating) found during browser verification. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017eEAG8HD3mm8gsKXgk8uU8
This commit is contained in:
Jesse_Chen
co-authored by
Claude Opus 5.5
Claude Opus 5.5
parent
ac224cef6a
commit
83cce7ad6a
@@ -0,0 +1,92 @@
|
||||
# PROGRESS · 最后一轮回答与操作按钮之间的大段空白（2026-09-26）
|
||||
|
||||
任务书：`TASK-latest-turn-actions-gap-20260926.md`。执行方：Claude 子代理（直接执行模式）。分支 `codex/latest-turn-actions-gap-20260926`，worktree `.worktrees/latest-turn-actions-gap-20260926`，本地提交未推送。
|
||||
|
||||
## 基线
|
||||
|
||||
- `origin/staging` = `a57c4310`。
|
||||
- 基线全量前端测试（Node 20.19.2）：3960 条，pass 3872 / fail 61（均为环境缺口：Node 20 `mock.module` 的 `ERR_MODULE_NOT_FOUND @/…`、无 Docker）。
|
||||
- 基线 rootMainFiles gzip 130933 B。
|
||||
- BUG 编号：开工时 `docs/BUG_HISTORY.md` 最大 BUG-1041，`docs/tasks/` 无更大号 → 本单 BUG-1042；验证中另查出的两个既有问题记为 BUG-1043、BUG-1044（investigating，未修）。
|
||||
|
||||
## DOM 核对（D2）
|
||||
|
||||
| 面 | 最后一轮的 `.message-list > :last-child` | 内容 | 用户行 |
|
||||
| --- | --- | --- | --- |
|
||||
| 普通咨询 | `div.message-entry`（`chat-transcript.tsx` `MessageEntry`） | `article.message-assistant` → `.message-actions` → `.conversation-follow-ups` | 单独一个 `.message-entry`，不在末轮外层里 |
|
||||
| 生时校正 | `div.rectification-message-wrap.rectification-message-entry`（`display: grid; gap: var(--space-1)`） | `article.message-assistant` → `.message-actions` → 交付卡 / 只读区间（若有） | 单独一个 wrap，不在末轮外层里 |
|
||||
|
||||
两处外层都**从助手行开始**、都不含用户行，所以 `--latest-turn-head-height` 的口径原样可用：头是用户行时扣用户行高度；头就是这条助手行（BUG-931）时写 `0px`，外层最小高度 = 整个视口，正好把它留在顶部。hook 不需要改逻辑。
|
||||
|
||||
末轮外层不是助手外层的情况（校正面的 persisted-question / pending-note / error 是最后一个子节点、普通咨询 `error-message`）：旧规则 `:last-child .message-assistant` 也匹配不到，新规则 `:last-child:has(.message-assistant)` 同样不匹配，行为不变。
|
||||
|
||||
## 改动
|
||||
|
||||
| 文件 | 内容 |
|
||||
| --- | --- |
|
||||
| `frontend/src/app/globals.css` | `.conversation .message-list > :last-child .message-assistant { min-height: … }` → `.conversation .message-list > :last-child:has(.message-assistant) { min-height: …; align-content: start; }`。计算式、变量不变。`align-content: start` 是必要的：生时校正外层是 grid，给了最小高度后 `align-content: normal` 会把多余高度分摊给各行，操作行又会离开正文。 |
|
||||
| `frontend/src/hooks/use-conversation-scroll-anchor.ts` | 只改 `turnHeadHeightForSpacer` 的注释（留白承载者从助手行变为末轮外层，BUG-931 写 0 的理由随之更新）。逻辑未动。 |
|
||||
| `frontend/tests/chat-notice-and-scroll-contract.test.ts` | 见下「改动既有断言」；新增 1 条。 |
|
||||
| `frontend/DESIGN.md` | Answer start anchor · Spacer 条目改写。 |
|
||||
| 记录 | `docs/BUG_HISTORY.md`（BUG-1042 / 1043 / 1044）、`CHANGELOG.md`、`docs/testing/latest-turn-actions-gap-20260926.md` + 4 张截图、`docs/tasks/README.md`。 |
|
||||
|
||||
`:has()` 兼容性：Safari 15.4+ / Chrome 105+ / Firefox 121+，低于本站语法下限 Safari 16.4；`globals.css` 已有多处 `:has()`。
|
||||
|
||||
### 改动既有断言（三栏也写在测试文件内）
|
||||
|
||||
| 测试 | 原值 | 新值 | 原因 |
|
||||
| --- | --- | --- | --- |
|
||||
| 「turn spacer uses conversation viewport variables and is not sticky」 | 选择器 `.conversation .message-list > :last-child .message-assistant` 带该 `min-height` 计算式 | 选择器 `.conversation .message-list > :last-child:has(.message-assistant)` 带同一计算式，并断言 `align-content: start` | BUG-1042：留白从助手行移到整轮外层；计算式与变量口径不变，`sticky` 否定断言保留，变量写入 / 清除的行为断言原样保留 |
|
||||
|
||||
新增「the turn spacer trails the actions row instead of sitting between text and actions (BUG-1042)」：任何 `.message-assistant { … }` 规则里不得出现 `--conversation-viewport`；普通咨询 `MessageEntry` 里 `ChatMessageRow` → `ChatMessageActions` → `ConversationFollowUps` 顺序同在 `.message-entry`；校正面 `ChatMessageRow` 在 `ChatMessageActions` 之前且 `RectificationMessageEntry` 直接挂在 `.rectification-message-wrap` 里。
|
||||
|
||||
BUG-930 / 931 / 932 的其余断言（`resolveTurnHead`、头即尾写 0、闲置不写留白、`pinLatestTurn` 源码断言、`lastTurnTail` 假 DOM）一条未改。
|
||||
|
||||
## 测试
|
||||
|
||||
| 项 | 结果 |
|
||||
| --- | --- |
|
||||
| `tsc --noEmit` | 0 错 |
|
||||
| `npm run lint` | 0 error（126 warning，均为既有） |
|
||||
| 全量 `npm test` | 3961 条，pass 3873 / fail 61 |
|
||||
| 失败名单 vs 基线 | 逐条一致，新增失败 0、修好 0 |
|
||||
| 测试名单 vs 基线 | +1 新名（上面新增那条），消失 0 |
|
||||
| Python 源码合同 | `test_session_management_entrypoints.py`、`test_daily_and_rectification_entrypoints.py`、`test_birth_time_journey_contract.py` 全过；`test_frontend_theme_contract.py::test_lightweight_warm_palette_contract` 失败，**改动前同样失败**（`--color-ink-secondary` 色值不符，与本单无关，未动） |
|
||||
| `npm run build -- --webpack` | 通过；`/` ○ Static |
|
||||
| gzip | rootMainFiles 130933 → 130933 B（0，本单只改 CSS）；`index.html` 引用的全部 js/css 合计 656748 B |
|
||||
|
||||
## 真实浏览器验证
|
||||
|
||||
环境：本地 `next build --webpack` + `next start`，无头 Chrome 151（`--headless=new --disable-dev-shm-usage`），CDP `Fetch` 拦截 `/api/*` 回虚构数据（5 轮虚构历史撑出一屏以上；普通咨询 `/api/consult` 回纯文本，校正 `/api/rectification/agent` 回 ndjson `answer.delta` + `run.completed`）。「改动前」= 同一构建里注入旧规则（新规则 `min-height: 0 !important` + 旧选择器原样），因为本单只改了这一条 CSS。输入框用 CDP `Input.insertText` + Enter 真发问，钉顶由真实 `pinLatestTurn` 完成。
|
||||
|
||||
「正文末行 → 操作行」= `.message-actions` 顶边 − 末轮回答文本节点最后一行的底边。「开头距顶」= 本轮用户行顶边 − 滚动容器顶边。
|
||||
|
||||
| 面 | 宽度 | 改动前 间距 | 改动后 间距 | 改动后 开头距顶 | 改动后 外层高度 / 助手行高度 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| 普通咨询 短回答 | 375 | 526px（操作行在视口外） | **23px** | 10px | 589 / 86 |
|
||||
| 普通咨询 短回答 | 1280 | 608px（操作行在视口外） | **23px** | 10px | 671 / 86 |
|
||||
| 生时校正 短回答 | 375 | 452px（且开头被顶出视口，见下） | **23px** | 10px | 495 / 66 |
|
||||
| 生时校正 短回答 | 1280 | 554px（同上） | **23px** | 10px | 597 / 66 |
|
||||
|
||||
23px 即操作行自身间距：同一页面里历史轮（非末轮，从未带留白）的同一量测得也是 23px（普通咨询、生时校正各测一次）。
|
||||
|
||||
长回答（14 段）：
|
||||
|
||||
- 普通咨询 375 / 1280：开头距顶 10 / 9px，「跳到最新」出现；点击后落底（`distanceFromBottom` 0）、按钮消失、操作行可见；随后往末轮插入 400px 内容，仍保持落底（跟随正常）。
|
||||
- 生时校正 375 / 1280：本轮开头**没有**停在顶部，回答一到就落底——改动前完全相同（开头位置同为 −1323 / −482px）。定性为既有问题 BUG-1044，见下。
|
||||
|
||||
截图（入库，375 宽）：`docs/testing/latest-turn-actions-gap-20260926/consult-375-{before,after}.png`、`rectification-375-{before,after}.png`。其余（1280、长回答、跳到最新后）在执行方 scratchpad `gap/`，未入库。校正截图底部的「合盘历史暂时无法读取」提示是虚构数据没回合盘接口所致，与本单无关。
|
||||
|
||||
附带改善：改动前校正面短回答结算时，操作行追加在已撑满视口的助手行之后，内容变高触发贴底跟随，把本轮开头顶出视口（上表「改动前」开头距顶 −118px）；改动后操作行落在外层的最小高度之内，内容总高不变，开头留在顶部。
|
||||
|
||||
## 验证中查出的既有问题（未修，前后表现一致）
|
||||
|
||||
1. **BUG-1043**：刷新或经 `?c=` / 启动落点直接进入已有消息的普通咨询会话时，`useConversationScrollAnchor` 的 scroll 监听与 ResizeObserver 一次都没挂上（给 `addEventListener` / `ResizeObserver.observe` 打点实测为 0），结果短回答也显示「跳到最新」、滚动不更新、点击后不跟随。先 `/?new=1` 再点侧栏进入同一会话则正常（本单的普通咨询测量都走这条路径）。推测：加载闸门期间容器未挂载、effect 早退，揭幕后依赖不变不重跑。
|
||||
2. **BUG-1044**：生时校正钉顶后静止时 `distanceFromBottom` = 94 ≤ 阈值 96，`measure()` 当成「回到底部」解除 `holdUnpin`、`anchored` 翻真，长回答随后贴底。普通咨询同一时刻约 198，不触发。
|
||||
|
||||
两条都在 hook 里，任务书红线禁止改 hook，只记为 investigating，建议另开单。
|
||||
|
||||
## 未做 / 环境缺口
|
||||
|
||||
- 登录态 iPhone Safari 真机：留给 `docs/testing/latest-turn-actions-gap-20260926.md`。
|
||||
- 未部署、未推送。
|
||||
@@ -124,6 +124,7 @@
|
||||
| `TASK-scroll-anchor-hook-fixes-20260926.md` | — | **滚动锚两处老问题**：直接打开已有会话时监听未挂上（BUG-1043）、校正长回答钉顶后因 96px 阈值被拉到底（BUG-1044）。排在 BUG-1042 合入后 | 待领取 | — |
|
||||
| `TASK-latest-turn-actions-gap-20260926.md` | — | **最后一轮正文与点赞 / 踩之间空大半屏**：BUG-930 钉顶留白（`min-height: 视口 − 本轮开头`）加在 `.message-assistant` 上，把兄弟节点 `.message-actions` 推到留白之后；改为加在整轮外层，按钮紧贴正文、空白落在后面；不动滚动 hook | 待领取 | — |
|
||||
| `TASK-starter-home-polish-20260926.md` | `PROGRESS-starter-home-polish-20260926.md` | **首页开场小字与图标**：今日趋势（每日模型生成，非写死）移到问候下方副行；入口下方提示只在有未完成校正或非本人时出现，删两句固定文案并修正已校正仍显示首次文案的分支；今日星语图标 MoonStar、点数图标 Coins。排在 BUG-1038、1040 之后。分支误判实为入口摘要解析读错键名（BUG-1041） | 已验收（Claude 09-26 直接执行：子代理实现并查出 BUG-1041 入口摘要驼峰/下划线字段不一致；Claude 改恢复提示文案为「可以在历史对话里接着做」；独立复验 tsc/lint 0、全量 3960 条失败名单与基线逐条一致、四路由 ○、gzip 不变） | `f04da103`（已部署 `62d4c9c4`，health 一致） |
|
||||
| `TASK-latest-turn-actions-gap-20260926.md` | `PROGRESS-latest-turn-actions-gap-20260926.md` | **末轮回答与点赞一排之间大段空白**：BUG-930 的钉顶留白加在助手行上，把其后的 `.message-actions` 顶到留白之后；改加在整轮外层（`:last-child:has(.message-assistant)` + `align-content: start`），不改 hook。验证中另查出既有 BUG-1043（直接进入普通咨询会话时滚动锚监听未挂上）、BUG-1044（校正长回答钉顶后被拉到底），未修 | 待验收 | `codex/latest-turn-actions-gap-20260926`（BUG-1042） |
|
||||
| `TASK-home-warm-return-20260926.md` | — | **从其他页面回首页不再放加载动画**：首页按组件挂载计揭幕，客户端返回会重跑模型列表 / 后台状态 / 入口摘要 / 今日星语（3–5 次往返 + 最多 4 秒）。产品定：每次打开网页只揭幕一次；模块级暖快照按账户隔离、只存内存，暖返回首帧即就绪、后台静默刷新；缺项回落冷启动，不许半揭幕。**排在 BUG-1038 合入后**。BUG-1040 | 已验收（Claude 09-26 直接执行：子代理实现，Claude 独立复验 tsc/lint 0、全量 3953 条失败名单与基线逐条一致、四路由 ○、gzip 不变；CDP 实测回首页 5.5 s → ~20 ms、无加载环） | `638b6a60`（已部署 `7475eb6e`，health 一致） |
|
||||
| `TASK-new-chat-from-people-20260926.md` | `PROGRESS-new-chat-from-people-20260926.md` | **从星盘档案页点新建对话落回上一次生时校正**（产品 09-26 真机）：标题显示旧校正会话、输入框「正在打开生时校正…」，中间却是新对话开场；另有两套新建入口（`?new=1` 与 `?newChat=1`）违反 BUG-1015 一处解析红线。先复现写失败测试、定位跨页残留状态再修，合并入口。BUG-1038 | 已验收（Claude 09-26 直接执行：子代理复现并定位 sessionStorage 登录返回存根；Claude 独立复验 tsc/lint 0、全量 3928 条失败名单与基线逐条一致、四路由 ○、gzip 不变、修复前后截图核对） | `0a8350cc`（已部署 `6a22626d`，health 一致） |
|
||||
| `TASK-people-archive-p1-fix-20260925.md` | `PROGRESS-people-archive-p1-fix-20260925.md` | **P0修复**：worker按持久化人物解析、真实删除预留退款、本人历史OR is、切人/消息时序及P2/P3；BUG-1031/1032，关联1030/990/1024。永久定向54/54、独立前端5探针与退款r4六场景通过；必须最终Node22 Linux全量+DB逐条基线对照 | 已验收（Claude 09-25：两 P0、两 P1、七 P2 通过；新 P2 删后跳错人、人物接口故障连累聊天 → 收尾单） | `4d801e53`（已部署，health 核对一致） |
|
||||
|
||||
Reference in New Issue
Block a user