八爪鱼通知插件介绍与安装配置教程（Halo）
版本：1.0.0 ｜ 要求：Halo >= 2.25.0 ｜ 作者：老韩
「八爪鱼通知」是一款 Halo 官方通知中心扩展插件。启用后，评论、登录、备份、友链申请等站点事件，可以经八爪鱼统一入队，再由 Agent 投递到邮箱、微信 Bot、QQ 官机等已绑定渠道——不必再为每种消息单独对接第三方。
插件下载
插件安装包请从网盘获取：
下载文件名为 plugin-octopus-notify-1.0.0.jar。
能做什么
接入 Halo 通知中心全部 ReasonType（含其它插件扩展的事件）
管理端默认尽量全订，可在「工具 → 八爪鱼通知」里勾选节点
管理端渠道固定绑定八爪鱼用户标识
0普通用户在个人中心「消息渠道」绑定自己的接收渠道
勾选节点后，会自动为接收用户打开通知偏好里的「八爪鱼通知」开关
安装前准备
已有可访问的八爪鱼服务（推送中枢）
在八爪鱼里创建应用，拿到 App ID、App Secret
Halo 版本满足
>= 2.25.0
一、安装插件
从网盘下载插件包：https://pan.ithxs.com/p/ithxs
登录 Halo 管理后台
进入插件
上传
plugin-octopus-notify-1.0.0.jar（或覆盖安装同名插件）安装完成后启用插件
在插件详情页确认：作者「老韩」、版本
1.0.0
二、填写应用凭证（插件设置）
应用地址与密钥只在这里填一次，不要和别处重复乱填。
打开插件 → 八爪鱼通知 → 设置（或插件详情里的设置）
勾选启用八爪鱼推送
填写：
八爪鱼服务地址：例如
https://push.ithxs.com（不要尾斜杠，不要带/api）App ID
App Secret
Halo 接收用户名：一般填
admin（插件会为该用户维护订阅）
可用页内测试通知验证入队是否成功（成功只表示已入队，真正送达看渠道与 Agent）
保存
三、在系统通知里启用通知器
打开系统 → 设置 → 通知（或站点设置里的通知相关页）
找到八爪鱼通知
勾选启用八爪鱼通知器并保存
说明：服务地址与密钥以「插件设置」为准；系统通知页主要负责「允许 Halo 调用本通知器」。若你以前在系统页填过旧凭证，插件仍可兼容读取，但建议统一改到插件设置。
四、配置通知节点与渠道（工具菜单）
打开左侧工具 → 八爪鱼通知，只有两个页签：
1. 通知节点
列表为当前站点全部通知类型（含友链、备份、登录、联系表单等）
默认全选，适合管理员值班接收
可按需取消不需要的类型，点保存
保存后插件会：
为「Halo 接收用户名」创建 / 更新官方订阅
自动勾选该用户通知偏好中对应事件的「八爪鱼通知」
2. 通知渠道
为管理端固定用户标识 0 绑定接收渠道（邮箱 / 微信 Bot / QQ 官机等）
至少启用并配置好一条渠道，否则消息入队后也无处可投
五、普通用户怎么用
用户登录 Halo 前台 / 个人中心
进入消息渠道（由本插件提供的 UC 入口）
绑定自己的接收渠道（按 Halo 用户名投递，与管理端的
0分开）如需自行控制某类事件，可到个人中心通知设置调整；管理端已勾选的节点会尽量自动打开八爪鱼通道
六、建议验收流程
插件设置：启用 + 凭证完整，测一次「测试通知」
系统通知：八爪鱼通知器已启用
工具页：节点已保存，渠道已绑定且开启
触发一条真实事件（例如新评论，或管理员登录）
在八爪鱼消息记录 / Agent 监控中确认入队与送达
七、常见问题
勾了节点却收不到？
按下面顺序排查：
插件设置是否启用且凭证正确
系统通知页是否启用了八爪鱼通知器
工具页渠道是否已绑定用户
0且开启个人中心 → 通知设置里，该事件的「八爪鱼通知」是否已勾选（保存节点后一般会自动勾上）
八爪鱼侧 Agent 是否在线、消息是否失败
管理员登录没有提醒？
「新设备登录」与「用户登录」是两类事件：新设备首次登录通常走「新设备登录」，不一定再发「用户登录」
确认两节点均已勾选，且渠道已绑在用户
0查看 Halo 日志中带
[octopus]前缀的输出：没有
notifier invoked：说明 Halo 还没把该事件派给本插件（偏好或订阅未生效）SKIP not-ready：凭证未配齐PUSH begin/http webhook ok：已成功入队八爪鱼
插件设置和系统通知页填两遍？
不需要。凭证只在插件设置填；系统通知页只负责启用通知器；节点与渠道只在工具 → 八爪鱼通知。
配置分工一览
插件包下载地址：https://pan.ithxs.com/p/ithxs（文件 plugin-octopus-notify-1.0.0.jar）。配置完成后建议先走一遍「测试通知」，再观察真实业务事件是否入队送达。