任务中心 · 操作手册

更新时间：2026-11-04

页面入口：左侧菜单「业务核对 → 任务中心」，网址 /task-center。

所有登录用户都能看到这个菜单。项目查看者不能把它当作加工页使用；解析、核对、导出仍由编辑者或所有者发起。见 项目成员与权限。

一、这一页是做什么的

图纸解析、质保书核对、料单准备、一致性核对里，凡是要排队、要等 AI、不能立刻返回的工作，都会变成这里的一条任务。

任务中心用来看：提交了没有、在排队还是在跑、失败在哪、能不能重试或取消。它不代替工作台或核对页本身。

二、界面速览

页头是「任务中心」，旁边是数量：共多少项、进行中、需处理、已完成。右上角「刷新」。列表在跑的时候会自己刷新，不必一直点。

左侧是任务列表，点一条后右侧打开详情。详情里有：

区域	看什么
标题栏按钮	重试、取消、归档等。只有已结束的任务能归档。
运行信息	排队、开始、结束、耗时。
问题摘要	失败了多少、点状态可以筛子任务。
子任务	每一小步的状态。失败、过期、已取消可以单独筛。
事件	这条任务发生过什么。
AI 调用	这条任务每次调用 AI 实际用了哪个连接和模型、耗时多少。切换到备用模型时，会同时显示原计划模型和最终生效的模型，耗时是各次尝试的累计。

区域解析任务的自动恢复信息：子任务展开后，如果触发过自动重试，会显示「自动恢复轮次（最多 3）」「实际 AI 请求（最多 12）」「恢复耗时（最多 15 分钟）」和「下次恢复」时间。用完仍失败才算失败。另外，失败的子任务如果已有部分结果，会以只读形式显示，但这些内容不会进入图纸事实。

「图纸事实刷新」任务：解析、处理需处理项之后，系统会自动排一个「图纸事实刷新」任务。同一份文档短时间内的多次变化会合并成一次（约 10 秒窗口），区域还在解析中时的中间改动不会单独出一条；变化不影响事实时也不会出空任务。看到它不用管，也不要手动重试。

管理员还会在列表上方看到服务状态（队列、worker 是否正常）。普通业务用户看不到这一条，遇到整页都不动时请管理员看。

从工作台或某个业务页跳进来时，会带上当前项目，列表只看这个项目。筛选可以再收窄。

页面切到后台（换了浏览器标签页）时会暂停自动刷新，切回来立即刷新一次。

三、状态怎么读

你看到的	含义	你要做的
排队 / 进行中	已提交，还在等或正在做	等它自己刷新。不要对同一件事再提交一遍。
等待恢复	AI 服务临时故障，系统正在自动延迟重试	什么都不用做。详情里能看到轮次、已用请求数和下次恢复时间。
已完成	做完了	回原来的业务页看结果。注意：解析任务「已完成」不等于所有区域都可用，可能还有需处理项。
需处理 / 失败 / 部分失败	有子任务没成功	打开详情，看失败原因，再决定重试。
已过期	正在跑的子任务长时间没有心跳；或排队超过 6 小时仍没有被执行	后台进程重启或意外退出时，它手上的子任务会自动重新排队续跑，不算这条任务的失败次数（同一个子任务最多因进程退出续跑 3 次）。一般不用管。仍然过期时可以重试；若总是过期，让管理员看后台进程。
已取消	有人取消了	需要的话重新从业务页发起，或重试允许重试的子任务。
已由重跑成功	这条任务失败过，但之后同一份图纸、同一页的同一件事已经重跑成功	不用处理。它不再出现在「需处理」里，点「已由重跑成功 · 查看」可以跳到成功的那条。
已归档	你或同事把它收起了	默认列表不显示，在筛选「已归档」里能找回。

区域解析子任务的自动恢复用完仍失败后，你在这里点重试，会重新开始一轮自动恢复，不会马上又提示「自动恢复已超过 15 分钟」。

当前项目有失败任务时，列表上方会出现「重试当前项目失败项」：重试失败、过期的子任务；正在运行或排队中的不会重复投递。有人主动取消的子任务不会被这个按钮重新拉起，要重跑请在那条任务的详情里单独点重试。

四、常用操作

4.1 看一条任务为什么停住

1. 在列表里点那条任务。
2. 看问题摘要里的失败数量。
3. 打开「子任务」，筛「失败」。
4. 看错误说明。是「还没解析完」「方向未确定」这类业务原因时，回工作台处理，不要只点重试。
5. 是临时失败时，点该子任务的重试，或「重试当前项目失败项」。

4.2 取消

详情里点取消。确认后，还没开始的子任务会停，已经开始的 AI 调用会被中断。页面提示「取消请求已发出」后，等状态变成已取消再离开。

正在跑的任务不能直接删除。先取消，或等它结束。

4.3 归档（清理不再需要的失败任务）

任务不再提供「删除」，改为归档：把已结束的任务（已完成、失败、已取消、已过期）从默认列表里收起，数据不动。

• 单条：详情标题栏「更多」→「归档任务」。归档后可以在筛选「已归档」里找到，点「取消归档」放回来。
• 批量：筛选切到「需处理」时，列表上方有「归档当前筛选下的需处理任务」，一次收起当前筛选（项目、领域、搜索词）下所有已结束的需处理任务；正在运行的不受影响。
• 对已归档的任务点重试，会自动取消归档。
• 已归档超过 30 天的任务由系统自动清理；但同一份图纸、同一类工作的最新一条任务永远保留，业务页依赖它显示状态。
• 归档和清理都不会删掉图纸或已经写入的解析结果。

很多失败其实不用你动手：之后重跑成功的，会自动标成「已由重跑成功」并离开「需处理」。

五、常见问题

Q：业务页点了按钮，这里没有新任务？ 先点「刷新」。仍没有，看业务页是否弹出了错误（例如没有权限、还有未保存的修订、后台进程不可用）。助手的确认卡如果还没点，任务也不会提交。

Q：一直排队，进度不变？ 让管理员看任务中心顶部的服务状态，确认 worker 和定时任务在运行。业务用户把任务 ID 或页面上的失败摘要发过去即可。

Q：自动恢复用完失败了，重试有用吗？ 有用。手动重试会重新开始一轮自动恢复（轮次、请求数、15 分钟时限都重新计算）。

Q：子任务详情里有一条「执行该任务的 worker 已停止，任务已自动重新排队」？ 说明后台进程中途重启或退出过，系统已经自动把这条子任务重新排队，等它跑完即可，不用手动重试。这种中断不占用任务的重试次数；同一子任务自动续跑 3 次后仍被中断，才会停下来提示管理员检查后台进程。

Q：「需处理」里怎么少了很多失败任务？ 之后已经重跑成功的失败任务会自动收进「已完成」（标着「已由重跑成功」），不再催你处理。想看全部，切到筛选「全部」。

Q：管理员看到「代码版本」提示 API 或 worker 落后？ 说明某个后台进程还在跑旧代码，提示里会点名是哪一个（API 还是哪台 worker）以及它的启动时间，重启那一个即可。只改文档、只提交代码而没有改动后端程序时，不会再出现这个提示。

Q：重试之后业务页还是旧结果？ 回业务页点一次「刷新」。图纸解析类任务完成后，还要看工作台左栏当前步骤，而不是只看任务中心变成已完成。