iPad协议微信机器人快速上手与二次开发完整指南
【免费下载链接】wechat-robot-ipadiPad协议的微信机器人项目地址: https://gitcode.com/gh_mirrors/we/wechat-robot-ipad
群聊里手工回消息、重复解答相同问题、定点发群公告，都是重复且耗时的操作。wechat-robot-ipad 是基于 Wechaty 与 iPad 协议实现的微信机器人，扫码登录后即可自动完成关键词回复、好友请求自动通过与定时群消息推送。
为什么选 iPad 协议机器人
该项目用 wechaty-puppet-padplus 替代表现不稳定的 web 协议，登录成功率更高、被限流踢出的概率更低；代码按事件拆分，没有框架包裹，六个文件即可看完全貌。
- 协议层：iPad 协议登录比 web 协议更稳定，适合长时间挂机
- 结构层：一个事件对应一个监听文件，职责单一，改哪处看哪处
- 可作模板：内置关键词回复、定时群消息与文本工具函数，拿过来就能改
3分钟部署步骤
环境要求 Node.js 10 及以上，先克隆仓库并安装依赖：
git clone https://gitcode.com/gh_mirrors/we/wechat-robot-ipad && cd wechat-robot-ipad && npm install再打开 config/index.js 填写四个配置项：
| 配置项 | 作用 | 示例值 |
|---|---|---|
| TOKEN | iPad 协议令牌，登录鉴权用 | 自行申请后填入 |
| IGNORE | 忽略消息的用户列表，填用户昵称 | ["www.iiter.cn"] |
| WEBROOM | 要管理的群名称 | "技术交流群" |
| MYSELF | 管理员的备注名（备注，不是昵称） | "Peanut" |
然后启动程序，用微信扫描终端二维码完成登录，控制台打印"开始登陆微信"：
npm start工作原理：事件到模块的映射
app.js 负责实例化 Wechaty 的 iPad 协议 puppet，并用 bot.on 注册六类事件，每个事件的处理逻辑都落在 listeners 目录下对应的文件中：
| 模块 | 事件与职责 |
|---|---|
| app.js | 入口：创建机器人实例并注册全部事件监听 |
| listeners/on-login.js | login：登录成功后注册每天早上九点的定时群消息任务 |
| listeners/on-scan.js | scan：把登录二维码渲染到终端供扫描 |
| listeners/on-message.js | message：区分群消息与私聊消息，走各自的关键词回复链 |
| listeners/on-friendship.js | friendship：收到好友请求自动同意 |
| listeners/on-room-join.js | room-join：打印新入群成员日志 |
| listeners/on-room-leave.js | room-leave：打印成员退出日志 |
| schedule/index.js | 封装 node-schedule 的 cron 表达式，文件注释写明了字段含义 |
| superagent/index.js | 封装每日一句、毒鸡汤、英语一句话等外部接口请求 |
二次开发入口：加关键词与改定时任务
方向一，新增关键词回复：打开 listeners/on-message.js 的 onPeopleMessage 函数，仿照现有 if-else 链追加一个分支，即匹配关键词、拉取数据、用 msg.say 回复；若新关键词依赖外部接口，按 superagent/index.js 中 getOne 的写法新增一个请求函数，用 superagent 发请求、cheerio 解析 HTML。
方向二，改定时任务：打开 listeners/on-login.js 的 onRoom 函数，修改 cron 表达式（默认 0 0 9 * * * 即每天九点整），把回调里每日一句、英语一句话、毒鸡汤的组合换成你的自定义内容；cron 各字段含义见 schedule/index.js 顶部注释。
坑与合规清单
- Wechaty 上游项目已归档、依赖冻结，README 亦提示示例代码可能失效，动手扩展前先确认本机能正常登录。
- TOKEN 留空机器人无法登录，令牌过期后需要重启程序并重新扫码。
- MYSELF 必须填大号在你的通讯录里的备注，填成昵称会导致群内"踢@"权限失效并增加被冒充的风险。
- on-friendship.js 会无差别同意全部好友请求，生产环境务必先按联系人或验证消息过滤再 accept。
- 自动通过好友、拉群、踢人属于高频自动化操作，建议用小号并控制触发频率，避免触发风控导致封号。
项目适合想借 Wechaty 事件模型练手的开发者，以及需要给小群加关键词回复、定时群发的团队；建议先跑通默认流程，再按上文两个入口改造。
【免费下载链接】wechat-robot-ipadiPad协议的微信机器人项目地址: https://gitcode.com/gh_mirrors/we/wechat-robot-ipad
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
