准备工作
一台轻量级服务器/ 本地 windows/linux 能够在服务器/本地 科学上网
环境部署
笔者所演示的环境为阿里云服务器(2 核 CPU,2GB 内存,40GB 系统盘),操作系统为 Ubuntu 24.04。
确保已成功安装 Python 环境(版本须 >3.8,建议 >=3.12,不建议 >=3.13)
确保已成功安装 git
如果你没有安装 git 且的系统是 ubuntu,安装 git 只需要输入
如果系统为 Windows,则自行前往 官网 下载安装包安装即可

创建虚拟环境
从 Python 3.11 开始,Debian 和 Ubuntu 默认启用了 "Externally-Managed-Environment"(外部管理环境)保护机制,防止用户直接使用 pip 安装包到系统 Python 环境中,以避免破坏系统依赖。因此我们选择创建一个虚拟环境,每次使用之前只需要启动环境即可。
Windows 可直接运行 pip install uv
如果直接安装 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
gsuid_core














