环境准备
你需要一台轻量级服务器或本地开发机（支持 Linux/Windows），并确保网络环境通畅。本教程以 Ubuntu 24.04 为例，建议配置 2 核 CPU 及以上。
首先确保系统已安装 Python 环境（版本需大于 3.8，建议 3.11 至 3.12 之间，暂不建议使用 3.13+）。同时需要安装 Git 工具。
- Ubuntu 用户：直接运行
sudo apt install git - Windows 用户：前往官网下载安装包并安装
创建虚拟环境
从 Python 3.11 开始，Debian 和 Ubuntu 默认启用了'外部管理环境'保护机制，防止用户直接使用 pip 安装包到系统 Python 环境中。因此我们选择创建一个虚拟环境，每次使用前只需启动即可。
在 Windows 上可直接运行 pip install uv，但在 Linux 服务器上建议在虚拟环境中操作以避免权限问题。
安装虚拟环境包
# 创建虚拟环境
python -m venv mcvenv
# 退出虚拟环境的命令：deactivate
激活虚拟环境并安装 uv
# 激活虚拟环境
source mcvenv/bin/activate
# 在虚拟环境内安装 uv
pip install uv
安装核心插件
安装 GsCore
早柚核心是机器人的基础框架，文档地址为 https://docs.sayu-bot.com/。
进入项目目录 opt/mcbot，执行以下命令克隆代码：
cd opt/mcbot
git clone https://github.com/Genshin-bots/gsuid_core.git --depth=1 --single-branch
cd gsuid_core
运行 GsCore
使用 uv 运行核心程序：
uv run core
启动后出现的常规依赖警告可忽略。如果在服务器上部署，请修改 config.json 中的 host 为 0.0.0.0；本地部署则保持默认。编辑完成后按 Ctrl+X 退出并确认保存。
配置服务器端口
GsCore 默认运行在 8765 端口，需要在防火墙处添加对应规则以确保外部可访问。
安装鸣潮插件
进入插件目录，分别安装鸣潮 UID 查询插件和库街区签到插件。
cd gsuid_core/plugins
git https://github.com/Loping151/XutheringWavesUID.git
git --depth=1 https://github.com/Loping151/RoverSign.git
