环境准备
在开始之前，请确保你拥有一台轻量级服务器或本地开发机（支持 Linux/Windows），且网络环境能够访问 GitHub。若使用 Ubuntu 24.04 系统，建议配置为 2 核 CPU、2GB 内存以上。
首先检查 Python 环境，版本需大于 3.8，推荐 3.12 及以上（暂不建议使用 3.13）。同时确保已安装 Git，Ubuntu 用户可通过 apt install git 安装，Windows 用户可前往官网下载安装包。
创建虚拟环境
从 Python 3.11 起，Debian 和 Ubuntu 默认启用了外部管理环境保护机制，直接 pip 安装包可能会破坏系统依赖。因此我们创建一个独立的虚拟环境来隔离项目依赖。
推荐使用 uv 作为包管理器，它比传统 pip 更快。Windows 用户可直接运行 pip install uv；Linux 用户同样适用。
# 创建并激活虚拟环境
python -m venv mcvenv
source mcvenv/bin/activate
# 在虚拟环境中安装 uv
pip install uv
注意：退出虚拟环境时输入
deactivate即可。
部署早柚核心 (GsCore)
进入工作目录（例如 /opt/mcbot），克隆早柚核心仓库。
git clone https://github.com/Genshin-bots/gsuid_core.git --depth=1 --single-branch
cd gsuid_core
启动核心服务：
uv run core
启动后若出现警告信息，通常可以忽略。如果是服务器部署，需要修改配置文件中的 host 地址。
编辑 config.json，将 host 设置为 0.0.0.0 以允许外部连接，保存并退出编辑器（如 nano 按 Ctrl+X 确认）。
随后需在防火墙开放 8765 端口，确保服务可被外部访问。
安装插件模块
接下来在核心目录下添加鸣潮相关插件。
1. 鸣潮 UID 查询插件
cd plugins
git clone https://github.com/Loping151/XutheringWavesUID.git
2. 库街区签到插件
git clone --depth=1 https://github.com/Loping151/RoverSign
安装完成后重启早柚核心，确认插件已成功加载。
搭建 OneBot 框架
回到 mcbot 主目录，激活虚拟环境并安装 NoneBot 相关组件。
cd ..
source mcvenv/bin/activate
pip install nb-cli-plugin-bootstrap nb-cli
执行初始化命令，项目名称设为 onebot，选择对应的协议类型。
进入 onebot 目录，安装早柚插件以建立连接（若网络受限需确保能访问 GitHub）：
cd onebot
nb plugin install nonebot-plugin-genshinuid
最后运行 OneBot 服务：
nb run
记得在防火墙中放行 8080 端口，至此基础架构已搭建完成。后续可根据需求接入大语言模型，扩展机器人的交互能力。
