Skip to content

v0.9.0 · 状态回退修复与上线级审计

Choose a tag to compare

@MAHONGHAO1 MAHONGHAO1 released this 14 Nov 15:52
· 9 commits to main since this release

RoboData Workbench v0.9.0

v0.9.0 是状态一致性修复版本,不新增界面。它处理的是一条真实反馈:提交审核后离开页面约一小时,回来发现「整个页面都回退到要导入的阶段」。审计结论是——这不是前端缓存或渲染问题,而是业务数据真的被改写了。

缺陷根因(修复前)

  1. 后端把「读取运行记录」实现成带副作用的操作:GET 与 SSE 读路径都会重放质检登记,apply_quality_report 把已提交的审核全部打回草稿、清掉清洗确认、递增内容版本,并让已验证输出与交付包失效。
  2. SSE 终态不下发结束事件,浏览器 EventSource 在服务端结束后无限自动重连,一小时里把这条危险读路径放大了成百上千次。
  3. 前端阶段进度是硬编码推导的,审核与产物一旦失效,七段进度只剩「导入」,视觉上就是「全部回退」。

由于 apply_quality_report 带幂等键,业务重置实际只发生 1 次;一小时里主要是空转读与前端刷新放大。这一点决定了修复重点是「读路径零副作用」,而不是轮询节流。

本版本修复

  • 读路径零副作用:_load_state、get_run / list_runs、available_runs / load_run 全部改为只读派生视图,不写盘、不终止进程、不回写业务。
  • 恢复只能显式触发:新增 POST /api/runs/{id}/recover,带 2 秒节流与 429;恢复质检登记必须带 invalidate_reviews: true,否则 409 并完整说明「审核失效 / 清洗确认失效 / 产物与交付包非当前版本」。
  • 门禁口径统一:新增只读 registration_operation_of(),门禁判定与真正执行回写的 _register 共用同一回退口径,历史记录缺字段也无法绕过。
  • SSE 有始有终:终态 / 错误 / 超时下发 event: done,15 秒心跳、7200 秒超时;客户端在终态快照、done、带数据的错误事件上幂等关闭。
  • 旧 Streamlit 入口同纪律:sync_last_run 改为纯只读 + 提示,load_run 默认不再写盘,破坏性恢复改为两步确认;并有源码级护栏用例防回归。
  • 进度与事实一致:deriveStages(batch, runs) 按真实审核、候选集、产物与独立验包结果推导,不再硬编码。
  • 会话与草稿:URL + localStorage 双通道恢复;草稿绑定 content_version,版本变化自动失效并提示。
  • 破坏性交互:质检重跑、恢复质检登记、修改筛选决定三道确认;保存标注 / 提交审核 / 审核 / 确认筛选在已有当前产物时明确告知「产物将失效」。
  • 409 可操作兜底:API 客户端保留 HTTP 状态码;后端门禁拒绝时错误条提供「确认并重试」,先取服务器最新 revision / content_version,再带确认标记重发,消除「反复点同一个按钮 → 反复 409」的循环。
  • 归因纠正:版本基准随写操作同步,提示改为中性的「批次内容版本已更新」,不再把自己人的操作误报成「后台处理」。

核验

项 结果
Python 全量回归(独立 basetemp) 289 passed, 7 skipped, 13 subtests passed / 318.20 s / exit 0
上线级审计套件 tests/test_launch_audit.py 43 passed / exit 0
前端单测(Vitest,4 个文件) 26 passed / exit 0(进度 7、会话 6、事件流与 409 兜底 10、主组件 3)
前端类型检查与生产构建 tsc --noEmit exit 0;tsc -b && vite build 成功,仅有 chunk 体积告警
真实 uvicorn 运行态 终态 SSE 在 8 ms 内下发 done 并关闭;连续读后 registration.json 字节级不变
性能硬断言 并发读 n=80 p95 < 2 s;5000 episode 读 < 1.5 s;300 条运行列表 < 5 s;60 次终态读状态不变

完整根因链、逐条修复位置、双入口复核与剩余风险见 上线级审计报告。

边界

  • 运行边界不变:本机单用户、仅 127.0.0.1 loopback,不提供公网交互实例;展示页为静态页。
  • 本版不宣称「公网多用户可上线」:认证 / CSRF / 全局限流、任意本机路径收敛、上传配额与审计日志留存仍未处理。
  • content_version 粒度仍是「任一业务写操作即作废全部已登记产物」的保守语义;是否拆成 evidence_version 属产品决策,未在本版单方面改动。
  • 端到端浏览器回归仍为 2 条旧用例,未覆盖「离开一小时 / 标签页被丢弃 / 409 重试」场景,列为后续迭代项。
  • 自动验收中的标注审核门禁为脚本模拟,不代表人工审核、机器人执行或训练效果。

本版本于 2026-11-14 发布为 GitHub Release v0.9.0。安装、启动与复现命令见 README。