droboticflow/docs/annotation-admin-task-pool.zh-CN.md
2026-11-10 04:57:09 -08:00

32 lines
5.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 管理员切分与标注任务池
2026-10-21 本地修复。适用于平台管理员的“切分与语义标注”队列;标注员随机领取、个人缓冲池及质检/验收原入口保持原合同。
“可领取/我的任务/全部任务”统计当前权限与项目、工作流、执行、Capture 范围内的完整人工任务池,不再把首屏或已加载列表条数当作总数。搜索词和状态分类只筛选下方列表,不改变这些总数。管理员“全部任务”沿用当前环节范围,包含标注及已送检质检任务,不是全部历史已交付任务。
新增只读接口 `GET /api/plugins/annotation-qa/admin-pool`,只有组织管理员/平台管理员可用,组织范围由服务端身份决定。有效批次及阶段校验保留;非管理员不能通过传入 pool、用户或组织参数取得公共任务明细。旧接口保留,已有浏览器和在途任务无需迁移。
列表默认且最多每页 200 条,以人工任务的 `(createdAt,id)` 游标继续,任务摘要只关联这一页的 ID。“显示更多”读取下一页人工任务,而不是继续拉取独立的最新任务窗口。搜索及状态分类在服务端处理,能够找到第 500 条以后的任务;旧 Capture 名称仍通过原有元数据提取规则兼容。切换项目、列表或搜索后,不接受旧请求迟到的内容。
总数按批次/阶段聚合紧凑计数,再用既有批次权限投影校验;不读取动作正文或草稿来计数。总数使用有身份和范围隔离、容量上限的 5 秒进程缓存,当前进程的 API 写入会使缓存失效;其他副本与后台写入最多延迟到缓存到期。列表不缓存。搜索输入合并 350 毫秒,新搜索与范围切换取消过期请求;旧任务搜索在服务端流式读取投影元数据,查询和范围统计受 8 秒期限限制,不向浏览器传整池,也不把失败当成零条。计数与页面是相邻的只读操作,并非冻结生产时刻的结算快照。
不新增统计集合、数据库字段或索引,不改领取、标注、返工、审核及交付结果。生产环境仍需单独发布与验收。
## 2026-11-09 管理员查询超时修复
管理员任务池使用独立的 `/admin-pool`,与质检/验收的 `human-item-summaries` 搜索不同。线上只读日志确认前者出现500及8000/8006毫秒超时;截图中的HTTP非安全连接提示是连续工作入口的另一项限制,不能解释该接口的后端超时。
旧路径按每条候选关联批次、运行、采集及来源校验任务,搜索旧任务或没有命中时会扫完整个范围;总数读取在页面列表之前执行,失败会阻断首屏。管理员显示名称补充也未调用按页预取。此前81人读取对照中的管理员只请求统计面板,不能作为该独立接口已验证的证据。
本次改为每64条窄元数据批量关联,逐条恢复原批次/阶段、来源凭证及范围判定,然后按原创建时间和ID恢复顺序。仅命中的页面按ID读取原列表字段;缺少或过期摘要的历史正文仍按批读取,不丢旧名称。保留搜索字面匹配、全部任务的原环节范围、游标、跨组织隔离及缺失/失败/已替代来源凭证规则。没有新增索引、字段或生产补写要求。
管理员显示名称预取改为整页一次;5秒计数缓存保留,补齐节点范围键,避免不同节点复用错误总数。列表仍不缓存,权限检查仍在计数缓存之前执行。其他角色不经过该管理员入口:质检/验收继续使用既有批量搜索路径,标注个人池及来源准入继续使用其有界读取路径。本次回归覆盖这些入口,不能据此宣称所有页面或网络链路都没有性能瓶颈。
验证入口:`ADMIN_POOL_SCALE=1 POOL_LOCAL_MONGO_URI=mongodb://127.0.0.1:27018 go test ./internal/store -run '^TestAdminAnnotationPoolMongoParity$' -count=1 -v`。只接受本机27018,创建并清理独立合成库;26,218条记录对照内存参考实现,覆盖历史命中、无命中、特殊字符、自定义Capture、状态和游标。192组来源凭证用原表达式对照批量表达式;管理员HTTP及真实浏览器回归验证权限、范围计数、翻页、取消与失败重试。
额外混合读取使用 `TestPollPoolReadMixLocal`,在生产规模合成数据及81人背景下显式设置 `POLL_POOL_ADMIN_TASKS=1`、`POLL_POOL_CLAIM_COUNTS=1`;`POLL_POOL_ADMIN_PERIOD_SECONDS=1` 用于提高单个管理员的重复采样频率,默认仍为12秒。它不改变生产轮询。计入管理员的全部/单项目、可领取、我的任务、状态、命中及无命中。该短时补验排除媒体、写作业、网关和公网传输,不替代生产容量验收。
结果:26,218条全量有效候选的历史命中/无命中搜索由约6.2~6.5秒降至0.90~1.02秒,计数由约2.04秒降至0.81秒。首轮81人补验的某次全部项目可领取为3.53秒,保留为异常样本,不用于稳定p95结论。后续提高管理员重复频率:预热30秒、稳态200秒,10种管理员场景各20次;全部项目可领取API p95为312ms,管理员搜索p95为475~671ms,质检/验收搜索最高p95为724ms。5,920次稳态读取零HTTP错误、零业务写入,同账号同接口任务/数量/权限及追溯摘要稳定。该时间不含公网传输,旧响应格式仍保留;生产冷加载及容量仍待上线只读复测。
任务门禁 `verify-1794289069683716000` 通过,无未映射或待执行项,含管理员与审查浏览器、Mongo历史兼容、角色权限及项目Go基线门禁。之后仅调整测试脚本的管理员采样周期,API/Store实现未变;调整后的脚本通过上述重复采样。私有证据在工作树 `local-data/diagnostics/acceptance-search/admin-*` 及 `local-data/diagnostics/admin-pool-timeout/final-summary.json`。本轮只读查线上、仅在隔离合成库测试,未推送、部署或修改客户数据。