搭建帮助-早柚核心

完整教程请以 早柚核心官方文档 为准，下面是照着走一遍就能用的流程。

说明

早柚核心（GsCore）本身不能独立使用，需要搭配 Bot 框架（本站用的是 TRSS / Yunzai）才能收发消息。

1.检查环境

✅ 确保安装 Python 环境

版本须 > 3.9，建议 >= 3.12，不建议 >= 3.14。

# 【命令行内输入】
python -V

# 【以下为回复示例、无需输入】
# 回复类似 Python 3.10.10 的信息，即为已经安装 python 环境
>>> Python 3.x.x

✅ 确保安装 git 环境

提醒

如果你没有安装 git 且系统是 ubuntu，安装 git 只需要输入 sudo apt-get install git

如果系统为 Windows，则自行前往 官网 下载安装包安装即可

# 【命令行内输入】(注意 v 为小写)
git -v

# 【以下为回复示例、无需输入】
# 回复类似 git version 2.38.1.windows.1 的信息，即为已经安装 Git 环境
>>> git version xxxxx

✅ 确保安装 uv 环境

poetry、pdm、uv 三选一即可，建议使用 uv。

# 【uv】
# 命令行内输入
uv -V

# 【以下为回复示例、无需输入】
# 回复类似 uv 0.5.18 的信息，即为已经安装 uv 环境
>>> uv 0.5.18 (27d1bad55 2025-01-11)

提醒

没有安装 uv 的话，输入 pip install uv 即可安装（poetry 同理：pip install poetry）

2.下载/克隆仓库

在 Bot目录 的上级（例如你的 bot 目录为 ./Wuyi/nb2，则 cd 至 ./Wuyi 处），输入安装 core 命令：

git clone https://github.com/Genshin-bots/gsuid_core.git --depth=1 --single-branch

进入文件夹内：

cd gsuid_core

3.安装依赖

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

4.启动 core

先移动到主路径（例如 E:\gsuid_core，也就是刚才 clone 出来的那个文件夹），再启动：

uv run core

启动成功后，浏览器访问 http://你的ip:8765/app 就是网页控制台，插件、配置项都在这里管理。

5.TRSS 连接早柚核心

TRSS（Yunzai）要连上早柚核心，需要装 ws-plugin：XasYer/ws-plugin（也可以走 Gitee 镜像）

装好后在群里（或私聊）用 ws 的命令添加连接：

1. 发送 #ws添加连接
2. 方式选择第三种
3. 连接地址填 你的ip:8765，命名随意

6.安装插件

core 启动后打开 http://你的ip:8765/app 控制台，在插件市场里搜索安装即可（如 GenshinUID、StarRailUID、MajsoulUID 等），装完按控制台提示重载，或者在群里发 #重启 生效。