准备工作
准备一台轻量级服务器或本地开发机(Windows/Linux),并确保网络环境稳定。
环境部署
以下以 Ubuntu 24.04 系统为例,硬件配置建议 2 核 CPU、2G 内存以上。确保已成功安装 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
早柚核心文档地址:https://docs.sayu-bot.com/
进入 /opt/mcbot 目录,输入如下命令:
git clone https://github.com/Genshin-bots/gsuid_core.git --depth=1 --single-branch
cd gsuid_core

运行 GsCore
uv run core
启动时出现的部分警告通常不影响运行,可暂时忽略。













