Python

服务器或本地部署鸣潮 QQ 机器人，实现签到与练度查询功能

准备工作 > 一台轻量级服务器/ 本地 windows/linux 能够在服务器/本地科学上网环境部署 > 笔者所演示的环境为阿里云服务器（2 核 CPU，2GB 内存，40GB 系统盘），操作系统为 Ubuntu 24.04。确保已成功安装 Python 环境（版本须 >3.8，建议 >=3.12，不建议 >=3.13）确保已成功安装 git 如果你没有安装 git 且的系统是 ubun…

栈溢出发布于 2026/4/6更新于 2026/7/2526K 浏览

准备工作

一台轻量级服务器/ 本地 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

uv run core

cd gsuid_core/plugins
# 安装 XutheringWavesUID
git clone https://github.com/Loping151/XutheringWavesUID.git

# 在 plugins 目录下安装库街区签到插件
git clone --depth=1 https://github.com/Loping151/RoverSign

cd opt/mcbot
# 激活虚拟环境
source mcvenv/bin/activate
# 安装 nb
pip install nb-cli-plugin-bootstrap nb-cli

cd onebot
nb plugin install nonebot-plugin-genshinuid

nb run