MiniMax Agent长链任务卡在“正在处理中”通常是因未启用Mavis Team模式、MMX-CLI未安装或Verifier离线所致；需切换至Agent Team模式、安装并重启CLI、强制终止卡住Worker、验证Verifier状态并重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent在执行长链任务时突然卡在某个步骤不动，对话框里只显示“正在处理中”却迟迟不推进，既不报错也不继续，这种情况常见于上下文焦虑触发的隐式中断或基础设施未就绪。
确认是否进入Mavis Team模式
打开Agent客户端右上角的模式切换开关，检查当前是否为【Agent Team】而非单Agent模式。只有复杂任务才会自动启用Team Engine，若手动选了单Agent，Leader拆解、Worker执行、Verifier验收的闭环根本不会启动，任务会卡在第一步无法分发。
点击对话框右侧的“团队协作”图标，若图标呈灰色不可点，说明当前任务未被识别为需Team介入的复杂任务——此时需在指令开头明确写“请以Mavis团队模式执行”，例如：“请以Mavis团队模式分析这份财报，拆解为数据提取→趋势建模→风险标注→报告生成四步”。
检查MMX-CLI是否已安装并生效
打开终端，运行mmx --version。若提示command not found，说明MMX-CLI未安装，所有依赖命令行调用的Worker（如代码审计、视频生成、Excel解析）将直接挂起，不报错也不超时。
执行两行安装命令：curl -fsSL https://cli.minimaxi.com/install.sh | sh → source ~/.mmx/bin/mmx-init.sh。安装后必须重启Agent客户端，否则旧进程仍读不到CLI路径。
【关键前提】：未安装MMX-CLI时，任何需要调用本地工具链的Worker都会静默卡死，且不会向Leader反馈失败状态，Leader将持续等待超时（默认15分钟），期间界面无任何提示。
强制唤醒卡住的Worker任务
第一步：在Agent桌面端左下角点击「运行日志」→ 找到卡住任务对应的时间戳行 → 点击右侧「详情」。
第二步：在弹出面板中定位到具体Worker ID（格式如wkr-8a3f9d）→ 复制该ID。
第三步：打开终端，执行mmx worker kill --id wkr-8a3f9d（将ID替换为你复制的实际值）→ 等待返回OK: worker terminated。
第四步：回到Agent界面，点击对话框中的「重试当前步骤」按钮。Verifier会立刻重新调度该Worker，且因状态机记录完整，无需从头开始。
注意：不要点击「重新开始整个任务」，否则Leader会再次拆解并可能分配到同一故障Worker节点，卡死循环重现。
验证Verifier是否正常接入
方法一：向Agent发送测试指令“请用Verifier角色检查以下JSON是否符合RFC8259规范：{“name”:“test”,“valid”:true}”，若3秒内返回结构化校验结果（含line/column错误定位），说明Verifier通道畅通。
方法二：在任务卡住时，观察右上角状态栏——若出现闪烁的红色「V」图标，代表Verifier心跳中断，此时Worker产出物无人验收，必然堆积卡死。需重启Verifier服务：mmx verifier restart。
Verifier一旦离线，Team Engine不会降级为单Agent模式，而是严格阻塞在验收环节，这是设计使然，不是bug。
