• v4.0

      • 命令参考

      命令概览

      命令用途
      worker启动、查看和停止常驻账号进程
      auth激活、导出和检查授权
      status查看账号信息与在线状态
      switch切换聊天或通讯录页面
      sessions查看最近会话
      chat打开聊天并管理群聊信息
      message查询、发送或操作消息
      contact添加联系人并处理好友申请
      contacts查询已有联系人
      group查询或创建群聊
      card发送 URL 卡片
      moments查询、发布或操作朋友圈
      listen在前台持续接收消息

      状态与页面

      # 账号信息与在线状态
wxautox4 status --json

# 切换页面
wxautox4 switch chat
wxautox4 switch contact

# 最近会话
wxautox4 sessions list --json

      聊天

      # 打开聊天，--fuzzy 表示允许模糊匹配
wxautox4 chat open "项目" --fuzzy

# 读取聊天或群聊信息
wxautox4 chat info --chat "项目群" --json

# 添加群成员
wxautox4 chat add-members "张三" "李四" --chat "项目群"

# 加载更多历史记录
wxautox4 chat load-more --chat "项目群" --times 3

# 修改群名称、备注、我的群昵称或群公告
wxautox4 chat set --chat "项目群" --field remark --value "核心项目"

      chat set --field 支持 name、remark、my-nickname 和 announcement。

      消息查询与发送

      # 获取全部消息、新消息和历史消息
wxautox4 message list --chat "项目群" --json
wxautox4 message new --chat "项目群" --json
wxautox4 message history 50 --chat "项目群" --timeout 60 --json

# 轮询下一个新消息集合
wxautox4 message next --filter-mute --timeout 20 --json

# 发送文本、文件和语音
wxautox4 message send "请确认" --chat "项目群" --at "张三"
wxautox4 message send-file "C:\Temp\report.pdf" --chat "项目群"
wxautox4 message send-audio "C:\Temp\voice.mp3" --chat "项目群"

# @所有人
wxautox4 message at-all "今晚发布" --chat "项目群"

      消息操作

      message action 可以回复、引用、转发、删除、下载或识别消息：

      wxautox4 message action --chat "项目群" --index 3 --op reply --text "收到"
wxautox4 message action --chat "项目群" --index 2 --op forward --targets "文件传输助手" "归档群"
wxautox4 message action --chat "项目群" --index 1 --op download --dir "C:\Temp"
      操作用途
      reply / quote回复或引用消息
      forward转发到一个或多个聊天
      delete删除消息
      download下载消息中的文件
      ocr识别图片文字
      voice-text将语音转为文字
      link-url获取链接地址
      note-content获取笔记内容
      note-files保存笔记附件
      note-markdown将笔记转换为 Markdown
      capture截取消息内容

      --index 是本次 message list 返回结果中的零基位置。聊天内容变化后索引也会变化，应在读取后立即操作。

      联系人与好友申请

      # 添加联系人
wxautox4 contact add "wxid_x" --addmsg "项目合作" --tag "客户"

# 查看和接受好友申请
wxautox4 contact requests list --json
wxautox4 contact requests accept --index 0 --remark "张三" --tag "客户"

# 查询联系人详情或按标签查询
wxautox4 contacts details --count 100 --timeout 120 --json
wxautox4 contacts by-tag "客户" --timeout 60 --json

      群聊、卡片与朋友圈

      # 群聊
wxautox4 group recent --json
wxautox4 group create "张三" "李四"

# URL 卡片
wxautox4 card send "https://example.com" "张三" --message "请查看"

# 查询和发布朋友圈
wxautox4 moments list --next-page --timeout 30 --json
wxautox4 moments publish --text "项目照片" --media "C:\Temp\1.jpg" --tag "同事"

# 点赞或评论当前查询结果中的第一条朋友圈
wxautox4 moments action --index 0 --op like
wxautox4 moments action --index 0 --op comment --text "赞"

      好友申请、消息和朋友圈的 --index 都是当前查询结果中的临时零基位置，不是稳定 ID。