VRCX 完整指南：把 VRChat 好友、世界收藏和通知一次管起来

VRCX 完整指南：把 VRChat 好友、世界收藏和通知一次管起来

【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX

VRCX 是一款开源的 VRChat 好友管理工具：盯住好友在线状态、管理世界与头像收藏、处理邀请和通知，还能在 VRChat 崩溃时自动重启并重连。适合想脱离游戏客户端本身来管理社交数据、查找世界、留档记录的 VRChat 玩家。

VRCX 是什么：装在自己电脑上的 VRChat 助手

游戏客户端里的信息很零散：好友改名了查不到历史，想记一下"和谁在一起待过多久"没地方写，想找一个世界只能在列表里翻。VRCX 把这些事挪到桌面端：它调用 VRChat 官方 API 拉取数据，在本地一个 Electron 应用里展示好友列表、世界收藏、活动日志和通知。

项目结构其实不复杂：前端是 Vue 3 + Electron（见 src/），负责界面和状态管理；C#/.NET 部分（见 Dotnet/）处理 API 调用、登录鉴权、进程监控和截图元数据写入；所有本地数据存在 SQLite 数据库里。需要说明的是，VRCX 是外部工具，只通过 API 取数，不修改游戏文件，官方 FAQ 里也明确它不属于 mod 或作弊。中文说明可以直接看 README/README.zh_CN.md。

快速上手：下载安装或源码构建

最快路径是从项目 Releases 页面下载官方安装包VRCX_Setup.exe，运行安装器，启动后登录 VRChat 账号；如果账号开了两步验证，会多一个 6 位验证码输入框。macOS 和 Linux 用户可以在中文 README 里查看运行方式。

想改代码或者在 Linux 上跑，就从源码构建，命令很少：

git clone https://gitcode.com/GitHub_Trending/vr/VRCX cd VRCX npm install # 需要 Node.js >= 24.15 npm run prod # 构建前端产物

依赖装完后，npm test跑 vitest 用例，npm run lint做静态检查，配置文件分别是 vitest.config.js 和 oxlint.config.mts。

盯好友能盯到什么程度：状态、时长、改名记录

好友列表不是简单罗列，每个好友能查到的信息包括：

• 实时在线状态、当前所在世界、实例类型和头像变化
• 加好友时间、累计共同在线时长、一起进过多少次世界
• 改名历史——对方改了一串名字，你也能对上号
• 备注和 memo：你们怎么认识的、在哪个世界见的面，写下来就不会忘
• 活动热力图：按"星期 x 小时"统计某个好友的在线规律，找对人一起上线很方便

邀请和好友请求也能直接在 VRCX 里发或回。收到邀请时会显示它指向哪个世界，不用再回游戏里看。

世界、头像和收藏怎么管

世界、群组、头像三个列表都可以在游戏外维护，收藏夹是纯本地的，想存多少个存多少个，不受游戏内限制。搜索支持用户、世界、头像、群组，也可以直接粘贴 VRChat 链接或 ID 跳转。

两个省事的点值得单独说：

• 上传头像和世界封面图、修改信息不需要打开 Unity
• 截图带元数据：VRCX 会把拍照时所在世界的信息写进游戏内截图文件，半年后翻照片仍知道是在哪个世界拍的，实现代码在 Dotnet/ScreenshotMetadata/

Dashboard 支持自己搭面板：Feed、GameLog、Instance 等 widget 随意组合，可以建多个布局，各自的列和过滤条件独立配置。

通知处理、崩溃恢复和自动启动

• 通知中心：好友请求、邀请等事件弹出系统通知，可直接响应
• GameLog 记录当前房间的统计、玩家列表，还能看到世界里正在播放的视频的真实链接
• 自动启动：配置好之后，一启动 VRChat 就帮你把 OSC 应用、变声器等一起拉起来，逻辑在 Dotnet/AutoAppLaunchManager.cs
• 崩溃恢复：VRChat 崩了，VRCX 检测到后自动重启客户端并把你送回崩溃前所在的世界
• 状态栏会显示 VRChat 服务器状态，官方宕机时一眼能看出来
• Discord Rich Presence 会展示世界封面、名称、人数，公共实例还能带"加入"按钮；另有 VR 内实时事件浮层

实战技巧与常见坑

• 首次登录时如果卡在两步验证，确认输入的是当前会话的验证码，过期会要求重取
• 状态栏提示服务器异常时，问题在官方那边，不是本地网络，等恢复即可，期间别反复重登
• 崩溃后没自动重连，先检查设置里的自动重启/重连开关是否开启
• 想迁移或备份，好友列表、备注、收藏群组都能导出/导入，换机器不丢记录
• 想换到 beta 或 nightly 版本，走 设置 → 通用 → Change build，不用重新下载
• 构建时最容易踩的坑是 Node 版本过低，engines要求 Node >= 24.15、npm >= 11.5，老版本装依赖会直接报错

一句话总结：VRCX 就是把 VRChat 客户端和官网都不方便做的社交管理，搬到一个桌面应用里集中处理。更多细节看 中文 README，前端源码在 src/，C# 后端在 Dotnet/。

【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX