Skip to content

fix(workspace): restore keyboard focus when reading review materials - #8913

Merged
huangruiteng merged 1 commit into
mainfrom
codex/review-material-keyboard-20261117
Nov 17, 2026
Merged

huangruiteng merged 1 commit into
mainfrom
codex/review-material-keyboard-20261117

Conversation

@huangruiteng

@huangruiteng huangruiteng commented Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator

从主页或成果目录用键盘打开审阅材料时,读取和导航更新会取消或提前消耗焦点请求,最终焦点落到 BODY;返回目录也无法回到刚读的条目。刷新失败材料时,禁用中的刷新按钮还会丢失焦点。

本改动让焦点意图绑定当前来源与 Goal,等当前读取完成、阅读或错误视图就绪后,再复用共享成果目录组件恢复焦点。进入和恢复阅读定位阅读区,返回定位原条目;显式刷新后也能继续键盘操作。审阅状态继续由既有后端处理,阅读不会完成验收。

验证(候选 5cbbfb1c863ad2cf09cbb65af2f3c528836c9971,基线 d210e4cc1d002f92498b2811c565b9430e79f4c1):

  • uv run --extra test python scripts/chat_bundle.py ensure:TypeScript 检查与 Vite 生产构建通过;uv build --wheel 通过。
  • Ego 实际键盘操作对照同一组五份合成材料:主页进入、目录进入、重载恢复、返回原条目、页面/文字切换、损坏来源拒绝读取、恢复后刷新。原版丢失焦点,候选恢复到对应可见区域。
  • 从隔离 wheel 运行真实 serve_chat 与临时 canonical SQLite;读取前后保持四份待审、一份已处理。错误视图不提供验收操作,恢复仍读取原版本。
  • 1200×854 与 390×844;长标题、混合状态和内部面板宽度检查通过。wheel 的前端输入摘要与候选源码一致,后端源码逐文件一致。
  • uv run --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main --tier quick --timeout-seconds 120 通过。

首屏证据均为合成数据、隔离打包后端;未验证已安装桌面壳或真实定时任务。图片保留为 PR 附件。

原版阅读:焦点落到正文(1200) 修复后阅读:焦点位于阅读区(1200)
Before: reader has no keyboard focus After: reader receives keyboard focus
修复后阅读(390) 返回原条目(390)
Narrow reader focus Narrow catalog returns to original edition

Restores report-review keyboard focus after the current read and navigation settle, including reload and failed-read recovery. Validated against the baseline through an isolated packaged backend; installed desktop and scheduled execution remain unqualified.

合入后验证补充(主干 68fe1788518e7edbf912638dcc421e17b0c9bc31):

  • 在 main d25e044c8c2a 上原样集成本 PR 的单文件补丁,重新完成 TypeScript 检查、Chat 生产构建、wheel 构建与 18 项报告审阅后端测试。该集成与合入主干的 runtime/frontend 源码一致;差异仅为两份未在本轮运行的 benchmark readiness 测试。
  • 从新 wheel 启动真实 HTTP 后端与独立临时 SQLite,补验损坏材料 → 错误区键盘焦点 → 恢复原材料 → 刷新 → 重载 → 返回原目录条目。1200 桌面和 390 窄屏均通过;原五版材料的身份、摘要及 4 待审 / 1 已处理状态保持不变,错误材料没有验收按钮。
  • 本轮验证覆盖打包浏览器路径;正式已安装桌面、原会话真实反馈及每日 09:00 材料质量/准时性仍待实际采用验收。没有启动模型、付费实验或 CI 查询。

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

APPROVE。 完整审查 5cbbfb1c863ad2cf09cbb65af2f3c528836c9971,未发现阻断问题。以下是独立执行结果,不继承作者测试结论。

动机 / Motivation

用键盘从主页或成果目录阅读审阅材料的用户,需要在打开、返回和读取恢复后知道当前位置。
基线在打开材料和返回目录后把焦点丢到 BODY;候选等当前读取完成再定位阅读区,返回时定位刚读过的原条目。
在真实隔离 SQLite 后端和浏览器中,主页进入、目录进入、重载及失败后刷新都恢复阅读焦点,返回定位原条目;晚到的读取不会重新打开已关闭材料。
本 PR 修复现有阅读流程,不改变材料验收权限或开启报告生成;本轮没有认证现用桌面壳、读屏软件或真实定时任务。

改动思路 / Approach

只在原阅读组件暂存来源、Goal 和行的焦点意图,完成代次负责消费;复用共享目录焦点 hook,未增加导航或后端状态 owner。
当前边界是已有审阅材料的键盘进入、返回、重载和失败恢复;用户不用增加确认步骤,材料验收仍走既有后端。
读取代次、当前已提交代次和来源范围共同决定何时可以移动焦点。打开动作只记录意图,内容或错误实际挂载后才由原 hook 的 animation frame 定位;返回动作先使旧读取失效。比在每个入口新增计时器更简单,也保留原导航和 read/cancel owner。界面没有新增控件,因此这里用文字描述状态顺序即可。

具体改动 / Changes

相对 d210e4cc1d002f92498b2811c565b9430e79f4c1 仅一个 TSX 文件 +26/-6;后端、样式、原报告正文与验收接口均未修改。规范为 docs/development/design.md,版本 d210e4cc1d002f92498b2811c565b9430e79f4c1,其 design.md:445 条款要求异步内容加载后聚焦、关闭回原控件、晚到响应不得重开;本头逐项通过实际浏览器路径。

关键代码讲解

  • GoalReportReviews 继续用原 state 和 generation;新增 completedRead 只确认当前读取完成,pendingFocus 只表示原键盘导航的短暂意图,不是材料验收或第二个业务事实。
  • select 先保存原材料身份、增加读取代次,再发实际 readReportReview。当前请求完成前不会提前消费焦点;新导航触发重新读取时,也要等那个代次提交。
  • returnToCatalog 记录原行并失效旧请求,视图返回后复用 useResultCatalogFocus.row。换来源取消未完成的焦点,卸载仍由共享 hook 清理。

对主干的风险 / Risks

最强反例是打开后立即返回,旧读取晚到时抢走焦点或重开材料。独立测试让真实 HTTP 读取在浏览器侧等待,返回目录后才释放请求;最后仍在原行,没有阅读区重新出现。损坏隔离 bundle 后刷新,错误区得到焦点且验收按钮为零;恢复原字节再刷新,仍读取同一版本并恢复阅读焦点。没有通过假的成功响应代替后端。

  • PASS 相同五份合成材料的不可变 base/head 对照:基线主页进入和返回均停在 BODY;候选到阅读区/原行。目录进入、重载恢复、文字版切换与错误恢复通过。
  • PASS 独立构建并安装 wheel,1880 个 Python/TypeScript/JSON 源文件与候选一致,21份静态资源随包;实际安装候选后端及 canonical SQLite 上键盘进入、返回和损坏来源拒绝通过;恢复后同一版本的 HTTP 读回通过。最后一次安装版恢复后的浏览器焦点读回被提前关闭的会话中断,未算通过。三实例前后均四份待审、一份已处理,Todo 身份和 bundle 摘要不变。
  • PASS TypeScript 与 Vite 生产构建;原报告后端18项;quick premerge 4项直接检查和2项选中检查。未查询 CI。

这是已有显示路径的修复,没有新启用开关、默认权限、状态词汇或模型义务;阅读能力可用仍不表示用户已验收。

我的整体评价 / Verdict

局部任务已交付,长程工作语义保持,键盘阅读体验改善。修复复用原组件和焦点 owner,机制与问题相称,未增加人工确认或配置步骤。
已实际查看1200×854阅读、390×844长标题阅读与混合状态目录:焦点轮廓清楚,正文与来源可达;长标题占用空间但未缩小字号,也未新增重复说明。
实际浏览器使用合成材料及自建安装包;现用桌面壳、原生读屏和定时生成未验证。安装包最后一次恢复焦点读回因提前收尾中断,未算通过;源码版恢复通过且21份安装资源逐字节一致。

English verdict: APPROVE at 5cbbfb1. Independent base/head keyboard checks, failure recovery, late-read cancellation and an isolated installed-wheel journey preserve passive canonical readback while restoring focus. Installed desktop-shell and screen-reader qualification remain outside this review.

@huangruiteng
huangruiteng merged commit 68fe178 into main Nov 17, 2026
41 checks passed
@huangruiteng
huangruiteng deleted the codex/review-material-keyboard-20261117 branch November 17, 2026 10:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants