5.9 KiB
管理员切分与标注任务池
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。本轮只读查线上、仅在隔离合成库测试,未推送、部署或修改客户数据。