Repository navigation
v0.9.0 · 状态回退修复与上线级审计
RoboData Workbench v0.9.0
v0.9.0 是状态一致性修复版本,不新增界面。它处理的是一条真实反馈:提交审核后离开页面约一小时,回来发现「整个页面都回退到要导入的阶段」。审计结论是——这不是前端缓存或渲染问题,而是业务数据真的被改写了。
缺陷根因(修复前)
- 后端把「读取运行记录」实现成带副作用的操作:
GET与 SSE 读路径都会重放质检登记,apply_quality_report把已提交的审核全部打回草稿、清掉清洗确认、递增内容版本,并让已验证输出与交付包失效。 - SSE 终态不下发结束事件,浏览器
EventSource在服务端结束后无限自动重连,一小时里把这条危险读路径放大了成百上千次。 - 前端阶段进度是硬编码推导的,审核与产物一旦失效,七段进度只剩「导入」,视觉上就是「全部回退」。
由于 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.1loopback,不提供公网交互实例;展示页为静态页。 - 本版不宣称「公网多用户可上线」:认证 / CSRF / 全局限流、任意本机路径收敛、上传配额与审计日志留存仍未处理。
content_version粒度仍是「任一业务写操作即作废全部已登记产物」的保守语义;是否拆成evidence_version属产品决策,未在本版单方面改动。- 端到端浏览器回归仍为 2 条旧用例,未覆盖「离开一小时 / 标签页被丢弃 / 409 重试」场景,列为后续迭代项。
- 自动验收中的标注审核门禁为脚本模拟,不代表人工审核、机器人执行或训练效果。
本版本于 2026-11-14 发布为 GitHub Release v0.9.0。安装、启动与复现命令见 README。