VRCX 完整指南：VRChat 好友管理与世界整理的完整方案
【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX
VRChat 官方客户端的好友列表与收藏都有数量上限，而"六个月前和谁在哪个世界待过"这类信息，官方客户端没有任何地方记录。VRCX 是一款面向 VRChat 的友谊管理与陪伴应用，它在本地数据库中整理好友、世界、Avatar 与群组，自动记录活动历史，处理邀请与好友请求，并在 VRChat 崩溃后自动重连回你所在的实例。
先看 VRCX 替你接走了哪些活
与其罗列功能，不如看它接管了哪些具体工作。
好友台账。官方客户端只显示当前状态，VRCX 为每个好友保留完整历史：加好友的日期、共同在线总时长、历次改名记录，还有一个备注栏可以写清楚"我们是在哪认识的"（见 src/views/FriendList/）。好友列表从一组名字变成一套档案。
世界收藏移出游戏。世界收藏不再受客户端上限约束，可以在游戏外保存、分类、随时翻看，避免想长期关注的世界被列表沉底。
崩溃后自动回场。VRChat 意外退出时，VRCX 会自动重启客户端并重新加入上一个实例，核心逻辑在 src/coordinators/gameCoordinator.js，不必重新找世界、也不用等好友再发一次邀请。
通知就地处理。邀请和好友请求可以直接在 VRCX 里收、发、回复，收到的邀请附带实例信息，不用来回切客户端查看。
倒推它的实现：三个机制
上述结果来自三个机制的组合。
本地数据库。好友、世界、备注、历史记录全部保存在本机 SQLite 数据库中，数据层位于 src/services/database/。带来的直接好处：离线可用、数据不上传云端、版本升级时平滑迁移。
游戏日志解析。VRCX 实时读取 VRChat 客户端输出的 debug log，从中提取所在实例、好友位置与活动。这也是它强制要求开启调试日志的原因。
注意：使用前需在 VRChat 游戏内快速菜单中开启 debug logging，否则位置与活动相关功能无法正常工作。
官方 API 调用。日志拿不到的数据（好友列表、世界信息、Avatar 详情）通过 VRChat 官方 API 获取，调用按领域拆分为独立模块（见 src/api/），各自带重试与错误恢复。项目在 README 中明确说明：VRCX 是外部工具，不修改游戏本体，不属于 mod 或外挂。
完整安装步骤：十分钟跑起 VRCX
- 从项目 Releases 页面下载最新的
VRCX_Setup.exe安装包，按向导完成安装； - 打开 VRChat，在快速菜单中开启 debug logging；
- 首次启动 VRCX 并用 VRChat 账号登录，登录页支持 2FA 验证码；
- 登录成功后，好友列表与世界数据会自动拉取并写入本地库。
Linux 与 macOS 有专门的运行方式，可参考项目提供的多语言文档（含 README/README.zh_CN.md）。如果想读源码，前端在src/，.NET 后台（截图元数据、VR 覆盖层等）在Dotnet/。
进阶功能：值得二看的几处
Dashboard 与快速搜索
Dashboard 支持自定义多面板布局，可自由组合 Feed、GameLog 与实例小组件，还能创建多套配置；Quick Search 对好友、Avatar、世界与群组做即时模糊搜索，直接粘贴 ID 或 URL 也能跳到目标。
活动热力图与图表
好友档案页提供星期 × 时段的在线活动热力图和峰值统计；更深的统计在图表模块 src/views/Charts/，把互动频率与关系强度画出来。
截图元数据
VRCX 会把拍照时的世界信息写进游戏截图文件（实现在 Dotnet/ScreenshotMetadata/），半年前的照片也能回答"这是在哪个世界拍的"。
Discord 集成与数据导出
Discord Rich Presence 展示世界缩略图、名称与玩家数，公开房间附带一键加入按钮；数据方面支持导出好友列表、备注、Avatar 列表与收藏群组，备份和迁移都不成问题。
使用前须知
- 保持 debug logging 开启。这是 VRCX 获取实时数据的命脉，关闭后位置相关功能会整体失效。
- 定期导出当备份。数据量大时，定期导出好友列表与备注，防止意外丢失。
- 长列表无需担心卡顿。好友、世界等长列表采用虚拟化滚动渲染，千级数据量下界面依然流畅。
陪伴应用与客户端的真正差别在于：客户端负责"此刻"，VRCX 负责"别丢"。当这些活动记录都沉淀在本地数据库里，还有一个问题留给每个人自己——这些痕迹想留多久，什么时候开始整理它们。
【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
