微信机器人 PadLocal WeChat Bot 使用教程

1. 项目目录结构及介绍

微信机器人 wechat-bot-padlocal 是一个基于 Node.js 和 Wechaty 框架的个人微信自动化工具。下面是其主要的目录结构及各部分的功能简介：

• config/: 存放公共配置文件，包括项目的全局配置，如服务器地址、各类API的令牌等。
• imgs/: 用于存储与项目相关的图片资源。
• password/: 存储密码簿相关文件，用于管理敏感信息，如加密的账号密码等。
• listeners/: 包含机器人启动后的事件处理脚本，如处理登录、消息、好友请求等模块化的监听器。
• schedule/: 对定时任务功能的支持，封装了node-schedule库，用于安排重复或一次性任务。
• superagent/: 数据请求与接口封装的模块，负责与外部服务通信。
• utils/: 提供一系列公用函数，增强代码复用性。
• bot.js: 机器人实例的核心文件，初始化Wechaty机器人。
• start.js: 项目的入口文件，用于启动机器人。
• README.md: 项目的主要说明文档，包含项目介绍、使用说明及更新日志。

2. 项目的启动文件介绍

• start.js: 这是项目的启动脚本。运行此文件之前，你需要确保所有必要的配置已完成，并且依赖项已被正确安装。执行npm start命令后，该脚本将初始化机器人，生成二维码并引导用户登录。一旦二维码被扫描，机器人便开始运行，监听并响应指定的各种事件和任务。

3. 项目的配置文件介绍

配置主要位于 config/ 目录下的文件，尤其是 index.js（或需按指示创建），其中应包含以下关键配置项：

• SERVER: 服务器IP或域名，用于部署时的网络定位。
• PUPPET_TOKEN: PadLocal协议的访问令牌，新用户可获得短期免费试用期。
• TXAPI_TOKEN, JUHEAPI_TOKEN, WXAI_TOKEN: 分别对应天行数据、聚合数据和微信对话开放平台的API令牌，用于集成外部服务。
• BAIDU_APPID, BAIDU_KEY: 百度翻译API的App ID和Key，用于翻译功能。
• IGNORE: 指定不应由机器人回复的用户列表。
• WEBROOM: 需要管理的群聊名称列表。
• MYSELF, BOTNAME: 用户的自定义备注和机器人的昵称，便于识别和管理。
• PROVINCE, KEYWORDS, VIP: 分别为省份列表、基础命令关键字和服务高级功能说明。

配置步骤简述

1. 克隆项目：首先，从GitHub克隆项目到本地。
2. 安装依赖：在项目根目录下，运行npm install安装所需Node.js依赖。
3. 配置文件：编辑config/index.js，替换示例配置为实际值。
4. 环境准备：获取并填入所需的API令牌。
5. 启动机器人：运行npm start，按照提示操作登录微信。

记住，每次更改配置后都需要重启机器人以使改动生效。此外，对于生产环境部署，推荐使用PM2等进程管理工具来保持服务的稳定性。