首页
/ TheLounge 项目中实现频道消息全量推送通知的修改方案

TheLounge 项目中实现频道消息全量推送通知的修改方案

2025-06-05 18:45:21作者:何将鹤

TheLounge 是一个基于 Web 的 IRC 客户端,其消息通知机制默认只会在用户被@提及或触发自定义高亮规则时才发送推送通知。本文将介绍如何通过修改源代码实现特定频道中所有消息的推送通知功能。

原通知机制分析

TheLounge 的消息通知系统主要通过以下逻辑判断是否触发推送:

  1. 首先检查消息是否为用户自己发送的(self 消息),这类消息不会触发通知
  2. 然后检查消息是否包含用户昵称(通过 highlightRegex 正则匹配)
  3. 最后检查是否匹配用户设置的自定义高亮规则

这种设计确保了通知的精准性,避免用户被无关消息打扰,但对于某些需要密切关注的频道,用户可能需要接收所有消息的通知。

修改方案实现

server/plugins/irc-events/message.ts 文件中,我们可以修改消息处理逻辑,添加对特定频道的全量消息推送功能。关键修改点如下:

  1. 在自定义高亮规则检查后,添加对频道名称的匹配检查
  2. 当消息目标(data.target)匹配自定义高亮规则中的频道名称时,触发推送通知
  3. 添加额外条件防止频道名称出现在消息内容中时重复推送

修改后的代码会在以下情况触发推送:

  • 消息发送到指定频道(如 #thelounge、#linux)
  • 消息不是用户自己发送的
  • 消息内容不包含频道名称(避免重复通知)

配置方法

用户需要在 TheLounge 的设置界面进行以下配置:

  1. 进入 Settings -> Notifications -> Browser Notifications
  2. 在 Custom highlights 字段中输入需要接收全量通知的频道名称,多个频道用逗号分隔
  3. 例如输入:#thelounge, #linux

技术实现细节

修改后的代码通过 client.highlightRegex 检查消息目标(频道名称),然后使用 client.manager.webPush.push 方法发送推送通知。推送内容包含:

  • 通知类型标记为 "notification"
  • 当前时间戳
  • 标题设置为频道名称
  • 正文设置为消息内容

注意事项

  1. 此修改会覆盖默认的高亮行为,在指定频道中所有消息都会触发通知
  2. 对于高频频道,可能会产生大量通知,影响用户体验
  3. 建议仅对真正需要密切关注的频道启用此功能
  4. 该修改属于项目定制化,升级 TheLounge 时可能需要重新应用

这种方案虽然简单,但有效解决了特定场景下需要接收频道全量消息通知的需求,为用户提供了更灵活的通知控制方式。

登录后查看全文
热门项目推荐
相关项目推荐