GitHub Follow Bot

GitHub 关注机器人

22年11月28日

由于我正在处理其他项目，我不确定何时才能完成这个工具。但是，我想指出的是，大量关注用户违反了 GitHub 的 TOS（下文未说明）。因此，请自行承担使用风险！

描述

这是在 Django 应用程序内部制作的 GitHub Follow Bot。机器人的管理是在 Django 的默认管理中心 ( /admin ) 内完成的。该机器人本身在 Django 应用程序的后台运行。

该机器人的工作原理如下。

• 作为 Django 应用程序中的后台任务运行。
• 机器人的管理是在 Django 应用程序的 Web 管理中心完成的。
• 安装后，您必须通过 Django 添加超级用户（例如python3 manage.py createsuperuser ）。
• 导航到管理网络中心并添加您的目标用户（将关注其他人的用户）和播种者（开始关注传播的用户）。
• 添加用户后，将其添加到目标用户和种子用户列表中。
• 首先解析新的/最少更新的用户，直到最大用户设置值，然后是随机范围等待扫描时间。
• 在后台为解析的用户运行任务，以确保目标用户正在关注他们。
• 另一个任务在后台运行以检索目标用户的关注者，如果启用“删除关注”设置，它将自动为目标用户取消关注这些特定用户。
• 运行另一个任务，检查目标用户正在关注的所有用户，并在x天后取消关注该用户（0 = 不取消关注）。
• 每个关注和取消关注后面都有一个可以配置的随机范围等待时间。

待办事项

• 开发一个更加随机的计时系统，包括一天中最可能的活跃时间。
• 看看我是否可以在 Django 中使用更好的东西来更改常规设置，而不是依赖 SQLite 数据库中的表。由于目前 Django 的限制，还存在同步问题。

要求

需要以下 Python 模型，我建议使用 Python 3.8 或更高版本，因为这是我测试过的版本。

 django
aiohttp

您可以像下面这样安装它们。

 # Python < 3
python -m pip install django
python -m pip install aiohttp

pip install django
pip install aiohttp

# Python >= 3
python3 -m pip install django
python3 -m pip install aiohttp

pip3 install django
pip3 install aiohttp

我的动机

几个月前，我发现一些 GitHub 用户关注了超过 10 万个明显使用机器人的用户。起初我很震惊，因为我认为 GitHub 反对大量关注用户，但在阅读更多内容后，他们似乎并不介意。这让我开始思考如果我也开始关注随机用户会怎样。其中一些用户有一个 GitHub.io 项目，该项目受到了很多关注，我认为它来自他们关注的所有用户。我决定尝试一下。我想看看它是否可以帮助我与其他开发人员建立联系，它确实可以/已经可以了！就我个人而言，我没有使用机器人来实现这一点，我实际上是在浏览其他帐户的关注者列表并关注随机用户。正如你所料，这完全弄乱了我的主页，但它也让我发现了新项目，在我看来这很整洁。

虽然这在技术上是“垃圾邮件”，但我注意到的一件好事是，它肯定不会影响我所关注的用户，除了在他们的主页中添加一行表明我正在关注他们（或者他们收到电子邮件说明这一点（如果他们有的话）。不过，如果很多人/机器人开始这样做，我可能会发现这变得很烦人（也许 GitHub 可以添加一个用户设置，该设置具有可以关注他们的用户的最大关注计数，或者在用户关注时收到通知）。

实际上，我认为到目前为止允许这样做很巧妙，因为它允许其他人发现您的项目。由于我在这个帐户上有相当多的网络项目，所以我有一些人联系了我关注的人，说他们发现我的项目很整洁，因为他们不进入这个领域。

我也不支持仅仅为了大量关注而制作的空配置文件。

使用风险由您自行承担

尽管 GitHub 似乎并不介意用户大量关注其他人（我再次支持），但这仍然被视为垃圾邮件策略。因此，请您自行承担使用此工具的风险。我什至不会自己使用它，因为我确实喜欢手动关注用户。我创建这个项目是为了更多地了解 Python。

设置

在网络界面内部，应该可以看到一个设置模型。应插入以下设置。

• 启用- 是否启用机器人（应为“1”或“0”）。
• max_scan_users - 在等待扫描时间之前一次解析的最大用户数。
• wait_time_follow_min - 关注或取消关注用户后等待的最短秒数。
• wait_time_follow_max - 关注或取消关注用户后等待的最大秒数。
• wait_time_list_min - 解析用户关注者页面后等待的最短秒数。
• wait_time_list_max - 解析用户关注者页面后等待的最大秒数。
• scan_time_min - 解析一批用户后等待的最短秒数。
• scan_time_max - 解析一批用户后等待的最大秒数。
• verbose - 标准输出的详细级别（请参阅下面的级别）。

1. + 当目标用户关注另一个用户时的通知。
2. + 当目标用户因位于关注者列表或清除而取消关注用户时发出通知。
3. + 从关注传播自动创建用户时的通知。

• user_agent - 用于连接到 GitHub API 的用户代理。
• 种子- 是否播种（将任何现有用户的关注者添加到用户列表中）。
• seed_min_free - 如果大于 0 并且启用播种，则仅当新用户（尚未被任何目标用户关注的用户）数量低于此值时才会发生播种。
• max_api_fails - 在停止机器人一段时间之前，GitHub API 失败的最大数量基于以下内容（0 = 禁用）。
• lockout_wait_min - 当失败次数超过最大 API 失败次数时，它将等待至少几分钟，直到再次启动。
• lockout_wait_max - 当失败次数超过最大 API 失败次数时，它将等待最多几分钟，直到再次启动。
• seed_max_pages - 寻找新用户（播种）时每个用户解析的最大页面数量。

安装

安装应该像常规 Django 应用程序一样执行。该应用程序使用 SQLite 作为数据库。您可以在这里阅读有关 Django 的更多信息。我会推荐以下命令。

 # Make sure Django and aiohttp are installed for this user.

# Clone repository.
git clone https://github.com/gamemann/GitHub-Follower-Bot.git

# Change directory to Django application.
cd GitHub-Follower-Bot/src/github_follower

# Migrate database.
python3 manage.py migrate

# Run the development server on any IP (0.0.0.0) as port 8000.
# NOTE - If you don't want to expose the application publicly, bind it to a LAN IP instead (e.g. 10.50.0.4:8000 instead 0f 0.0.0.0:8000).
python3 manage.py runserver 0.0.0.0:8000

# Create super user for admin web interface.
python3 manage.py createsuperuser

Web 界面应位于http://<host/ip>:<port> 。例如。

http://本地主机:8000

虽然从技术上讲，您可以为此机器人运行 Django 应用程序的开发服务器，因为只有设置是通过那里配置的，但 Django 建议阅读本文以供生产使用。

常问问题

为什么选择 Django 作为界面？

虽然设置可以在主机本身上配置，但我想要一个可以从任何地方轻松访问的界面。在我看来，最好的办法就是建立一个网站。我的大部分经验都是与 Django 相关的，这就是我选择该项目的原因。

制作人员

• 克里斯蒂安·迪肯