各框架的官方网站

NapCat

https://napcat.napneko.icu/

AstrBot

https://astrbot.app/

早柚核心

https://docs.sayu-bot.com/

XutheringWavesUID

https://github.com/Loping151/XutheringWavesUID

RoverSign

https://github.com/Loping151/RoverSign

前期准备工作

Linux/Ubuntu设备、闲置QQ号

Linux环境检查

检查与安装Git

1
2
3
4
5
# 检查 Git 版本
git --version

# 如果显示 "command not found"，请执行安装命令：
sudo apt update && sudo apt install git -y

检查与安装Docker(可选)

1
2
# 检查 Docker 版本
docker --version

如果没有安装Docker，需要进行安装

1
2
3
# 更新索引并安装Ubuntu自带的docker包
sudo apt update
sudo apt install docker.io docker-compose-v2 -y

检查环境与Github.com的网络连通性

1
ping github.com

如果 ping通了,延迟在100-300ms左右均属正常，可以继续。
如果显示Time out或Name or service not known：说明你的服务器无法解析或连接到 GitHub，直接clone源码大概率会失败

鸣潮机器人框架主体部署

GsCore早柚核心框架部署

一键部署并启动容器

1
2
3
4
5
6
7
8
docker run -d \
  --name gsuid_core \
  --restart always \
  -p 8765:8765 \
  -v /opt/gscore_data:/gsuid_core/data \
  -v /opt/gscore_plugins:/gsuid_core/gsuid_core/plugins \
  -v gsuid_core_venv:/venv \
  docker.cnb.cool/gscore-mirror/gsuid_core:latest

如果你需要自定义 docker run 命令，可以参考下表修改对应参数：

参数功能说明备注
-d后台运行容器将在后台持续执行，不会占用当前终端窗口。
--name gsuid_core容器命名为容器指定一个名字，方便后续执行 docker stop 或 logs 命令。
-p 8765:8765端口映射宿主机端口:容器端口。映射后通过 IP:8765 访问后台。
-v /opt/gscore_data:/gsuid_core/data数据持久化极其重要！存放玩家账号和数据库，防止容器删除后数据丢失。
-v /opt/gscore_plugins:/gsuid_core/.../plugins插件挂载允许你在宿主机直接增删插件文件，无需进入容器内部。
-v gsuid_core_venv:/venv环境持久化使用命名卷存储 Python 虚拟环境，加快二次启动速度。
--add-host host.docker.internal:host-gateway映射宿主机 IP允许容器内部通过 host.docker.internal 访问宿主机上的服务。
-e http_proxy=...网络代理如果服务器在国内，设置此项可加速插件下载（需配合代理软件）。
-e UV_INDEX=...Python 镜像源可设置为阿里云或清华源，加速依赖包安装。

克隆源码并进入目录

1
2
git clone [https://cnb.cool/gscore-mirror/gsuid_core.git](https://cnb.cool/gscore-mirror/gsuid_core.git)
cd gsuid_core

启动构建

1
2
3
4
# 复制环境配置（可选）
cp .env.example .env
# 后台构建并启动
docker compose up -d --build

检查uv安装情况

1
uv -V

如果没有显示版本号，则需要下载

1
2
3
4
5
6
7
8
# 使用官方脚本一键安装
curl -LsSf https://astral.sh/uv/install.sh | sh

# 立即生效环境变量 (针对当前会话)
source $HOME/.cargo/env

# 验证安装是否成功
uv -V

克隆源码并进入目录

1
2
git clone [https://cnb.cool/gscore-mirror/gsuid_core.git](https://cnb.cool/gscore-mirror/gsuid_core.git)
cd gsuid_core

安装依赖

1
2
3
4
# uv安装依赖方式
uv python install 3.13
uv sync --python 3.13
uv run python -m ensurepip

启动

1
2
# 当前目录下
uv run core

安装XutheringWavesUID与配套的签到插件RoverSign

进入GsCore项目的根目录，进入gsuid_core文件夹，进入plugins文件夹

1
2
3
git clone https://github.com/Loping151/XutheringWavesUID.git

git clone https://github.com/Loping151/RoverSign.git

重启GsCore

配置网页控制台

开放端口号

GsCore默认运行在8765端口号，故而需要服务器配置中开放8765端口号

访问地址为：http://your-ip:8765/app

获取注册码

进入到早柚核心根目录，进入data文件夹，打开config.json文件，文件顶部在masters字段下填写你的QQ号，这是作为主人QQ

滑动到文件底部，可以看到REGISTER_CODE，复制它的值，这就是注册码，是注册网页控制台账户的唯一凭证

注册并进入网页控制台

这里可以解决99%的配置问题

在网页控制台Core核心配置中填写WebSocket Token，这是为安全性考虑

上游机器人框架部署

部署NapCat与AstrBot

1
2
3
4
mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
sudo docker compose -f astrbot.yml up -d

点击查看如何使用Linux部署AstrBot

点击查看如何使用Linux部署NapCat

配置AstrBot连接GsCore

  1. 准备好在GsCore控制台填写的WebSocket Token
  2. 进入AstrBot控制台，点击插件市场，搜索关键词gscore，点击安装，等待安装完成
    如果没有安装成功则使用镜像地址
  3. 进入AstrBot插件菜单，搜索关键词gscore，点击插件配置，填入连接Core的WsToken

验证连接情况与主人设置

在QQ中对机器人发送corestatus，如果成功返回图片，则代表当前用户为主人用户，且QQ已经正确连接到AstrBot
发送ww帮助,如果有帮助图片返回则证明插件运行成功，到此只剩下最后一步

向作者申请伤害计算token以及接入全排行token

总排行申请、反馈（仅限主人）：群号 387393347（需中转一次，因为被炸过群了）。如完全不使用QQ平台，可发邮件给客服小维 agent@loping151.com（记得写标题）申请计算服务token，要求附带具体使用平台、core信息截图和使用情况和规模说明，支持较少的请求量和用户量，但完全足以小范围使用，一般都欢迎入群。

  • 为什么需要申请总排行进行使用：

    为了确保不被上传大量伪造数据影响持有率、排行等，以及 https://ngabbs.com/read.php?tid=45654606

  • 总排行申请有无条件？

    待在群里，潜水不沙

  • 除了总排行，插件本体功能是否有其他内容需要申请：

    无。评分功能由于是独立的服务，与插件本体无关。为爱发电以及防剽窃成果被批控制欲强

控制台填写token完成后，发送ww下载全部资源

参考以及致谢