#Worker 与多账号

CLI 支持直接模式和 Worker 模式。一次性查询或偶尔发送消息可以直接运行命令；连续操作、多账号路由、消息监听和 message next 更适合使用 Worker。

#管理 Worker

# 启动默认账号 Worker
wxautox4 worker start

# 查看默认 Worker 和全部 Worker
wxautox4 worker status
wxautox4 worker list --json

# 停止默认 Worker 或全部 Worker
wxautox4 worker stop
wxautox4 worker stop --all

启动时可以调整等待时间：

wxautox4 worker start --timeout 45

Worker 在本机后台持有微信账号实例，但不是并行任务队列。所有 UI 操作仍会串行执行，CLI 退出后 Worker 不会自动停止。

#命令如何选择执行模式

普通命令按以下顺序执行：

1. 指定 --nickname 时查找该昵称的 Worker，否则查找默认 Worker。
2. 找到有效 Worker 后，通过 Worker 执行命令。
3. 没有 Worker 时，创建临时微信实例直接执行。

Worker 进程存活但无法连接时，CLI 会直接报错，不会回退到临时实例，以免两个进程同时操作微信。

#多账号操作

--nickname 是根参数，必须放在 worker 或其他业务命令之前：

wxautox4 --nickname "工作微信" worker start
wxautox4 --nickname "工作微信" status
wxautox4 --nickname "工作微信" message send "开始部署" --chat "项目群"
wxautox4 --nickname "工作微信" worker stop

#使用限制

• 最多同时注册 16 个 Worker。
• 多 Worker 和多进程仍共用 UI 锁，不会并行操作桌面微信。
• 长命令或慢监听回调会让后续命令等待。
• Worker 存活但不可达时会失败关闭，不会自动切换为直接模式。