准备工作
需要一台轻量级服务器或本地 Windows/Linux 环境,并确保网络环境支持访问 GitHub。
环境部署
示例环境为阿里云服务器(2 核 CPU,2GB 内存,40GB 系统盘),操作系统为 Ubuntu 24.04。
详述了在 Linux 或 Windows 服务器上部署鸣潮 QQ 机器人的完整流程。内容包括搭建 Python 虚拟环境、安装 Git 与 uv 工具、部署 GsCore 核心程序、添加鸣潮插件及签到插件。此外,还介绍了如何配置 NoneBot 框架、设置防火墙端口以及接入大语言模型,从而实现游戏内签到、练度查询及攻略查询等自动化功能。
需要一台轻量级服务器或本地 Windows/Linux 环境,并确保网络环境支持访问 GitHub。
示例环境为阿里云服务器(2 核 CPU,2GB 内存,40GB 系统盘),操作系统为 Ubuntu 24.04。
确保已成功安装 Python 环境(版本须 >3.8,建议 >=3.12,不建议 >=3.13)。
确保已成功安装 Git。
如果系统为 Ubuntu 且未安装 Git,可输入命令安装;如果系统为 Windows,请前往官网下载安装包安装即可。
从 Python 3.11 开始,Debian 和 Ubuntu 默认启用了 "Externally-Managed-Environment" 保护机制。因此我们选择创建一个虚拟环境,每次使用之前只需要启动环境即可。
Windows 可直接运行 pip install uv。
退出虚拟环境的命令为 deactivate。
# 激活虚拟环境
source mcvenv/bin/activate
# 在虚拟环境安装 uv
pip install uv
进入 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;如在本地部署请忽略。
按 Ctrl+X 退出并保存,回车确认。
由于 GsCore 运行在 8765 端口,我们需要在服务器的防火墙处添加对应的规则。
进入插件目录,安装 XWUID:
cd gsuid_core/plugins
git clone https://github.com/Loping151/XutheringWavesUID.git
# 在 plugins 目录下安装库街区签到插件
git clone --depth=1 https://github.com/Loping151/RoverSign
可以看到刚刚安装的插件成功导入了。
另外创建一个会话窗口,进入 mcbot 目录,运行虚拟环境,安装 nonebot:
cd opt/mcbot
# 激活虚拟环境
source mcvenv/bin/activate
# 安装 nb-cli
pip install nb-cli-plugin-bootstrap nb-cli
运行 nb bs,将文件夹命名为 onebot,空格选中,回车确定。
配置图如下。
进入 onebot 目录,连接早柚插件,需确保网络通畅:
cd onebot
nb plugin install nonebot-plugin-genshinuid
运行 onebot:
nb run
配置防火墙端口 8080。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online