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 加入环境变量。
   输入以下命令，返回正确的版本号即为安装完成。

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 目录。
   输入以下命令，返回正确的版本号即为安装完成。

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

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

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

软件包说明

• imagemagick 非必须 用于处理图片。
• libwebp-dev 非必须 用于处理图片。
• zbar 非必须 用于处理二维码信息。
• tesseract 非必须 图片光学字符识别。

以上软件包建议全部安装，不安装会影响部分功能的使用。

拉取项目

打开你想要安装到的目录，为演示方便，这里选择 C:\ （C盘根目录）。

右键选择 Git Bash Here ，在弹出的窗口中输入以下命令：

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

安装 Python 依赖包

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

修改配置文件

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

修改 config.yml

不会使用 vim 的请自行查找教程，这里不提供。

1. API配置 (可选)

在最新版本的 Pagermaid-Pyro 中添加了默认的 api_id 和 api_hash ，故下方生成 API Key与填写相关配置项为可选操作，但仍然建议自行生成 API 密钥。

配置文件中 api_id 和 api_hash 缺省则默认使用下方的 API Key。

在 Telegram 官网 ，登录后点击 API development tools ，按提示填写信息，生成 API Key。

生成后，只需要复制 api_id 和 api_hash 值并分别填入，编辑时请注意不要删掉引号。

按以上图片中格式填写即可。

2. 日志及报错信息记录 (可选) ：

3. 代理 (可选) ：

代理配置按需填写即可。

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

config.yml 中其他字段暂不做说明，参考对应注释即可。

登录账号

运行以下命令：

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

出现已启动提示，代表登录成功，此时可以去 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 ~

插件安装

安装后只能使用自带功能，但 Pagermaid 支持通过插件扩充功能。

如上图，插件名即为文件夹名称，在任意聊天中发送 ,apt install <插件名> 即可安装。

如需安装第三方/自制插件，发送插件 Python 文件至任意聊天，然后回复该文件并发送 ,apt install 即可安装。

常见问题

插件相关

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

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

1. 1. 如您是直接在聊天中回复了一个插件文件并安装，可能安装的是旧版插件，新旧插件无法兼容。
   2. 重新安装插件。
   3. 使用 ,restart 命令或在终端中输入 systemctl restart pagermaid-pyro 使程序重启。
   4. 在终端中使用 systemctl status pagermaid-pyro 通过查看日志来排除故障。
   5. 检查 Python 版本是否为 Python 3.8 或更高版本。
   6. 重新搭建 PagerMaid-Pyro 。

使用相关

1. 使用过程中进行了插件安装/升级等需要重启的操作后停止运行：

请重新执行上文 进程守护及后台运行 操作。

资源下载

OneDrive for Business 访问密码: 1zyva1