准备工作
你需要一台轻量级服务器或本地开发环境（支持 Linux/Windows），并确保网络连通性稳定。演示环境基于 Ubuntu 24.04，配置为 2 核 CPU、2GB 内存。
首先确认已安装 Python 环境，版本建议大于 3.8，推荐使用 3.12 及以上，暂不建议使用 3.13 版本。同时确保 Git 已安装，Ubuntu 用户可通过包管理器安装，Windows 用户请前往官网下载安装包。
环境部署
创建虚拟环境
从 Python 3.11 开始，Debian 和 Ubuntu 默认启用了'外部管理环境'保护机制，防止直接修改系统 Python 依赖。因此我们创建一个隔离的虚拟环境。
Windows 用户可直接运行 pip install uv。若遇到错误，请先检查网络或尝试其他安装方式。
安装并激活虚拟环境
# 创建虚拟环境
python -m venv mcvenv
# 激活虚拟环境
source mcvenv/bin/activate # Linux/Mac
# Windows 下可使用：mcvenv\Scripts\activate
# 在虚拟环境中安装 uv
pip install uv
退出虚拟环境时，输入 deactivate 即可。
安装核心 GsCore
进入项目目录（例如 /opt/mcbot），克隆早柚核心仓库。
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 端口。请在服务器防火墙中添加对应规则，允许该端口通信。
安装插件
进入核心插件目录，依次安装鸣潮 UID 插件与库街区签到插件。
cd gsuid_core/plugins
# 安装鸣潮 UID 插件
git clone https://github.com/Loping151/XutheringWavesUID.git
# 安装库街区签到插件
git clone --depth=1 https://github.com/Loping151/RoverSign.git
安装完成后，重启 GsCore 服务，确认插件已成功加载。
搭建机器人框架
打开新的终端窗口，进入 mcbot 目录并激活虚拟环境，安装 NoneBot 相关组件。
cd /opt/mcbot
source mcvenv/bin/activate
pip install nb-cli-plugin-bootstrap nb-cli
