在 Windows 环境下搭建 PagerMaid-Pyro

Pagermaid 简介

PagerMaid 是一个开源的 Telegram 人形自走 Bot 方案，基于 Python 开发，功能强大而丰富，它通过响应账号通过其他客户端发出的命令来自动执行一系列任务，可以帮助你打造专属的便利功能。

环境要求

Windows 7 SP1 / Windows Server 2008 及以上版本（已在该环境下通过测试，系统低于此版本不代表无法安装）
Python>=3.8
Git

搭建

环境安装

以下软件包已全部打包放于文末。

1. Python ，这里使用的是3.10版本，下载地址：https://www.python.org/downloads/
   安装时记得勾选 Add to Path 加入环境变量。
   输入以下命令，返回正确的版本号即为安装完成。

   1

   python -V

   

2. Git ，这里使用的是2.37.1版本，下载地址：https://git-scm.com/
   安装后鼠标右键菜单出现 Git Bash Here 即为安装完成。

3. libwebp ，这里使用的是1.2.2版本，下载地址：https://developers.google.com/speed/webp/download
   将解压后的 libwebp 文件夹放入 C:\Program Files 。
   在环境变量中添加 C:\Program Files\libwebp\bin 目录。
   
   输入以下命令，返回正确的版本号即为安装完成。

   1	img2webp -version

   

4. ImageMagick ，这里使用的是7.1.0-43版本，下载地址：https://www.imagemagick.org/script/download.php
   输入以下命令，返回正确的版本号即为安装完成。

   1	magick --version

   

5. zbar ，这里使用的是0.10版本，下载地址：http://zbar.sourceforge.net/download.html
   安装包执行后会默认安装在 C:\Program Files (x86)\ZBar
   在环境变量中添加 C:\Program Files (x86)\ZBar\bin 目录，方法同2。
   输入以下命令，返回正确的版本号即为安装完成。

   1	zbarimg --version

   

6. tesseract ，下载地址：https://digi.bib.uni-mannheim.de/tesseract/
   安装包执行后会默认安装在 C:\Program Files\Tesseract-OCR
   在环境变量中添加 C:\Program Files\Tesseract-OCR 目录，方法同2。
   输入以下命令，返回正确的版本号即为安装完成。

   1	tesseract -v

   

拉取项目

打开你想要安装到的目录，为演示方便，这里选择 C:\ （C盘根目录）。
右键选择 Git Bash Here ，在弹出的窗口中输入以下命令。

1

git clone https://github.com/TeamPGM/PagerMaid-Pyro.git

成功后会有一个 PagerMaid-Pyro 文件夹。

安装 Python 依赖包

依次在命令提示符中执行以下命令：

1
2

cd C:\PagerMaid-Pyro
pip install -r requirements.txt

修改配置文件

执行以下命令，将配置文件 config.gen.yml 复制一份并且命名为 config.yml
修改 config.yml

1. API配置 (可选)
   在最新版本的 Pagermaid-Pyro 中添加了默认的 api_id 和 api_hash ，故下方生成 API 与填写相关配置项为可选操作。
   
   配置文件中 api_id 和 api_hash 缺省则使用下方的 API。

   1 2	api_id = 21724 api_hash = "3e0cb5efcd52300aec5994fdfc5bdc16"

   去 Telegram 官网 ，登录后点击 API development tools ，按提示填写信息，生成 API (非必须)。
   
   申请 API 属于高危操作，特别是新注册的 Telegram 账号和使用 VoIP 语音号码注册的账号会加大封号概率，如被封号，请尽快向客服申诉申请解封。同时请勿将 API 泄露给他人。
   怂别用，用别怂。

   生成后，只需要复制 api_id 和 api_hash 值并分别填入，编辑时请注意不要删掉引号。
   当然也可以使用部分程序的 API Key (公开的 API Key 可能会受到限制，导致无法登录，此时仍需自行申请 API 。)
   公开的API

   Telegram Android

   1 2	api_id = "4" api_hash = "014b35b6184100b085b0d0572f9b5103"

   Telegram Desktop

   1 2	api_id = "2040" api_hash = "b18441a1ff607e10a989891a5462e627"

   Telegram Messenger CLI

   1 2	api_id = "2899" api_hash = "36722c72256a24c1225de00eb6a1ca74"

   Telegram Swift

   1 2	api_id = "10840" api_hash = "33c45224029d59cb3ad0c16134215aeb"

   Telegram Messenger Plus

   1 2	api_id = "16623" api_hash = "8c9dbfe58437d1739540f5d53c72ae4b"

   Telegram X

   1 2	api_id = "21724" api_hash = "3e0cb5efcd52300aec5994fdfc5bdc16"

   Telegram Web K

   1 2	api_id = "1025907" api_hash = "452b0359b988148995f22ff0f4229750"

   
   按以上图片中格式填写即可。
