准备工作
确保拥有一台可访问公网的服务器或本地开发机（支持 Linux 或 Windows）。
环境要求
- Python 环境：版本需大于 3.8，建议 3.11 至 3.12。
- Git：用于拉取代码仓库。
Ubuntu 用户可直接安装 Git，Windows 用户请前往官网下载安装包。
创建虚拟环境
从 Python 3.11 开始，Debian 和 Ubuntu 默认启用了外部管理环境保护机制，防止直接修改系统 Python。因此推荐使用 uv 创建隔离的虚拟环境。
Windows 用户可直接运行 pip install uv。
安装与激活
# 创建虚拟环境
python -m venv mcvenv
# 激活虚拟环境
# Linux/Mac: source mcvenv/bin/activate
# Windows: mcvenv\Scripts\activate
# 在虚拟环境中安装 uv
pip install uv
退出环境使用 deactivate 命令。
核心部署
安装 GsCore
早柚核心是机器人的基础框架。进入工作目录后执行以下命令：
cd /opt/mcbot
git clone https://github.com/Genshin-bots/gsuid_core.git --depth=1 --single-branch
cd gsuid_core
启动服务
uv run core
启动后忽略非关键警告。若在服务器上部署，需修改 config.json 中的 host 为 0.0.0.0 以允许外部连接；本地部署则保持默认。
编辑配置文件后保存退出。
开放端口
GsCore 默认运行在 8765 端口，需在服务器防火墙添加对应规则。
插件安装
鸣潮插件
进入插件目录克隆鸣潮相关插件：
cd gsuid_core/plugins
git clone https://github.com/Loping151/XutheringWavesUID.git
签到插件
继续在同一目录下安装库街区签到插件：
git clone --depth=1 https://github.com/Loping151/RoverSign.git
重启早柚插件即可看到新插件导入成功。
NoneBot 集成
初始化项目
新建终端窗口，进入主目录并激活虚拟环境，安装 NoneBot 相关工具：
cd /opt/mcbot
mcvenv/bin/activate
pip install nb-cli-plugin-bootstrap nb-cli
