准备工作
一台轻量级服务器或本地 Windows/Linux 环境，需能够访问外网。
环境部署
笔者演示环境为阿里云服务器（2 核 CPU，2GB 内存，40GB 系统盘），操作系统为 Ubuntu 24.04。
确保已成功安装 Python 环境（版本须 >3.8，建议 >=3.12，不建议 >=3.13）。 确保已成功安装 Git。
如果系统为 Ubuntu 且未安装 Git，可输入命令安装；如果系统为 Windows，请前往官网下载安装包安装即可。
创建虚拟环境
从 Python 3.11 开始，Debian 和 Ubuntu 默认启用了 "Externally-Managed-Environment"（外部管理环境）保护机制，防止用户直接使用 pip 安装包到系统 Python 环境中。因此我们选择创建一个虚拟环境，每次使用之前只需要启动环境即可。
Windows 可直接运行 pip install uv。
安装虚拟环境包
退出虚拟环境的命令：deactivate。
激活虚拟环境并安装 uv
# 激活虚拟环境
source mcvenv/bin/activate
# 在虚拟环境安装 uv
pip install uv
安装插件
安装 GsCore
进入 opt/mcbot，输入如下命令：
git clone https://github.com/Genshin-bots/gsuid_core.git --depth=1 --single-branch
cd gsuid_core
运行 GsCore
uv run core
忽视警告。
如在服务器上部署请按照说明修改 config.json 中的 host 为 0.0.0.0，如在本地部署请忽略。Ctrl + x 退出并保存，回车确认。
配置服务器端口 8765
由于 GsCore 运行在 8765 端口，我们需要在服务器的防火墙处添加对应的规则。
安装 XutheringWavesUID 鸣潮插件
进入插件目录，安装 XWUID：
cd gsuid_core/plugins
git clone https://github.com/Loping151/XutheringWavesUID.git
安装库街区签到插件
# 在 plugins 目录下安装库街区签到插件
git clone --depth=1 https://github.com/Loping151/RoverSign
重启早柚插件
可以看到刚刚安装的插件成功导入了。
安装 NoneBot
另外创建一个会话窗口，进入 mcbot 目录，运行虚拟环境，安装 nonebot：
cd opt/mcbot
# 激活虚拟环境
source mcvenv/bin/activate
# 安装 nb
pip install nb-cli-plugin-bootstrap nb-cli
运行 nb bs，将文件夹命名为 onebot，空格选中，回车确定。
配置图如下。
进入 onebot 目录，连接早柚插件，可能需要科学上网：
cd onebot
nb plugin install nonebot-plugin-genshinuid
运行 onebot：
nb run
配置防火墙端口 8080。