2. 日志及报错信息记录 (可选) ：
   

   1 2	log: "False" # False 代表禁用，True 代表启用 log_chatid: "503691334" # 这里填写记录用的群组或频道ID

3. 代理 (可选) ：
   
   代理配置按需填写即可。

   1 2 3 4 5 6 7

   proxy_addr: "" # socks5 代理地址 proxy_port: "" # socks5 代理端口 http_addr: "" # http 代理地址 http_port: "" # http 代理端口 mtp_addr: "" # mtp 代理地址 mtp_port: "" # mtp 代理端口 mtp_secret: "" # mtp 代理密钥

4. 二维码登录 (可选) ：

   1	qrcode_login: "False" # False 代表禁用，True 代表启用

   config.yml 中其他字段暂不做说明。

登录账号

运行以下命令：

1

python -m pagermaid

此步需要填入完整的电话号码（eg：+18888888888，需要带上国际区号）然后 Telegram 会向你的其他客户端发送验证码，少数用户会向手机号发送验证码，填入验证码后，回车，如有两步验证密码，则再输入两步验证密码即可。

1
2
3
4
5
6
7
8

Enter phone number or bot token:    #此处填入手机号
Is "+18888888888" correct? (y/N):    # 号码显示正确输入 y ,错误输入 n
The confirmation code has been sent via Telegram app
Enter confirmation code:    # 此处输入 Telegram APP 中收到的验证码
# 如果设置了两步验证，则会出现以下提示
The two-step verification is enabled and a password is required
Password hint: None
Enter password (empty to recover):    # 此处输入两步验证密码

出现已启动提示，代表登录成功，此时可以去 Telegram 任意聊天发送 ,help 进行测试。

如果在配置文件中启用了二维码登录，即配置了 qrcode_login: "True" ，可以进入 菜单栏-Settings-Devices ，点击 Link Desktop Device ，扫描终端中显示的二维码即可登录。
受部分终端显示限制，二维码可能无法正常显示，可以下载运行目录下的 qrcode.png 文件扫码登录，或复制二维码下方以 tg://login?token= 开头的链接至任意聊天，点击后根据提示登录。

进程守护及后台运行

首先按下 Ctrl 键和 C 键并关闭窗口使程序停止运行
然后将 run.bat 放入 PagerMaid-Pyro 文件夹内。（文末有）

双击运行 run.bat ，等待10秒倒计时后会进入后台运行。
至此 Pagermaid-Pyro 搭建完成，enjoy ~

常见问题

插件相关

1. 如安装插件时提示错误但无任何错误日志，可能是网络问题，请按以下步骤解决：
   1.将 config.yml 中 git_source 修改为以下内容：

   1	git_source: "https://gitlab.com/Xtao-Labs/PagerMaid_Plugins_Pyro/-/raw/v2/"

   2.修改后使用 ,restart 命令或在终端中输入 systemctl restart pgp 使程序重启。

2. 如安装插件后遇到插件加载失败的情况（如图所示），请按照以下步骤排除解决：
   
   1.如您是直接在聊天中回复了一个插件文件并安装，可能安装的是旧版插件，新旧插件无法兼容。
   2.重新安装插件。
   3.使用 ,restart 命令使程序重启。
   4.删除 ./plugins 文件夹下全部插件，然后重新安装插件。
   5.检查 Python 版本是否为 Python 3.8 或更高版本。
   6.重新搭建 PagerMaid-Pyro 。

使用相关

1. 使用过程中进行了插件安装/升级等需要重启的操作后停止运行：
   请重新执行上文 进程守护及后台运行 操作。

资源下载

OneDrive for Business 访问密码: 1zyva1