跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表

目录

  1. 准备工作
  2. 环境部署
  3. 创建虚拟环境
  4. 安装虚拟环境包
  5. 激活虚拟环境并安装 uv
  6. 激活虚拟环境
  7. 在虚拟环境安装 uv
  8. 安装插件
  9. 安装 GsCore
  10. 运行 GsCore
  11. 配置服务器端口 8765
  12. 安装 XutheringWavesUID 鸣潮插件
  13. 安装库街区签到插件
  14. 在 plugins 目录下安装库街区签到插件
  15. 重启早柚插件
  16. 安装 nonebot
PythonAI

鸣潮 QQ 机器人部署指南:GsCore 核心与 NoneBot 插件配置

介绍在 Linux/Windows 环境下部署鸣潮 QQ 机器人的步骤。首先准备 Python 3.8+ 环境及 Git,创建虚拟环境并安装 uv。接着克隆 GsCore 核心及鸣潮插件(XutheringWavesUID、RoverSign),配置端口 8765。随后使用 NoneBot 初始化项目,安装相关插件并连接 GsCore,最后开放防火墙端口 8080 完成部署。

日志猎手发布于 2026/4/5更新于 2026/4/198 浏览

准备工作

准备一台 Linux/Windows 服务器或本地环境,确保网络可访问 GitHub。

环境部署

示例环境:Ubuntu 24.04,2 核 CPU,2GB 内存,40GB 系统盘。

确保已安装 Python 环境(版本须 >3.8,建议 >=3.12,不建议 >=3.13)。 确保已安装 Git。

如果系统为 Ubuntu,安装 Git 命令如下:

sudo apt update && sudo apt install git -y

如果系统为 Windows,请前往官网下载安装包安装。

创建虚拟环境

从 Python 3.11 开始,Debian 和 Ubuntu 默认启用了 "Externally-Managed-Environment" 保护机制。因此我们选择创建一个虚拟环境。

Windows 可直接运行 pip install 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
cd gsuid_core

运行 GsCore

uv run core

忽略启动警告。

如在服务器上部署,请按照说明修改 config.json 中的 host 为 0.0.0.0;如在本地部署请忽略。 编辑保存配置文件。

配置服务器端口 8765

由于 GsCore 运行在 8765 端口,需要在服务器的防火墙处添加对应的规则。

安装 XutheringWavesUID 鸣潮插件

进入插件目录,安装 XWUID:

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

安装库街区签到插件

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

重启早柚插件

确认插件导入成功。

安装 nonebot

新建终端窗口,进入 mcbot 目录,运行虚拟环境,安装 nonebot:

cd opt/mcbot
source mcvenv/bin/activate
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

更多推荐文章

查看全部
  • 基于Spring Boot的微信小程序二手物品租赁系统设计与实现
  • 基于 Spring Boot 4.0 + Java 21 + Spring AI 2.0 的智能面试辅助平台
  • Node-RED 快速搭建智能家居自动化系统
  • Rokid JSAR 基于 Web 技术栈的 AR 开发环境搭建与 3D 时钟实战
  • Web 虚拟卡销售店铺实现方案
  • MogFace 人脸检测模型 WebUI GPU 方案:单卡并发处理 20 路实时流人脸检测
  • 位运算基础与经典算法题解析
  • Docker 部署 MySQL 8.0 命令详解与参数说明
  • 使用 Bright Data Web Scraper API 配合 Python 抓取 Glassdoor 数据
  • C++ 内存管理解析:现代视角下的核心机制与实践
  • Java 全栈开发面试实录:从基础到微服务实战
  • Linux 系统 Git 安装与基础配置指南
  • Neo4j 插件 APOC 安装及配置指南
  • 基于 Unity 2022 LTS 与 UXR 3.0 SDK 开发 Rokid AR 消消乐游戏
  • Windows 上 Docker Desktop 安装、汉化及 WSL 更新失败解决方案
  • Python+Django 微信小程序个人运动健康饮食指导管理平台设计与实现
  • C++与Rust数据交互与内存安全传递技术
  • C++ 结构体基础:定义、成员函数与排序
  • Flutter 三方库 xpath_selector 的鸿蒙适配与 HTML 解析实战
  • Vue3 前端开发常用 20 道面试题及代码解析

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online