MiniMax Agent长链任务一直卡在“正在处理中”，通常与未启用Ma vis Team模式、MMX-CLI未正确安装，或Verifier服务离线有关；可通过切换到Agent Team模式、安装并重启CLI、强制结束卡住的Worker，以及检查并重启Verifier服务来快速恢复任务执行。

MiniMax Agent在执行长链任务、复杂工作流或多步骤指令时，如果突然停在某个环节不再推进，对话框中只显示“正在处理中”却长时间没有后续反馈，既不报错也不继续执行，这类问题通常与上下文压力触发的隐式中断，或底层运行环境未准备完成有关。

确认是否进入Ma vis Team模式

进入Agent客户端后，先检查右上角的模式切换开关，确认当前启用的是【Agent Team】，而不是单Agent模式。需要注意的是，只有在复杂任务场景下系统才会自动启用Team Engine；如果之前被手动切换为单Agent，原本应由Leader负责拆解、Worker负责执行、Verifier负责验收的协作闭环就不会生效，任务也可能停留在第一步，无法继续分派和处理。

在对话框右侧找到“团队协作”图标后，可先确认该功能是否可用；如果图标显示为灰色且无法点击，通常说明当前任务尚未被系统识别为需要Team参与的复杂流程。此时，可在提示词或指令开头直接写明“请以Ma vis团队模式执行”，例如：“请以Ma vis团队模式分析这份财报，拆解为数据提取→趋势建模→风险标注→报告生成四步”。

检查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节点，导致MiniMax Agent卡住的问题再次出现，形成循环。

验证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。