vulpineclub/ambassador

Ambassador Bot

这是一个为***实例设计的机器人，旨在解决关注机器人（followbot）的问题，同时为可在任何服务器上运行的机器人添加实用且有趣的功能。

Ambassador Bot将在您的服务器上运行，找出本地获得相对较多点赞（fav）的公共推文（toot）并进行转发（boost）。其核心思想是持续转发实例中“最佳”的推文，任何关注该实例Ambassador的用户都能在其联邦流中获取该社区的优质内容，无需通过关注机器人系统地关注用户即可轻松获取最佳推文。

安装

该机器人需安装在您的***实例服务器上，因此只有管理员才能进行设置。原因是机器人直接从数据库读取数据，而非使用API。

为Ambassador Bot创建***账号

首先，您需要在实例上创建一个新账号，并使用@tinysubversions的提取工具获取其OAuth令牌。

为Ambassador创建UNIX用户

从安全角度考虑，不建议以***用户（或更糟的root用户）身份运行Ambassador。创建新用户很简单：

bash
# sudo adduser ambassador
# sudo -u ambassador -s
# 现在您已以ambassador用户身份登录
$ cd

以ambassador用户身份登录后，克隆源代码仓库：

bash
git clone git@github.com:mbilokonsky/ambassador

注意：理想情况下，ambassador不应拥有自身源代码的读写权限，但服务器部署的最佳实践超出本README范围。

为Ambassador创建数据库用户

为避免安全问题，ambassador仅获得对包含公共推文的数据库视图（view）的只读访问权限。因此，您需要先创建视图和PostgreSQL用户：

bash
# pgsql -f ~ambassador/ambassador/install.sql

默认设置假设：

• UNIX用户和PostgreSQL用户均名为ambassador；
• PostgreSQL允许https://www.postgresql.org/docs/9.6/static/auth-methods.html#AUTH-PEER%E3%80%82 若不符合，可改用密码认证。

运行Ambassador

机器人需要以下环境变量（缺失时使用默认值）：

bash
DB_HOST（默认：'/var/run/postgresql'）
DB_NAME（默认：'mastodon_production'）
DB_USER（默认：'ambassador'）
DB_PASSWORD（默认：空）
INSTANCE_HOST（无默认值，您的实例主机地址）
AMBASSADOR_TOKEN（无默认值）

以ambassador用户身份设置环境变量并执行：

bash
cd ~/ambassador
yarn && yarn start

机器人每15分钟循环一次，转发超过阈值的新推文。它会在内存中记录已转发的推文，避免重复转发。

如何判断推文是否值得转发？

当前使用以下查询来确定：

sql
SELECT id 
FROM docker.xuanyuan.run/public_toots
WHERE favourites_count > (
  SELECT avg(favourites_count) 
  FROM docker.xuanyuan.run/public_toots
  WHERE 
    favourites_count > 1
    AND created_at > NOW() - INTERVAL '30 days'
)
AND created_at > NOW() - INTERVAL '5 days';

步骤说明：

1. 计算点赞阈值：获取过去30天内点赞数超过1的所有公共推文，取其点赞数的平均值作为阈值。
2. 找出过去5天内点赞数达到该阈值的公共推文。 该逻辑设置了较高的门槛（基于30天数据）并仅应用于最近5天，是一种动态调整的过滤方式。

真的要让它访问生产数据库吗？

Ambassador仅通过install.sql创建的public_toots视图访问公共推文，直接数据库访问是为了高效找到优质推文。

下一步计划？我能帮忙吗？

欢迎提出反馈：SQL是否正确？阈值函数是否合理？是否存在安全问题？

在哪里运行？

1. A Weirder Earth!
2. The Vulpine Club