VRCX：管理你的 VRChat 社交圈

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

三个月前你在某个世界拍了一组很棒的截图，现在却想不起那是哪个世界；好友改了一次名，你就不确定哪个是谁了。VRCX就是为这类烦恼而生的开源 VRChat 伴侣工具——它在游戏客户端之外帮你管理好友、世界和模型，并记住你们相处的每个细节。

它到底帮你省了什么事

你不用守在 VRChat 里刷好友动态。VRCX 实时同步好友的在线状态、所在房间和模型变化，记录成为好友的日期、共同时长与改名历史，还能给每个好友写备注，再也不用对着陌生 ID 想"我们怎么认识的来着"。

你不用戴头显也能管理资产。世界收藏、模型信息的编辑和封面图上传，过去需要开 Unity 或游戏内客户端，现在在 VRCX 里直接改；搜索框支持粘贴 ID 或 URL，直接定位到某个好友、世界或群组。

⚡ 你拥有一套"启动 VRChat = 启动一切"的自动化。VRCX 可以在 VRChat 启动时自动拉起 OSC 工具、变声器等你指定的程序，崩溃时自动重启并重新加入之前所在的房间，不用手动重进找房间。

通知也不用进游戏处理。邀请和好友请求可以在应用里直接回应，还能看到邀请指向的房间信息；Discord 状态面板可以显示当前世界的封面、名称和"加入"按钮。

跟着跑一遍：从克隆到跑起来

日常最省事的路线是从官方 Releases 页面下载VRCX_Setup.exe安装；这里走一遍源码路径：

1. git clone https://gitcode.com/GitHub_Trending/vr/VRCX克隆仓库
2. cd VRCX && npm install安装前端依赖
3. npm run start-electron启动完整应用（纯前端开发用npm run dev起 Vite 开发服务器）

跑完后可以用npm run test跑一遍 vitest 测试套件验证环境。环境要求一句话带过：Node.js >= 24.15.0、npm >= 11.5.0（package.json中声明），C# 后端目标框架为 .NET 10（见 Dotnet/VRCX-Electron.csproj）。

几个值得留意的实现细节

把世界数据藏进截图里。VRCX 保存游戏截图时，会把拍摄者、所在世界、当时在场的人直接写进图片文件自身的PNG chunk：

// Dotnet/ScreenshotMetadata/PNGFile.cs // Basic PNG Chunk Structure: Length(int, 4 bytes) | Type (string, 4 bytes) | chunk data (x bytes) | 32-bit CRC code (4 bytes) public class PNGFile : IDisposable { private FileStream fileStream; private List<PNGChunk> metadataChunkCache = new List<PNGChunk>(); public PNGFile(string filePath, bool writeAccess) { fileStream = new FileStream(filePath, FileMode.Open, writeAccess ? FileAccess.ReadWrite : FileAccess.Read, FileShare.ReadWrite, 4096); } }

📌 这个取舍的好处是数据跟着文件走：图片搬到云盘或发给谁，元数据都不会和图分离，也不需要额外建索引。它同时还兼容旧工具 LFS 写入的格式，完整 schema 定义在 Dotnet/docs/screenshotMetadata-schema.json。

应用启动绑定 VRChat 进程生命周期。Dotnet/AutoAppLaunchManager.cs 监听 VRChat 进程的启动/退出事件，从 AppData 的startup目录读取快捷方式文件：

private void OnProcessStarted(MonitoredProcess monitoredProcess) { if (!Enabled || !monitoredProcess.HasName(VRChatProcessName) || monitoredProcess.Process.StartTime < startTime) return; lock (startedProcesses) { if (KillChildrenOnExit) KillChildProcesses(); else UpdateChildProcesses(); var (shortcutFiles, steamIds) = FindShortcutFiles(AppShortcutDirectory); } }

🔧 细节在边界条件里：StartTime < startTime的比较避免了把"打开 VRCX 前就已经在跑"的 VRChat 误判为新启动；游戏退出时按KillChildrenOnExit设置，可以一键清理变声器等子进程，也可以让它们继续存活。

谁适合用 / 谁可能用不上

VRCX 适合好友数量多、需要脱开游戏管理社交的 VRChat 重度玩家，频繁上传世界和模型素材的创作者，以及想让语音/OSC 工具随 VRChat 一起启动的用户。反过来，如果你只是偶尔玩玩，它的多数功能用不上；另外它是纯外部 API 工具，不改变游戏内任何行为，自动启动等部分自动化能力目前仅限 Windows。

相关链接与延伸阅读

仓库与文档：

• git clone https://gitcode.com/GitHub_Trending/vr/VRCX——完整源码入口，克隆地址
• README/README.zh_CN.md——中文功能说明与 TOS 合规性解释
• Dotnet/docs/screenshotMetadata-schema.json——截图元数据的 JSON schema

按兴趣深入阅读：

• Dotnet/ScreenshotMetadata/——PNG chunk 读写与 LFS 兼容实现
• src/services/websocket.js——好友状态实时同步与断线重连逻辑
• Installer/installer.nsi——Windows NSIS 安装包脚本

Issue 提交与社区讨论入口见仓库主页的对应链接。

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