Repository navigation
fix(workspace): restore keyboard focus when reading review materials - #8913
Conversation
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
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.
从主页或成果目录用键盘打开审阅材料时,读取和导航更新会取消或提前消耗焦点请求,最终焦点落到
BODY;返回目录也无法回到刚读的条目。刷新失败材料时,禁用中的刷新按钮还会丢失焦点。本改动让焦点意图绑定当前来源与 Goal,等当前读取完成、阅读或错误视图就绪后,再复用共享成果目录组件恢复焦点。进入和恢复阅读定位阅读区,返回定位原条目;显式刷新后也能继续键盘操作。审阅状态继续由既有后端处理,阅读不会完成验收。
验证(候选
5cbbfb1c863ad2cf09cbb65af2f3c528836c9971,基线d210e4cc1d002f92498b2811c565b9430e79f4c1):uv run --extra test python scripts/chat_bundle.py ensure:TypeScript 检查与 Vite 生产构建通过;uv build --wheel通过。serve_chat与临时 canonical SQLite;读取前后保持四份待审、一份已处理。错误视图不提供验收操作,恢复仍读取原版本。uv run --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main --tier quick --timeout-seconds 120通过。首屏证据均为合成数据、隔离打包后端;未验证已安装桌面壳或真实定时任务。图片保留为 PR 附件。
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 测试。