[API] 请求逻辑
- 登录时:仅获取好友列表(2次API),不获取世界信息
- 手动刷新:获取好友列表和好友的状态信息
- 监控检查:每30秒检查,仅获取被监控好友的世界信息(标准模式下)
- 冷却期:登录/刷新后60秒内暂停所有api请求,防止冲突
[!] 重要提示
- 最多监控5个好友,仅被监控好友会获取世界信息
- VRCX兼容性:如使用VRCX可能产生API冲突,但本工具保留大量API冗余,不会影响VRCX正常使用
- 如遇问题,点击"退出并清除数据"按钮,后手动删除data里的文件
免责声明:本应用已尽可能规避API使用问题,且使用底层保护,如用户不特意调用API,不会出现账号封禁问题。若账号出现封禁,与本工具无关。(开源社区声明)
邮件通知配置
SMTP 服务器配置
邮件通知格式配置
{friendName}- 好友名称{changeType}- 变化类型(好友上线/好友下线/切换世界/状态更新/自定义状态){changeDescription}- 变化描述文本{changeDetailsHtml}- 变化详情HTML表格(自动根据变化类型生成){oldStatus}- 变化前的状态{newStatus}- 变化后的状态{oldStatusDescription}- 变化前的自定义状态{newStatusDescription}- 变化后的自定义状态{oldWorld}- 之前所在的世界{newWorld}- 当前所在的世界{timestamp}- 状态变化时间{avatarUrl}- 好友头像URL{oldPlatform}- 变化前的平台{newPlatform}- 变化后的平台
提示:如不需要自定义模板,可留空使用系统默认模板。系统会根据变化类型自动显示相应的变化详情。
[单条通知模板] - 好友上线/下线/状态变化
加载中...
[批量通知模板] - 多个好友世界变化
加载中...
发送测试邮件
配置完成后,点击按钮发送测试邮件验证 SMTP 设置是否正确。
Gotify 服务配置
开启后,当好友状态变化时,将通过 Gotify 服务器推送通知到您的设备。
服务器配置
您的 Gotify 服务器地址,例如: http://your-server:8080
在 Gotify 的 Apps 页面创建应用后获取的 Token
优先级越高,通知越明显。建议: 普通通知=5,重要通知=8-10
Gotify 推送模板配置(可选)
系统已内置智能标题生成,无需配置模板即可使用:
- 上线: 好友名称 上线了
- 下线: 好友名称 下线了
- 切换世界: 好友名称: 旧世界 → 新世界
- 状态变化: 好友名称: 旧状态 → 新状态
建议:使用默认智能标题即可,标题会直接显示变化内容,无需点开就能知道发生了什么。
自定义模板变量(高级用户):{friendName}- 好友名称{changeType}- 变化类型(上线/下线/切换世界/状态变化/自定义状态){oldStatus}- 变化前的状态{newStatus}- 变化后的状态{oldStatusDescription}- 变化前的自定义状态{newStatusDescription}- 变化后的自定义状态{oldWorld}- 之前所在的世界{newWorld}- 当前所在的世界{timestamp}- 状态变化时间{oldPlatform}- 变化前的平台{newPlatform}- 变化后的平台
提示:消息内容支持 Markdown 格式,可以使用 **粗体**、*斜体*、- 列表等语法。
[单条推送预览] - 好友上线
加载中...
[批量推送预览] - 多个好友状态变化
加载中...
发送测试推送
配置完成后,点击按钮发送测试推送验证 Gotify 设置是否正确。
使用说明
Gotify 是一个开源的自托管消息推送服务器,可以将通知推送到您的 Android 设备或浏览器。 您需要在服务器上部署 Gotify,然后在手机上下载 Gotify App 来接收推送。
配置步骤:- 在您的服务器上部署 Gotify(Docker 部署最简单)
- 登录 Gotify Web 界面,创建一个新的 Application
- 复制生成的 Token,填写到上面的"应用 Token"字段
- 填写您的 Gotify 服务器地址
- 点击"发送测试推送"验证配置
- 在手机上下载 Gotify App,登录后即可接收推送
docker run -p 8080:80 -v /var/gotify/data:/app/data gotify/server
NTFY 服务配置
开启后,当好友状态变化时,将通过 NTFY 服务器推送通知到您的设备。
服务器配置
NTFY 服务器地址,默认使用官方 ntfy.sh,也可自建服务器
Topic 名称相当于频道,在 NTFY App 中订阅此 Topic 即可接收通知。建议使用不易猜测的名称。
NTFY 优先级: 1=min, 2=low, 3=default, 4=high, 5=max。建议: 普通通知=3,重要通知=4-5
NTFY 推送模板配置(可选)
系统已内置智能标题生成,无需配置模板即可使用:
- 上线: 好友名称 上线了
- 下线: 好友名称 下线了
- 切换世界: 好友名称: 旧世界 → 新世界
- 状态变化: 好友名称: 旧状态 → 新状态
建议:使用默认智能标题即可,标题会直接显示变化内容,无需点开就能知道发生了什么。
自定义模板变量(高级用户):{friendName}- 好友名称{changeType}- 变化类型(上线/下线/切换世界/状态变化/自定义状态){oldStatus}- 变化前的状态{newStatus}- 变化后的状态{oldStatusDescription}- 变化前的自定义状态{newStatusDescription}- 变化后的自定义状态{oldWorld}- 之前所在的世界{newWorld}- 当前所在的世界{timestamp}- 状态变化时间{ntfyTimestamp}- 横线连接时间格式{oldPlatform}- 变化前的平台{newPlatform}- 变化后的平台
提示:消息内容支持 Markdown 格式,可以使用 **粗体**、*斜体*、- 列表等语法。
[单条推送预览] - 好友上线
加载中...
[批量推送预览] - 多个好友状态变化
加载中...
发送测试推送
配置完成后,点击按钮发送测试推送验证 NTFY 设置是否正确。
使用说明
什么是 NTFY?
NTFY 是一个简单、免费、开源的 HTTP 消息推送服务,无需注册即可使用。您可以通过 HTTP PUT/POST 请求向手机或桌面发送通知。支持 iOS、Android 和 Web。
配置步骤:
- 在手机上下载 NTFY App(App Store 或 Google Play)
- 打开 App,点击右上角 + 号添加订阅
- 输入 Topic 名称(建议使用随机字符串,如 vrc-notifier-xxx)
- 在上方表单填写相同的 Topic 名称
- 点击"发送测试推送"验证配置
- 保存设置,开始接收推送
使用提示:
- Topic 名称是公开的,任何人知道 Topic 名称都可以订阅。建议使用包含随机字符的 Topic 名称。
- 如需更高隐私性,可以自建 NTFY 服务器(Docker 一键部署)
基础配置
接收推送通知的 HTTP 端点地址
自定义请求头(可选)
用于身份验证或其他自定义请求头,JSON 格式,例如:{"Authorization": "Bearer xxx"}
请求体模板(可选)
自定义 Webhook 请求体,留空使用默认 JSON 格式。支持以下变量:
{friendName}- 好友名称{changeType}- 变化类型(上线/下线/切换世界/状态变化/自定义状态){oldStatus}- 变化前状态{newStatus}- 变化后状态{oldStatusDescription}- 变化前的自定义状态{newStatusDescription}- 变化后的自定义状态{oldWorld}- 之前世界{newWorld}- 当前世界{timestamp}- 时间戳{avatarUrl}- 头像URL{eventType}- 事件类型{oldPlatform}- 变化前的平台{newPlatform}- 变化后的平台
发送测试 Webhook
配置完成后,点击按钮发送测试请求验证 Webhook 设置是否正确。
使用说明
通用 Webhook 允许您将通知推送到任何支持 HTTP 请求的第三方服务,如 Discord、Slack、企业微信、钉钉、飞书等。 只需配置目标 URL 和请求格式,即可实现消息推送。
支持的推送平台示例:- Discord - 使用 Discord Webhook URL
- Slack - 使用 Slack Incoming Webhook
- 企业微信 - 使用企业微信群机器人 Webhook
- 钉钉 - 使用钉钉群机器人 Webhook
- 飞书 - 使用飞书群机器人 Webhook
- 自定义服务 - 任何支持 HTTP 的接口
访问密钥设置
开启后,访问网页时需要先输入访问密钥,公网部署建议开启,本地部署可选择性关闭。
更新日志
V1.6 更新日志
当前版本:1.6
修复:
- 修复用户刷新网页后退回登录界面的问题
V1.5 更新日志
当前版本:1.5
新增:
- 增添 NTFY 通知平台的支持
- 新增 web 端平台识别以修复使用 VRCX 工具时出现的通知重复问题
- 新增了 {oldPlatform}{newPlatform} 变量,为自定义用户提供好友平台显示
- 新增 web 端上线下线逻辑和防抖机制
- 在终端里新增了关于验证码部分的调试内容,以监控输入验证码时出现的错误
修复:
- 修复部分自定义变量没有返值的问题
- 修复第一次使用时,会将所有好友的初始状态设置为离线,后出现的通知大量重复问题
- 修复第一次使用时,将好友的世界命名为未知世界导致的重复通知问题
- 修复 NTFY 中时间格式被手机端识别为电话号码的问题
- 修复好友每次上线时,自定义状态都会通知一遍的问题
- 修复登录时的提示为错误的问题
- 修复了账号登出之后并不会返回到登录界面的问题
优化:
- 优化上下线通知逻辑
- 优化默认模板的格式
- 优化标签页内容与布局
- 删掉了多余的文字和不用的函数变量