🔔 通知与交互
弹幕服务支持通过多个通知渠道接收系统通知、任务状态、弹幕源更新、异常告警和任务结果。可用渠道由当前版本动态提供，具体以 Web UI 中 “设置” → “通知与交互” 的渠道类型列表为准。
此功能自 v2.5.3 起内置支持，灵感来源于 表哥 bot。v2.8.2～v2.8.8 期间新增了通知洪峰汇总、图片发送模式、任务结果消息和更完善的 Webhook 能力。
通用配置
在 “设置” → “通知与交互” 中点击 添加通知渠道，按页面提示填写：
- 渠道名称：用于区分同类型的多个通知渠道；
- 渠道类型：从当前版本提供的渠道中选择；
- 启用状态：关闭后保留配置但不发送通知；
- 使用代理：适用于渠道接口需要通过代理访问的场景；
- 订阅事件：按导入、刷新、Webhook、定时任务、后备搜索、任务进度等分组选择；
- 测试：保存后使用测试按钮验证渠道连接；
- 编辑/删除：修改配置或移除渠道。
不同渠道的配置字段不同。请以当前页面显示的字段和说明为准，不要直接照抄其他渠道的 Token、URL 或参数。
图片发送模式
v2.8.4 起，支持为通知渠道单独配置图片发送模式。常见选项包括：
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 纯文字 | 不发送图片，只发送文字和链接 | 内网部署、渠道不支持图片 |
| 海报 | 发送作品或任务相关海报 | 普通通知 |
| 图片模式/公网外链 | 通过可访问的图片地址发送 | 渠道要求公网图片地址 |
公网外链模式需要先在设置中配置自定义域名，并确保该域名能够从公网访问服务的图片静态地址。系统在保存或切换该模式时会执行连通性校验；校验失败时不要强行保存。
通知海报会优先使用服务端本地化后的图片地址，避免在通知正文中暴露第三方源站地址。
任务进度与任务结果
可订阅的任务事件包括导入成功/失败、刷新成功/失败、Webhook 导入、定时任务、后备搜索、预下载、匹配后备和任务进度等。
- 支持消息编辑的渠道，会原地更新任务进度，减少刷屏；
- 不支持消息编辑的渠道通常只发送阶段性结果，不会逐条推送全部进度；
- 任务完成通知可能包含作品、季度、集数、弹幕源、海报和实际下载数量等上下文；
- 任务失败通知应优先结合任务页面和日志排查，不要仅依据通知文本判断根因。
v2.8.2 起，短时间内大量成功通知可以进行智能洪峰汇总；失败通知仍会逐条发送，避免重要错误被合并隐藏。v2.8.4 起，通知页面也可以进入通知端任务管理菜单查看相关后台任务。
Telegram Bot（内置）
v2.5.3 起，弹幕服务内置了 Telegram Bot 通知功能，无需额外部署即可使用。
功能特性
- 📢 接收系统通知和任务状态更新
- 🔄 接收弹幕源更新提醒
- ⚠️ 接收异常告警信息
- 🔍 通过 Bot 与弹幕服务进行基本交互
- 🖼️ 根据图片发送模式发送海报或图片
配置方法
- 在 Telegram 中通过 @BotFather 创建 Bot，获取 Bot Token；
- 获取 Telegram Chat ID（可通过 @userinfobot 获取）；
- 在 Web UI 中进入 “设置” → “通知与交互”；
- 选择 Telegram 渠道，填写 Bot Token 和 Chat ID；
- 选择需要接收的事件和图片发送模式；
- 保存后点击测试按钮。
提示
如果服务器无法直接访问 Telegram API，请先在 代理配置 中设置代理。
Server酱³ Bot（内置）
Server酱³ 是一个轻量级的消息推送服务，支持通过微信、企业微信等渠道接收通知。目前为内测功能。
配置方法
Server酱³ Bot 使用 Bot Key 和用户 UID 进行消息推送，而非传统 Server酱的 SendKey。
- 前往 Server酱³ 官网 注册账号；
- 获取 Bot Key 和 用户 UID；
- 在 Web UI 中进入 “设置” → “通知与交互”；
- 选择 Server酱³ 渠道，填写对应凭据；
- 选择事件和图片发送模式；
- 保存后点击测试按钮。
企业微信与通知 Webhook
v2.8.2 起，企业微信通知支持主动上传海报，减少公网外链或源站防盗链导致的图片加载失败。使用 Webhook 模式时，编辑已保存的通知渠道即可复制完整回调地址。
通用回调地址格式如下：
https://<服务地址>/api/notification/channels/<渠道ID>/webhook?api_key=<Webhook_API_Key>配置企业微信等需要回调验证的渠道时：
- 确认通知渠道已启用；
- 在 Webhook 配置中填入完整回调地址；
- 按渠道要求填写 Token、EncodingAESKey 等参数；
- 使用渠道提供的验证功能确认回调可达；
- 再通过 Web UI 的测试按钮发送测试消息。
安全提示
Webhook API Key、企业微信 Token、EncodingAESKey、Bot Token 和私有域名都属于敏感信息。截图、日志和问题反馈中必须遮盖这些字段。不要把通知回调地址公开发布。
第三方方案：表哥 Telegram Bot
除了内置的通知功能外，balge（表哥） 开发了一个功能更丰富的第三方 Telegram Bot，支持通过聊天界面直接管理弹幕服务器。
版本要求
弹幕库版本需要大于 v2.0.4 才可以使用此第三方 Bot。
项目地址: misaka-danmuku-bot
功能特性
相比内置通知，表哥 Bot 提供了更完整的交互管理能力：
- 🔍 搜索和导入新的影视作品
- 📚 管理媒体库、数据源和分集
- 📋 查看和管理后台任务
- 📊 查看系统状态
- 💬 通过聊天指令直接操作弹幕服务
使用方法
此 Bot 需要独立部署，请参考 misaka-danmuku-bot 项目的 README 进行配置和使用。
📚 相关文档
- ⚙️ 设置 - 系统设置
- 🔗 Webhook 配置 - 媒体服务器自动化触发
- 🔌 外部控制 - API 控制
- 📅 订阅管理 - 订阅和追番任务