📋 Record PR review fixes, backup and integration evidence

This commit is contained in:
d-robotics 2026-09-18 10:57:38 +08:00
parent f564003cb7
commit 92be2e36c1

View File

@ -0,0 +1,90 @@
# PR #1 修改与本地集成报告
日期:2026-09-18。当前个人分支:`feature/local-dev-toolkit`。
## 结果
在当前专注工作页版本上修复同事提出的 HTTP 领取回归和快照分块问题,保留快捷键、撤销、双视频布局及安全连接下的连续作业。最新 `origin/dev`(`cb474b6abcad05333092374903eb0a34440039cc`)已无冲突合入,保留已发布的批量下载接口和 Rust 下载器。只做本地提交,没有推送 PR、回复同事、合并远端分支或部署公司环境。
反馈来源:[问题说明](https://gitea.d-robotics.cc/longtao.wu/droboticflow/pulls/1#issuecomment-20309)、[推荐方案与验收要求](https://gitea.d-robotics.cc/longtao.wu/droboticflow/pulls/1#issuecomment-20316)。采用其中的方案 A。
## 修改前备份
- 本地标签:`codex/annotation-workspace-pre-review-20260918`。
- 源码提交:`7585b43f0c14b29015541fc3a33d914227ce4366`。
- 完整历史包:`local-data/backups/annotation-workspace-pre-review-20260918.bundle`,44,853,795 字节。
- SHA-256:`50c80526dd859fda4849fead4f368301bf5b7d0dc01dd0d49d9ddf365065ea7f`。
- `git bundle verify` 通过,包含完整可达历史;标签指向已核对。原快捷键备份 `codex/annotation-keyboard-baseline-20260918` 保留。
备份覆盖已提交源码及历史,不包含 Mongo、视频、凭据、浏览器草稿和撤销记录。可另建检出检查修改前版本,不必覆盖当前目录:
```bash
git worktree add /tmp/droboticflow-workspace-backup codex/annotation-workspace-pre-review-20260918
```
## 处理结果
| 意见 | 实现及边界 |
| --- | --- |
| HTTP 缺少 Web Locks 导致原手动领取无响应 | 明确区分不支持、占用、协调错误和失效上下文。只有不支持时允许原工作台手动领取,仍使用真实后端原子分配及同一 requestId 重试。 |
| 独立工作页及连续领取 | 需要支持 Web Locks 的安全上下文。普通 HTTP 明确提示手动模式;直接打开 `/work` 可返回同一项目和任务,不释放、不重新领取。加载未完成时也保留 URL 编号。 |
| 页面锁占用或错误 | 不绕过锁;即使查询快照漏报占用,实际抢锁失败也不会派发领取请求。手动 HTTP 不宣称多标签互斥。 |
| 空标注工作区 | 保留原兼容修复。零描述的舍弃、刷新、恢复、再次刷新没有崩溃,边界、舍弃原因与归属回读正确。 |
| 快照小分块命名错误 | 固定六位后缀,按远端实际文件清单排序下载;不再按总块数推测文件名。 |
| 临时目录与完整性 | 本地、远端分别创建独立临时目录。远端路径只有创建成功且验证通过后才成为清理目标,清理时再次验证。缺块、下载失败、截断或 SHA 不符时不会调用 Docker,更不会恢复数据库。 |
| 目录参数 | 仅接受单个安全目录名,通过参数传入远程 shell,避免拼接注入。 |
独立审阅发现并关闭了两个额外边界:慢网络时返回链接丢失项目/任务;远端 mktemp 失败输出未经验证便进入清理路径。两项都有失败复现和修复后的行为证据,最终复核未发现阻塞问题。
## 验证
| 检查 | 结果 |
| --- | --- |
| 修改前 HTTP 复现 | 真实 Edge 普通域名下 `isSecureContext=false`、`navigator.locks=undefined`;点击手动领取发出 0 个请求,复现问题。 |
| HTTP 与页面锁浏览器回归 | 9 个场景通过:慢加载返回、零描述舍弃/恢复、直接 `/work` 回退、未知领取同 ID 重试、保存/刷新/送检、迟到领取不抢当前任务、真实抢锁冲突、双标签关闭后恢复、协调异常不降级。 |
| 安全上下文完整连续作业 | 三条全新本地任务全部进入 `quality_review`;3 次切片生成、3 次描述保存、3 次送检、2 次成功自动领取、1 次空池结果。完成当前后停止、手动恢复、空池不循环通过。 |
| 快照脚本行为测试 | 7 项全部通过,覆盖 1/2/9/10/99/100 块,缺块、失败、截断、错误/缺失校验文件、哈希命令失败、非法参数、信号中断后重试及 mktemp 异常。使用本地 fake kubectl/docker,真实 split/cat/hash;未恢复真实数据库。 |
| TypeScript / Vite 构建 | 通过;构建仍有既有大 chunk 提示。 |
| 全量前端测试 | 修改前后均为 577 项,568 通过、9 失败;失败集合完全相同,没有新增失败。合并 dev 未改变前端代码或该测试集。 |
| Go 接口集成 | `Test.*(DeliveryDownload|RandomClaim|AnnotationHistory)` 匹配测试通过;合并后的 API 编译通过。 |
| Rust 下载器 | 锁定依赖安装后,6 项库测试、5 项命令行测试通过。 |
| 格式与脚本语法 | 本轮修改的 Prettier、bash -n、diff 检查通过。dev 自带的 Cargo.toml 末尾空行提示原样保留,未扩大修改范围。 |
| 5173 最终运行检查 | 本地 API 与 Vite 已重启。原工作台 → 新工作页 → 双视频加载通过;登录、任务读取、`/api/delivery-downloads/projects` 均返回 200。 |
关键命令:
```bash
npm run lint:web
npm run build:web
npm run test:frontend
python3 -m unittest discover -s tests/backend -p fetch_mongo_snapshot_script_test.py -v
go test ./internal/api -run 'Test.*(DeliveryDownload|RandomClaim|AnnotationHistory)' -count=1
REVIEW_FIXTURE_PREFIX=pr-review-http-final node tests/browser/annotation-http-manual.mjs
cargo test --locked --manifest-path tools/drobotic-pull/Cargo.toml
```
浏览器测试仅针对本地 API 3001 / Mongo 27018,通过独立且禁用文件热重载的 Vite 5174/5175 运行。普通 HTTP 域名 `annotation-http.test` 只在测试浏览器中解析至 127.0.0.1,未使用降低浏览器安全性的标志;安全上下文使用浏览器认可的本机回环地址。测试要求预先创建隔离 fixture,不能向公司服务运行;本次已消耗的送检任务不应重置后重跑。
本地详细日志与 fixture 准备脚本位于忽略目录 `local-data/verification/pr-review-20260918/`:`http-before.log`、`early-return-red.log`、`http-final.log`、`continuous-final.log`、`snapshot-cleanup-red.log`、`snapshot-root-final.log`、`frontend-before.log`、`frontend-after.log`、`go-integration.log`、`rust-downloads.log`、`5173-final-smoke.log`。浏览器测试读取已有未跟踪登录文件,没有把账号密码写入源码。
未对公司实际 HTTP 入口执行领取或保存,也未配置公司 HTTPS、执行公司快照恢复、访问 BOS 写入或重新跑全部历史 Go/Python 测试;本报告不代表公司部署验收。HTTP 下新增独立工作页与自动连续领取仍需后续安全连接部署才能启用。
## 提交与使用
- `7ed51d32`:HTTP 手动标注与页面锁修复、浏览器回归和说明书。
- `024dfd01`:快照下载完整性、隔离清理及本地行为测试。
- `f564003c`:无冲突集成最新 dev 的批量下载功能。
本地页面:[http://127.0.0.1:5173](http://127.0.0.1:5173)。操作说明见[标注工作页操作说明](../../annotation-workspace-layout.md)。当前改动已本地提交,PR 远端尚未更新。
## 已有前端失败项
- automation keeps advanced settings collapsed and separates saving from listener activation
- project workflow exposes complete Capture automatic processing without a scan node
- project exposes only its selected dictionary descriptions
- ProjectDetail.tsx has '运行历史' tab and resets pagination cursors on modeFilter change
- workflow run input renders a per-run automatic HandPose switch
- workflow default and run input surfaces use the reusable BOS browser
- layout removes the redundant product header and keeps only a compact health control
- project detail separates released and debug workflows and opens released run history
- creation exposes Capture mode and projects can reference released templates