VRC-Notifier 开源好友状态监控与通知工具

介绍

VRC-Notifier是一个专门为 VRChat 玩家设计的后台监控工具，它可以持续地在后台监控您所指定的好友的状态变化，比如上线信息、下线信息、状态切换信息、和世界切换信息，并通过邮箱 SMTP 服务或者 Gotify 等其他开源平台实时通知你。

功能

• 智能好友监控 - 选择性监控指定好友，而非全部好友列表
• 仅监控状态模式 - 无限制监控所有好友的在线状态，不监控世界变化
• 邮件通知 - 支持自定义 SMTP 服务器，实时接收状态变化通知
• Gotify 推送 - 支持开源推送平台 Gotify，手机实时接收通知
• 世界轮询 - 智能轮询机制追踪好友所在世界变化（标准模式）
• API 保护 - 多层限流保护机制，确保不触发官方 API 限制
• 防抖动机制 - 避免服务器抖动导致的误判，确保通知准确性
• 精美界面 - 现代化 Web UI，支持明暗主题切换
• Docker 支持 - 一键部署，支持 Docker Compose
• 国际化支持 - 中英双语翻译

使用

部署本项目，并启用本项目。在终端会收到访问密钥输入生成的访问密钥即可登录 VRChat 官方账号（账号不会明文保存，相关数据均已加密并保存在本地）。

进入好友列表，便会自动刷新一次好友列表，后面工具将不会主动地自动刷新以降低 API 的请求频率。刷新完后好友列表会进入六十秒等待期（不会调用任何 API），以防止用户在此多次频繁地使用 API 导致限流问题。

用户可选择标准模式和仅监控状态模式。标准模式会监控好友的世界信息，但最多只能监控五个好友；仅监控状态模式下可以监控所有好友，但无法监控他们的世界变化信息，两种模式均在关于按钮中呈现。

接下来用户只要配置 SMTP 服务或者 Gotify 服务或者 Webhook 服务就可以将好友状态及其变化推送到推送平台了。

快速开始

环境要求

• Node.js 18.0 或更高版本
• 支持的平台：Windows / macOS / Linux

安装步骤

方式一：直接运行

# 克隆仓库
git clone https://github.com/shanyaojinjn/vrc-notifier.git
cd vrc-notifier
# 安装依赖
npm install
# 启动服务
npm start

方式二：Docker 部署（推荐）

1. 创建项目目录并进入

mkdir vrc-notifier && cd vrc-notifier

2. 创建 docker-compose.yml 文件

version: '3.8'
services:
  vrc-notifier:
    image: