CLI 命令参考

本页记录由用户按次发起的 CLI 用法。

基础命令

命令用途
auth激活、导出和检查授权
status查看当前账号信息与在线状态
switch切换聊天或通讯录页面
sessions查看最近会话
chat打开并读取用户指定的会话
message查询消息或执行低频消息辅助操作

授权与状态

wxautox4 auth check --json
wxautox4 status --json

页面与会话

wxautox4 switch chat
wxautox4 switch contact
wxautox4 sessions list --json
wxautox4 chat open "文件传输助手"
wxautox4 chat info --chat "文件传输助手" --json

消息查询

wxautox4 message list --chat "文件传输助手" --json
wxautox4 message new --chat "文件传输助手" --json

读取结果可能包含个人信息。请遵循最小必要原则,不得未经授权收集、导出或转交他人的消息和联系人数据。

低频消息辅助

wxautox4 message send "CLI 测试" --chat "文件传输助手"
wxautox4 message send-file "C:\\Temp\\report.pdf" --chat "文件传输助手"
🟡 自动交互命令

发送前必须核对目标、内容和文件。不得用于批量营销、垃圾信息、骚扰或向大量不特定用户发送信息。

输出与退出码

  • --json 用于输出便于程序读取的 JSON;
  • 退出码 0 表示命令完成;
  • 其他退出码表示参数、运行或接口失败,应停止后续操作并人工检查;
  • 不应仅依据终端文本推断外部操作已经成功,应同时核对返回结果和目标界面。