VRCX：VRChat 好友管理与活动记录，完整使用指南
【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX
在 VRChat 里，朋友的旧名、初见的世界、一起待过多久，过一阵子就容易记不清。VRCX 是一款免费开源的 VRChat 好友管理工具：它自动记录每位好友的相识史、共同游玩时长与活跃时段，并在电脑上实时同步好友列表、收藏与通知，不用反复切到官网处理。
先上手：安装与首次配置
下载安装：Windows 用户从项目 Release 页面拿到
VRCX_Setup.exe直接安装；macOS/Linux 按官方 wiki 说明配置即可。登录账号：首次启动用 VRChat 账号登录，支持两步验证（2FA）；登录 Cookie 由程序自动保存，一般不用反复输密码。
等首次同步：登录后自动拉取好友列表、收藏的世界/头像/群组和最近的活动记录，数据落在本地，可直接开始查看。
基础设置：进「设置」调通知类型、同步频率、界面语言，顺手选个主题。
源码玩家：想自己构建的话，一行命令拉到本地：
git clone https://gitcode.com/GitHub_Trending/vr/VRCX构建步骤见 README.md 的 Misc 部分指向的 wiki。
重点功能拆解
好友历史与个人备注
一句话价值：把"你是谁、我们认识多久了"变成一条可检索的记录。
- 自动记录加好友时间、共同游玩时长与次数、改名历史，谁改名了也不会对不上号
- 好友卡片上可以写个人备注（notes）和备忘录（memos），比如"在某某世界认识的"
- 数据全部存在本地，配合导出功能可以备份整份好友列表
活动热力图
一句话价值：一眼看出谁在什么时间段最活跃。
- 按"星期 × 小时"画出某个用户的在线模式，并给出峰值统计
- 排活动前先看好友的热力图，挑大家都在线的时段，比群里问一圈靠谱
截图元数据
一句话价值：照片拍完半年，也能找回当时所在的世界。
- 把游戏内截图对应的世界信息直接写进图片文件里，不依赖额外数据库
- 元数据格式在 Dotnet/docs/screenshotMetadata-schema.json 有完整定义，可自己解析
- 整理旧截图时按元数据分组，比凭记忆翻相册快得多
| 功能 | 典型入口 | 解决的问题 |
|---|---|---|
| 好友历史 | FriendLog 视图 | 好友改名后认不出、不记得怎么认识的 |
| 活动热力图 | 用户信息页 | 约活动时不知道对方几点上线 |
| 截图元数据 | 游戏内截图自动写入 | 老照片想不起在哪个世界拍的 |
三个落地场景
几百好友的大群主，做季度好友清理时：用好友历史筛出长期不活跃、从未一起在线过的账号，再结合备注决定是否移除，得到一份干净的活跃好友名单。
世界主理人，筹备每周固定活动时：打开几位核心成员的活跃热力图，找出重叠度最高的时段固定下来，得到不用再每次群里对时间的排期方案。
截图收藏爱好者，年底整理一文件夹旧图时：读取截图元数据批量还原每张图的世界名，得到一份按世界归档的素材库，还能顺带补进自己的世界收藏。
技术实现速览
前端：Electron + Vue 3。界面在 src/，用 Vue 3 + Pinia 做状态管理，Vite 打包；API 封装在 src/api/，本地数据访问走 src/services/database/。
.NET 侧负责重活。Dotnet/ 是 C# 程序：WebApi走 VRChat API，ProcessMonitor监听游戏进程，VR 覆盖层逻辑在 Dotnet/Overlay/。Windows 上的登录窗口用 CefSharp 嵌网页，Linux 则改用 Electron 承载，两套壳共用同一套 .NET 核心（源码里用LINUX编译开关区分）。
数据流与跨平台。.NET 端定时请求 VRChat API 并写入本地 SQLite（VRCX.sqlite3），前端只读数据库展示；两侧通过 IPC 与 WebSocket（Dotnet/IPC/、Dotnet/OverlayWebSocket/）实时推送游戏内事件和通知。这样 Windows、macOS、Linux 三个平台的界面体验保持一致，数据都留在本机。
参与项目
- 文档入口：README.md（英文）、README/README.zh_CN.md（简体中文），构建与 Linux 运行说明在官方 wiki
- 社区渠道：官方 Discord 服务器（邀请链接见项目 README），翻译与使用问题都可以在那里交流
- 二次开发路径：翻译在 src/localization/（已有 14 种语言），界面主题在 src/styles/themes/，前端插件挂载结构在 src/plugins/
VRCX 是走 VRChat API 的外部工具，不改游戏文件，不是 mod 也不是外挂，官方立场也明确不违反服务条款。想上手的话，直接从项目 Release 页面下载安装VRCX_Setup.exe，五分钟之内就能看到你好友的第一条历史记录。
【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
