sikii/nexusphp_staff_bot repository overview

⁠NexusphpStaffBot

nexusphp 通用 TG 站务机器人

⁠设计目标

• 便捷处理站务, 避免用户等待太久, 也减轻了管理组的负担
• 定时通知, 比如候选有的时候就会忘掉
• 使用皮套, 避免盒威慑

⁠用途

• mod+ 单独拉个群, 群里面用机器人统一处理站务. 机器人的用户信息群内共享. 消息处理完之后在消息上面使用表情进行回复, 用于区分和标记状态.
• 简单的管理组私信和私信可以直接在 TG 里面回复对应消息, 机器人会自动转发到站内. 站点有时确实不如 TG 看的多

⁠支持的功能

• 管理组私信, 翻页
• 举报处理
• 私信, 翻页
• 候选
• 设置为已处理: 管理组私信, 举报
• TG 回复: 管理组私信, 举报, 私信

⁠支持的站点

• PterClub
• 2xfree
• Audiences
• OurBits

⁠运行

1. 修改 compose 文件里面以下内容
2. docker-compose up -d 即可

    environment:
      - TZ=Asia/Shanghai
      # tg 机器人 token
      - BOT_TOKEN=xxxxxxxx
      # tg 群组 id
      - GROUP_ID=
      # 通用话题 id
      - GENERAL_THREAD_ID=
      # 管理组消息 话题 id
      - STAFF_MSG_THREAD_ID=
      # 服务
      # 开启定时任务, 默认 15 分钟一次
      - STAFF_MSG_ENABLE=true
      # - STAFF_MSG_ENABLE=false
      # 服务配置
      # mod+ 用户的 cookie, 要不然看不消息...
      - STAFF_MSG_COOKIE=xxxxxxxx
      # 站点schema
      - STAFF_MSG_SITE=PterClub
      # - STAFF_MSG_SITE=Xfree
      # - STAFF_MSG_SITE=Audiences
      # - STAFF_MSG_SITE=Ourbits

⁠ID 信息怎么获取?

1. 使用 id 命令
2. 使用其他 bot 获取
3. 将机器人添加到群组后, 设置为管理员, 从日志里面能看出来
4. https://iitii.github.io/2022/09/28/1/⁠

⁠适配新站点

• 站点信息位于: libs/staff/sites/index.js, 基于 libs/staff/sites/NexusphpSchema.js 模板进行开发, 所有方法均已抽象, 按需实现即可.
• 管理站内信私信我

• 并不是所有站点都需要这个功能, 或许也有一些站点已经自己实现了部分功能, 但是没有开源出来
• 开源的目的是为了减少重复劳动, 也是为了方便站点管理组, 方便用户.
• 如果你需要这个功能, 请提 issue, 或者自己实现, 希望可以提 PR