#CLI 命令行工具

wxautox4 CLI 是 Python API 的命令行入口，可以直接在终端中查询微信状态、发送消息、管理联系人和群聊、操作朋友圈，或持续监听新消息。

#运行条件

• 使用 Windows 交互桌面，不能运行在无桌面的服务会话中。
• 桌面微信已经启动并登录到目标账号。
• 当前 Python 环境已安装并激活 wxautox4。
• Worker 的启动和命令执行使用同一个 Windows 用户。

CLI 会真实操作微信。发送、删除、添加好友、修改群设置和发布朋友圈可能产生不可逆结果，请先用测试账号和小范围对象验证。

#快速开始

正常安装 wxautox4 后，可以直接使用 wxautox4 命令：

# 查看帮助和版本
wxautox4 --help
wxautox4 --version

# 查看当前账号和授权状态
wxautox4 status
wxautox4 auth check

# 发送消息
wxautox4 message send "CLI 测试" --chat "文件传输助手"

# 获取最近会话，输出 JSON
wxautox4 sessions list --json

如果系统提示找不到 wxautox4 命令，请确认当前 Python 环境已安装 wxautox4，并将该环境的 Scripts 目录加入 PATH。

#全局参数

wxautox4 [-h] [-v] [--json] [--nickname NICKNAME] COMMAND ...

--nickname 是根参数，必须写在业务命令前：

wxautox4 --nickname "工作微信" status

--json 可以放在嵌套命令前或后：

wxautox4 --json chat info --chat "测试群"
wxautox4 chat info --chat "测试群" --json

每一级命令都有独立帮助。记不清参数时，可以直接查看对应层级：

wxautox4 worker --help
wxautox4 message action --help

#文档导航

• Worker 与多账号：了解直接模式、后台 Worker 和账号选择。
• 命令参考：查找消息、聊天、联系人、群聊和朋友圈命令。
• 消息监听：持续接收消息并运行自定义回调。
• 自动化与排错：处理 JSON 输出、退出码、授权和常见错误。
• 实战案例：组合多个命令完成日常自动化任务。