ascensive/irc-url-title-bot

irc-url-title-bot

irc-url-title-bot是一个基于Python 3.9的Docker化IRC URL标题发布机器人。它会在IRC服务器的配置频道中，自动发布用户分享URL对应的页面标题。请注意：SSL验证已禁用，且由于多种因素，发布的标题无法保证完全准确。

链接

示例

text
<Adam> 深度学习的数学知识可以看https://arxiv.org/abs/2105.04026和https://arxiv.org/pdf/2104.14033
<TitleBot> ⤷ [2105.04026] 现代深度学习数学 | PDF: https://arxiv.org/pdf/2105.04026
<TitleBot> ⤷ [2104.14033] 深度学习数学研究 | 摘要: https://arxiv.org/abs/2104.14033
<Eve> github.com/visinf/n3net是个好项目吗？我一直在学习bugs.python.org/file47781/Tutorial_EDIT.pdf
<TitleBot> ⤷ GitHub - visinf/n3net: 神经最近邻网络（NIPS*2018）
<TitleBot> ⤷ Python教程

更多示例请参见https://github.com/impredicative/urltitle/%E3%80%82

使用说明

机器人可在多个频道工作，但仅支持单个服务器。若需在多个服务器使用，需为每个服务器部署一个实例。

配置

准备私密的secrets.env环境文件，示例如下：

ini
IRC_PASSWORD=你的实际密码

准备版本控制的config.yaml文件，示例如下。完整的实际示例可参考https://github.com/impredicative/irc-bots/blob/master/libera/title-bot/config.yaml%EF%BC%9A

yaml
# 必选配置：
host: irc.libera.chat
ssl_port: 6697
nick: MyTitleBot
channels:
  - '#some_chan1'
  - '##some_chan2'

# 可选配置：
alerts_channel: '#mybot-alerts'
blacklist:
  title:
    - Invalid host
    - Untitled
  url:
    - model.fit
    - tf.app
ignores:
  - some_user1
  - some_user2
mode:

# 站点特定配置（可选）：
sites:
  arxiv.org:
    format:
      - re:
          url: /pdf/(?P<url_id>.+?)(?:\.pdf)*$
        str:
          title: '{title} | https://arxiv.org/abs/{url_id}'
      - re:
          url: /abs/(?P<url_id>.+?)$
        str:
          title: '{title} | https://arxiv.org/pdf/{url_id}'
  bpaste.net:
    blacklist:
      title: show at bpaste
  imgur.com:
    blacklist:
      title: 'Imgur: The magic of the Internet'
  paste.ee:
    blacklist:
      title_re: ^Paste\.ee\ \-\ View\ paste\b
  youtube.com:
    blacklist:
      channels:
        - '##some_chan2'

全局设置

必选

• host: IRC服务器地址
• ssl_port: SSL端口
• nick: 机器人昵称
• channels: 机器人加入的频道列表

可选

• alerts_channel: 告警频道（部分警告和错误信息会发送至此），默认值为##{nick}-alerts（{nick}会替换为实际昵称）。频道名称需用引号包裹，建议注册并监控该频道。
• blacklist.title: 标题黑名单列表（不区分大小写），匹配的标题不会被发布。
• blacklist.url: URL黑名单列表（不区分大小写），匹配的URL不会发布标题。
• ignores: 忽略的用户昵称列表。
• mode: 用户模式（如Libera的+igR），建议设置。

站点特定设置

URL的站点由https://github.com/impredicative/urltitle/%E5%8C%85%E5%AE%9A%E4%B9%89%E3%80%82%E7%AB%99%E7%82%B9%E9%85%8D%E7%BD%AE%E5%9C%A8%60sites%60%E9%94%AE%E4%B8%8B%EF%BC%8C%E6%89%A7%E8%A1%8C%E9%A1%BA%E5%BA%8F%E4%B8%BA%60blacklist%60%E2%86%92%60format%60%E3%80%82%E7%A4%BA%E4%BE%8B%E5%A6%82%E4%B8%8B%EF%BC%9A

• alert.read: 若为false，读取失败不会告警（默认true）。
• blacklist.channels: 站点URL在指定频道不发布标题（不区分大小写）。
• blacklist.title: 站点URL的标题匹配该列表时不发布（区分大小写）。
• blacklist.title_re: 站点URL的标题匹配正则表达式时不发布。
• format: 标题格式化规则，支持通过正则提取参数并替换标题。

部署

• 建议注册并监控告警频道。
• 建议为机器人在每个频道设置自动语音权限（+V）。
• 推荐使用Docker ≥18.09.2或Docker Compose ≥1.24.0运行。创建docker-compose.yml文件：

yaml
version: '3.7'
services:
  irc-url-title-bot:
    container_name: irc-url-title-bot
    image: docker.xuanyuan.run/ascensive/irc-url-title-bot:latest
    restart: always
    logging:
      options:
        max-size: 10m
        max-file: "3"
    volumes:
      - ./irc-url-title-bot:/config:ro
    env_file:
      - ./secrets.env

• 配置说明：
  • image: 建议使用特定版本标签（如0.2.2）替代latest以保证可复现性。
  • volumes: 替换为config.yaml所在的路径。
  • env_file: 替换为secrets.env所在的路径。
• 运行命令：docker-compose up -d irc-url-title-bot，查看日志：docker logs -f irc-url-title-bot。

维护

• 更新config.yaml后需重启容器生效。
• 更新secrets.env或docker-compose.yml后需重建容器（而非仅重启）生效。