在 Windows 环境下搭建 PagerMaid-Pyro-工具盒子

写在前面
本教程基于 Windows 系统，搭建 Pagermaid-Pyro ，Ubuntu / Debian 系统请参考这篇文章。
GitHub 开源地址： https://github.com/TeamPGM/PagerMaid-Pyro
GitLab 开源地址： https://gitlab.com/Xtao-Labs/PagerMaid-Pyro
官方网站： https://xtaolabs.com/
官方 Telegram 频道： @PagerMaid_Modify

Pagermaid 简介 {#Pagermaid-简介}

PagerMaid 是一个开源的 Telegram 人形自走 Bot 方案，基于 Python 开发，功能强大而丰富，它通过响应账号通过其他客户端发出的命令来自动执行一系列任务，可以帮助你打造专属的便利功能。
隐私政策与免责声明
您在使用本项目代码时即表示您已经同意本隐私协议并且允许我们以评估负载和修复代码的目的记录您 Bot 的在线状态和报错文件。
除可能使用的信息之外，我们不会记录与收集任何信息。
本项目代码完全遵循此隐私政策，您可以随时在此项目中审查我们的源代码。
本项目无法承诺 Userbot 行为不会被 Telegram 官方滥权，也无法承诺所有功能能在自建项目上成功运行。
使用 Userbot 所带来的损失或可能产生的任何责任由搭建者自行承担。

环境要求 {#环境要求}

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

搭建 {#搭建}

环境安装 {#环境安装}

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

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

|-----------|-------------------| | 1 | python -V |
Git ，这里使用的是2.37.1版本，下载地址： https://git-scm.com/
安装后鼠标右键菜单出现 Git Bash Here 即为安装完成。
libwebp ，这里使用的是1.2.2版本，下载地址： https://developers.google.com/speed/webp/download
将解压后的 libwebp 文件夹放入 C:\Program Files 。
在环境变量中添加 C:\Program Files\libwebp\bin 目录。

输入以下命令，返回正确的版本号即为安装完成。

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

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

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

|-----------|----------------------| | 1 | tesseract -v |

软件包说明（点击展开）
libwebp 非必须用于处理图片。
imagemagick 非必须用于处理图片。
zbar 非必须用于处理二维码信息。
tesseract 非必须图片光学字符识别。
以上软件包建议全部安装，不安装会影响部分功能的使用。

拉取项目 {#拉取项目}

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

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

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

安装 Python 依赖包 {#安装-Python-依赖包}

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

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

修改配置文件 {#修改配置文件}

此步骤为可选步骤

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

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" |

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

|-------------|---------------------------------------------------------------------------------------------| | 1 2 | log: "False" # False 代表禁用，True 代表启用 log_chatid: "503691334" # 这里填写记录用的群组或频道ID |
代理 (可选) ：

代理配置按需填写即可。

|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 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 代理密钥 |
二维码登录 (可选) ：

|-----------|---------------------------------------------------------| | 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= 开头的链接至任意聊天，点击后根据提示登录。
请注意保护好您已登录的 pagermaid.session （该文件在 Pagermaid 运行目录下）。此文件可以登录账号，请不要分享给他人使用。

进程守护及后台运行 {#进程守护及后台运行}

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

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

常见问题 {#常见问题}

插件相关 {#插件相关}

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

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

2.修改后使用 ,restart 命令或在终端中输入 systemctl restart pgp 使程序重启。
如安装插件后遇到插件加载失败的情况（如图所示），请按照以下步骤排除解决：

1.如您是直接在聊天中回复了一个插件文件并安装，可能安装的是旧版插件，新旧插件无法兼容。
2.重新安装插件。
3.使用 ,restart 命令使程序重启。
4.删除 ./plugins 文件夹下全部插件，然后重新安装插件。
5.检查 Python 版本是否为 Python 3.8 或更高版本。
6.重新搭建 PagerMaid-Pyro 。