7.8 KiB
标注保存协调与共享切片编辑会话
2026-10-21,继看板展示分层 ff1cf0be 后的第二阶段。本轮沿用现有 HTTP、记录结构、权限与工作流;只调整前端职责,并扩充本地测试。公司环境尚未部署本轮代码。
保存协调
src/lib/annotation-persistence.js 为显式写入集中处理:
- 取得当前任务/账号的独占操作令牌,等待已经在途的自动保存,使用其确认后的最新版本。
- 自动保存结果不明或等待失败时保留当前编辑,释放操作令牌,停止显式写入;编辑资格在等待后再次核对。
- 描述确认、切片用途、结构应用、撤销恢复及原有重新切片兼容入口共用同一读回逻辑。请求失败后只读回服务器,不自动重发写请求。
- 只有任务/账号仍匹配、任务项 ID 相同且版本不倒退时才采纳工作区。格式损坏的响应拒绝,历史 null 列表继续规范化为空列表。
- 更新详情、个人池元数据和保存基线集中在一个位置。
draft只更新草稿元数据与保存基线;confirmed更新正式确认基线而保留调用者的编辑展示;full采纳结构和动作。草稿不能冒充正式确认供撤销使用。
原有 annotation-authoritative-mutation.js 的令牌与读回算法继续复用;新增写请求前的令牌检查,避免已经失效的操作仍发送请求。各业务操作自己的应用编号/版本/归属判定、历史记录与错误处理留在调用者。
生产 adapter 使用现有 HTTP 客户端;模块测试使用可控的延迟响应。React 页面负责展示和更新自己的状态,服务器仍负责真正的授权与 CAS,前端令牌不是服务器权限机制。
共享编辑会话
src/lib/slice-edit-session.js 统一 E 面板、拖拽及结构快捷入口的会话快照与异步提交。
- 打开时冻结原始切片、动作、完整描述草稿及任务/账号上下文身份。几何、描述、分类相关字段完整保留,不通过手列字段重建快照。
- 草稿指纹、动作或切片结构发生外部变化时停止应用;拖拽只允许本次手势已知的预览结构不同于基线。相同内容的新数组可通过,不再依赖数组引用判断。
- 未完成动作终点不能被结构应用消费。面板保留原有定位、驻留、Esc 和冲突处置交互。
- 两个入口共用一把在途提交锁;失败保留选择与快照,旧上下文的在途请求不阻塞新任务;迟到响应不能结束另一个新会话。即使切走后回到相同任务/账号,旧上下文身份也无效。
- 正式结构保存成功才消费已合入的编辑草稿,并发送一次统一完成信号。撤销/重做不触发该草稿清理信号,保留恢复快照的机会。
- 独立工作台夹具使用同一实现的本地会话;完整页面由父级提供共享会话。
没有改变冲突分类、无效/舍弃含义、保留侧描述、审核只读限制或交付协议。ADR0001 的任务/阶段撤销范围、ADR0007 的原子归档与单条历史、ADR0010 的旧任务恢复继续有效。原有历史恢复和首次切片重设兼容路径保留。
回归中修复的交互问题
合成“描述保存失败→保留文本→鼠标再次确认”实测发现,工作台吸顶错误条遮住确认按钮。已将错误条改为正常文档流,保留 role=alert 和错误正文;同一真实鼠标测试已通过,没有用强制点击或快捷键绕过遮挡。
验证与发布检查
npm run test:annotation:persistence
npm run test:browser:annotation-persistence
npm run test:frontend:gate
前两项已接入 Fanyu 发布策略。浏览器命令启动真实 Go HTTP、隔离 MemoryStore、合成双目视频/PTS/IMU 与实际页面;没有客户数据库或 BOS 写入。
本轮结果:
- 24 项模块测试通过,覆盖等待版本、锁释放、账号/任务切换、丢响应、未知结果、旧响应拒绝、失败重试及快照校验。
- 18 个完整页面场景通过,覆盖首次标注/返工、左右舍弃边界、Enter/按钮、失败与迟到响应、撤销/重做、E 面板、描述确认和鼠标再次保存。
- 三角色真实 movi 加载失败后的恢复及标注草稿保留回归通过。
- 切片应用、归档、旧任务恢复和审核不可修改标注的定向 Go 回归通过。
- 全量前端基线门禁通过:13 项失败均属已有 14 项基线,没有新增失败,基线未修改。
- TypeScript、格式、生产构建与生产 dist 浏览器启动通过;发布工具 37 项测试通过。
三项旧前端接线测试原先硬匹配函数内部写法,本轮随责任迁移调整为共享会话接线和实际快照行为;未放宽业务断言。完整页面回归继续覆盖这些业务行为。
独立复核发现的旧上下文在途锁阻塞新任务问题已修复,并补两条并发请求的回归;复核后未发现剩余阻断问题。
最终汇总和日志位于忽略目录 local-data/verification/annotation-architecture-20261021/。页面细节证据在本工作树忽略目录 local-data/test-results/rework-boundary/;错误条遮挡的失败截图、正文和日志单独保留在 attempts/description-save-overlay/。它们是合成样本,不含客户正文。
范围与后续
这是保存协调和编辑会话的责任收敛,标注页面尚有任务池、审核和页面编排等职责。任务池读取与分页已在第三阶段进一步收敛;后续沿现有测试继续处理审核与页面编排。布局 agent 继续只通过展示配置工作,不接入保存与分类判定。独立镜像、JSON v4、数据库迁移及生产发布均不属于本轮实现。
2026-10-21 输入取消与强制关闭回归补充
共享会话改造后的稳定性检查中,真实 React 浏览器复现了两个独立问题:
- 数字边界输入按 Esc 时,状态恢复尚未渲染,紧随其后的 blur 仍读取旧输入,将应取消的值提交到面板预览。现在先标记取消本次 blur,再恢复显示;Enter 统一由 blur 提交一次,鼠标和 Tab 也复用这条路径。
- 权限或阶段变化使 E 面板强制关闭时,工作台未通知父页面结束会话,父页面可能持续暂停自动保存。现在强制关闭同步发出结束通知;没有放宽失权后的编辑资格。
新增 npm run test:browser:slice-input,在真实 StrictMode 组件中覆盖帧号与秒数输入、Esc、Enter 单次提交、鼠标应用及下一次 Tab 提交;此命令已接入发布本地检查。完整 Go HTTP 标注回归增加取消输入后应用无改动不发送结构写入的场景。现有权限浏览器夹具增加失权关闭及恢复权限后会话状态检查。均为隔离合成样本,不读写客户数据。
兼容范围不变:HTTP、Mongo、工作流、字典、分类与交付格式均未变更,旧任务继续走原路径。父页面的会话标志只是前端保存协调,不替代服务端授权。
上一轮 E 面板应用后偶发未出现冲突清单的超时,尚未获得稳定复现;本轮原有 18 场景及扩充后的 19 场景均通过,但上述两个修复不能据此认定为该超时的根因,仍保留未闭环状态。新增全页用例最初误将 10fps 合成源当成 30fps,已改为读取实际初值;失败证据保留。全量前端首次受限运行的 devboot 挂起后仅终止本次测试子进程,随后在允许本机监听的环境重跑通过,基线未修改。
验证结果:4 个输入交互场景、19 个完整标注场景、权限浏览器回归、类型、格式、构建、生产 dist 启动和 30 个发布工具测试通过;全量前端仍为 13 个已有失败,没有新增,14 项基线未修改。
证据:本工作树忽略目录 local-data/verification/slice-input-20261021/,包含修复前失败与修复后结果。本轮未推送或部署。