青龙面板很适合跑定时脚本签到、数据同步、服务巡检、自动化任务一旦脚本失败或产出关键结果最怕的不是报错而是报错以后没人知道。WxPusher 的极简推送刚好解决这个场景不需要创建应用、不需要配置 appToken 和 UID只要拿到一个 SPTSimple Push Token填进青龙面板就可以把任务通知推送到手机和电脑。这篇教程适合只想把青龙运行结果推给自己或者推给少数几个人的用户。如果你后续要做多人订阅、主题群发、用户管理、回调、付费消息等更完整的消息能力可以再升级为 WxPusher 标准推送。一、先确认青龙版本青龙面板从 v2.21.0 开始支持 WxPusher 极简推送。请先确认当前版本为v2.21.0或更高版本。需要注意v2.21.0之前的青龙版本也支持 WxPusher只是使用的是标准推送需要配置 appToken、UID 等信息。暂时不方便升级的用户可以参考 WxPusher 官方文档方式一标准推送 完成接入。进入青龙面板的通知设置如果能看到WxPusher(极简推送SPT-推荐)就说明当前版本已经支持极简推送。如果没有这个选项可以将青龙更新到v2.21.0或更高版本暂时不升级也可以继续使用上面的标准推送方式。青龙面板本身支持 Python3、JavaScript、Shell、Typescript 脚本任务也支持系统级通知。WxPusher 接入后青龙任务完成、失败、告警等通知就可以通过 WxPusher 直接到达你的设备。二、获取你的 SPT打开或扫码下面的二维码按页面提示获取自己的 SPT也可以直接访问二维码链接https://wxpusher.zjiecode.com/api/qrcode/RwjGLMOPTYp35zSYQr0HxbCPrV9eU0wKVBXU1D5VVtya0cQXEJWPjqBdW3gKLifS.jpgSPT 可以理解为你的极简推送收件地址。谁拿到这个值谁就可以给你发消息所以不要把它提交到公开仓库也不要在截图里暴露。WxPusher 支持 Android、iOS、鸿蒙、macOS、Windows、Linux 等客户端手机端可以走厂商推送、APNs、鸿蒙 Push Kit桌面端可以通过 WebSocket 长连接接收系统通知。对青龙这种“任务跑在服务器结果要及时看到”的场景来说手机和电脑都能收消息会舒服很多。三、在青龙面板里配置登录青龙面板。进入「系统设置」里的通知配置页面。通知方式选择WxPusher(极简推送SPT-推荐)。在wxPusherSptList中填入刚才获取到的 SPT。保存配置然后点击测试通知进行验证。配置完成后的界面如下。确认通知方式和wxPusherSptList都填写正确后再保存图中的 SPT 已做脱敏处理如果只推给自己填一个 SPT 即可SPT_xxxxxxxxxxxxxxxxx如果要推给多个人把多个 SPT 用英文逗号分隔最多 10 个SPT_xxx1,SPT_xxx2,SPT_xxx3青龙会自动判断只有一个 SPT 时使用spt字段多个 SPT 时使用sptList数组最终调用 WxPusher 的极简推送接口https://wxpusher.zjiecode.com/api/send/message/simple-push通知内容会以 HTML 方式发送标题会作为消息摘要展示任务详情会放到消息正文里。对于青龙自身触发的系统通知你不需要额外编写接口代码。四、通过配置文件或环境变量配置如果需要让「脚本管理」中的 JavaScript 或 Python 脚本调用青龙通知模块主动发送消息必须配置WXPUSHER_SPT_LIST环境变量。通过配置文件设置时可以写入exportWXPUSHER_SPT_LISTSPT_xxxxxxxxxxxxxxxxx多个接收人同样使用英文逗号分隔exportWXPUSHER_SPT_LISTSPT_xxx1,SPT_xxx2如果只想使用极简推送建议不要同时配置WXPUSHER_APP_TOKEN、WXPUSHER_TOPIC_IDS、WXPUSHER_UIDS避免标准推送和极简推送同时生效造成重复通知。运行脚本验证完成WXPUSHER_SPT_LIST环境变量配置后可以在「脚本管理」中运行一个会调用青龙通知模块的脚本。JavaScript 脚本调用sendNotify(...)后青龙会读取环境变量中的 SPT 并发送通知Python 脚本调用notify.send(...)也会读取同一个环境变量截图右上角出现 WxPusher 系统通知说明环境变量、脚本调用和客户端接收链路都已经正常工作。五、收到通知后可以期待什么配置成功后青龙脚本的通知会进入 WxPusher 消息列表并通过你启用的客户端渠道提醒你。常见用法包括定时任务失败时第一时间收到错误摘要每日签到、库存监控、价格监控等脚本执行后收到结果服务器资源、脚本订阅、自动化流程异常时及时提醒同一个青龙实例通知多个维护者每人填一个 SPT 即可。对于个人或小团队来说极简推送的好处是概念少不用先理解应用、主题、UID、回调这些完整推送模型先把消息稳定收到。等你的脚本通知从“发给自己”变成“发给一组用户”再切换到标准推送会更自然。六、极简推送和标准推送怎么选场景推荐方式说明青龙任务通知只发给自己极简推送扫码拿 SPT填入青龙即可通知少数几个维护者极简推送多个 SPT 用英文逗号分隔最多 10 个要管理大量用户标准推送使用应用、UID、主题等能力要做订阅、回调、用户绑定标准推送支持更完整的业务闭环要做消息产品或付费订阅标准推送可结合 WxPusher 消息产品能力极简推送不是标准推送的替代品它更像一个快速入口先让消息到达后面再按业务复杂度升级。七、常见问题1. 青龙通知方式里没有 WxPusher 极简推送怎么办先确认青龙版本。WxPusher 极简推送从 v2.21.0 开始支持如果你的镜像或代码版本较旧通知方式下拉框里可能还没有这个选项。你可以升级到v2.21.0或更高版本也可以继续使用旧版本已经支持的 方式一标准推送。2. SPT 可以给几个人用青龙接入和 WxPusher 极简推送接口都按最多 10 个 SPT 处理。多个 SPT 使用英文逗号分隔不要使用中文逗号。3. 为什么测试没有收到可以按下面顺序排查SPT 是否复制完整前后是否有空格多个 SPT 是否使用英文逗号青龙所在服务器是否能访问wxpusher.zjiecode.comWxPusher 客户端是否登录并开启了对应系统的通知权限是否同时配置了其他通知方式导致你看错了测试结果。4. 极简推送能不能管理用户或做回调不能。极简推送主打“自己给自己发”或者“小范围维护者通知”。如果需要用户关注、UID 回调、主题群发、订阅关系、消息产品等能力请使用 WxPusher 标准推送。5. 青龙原来的 WxPusher 配置还能用吗可以。原来的WXPUSHER_APP_TOKEN、WXPUSHER_TOPIC_IDS、WXPUSHER_UIDS属于标准推送方式适合更完整的用户管理和群发场景。极简推送只需要WXPUSHER_SPT_LIST适合快速接入。两种方式建议二选一配置避免重复通知。参考资料青龙 v2.21.0支持 WxPusher 极简推送WxPusher 官方文档方式一标准推送WxPusher 官方文档极简推送WxPusher 全平台客户端下载青龙官方文档
青龙面板接入 WxPusher 极简推送：v2.21.0 配置与脚本验证
青龙面板很适合跑定时脚本签到、数据同步、服务巡检、自动化任务一旦脚本失败或产出关键结果最怕的不是报错而是报错以后没人知道。WxPusher 的极简推送刚好解决这个场景不需要创建应用、不需要配置 appToken 和 UID只要拿到一个 SPTSimple Push Token填进青龙面板就可以把任务通知推送到手机和电脑。这篇教程适合只想把青龙运行结果推给自己或者推给少数几个人的用户。如果你后续要做多人订阅、主题群发、用户管理、回调、付费消息等更完整的消息能力可以再升级为 WxPusher 标准推送。一、先确认青龙版本青龙面板从 v2.21.0 开始支持 WxPusher 极简推送。请先确认当前版本为v2.21.0或更高版本。需要注意v2.21.0之前的青龙版本也支持 WxPusher只是使用的是标准推送需要配置 appToken、UID 等信息。暂时不方便升级的用户可以参考 WxPusher 官方文档方式一标准推送 完成接入。进入青龙面板的通知设置如果能看到WxPusher(极简推送SPT-推荐)就说明当前版本已经支持极简推送。如果没有这个选项可以将青龙更新到v2.21.0或更高版本暂时不升级也可以继续使用上面的标准推送方式。青龙面板本身支持 Python3、JavaScript、Shell、Typescript 脚本任务也支持系统级通知。WxPusher 接入后青龙任务完成、失败、告警等通知就可以通过 WxPusher 直接到达你的设备。二、获取你的 SPT打开或扫码下面的二维码按页面提示获取自己的 SPT也可以直接访问二维码链接https://wxpusher.zjiecode.com/api/qrcode/RwjGLMOPTYp35zSYQr0HxbCPrV9eU0wKVBXU1D5VVtya0cQXEJWPjqBdW3gKLifS.jpgSPT 可以理解为你的极简推送收件地址。谁拿到这个值谁就可以给你发消息所以不要把它提交到公开仓库也不要在截图里暴露。WxPusher 支持 Android、iOS、鸿蒙、macOS、Windows、Linux 等客户端手机端可以走厂商推送、APNs、鸿蒙 Push Kit桌面端可以通过 WebSocket 长连接接收系统通知。对青龙这种“任务跑在服务器结果要及时看到”的场景来说手机和电脑都能收消息会舒服很多。三、在青龙面板里配置登录青龙面板。进入「系统设置」里的通知配置页面。通知方式选择WxPusher(极简推送SPT-推荐)。在wxPusherSptList中填入刚才获取到的 SPT。保存配置然后点击测试通知进行验证。配置完成后的界面如下。确认通知方式和wxPusherSptList都填写正确后再保存图中的 SPT 已做脱敏处理如果只推给自己填一个 SPT 即可SPT_xxxxxxxxxxxxxxxxx如果要推给多个人把多个 SPT 用英文逗号分隔最多 10 个SPT_xxx1,SPT_xxx2,SPT_xxx3青龙会自动判断只有一个 SPT 时使用spt字段多个 SPT 时使用sptList数组最终调用 WxPusher 的极简推送接口https://wxpusher.zjiecode.com/api/send/message/simple-push通知内容会以 HTML 方式发送标题会作为消息摘要展示任务详情会放到消息正文里。对于青龙自身触发的系统通知你不需要额外编写接口代码。四、通过配置文件或环境变量配置如果需要让「脚本管理」中的 JavaScript 或 Python 脚本调用青龙通知模块主动发送消息必须配置WXPUSHER_SPT_LIST环境变量。通过配置文件设置时可以写入exportWXPUSHER_SPT_LISTSPT_xxxxxxxxxxxxxxxxx多个接收人同样使用英文逗号分隔exportWXPUSHER_SPT_LISTSPT_xxx1,SPT_xxx2如果只想使用极简推送建议不要同时配置WXPUSHER_APP_TOKEN、WXPUSHER_TOPIC_IDS、WXPUSHER_UIDS避免标准推送和极简推送同时生效造成重复通知。运行脚本验证完成WXPUSHER_SPT_LIST环境变量配置后可以在「脚本管理」中运行一个会调用青龙通知模块的脚本。JavaScript 脚本调用sendNotify(...)后青龙会读取环境变量中的 SPT 并发送通知Python 脚本调用notify.send(...)也会读取同一个环境变量截图右上角出现 WxPusher 系统通知说明环境变量、脚本调用和客户端接收链路都已经正常工作。五、收到通知后可以期待什么配置成功后青龙脚本的通知会进入 WxPusher 消息列表并通过你启用的客户端渠道提醒你。常见用法包括定时任务失败时第一时间收到错误摘要每日签到、库存监控、价格监控等脚本执行后收到结果服务器资源、脚本订阅、自动化流程异常时及时提醒同一个青龙实例通知多个维护者每人填一个 SPT 即可。对于个人或小团队来说极简推送的好处是概念少不用先理解应用、主题、UID、回调这些完整推送模型先把消息稳定收到。等你的脚本通知从“发给自己”变成“发给一组用户”再切换到标准推送会更自然。六、极简推送和标准推送怎么选场景推荐方式说明青龙任务通知只发给自己极简推送扫码拿 SPT填入青龙即可通知少数几个维护者极简推送多个 SPT 用英文逗号分隔最多 10 个要管理大量用户标准推送使用应用、UID、主题等能力要做订阅、回调、用户绑定标准推送支持更完整的业务闭环要做消息产品或付费订阅标准推送可结合 WxPusher 消息产品能力极简推送不是标准推送的替代品它更像一个快速入口先让消息到达后面再按业务复杂度升级。七、常见问题1. 青龙通知方式里没有 WxPusher 极简推送怎么办先确认青龙版本。WxPusher 极简推送从 v2.21.0 开始支持如果你的镜像或代码版本较旧通知方式下拉框里可能还没有这个选项。你可以升级到v2.21.0或更高版本也可以继续使用旧版本已经支持的 方式一标准推送。2. SPT 可以给几个人用青龙接入和 WxPusher 极简推送接口都按最多 10 个 SPT 处理。多个 SPT 使用英文逗号分隔不要使用中文逗号。3. 为什么测试没有收到可以按下面顺序排查SPT 是否复制完整前后是否有空格多个 SPT 是否使用英文逗号青龙所在服务器是否能访问wxpusher.zjiecode.comWxPusher 客户端是否登录并开启了对应系统的通知权限是否同时配置了其他通知方式导致你看错了测试结果。4. 极简推送能不能管理用户或做回调不能。极简推送主打“自己给自己发”或者“小范围维护者通知”。如果需要用户关注、UID 回调、主题群发、订阅关系、消息产品等能力请使用 WxPusher 标准推送。5. 青龙原来的 WxPusher 配置还能用吗可以。原来的WXPUSHER_APP_TOKEN、WXPUSHER_TOPIC_IDS、WXPUSHER_UIDS属于标准推送方式适合更完整的用户管理和群发场景。极简推送只需要WXPUSHER_SPT_LIST适合快速接入。两种方式建议二选一配置避免重复通知。参考资料青龙 v2.21.0支持 WxPusher 极简推送WxPusher 官方文档方式一标准推送WxPusher 官方文档极简推送WxPusher 全平台客户端下载青龙官方文档
