# Yunzai-Bot 指南 **Repository Path**: fenglinit/Yunzai-Bot-guide ## Basic Information - **Project Name**: Yunzai-Bot 指南 - **Description**: 教你如何安装和使用云崽 - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 60 - **Forks**: 9 - **Created**: 2023-07-30 - **Last Updated**: 2025-07-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Yunzai-Bot指南 # 公告 # 玩云崽死路一条! ## 简介 [![](https://qijieya.cn/logo.png)]() - Yunzai-Bot是原神qq群机器人,通过米游社接口,查询原神游戏信息,快速生成图片返回, - 此指南是教您如何安装Yunzai-Bot和它的插件,编写插件和一些问题的解决方法。 - **注意:此教程主要以喵崽(Miao-Yunzai)为主,如果您使用的是其他崽,该文档只提供参考** ## 目录 - Yunzai-Bot的安装教程 - [安装git](#安装git) - [安装redis](#安装redis) - [安装Yunzai-Bot本体](#安装Yunzai-Bot本体) - [Yunzai-Bot的Linux安装教程](#linux) - [Ubuntu通用教程](./Linux.md#ubuntu-通用版本教程) - [Ubuntu20.04教程(基于宝塔)](./Linux.md#ubuntu-2004教程采用宝塔) - [CentOS 7.9.2111](./Linux.md#centos-792111教程) - [TRSS脚本的安装教程](#安装trss脚本) - [基础操作](#基础操作) - [目录说明](#目录说明) - [问题解答](#问题解答) - [yunzai-bot插件编写教学](#yunzai-bot插件编写教学) - [插件安装教程](#插件安装教程) - [锅巴插件(Guoba-Plugin)](plugins.md#%E9%94%85%E5%B7%B4%E6%8F%92%E4%BB%B6) - [喵喵插件 (miao-plugin)](plugins.md#%E5%96%B5%E5%96%B5%E6%8F%92%E4%BB%B6-miao-plugin) - [抽卡插件 (flower-plugin)](plugins.md#%E6%8A%BD%E5%8D%A1%E6%8F%92%E4%BB%B6-flower-plugin) - [py插件](plugins.md#py插件) - [单个js格式插件通用安装方法](plugins.md#%E5%8D%95%E4%B8%AAjs%E6%A0%BC%E5%BC%8F%E6%8F%92%E4%BB%B6%E9%80%9A%E7%94%A8%E5%AE%89%E8%A3%85%E6%96%B9%E6%B3%95) - [签名api](#签名api) - 使用公共签名api(为避免不必要的争端,本文不提供公共API链接,请自行寻找) - [自建签名api教程教程](#自建签名api教程教程) - [ffmpeg安装教程](#ffmpeg安装教程) - [如何在windows获取ticket](#如何在windows获取ticket) - [常用链接](#常用链接) ## 安装Yunzai-Bot ### 安装redis - 下载地址[redis](https://wwrl.lanzouw.com/iml4v0xwo0za),密码:114514 - 解压后启动redis-server.exe这个文件。 - 要一直开着,不能关掉。(不要叉掉窗口) ### 安装Nodejs #### Node.js 安装配置 本章节我们将向大家介绍在 Windows 和 Linux 上安装 Node.js 的方法。 本安装教程以 Node.js v4.4.3 LTS(长期支持版本)版本为例。 Node.js 安装包及源码下载地址为:[https://nodejs.org/en/download](https://nodejs.org/en/download)。 ![nodejs_download](https://www.runoob.com/wp-content/uploads/2014/03/download-page.jpg) 你可以根据不同平台系统选择你需要的 Node.js 安装包。 Node.js 历史版本下载地址:[https://nodejs.org/dist/](https://nodejs.org/dist/) **注意:**Linux 上安装 Node.js 需要安装 Python 2.6 或 2.7 ,不建议安装 Python 3.0 以上版本。 --- #### Windows 上安装 Node.js 你可以采用以下两种方式来安装。 ### 1、Windows 安装包(.msi) ![](https://www.runoob.com/wp-content/uploads/2014/03/4530AA77-2208-47FA-A900-91C93AEC95AF.jpg) 本文实例以 v0.10.26 版本为例,其他版本类似, 安装步骤: 步骤 1 : 双击下载后的安装包 **v0.10.26**,如下所示: ![install-node-msi-version-on-windows-step1](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step1.png) 步骤 2 : 点击以上的Run(运行),将出现如下界面: ![install-node-msi-version-on-windows-step2](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step2.png) 步骤 3 : 勾选接受协议选项,点击 next(下一步) 按钮 : ![install-node-msi-version-on-windows-step3](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step3.png) 步骤 4 : Node.js默认安装目录为 "C:\Program Files\nodejs\" , 你可以修改目录,并点击 next(下一步): ![install-node-msi-version-on-windows-step4](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step4.png) 步骤 5 : 点击树形图标来选择你需要的安装模式 , 然后点击下一步 next(下一步) ![install-node-msi-version-on-windows-step5](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step5.png) 步骤 6 :点击 Install(安装) 开始安装Node.js。你也可以点击 Back(返回)来修改先前的配置。 然后并点击 next(下一步): ![install-node-msi-version-on-windows-step6](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step6.png) 安装过程: ![install-node-msi-version-on-windows-step7](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step7.png) 点击 Finish(完成)按钮退出安装向导。 ![install-node-msi-version-on-windows-step8](https://www.runoob.com/wp-content/uploads/2014/03/install-node-msi-version-on-windows-step8.png) 检测PATH环境变量是否配置了Node.js,点击开始=》运行=》输入"cmd" => 输入命令"path",输出如下结果: PATH=C:\oraclexe\app\oracle\product\10.2.0\server\bin;C:\Windows\system32; C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\; c:\python32\python;C:\MinGW\bin;C:\Program Files\GTK2-Runtime\lib; C:\Program Files\MySQL\MySQL Server 5.5\bin;C:\Program Files\nodejs\; C:\Users\rg\AppData\Roaming\npm 我们可以看到环境变量中已经包含了C:\Program Files\nodejs\ 检查Node.js版本 ![node-version-test](https://www.runoob.com/wp-content/uploads/2014/03/node-version-test.png) ### 2、Windows 二进制文件 (.exe)安装 32 位安装包下载地址 : [http://nodejs.org/dist/v0.10.26/node.exe](http://nodejs.org/dist/v0.10.26/node.exe) 64 位安装包下载地址 : [http://nodejs.org/dist/v0.10.26/x64/node.exe](http://nodejs.org/dist/v0.10.26/x64/node.exe) **安装步骤** 步骤 1 : 双击下载的安装包 Node.exe ,将出现如下界面 : ![install-node-exe-on-windows-step1](https://www.runoob.com/wp-content/uploads/2014/03/install-node-exe-on-windows-step1.png) 点击 Run(运行)按钮将出现命令行窗口: ![install-node-exe-on-windows-step21](https://www.runoob.com/wp-content/uploads/2014/03/install-node-exe-on-windows-step21.png) ### 版本测试 进入 node.exe 所在的目录,如下所示: ![node-version](https://www.runoob.com/wp-content/uploads/2014/03/node-version.png) 如果你获得以上输出结果,说明你已经成功安装了Node.js。 --- #### Linux 上安装 Node.js ### 直接使用已编译好的包 Node 官网已经把 linux 下载版本更改为已编译好的版本了,我们可以直接下载解压后使用: ```sh wget https://nodejs.org/dist/v10.9.0/node-v10.9.0-linux-x64.tar.xz // 下载 # tar xf node-v10.9.0-linux-x64.tar.xz // 解压 # cd node-v10.9.0-linux-x64/ // 进入解压目录 # ./bin/node -v // 执行node命令 查看版本 v10.9.0 ``` 解压文件的 bin 目录底下包含了 node、npm 等命令,我们可以使用 ln 命令来设置软连接: ```sh ln -s /usr/software/nodejs/bin/npm /usr/local/bin/ ln -s /usr/software/nodejs/bin/node /usr/local/bin/ ``` ### Ubuntu 源码安装 Node.js 以下部分我们将介绍在 Ubuntu Linux 下使用源码安装 Node.js 。 其他的 Linux 系统,如 Centos 等类似如下安装步骤。 在 Github 上获取 Node.js 源码: $ sudo git clone https://github.com/nodejs/node.git Cloning into 'node'... 修改目录权限: $ sudo chmod -R 755 node 使用 **./configure** 创建编译文件,并按照: $ cd node $ sudo ./configure $ sudo make $ sudo make install 查看 node 版本: $ node --version v0.10.25 ### Ubuntu apt-get 命令安装 命令格式如下: sudo apt-get install nodejs sudo apt-get install npm ### CentOS 下源码安装 Node.js 1、下载源码,你需要在[https://nodejs.org/en/download/](https://nodejs.org/en/download/)下载最新的Nodejs版本,本文以v0.10.24为例: cd /usr/local/src/ wget http://nodejs.org/dist/v0.10.24/node-v0.10.24.tar.gz 2、解压源码 tar zxvf node-v0.10.24.tar.gz 3、 编译安装 cd node-v0.10.24 ./configure --prefix=/usr/local/node/0.10.24 make make install 4、 配置NODE_HOME,进入profile编辑环境变量 vim /etc/profile 设置 nodejs 环境变量,在 _**export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL**_ 一行的上面添加如下内容: #set for nodejs export NODE_HOME=/usr/local/node/0.10.24 export PATH=$NODE_HOME/bin:$PATH :wq保存并退出,编译/etc/profile 使配置生效 source /etc/profile 验证是否安装配置成功 node -v 输出 v0.10.24 表示配置成功 npm模块安装路径 /usr/local/node/0.10.24/lib/node_modules/ **注:**Nodejs 官网提供了编译好的 Linux 二进制包,你也可以下载下来直接应用。 --- #### Mac OS 上安装 你可以通过以下两种方式在 Mac OS 上来安装 node: - 1、在[官方下载网站](https://nodejs.org/en/download/)下载 pkg 安装包,直接点击安装即可。 - 2、使用 brew 命令来安装: brew install node - 学不会怎么办~~V我50我手把手教你~~ - 环境准备:[Node.js](http://nodejs.cn/download/),[redis](https://wwrl.lanzouw.com/iml4v0xwo0za),[git](https://wwrl.lanzouw.com/iBjDY0hizgre) ### 安装git #### Git 安装配置 在使用Git前我们需要先安装 Git。Git 目前支持 Linux/Unix、Solaris、Mac和 Windows 平台上运行。 Git 各平台安装包下载地址为:[http://git-scm.com/downloads](http://git-scm.com/downloads) --- ##### Linux 平台上安装 Git 的工作需要调用 curl,zlib,openssl,expat,libiconv 等库的代码,所以需要先安装这些依赖工具。 在有 yum 的系统上(比如 Fedora)或者有 apt-get 的系统上(比如 Debian 体系),可以用下面的命令安装: 各 Linux 系统可以使用其安装包管理工具(apt-get、yum 等)进行安装: ###### Debian/Ubuntu Debian/Ubuntu Git 安装命令为: $ apt-get install libcurl4-gnutls-dev libexpat1-dev gettext \ libz-dev libssl-dev $ apt-get install git $ git --version git version 1.8.1.2 ###### Centos/RedHat 如果你使用的系统是 Centos/RedHat 安装命令为: $ yum install curl-devel expat-devel gettext-devel \ openssl-devel zlib-devel $ yum -y install git-core $ git --version git version 1.7.1 ###### 源码安装 我们也可以在官网下载源码包来安装,最新源码包下载地址:[https://git-scm.com/download](https://git-scm.com/download) 安装指定系统的依赖包: ########## Centos/RedHat ########## $ yum install curl-devel expat-devel gettext-devel \ openssl-devel zlib-devel ########## Debian/Ubuntu ########## $ apt-get install libcurl4-gnutls-dev libexpat1-dev gettext \ libz-dev libssl-dev 解压安装下载的源码包: $ tar -zxf git-1.7.2.2.tar.gz $ cd git-1.7.2.2 $ make prefix=/usr/local all $ sudo make prefix=/usr/local install --- ##### Windows 平台上安装 在 Windows 平台上安装 Git 同样轻松,有个叫做 msysGit 的项目提供了安装包,可以到 GitHub 的页面上下载 exe 安装文件并运行: 安装包下载地址:[https://gitforwindows.org/](https://gitforwindows.org/) 官网慢,可以用国内的镜像:[https://npm.taobao.org/mirrors/git-for-windows/](https://npm.taobao.org/mirrors/git-for-windows/)。 ![](https://www.runoob.com/wp-content/uploads/2015/02/20140127131250906) 完成安装之后,就可以使用命令行的 git 工具(已经自带了 ssh 客户端)了,另外还有一个图形界面的 Git 项目管理工具。 在开始菜单里找到"Git"->"Git Bash",会弹出 Git 命令窗口,你可以在该窗口进行 Git 操作。 --- ##### Mac 平台上安装 在 Mac 平台上安装 Git 最容易的当属使用图形化的 Git 安装工具,下载地址为: [http://sourceforge.net/projects/git-osx-installer/](http://sourceforge.net/projects/git-osx-installer/) 安装界面如下所示: ![18333fig0107-tn](https://www.runoob.com/wp-content/uploads/2015/02/18333fig0107-tn.png) #### 安装Miao-Yunzai本体 1. 新建一个文件夹(也可以不建),命名随便,最好别用中文(**可省略**) 2. 选个拉取方式: **使用git-bash** - 1.1 右键文件夹,选择git bash here **使用原生自带终端** - 2.1 进入你要安装Yunzai的文件夹 - 2.2 打开终端(在文件夹路径处将文件夹路径改为cmd或者powershell) 3. 克隆项目 - 命令 建议使用喵崽 ```sh git clone --depth=1 https://gitee.com/yoimiya-kokomi/Miao-Yunzai.git ``` 4. 进入Yunzai-Bot/Miao-Yunzai目录 - 使用 ```sh cd Miao-Yunzai ``` 5. 安装[喵喵插件 (miao-plugin)](plugins.md#%E5%96%B5%E5%96%B5%E6%8F%92%E4%BB%B6-miao-plugin) 先安装pnpm,已安装的可以跳过 ```sh npm install pnpm -g ``` - (因为我已经安装过了,所以就不放图了) - 这里会发生的一些问题: 输完卡住不动了怎么办?或者提示 `npm ERR!`?或者其他的报错? 原因:你的服务器网络太差了,根本下载不动,没问题才怪了。 解决方案:换源,执行命令来更换淘宝镜像源 ` npm config set registry https://registry.npmmirror.com` 然后再次执行安装 pnpm 的命令 `npm install pnpm -g` - 还有可能是你的nodejs版本太高,请使用`node -v` 查看您的nodejs版本.(建议版本v16.16.0) - 执行该命令安装喵喵插件 ``` git clone --depth=1 https://gitee.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin/ pnpm install -P ``` ​ 安装依赖 ```sh pnpm install -P ``` 8. 运行(首次运行按提示输入登录)(需要先开启Redis-server) ```sh node app ``` - 如果觉得启动麻烦,可使用脚本启动: >新建一个文件,把后缀改成bat,然后点击编辑 - 把下面代码复制进去,然后进行修改: - 第一行中,第一个双引号无需填写,第二个双引号填写你redis路径 - 第二行填写你Yunzai-Bot根目录 ```bat start "" "redis-server.exe路径" cd 机器人路径 node app pause ``` - 改完后保存运行即可食用 9. 安装[签名api](#签名api) - 点击上面链接查看安装教程 ### Linux - 教程中的操作系统有(Ubuntu 20.04),(CentOS 7.9.2111) - [Linux安装教程](./Linux.md) ##### 另:如果因为无法登录等问题需要换TRSS-Yunzai,只需要在Yunzai根目录输入 ``` node trss ``` 即可! ## 安装TRSS脚本 - 此教程由热心网友提供,不提供任何的帮助。 ### Windows平台:
MSYS2:Linux 兼容层(关闭 虚拟化 或 内存小于等于4G 推荐) #### MSYS2 安装 - [MSYS2官网](https://msys2.org/) - [MSYS2 安装程序](https://github.com/msys2/msys2-installer/releases/download/nightly-x86_64/msys2-x86_64-latest.exe) _PS:若速度太慢,可使用 GitHub 加速,如:[GitHub Proxy](https://ghproxy.com/github.com/msys2/msys2-installer/releases/download/nightly-x86_64/msys2-x86_64-latest.exe)_ #### 安装脚本 _PS: 首次安装可能会自动关闭,再次启动即可_ _PS: 以下内容复制至[TRSS.me](https://trss.me/Install/MSYS2.html#msys2-%E5%AE%89%E8%A3%85)_ - 在`MSYS2`内执行: ``` bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install-MSYS2.sh) ```
自定义功能 - 自定义 安装路径 `DIR` 和 启动命令 `CMD`(可用于多开) - 举例:将脚本安装至 `/Bot` 启动命令 `trss` ``` # 原安装命令 bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install-MSYS2.sh) # 修改后安装命令 DIR=/Bot CMD=trss bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install-MSYS2.sh) ```
ArchWSL:Linux 子系统(开启 虚拟化 且 内存大于等于8G 推荐) **系统要求** - Windows 11 及以上 / Windows Server 2022及以上 - 升级为WSL2的要求: 对于x64的系统要求win10版本为1903 或者更高, 可使用 Win + R 输入`winver`查看版本 #### 安装ArchLinux 1. 右键开始菜单, 选择`终端(管理员)`并执行以下内容: ``` # 启用 适用于 Linux 的 Windows 子系统 dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用 虚拟机平台 dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart ``` 2. 重启设备后,启用 WSL2 ``` wsl --set-default-version 2 ``` **输出以下内容则表示 WSL2 启用成功** ``` 有关与 WSL 2 的主要区别的信息,请访问 https://aka.ms/wsl2 操作成功完成。 ``` 3. 更新 WSL2 内核 ``` wsl --update ``` _PS: 如果速度太慢,可手动下载更新包: [https://aka.ms/wsl2kernel](https://aka.ms/wsl2kernel) 4. 从[ArchWSL GitHub Releases Assets](https://github.com/yuk7/ArchWSL/releases/latest)中下载`Arch.zip`并解压 _PS: 如果速度太慢可使用Github加速,如: [Github Proxy](https://ghproxy.com/)_ 5. 启动`Arch.exe` _PS: 如果输出以下内容则表示ArchWSL安装成功_ ``` Using: xxx\rootfs.tar.gz Installing... Installation complete Press enter to continue... ``` 6. 在`文件资源管理器`中打开(`Win + R`运行): ``` \\wsl$\Arch\etc\pacman.d ``` - 编辑`mirrorlist`,在`China`后选择你喜欢的镜像源,删除开头的`#`, 保存 ``` \\wsl$\Arch\etc ``` - 编辑`pacman.conf`,在文件末尾添加以下内容并保存: ``` [archlinuxcn] Server = https://mirrors.ustc.edu.cn/archlinuxcn/$arch Server = https://mirrors.bfsu.edu.cn/archlinuxcn/$arch Server = https://mirrors.tuna.tsinghua.edu.cn/archlinuxcn/$arch Server = https://mirrors.aliyun.com/archlinuxcn/$arch Server = https://mirrors.163.com/archlinux-cn/$arch Server = https://mirrors.tencent.com/archlinuxcn/$arch Server = https://repo.archlinuxcn.org/$arch SigLevel = Never [arch4edu] Server = https://mirrors.bfsu.edu.cn/arch4edu/$arch Server = https://mirrors.tuna.tsinghua.edu.cn/arch4edu/$arch Server = https://mirrors.aliyun.com/arch4edu/$arch Server = https://mirrors.tencent.com/arch4edu/$arch SigLevel = Never ``` 7. 启动`Arch.exe` _PS: 如果输出以下内容则表示`ArchWSL`启动成功: ``` [root@xxx Arch]# ``` 8. 更改软件包 ``` pacman -Syy archlinux-keyring && pacman -Syu ``` - 启动:运行 Arch.exe 或终端输入 wsl - 文件管理: 在`文件资源管理器`中打开(`Win + R`运行): ``` \\wsl$\Arch\root ``` - 卸载: `wsl --unregister Arch` _PS: 其他功能请参阅 [Microsoft 官方文档](https://learn.microsoft.com/zh-cn/windows/wsl) 和 [ArchWSL 文档](https://github.com/yuk7/ArchWSL/blob/master/i18n/README_zh-cn.md)_ #### 安装脚本 _PS:以下内容复制至[TRSS.me](https://trss.me/Install/Arch_Linux.html)_ - 在ArchLinux里执行: ``` bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install.sh) ```
自定义功能 - 自定义 安装路径 `DIR` 和 启动命令 `CMD`(可用于多开) - 举例:将脚本安装至 `/Bot` 启动命令 `trss` ``` # 原安装命令 bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install.sh) # 修改后安装命令 DIR=/Bot CMD=trss bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install.sh) ```
### Linux平台:
Docker:应用容器(推荐) _PS:以下内容复制至[TRSS.me](https://trss.me/Install/Docker.html)_ #### 安装脚本 - 在Linux中执行: ``` bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install-Docker.sh) ```
自定义功能 - 自定义 安装路径`DIR`启动命令`CMD`容器名`DKNAME` - 举例:将脚本安装至 `/Bot` 启动命令 `trss` 容器名`TRSS` ``` # 原安装命令 bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install-Docker.sh) # 修改后安装命令 DIR=/Bot CMD=trss bash <(curl -L gitee.com/TimeRainStarSky/TRSS_Yunzai/raw/main/Install-Docker.sh) ```
容器管理
查看容器 ``` docker ps -as ```
启动容器 ``` docker start 容器名 # 默认开机自启,无需手动启动 ```
重启容器 ``` docker restart -t0 容器名 ```
停止容器 ``` docker stop -t0 容器名 ```
删除容器 ``` docker rm -f 容器名 ```
重建容器 ``` docker run -itd -h 主机名 --name 容器名 -v 数据路径:/root/项目名 --restart always #自启动 -p 主机端口:容器端口 #端口映射 镜像名 ```
- 服务器 Linux 发行版 推荐使用 `Debian 11` 以上 - 若只有 `Debian 10` 以下,可执行以下命令并重启服务器后升级到 `Debian 12` ``` echo 'deb http://ftp.cn.debian.org/debian bookworm main contrib non-free deb http://ftp.cn.debian.org/debian bookworm-updates main contrib non-free deb http://ftp.cn.debian.org/debian-security bookworm-security main contrib non-free'>/etc/apt/sources.list apt update && apt full-upgrade -y && apt autoremove --purge -y && apt clean ```
## 基础操作 - 启动云崽: `node app` - 查看日志: `pnpm run log` - 后台运行: `pnpm start` - 关闭云崽: 对着机器人发送 `#关机`,或者在关掉云崽运行窗口,后台运行输入`pnpm stop`关闭云崽 - 功能列表: `#帮助`,`#插件名称+帮助` - 更新云崽: `#全部更新`,`#强制更新`,`#更新`,`git pull` - 重置云崽的部分设置(QQ 号,主人 QQ 等): `pnpm run login` ## 目录说明 | 目录 | 说明 | | ------------------------ | ------------------------------ | | config\config\qq.yaml | 可以修改登录方式,QQ 号 | | config\config\redis.yaml | redis的设置(非必要别修改) | | config\config\other.yaml | 可以修改主人 QQ | | data\face | 存放添加表情的位置 | | data\MysCookie | 存放 cookie 的位置 | | logs\ | 存放日志文件的位置 | | plugins\example | 存放 js 插件的位置 | | Yunzai-Bot\plugins | 存放大型插件的位置,如喵喵插件 | ## 问题解答 - [问题解答](./issue.md) ## Yunzai-Bot插件编写教学 - [Yunzai-Bot插件编写教学](plugins.md#yunzai-bot%E6%8F%92%E4%BB%B6%E7%BC%96%E5%86%99%E6%95%99%E5%AD%A6) ## 插件安装教程 - [插件安装教程](./plugins.md#%E6%8F%92%E4%BB%B6%E5%AE%89%E8%A3%85%E6%95%99%E7%A8%8B) ## 签名API ### 自建签名api教程教程 #### Windows - 第一步:下载 - [下载](https://www.123pan.com/s/7JaiVv-o5ZQA.html)并解压文件,密码:0000 - 第二步:安装jdk - 双击本文件夹下的jdk安装包安装Java环境 - 第三步:启动 - 双击启动start.bat - 第四步:更新 - 将icqq更新最新版 ```bash pnpm up icqq ``` - 将喵崽更新到最新版本 ```bash git pull ``` - 第五步:配置 - 更改喵崽配置文件(具体路径为Miao-Yunzai/config/config/bot.yaml) - 打开bot.yaml文件并修改: ```yaml sign_api_addr: http://127.0.0.1:8080/sign?key=114514 ver: ``` 打开qq.yaml文件修改: ```yaml platform: 2 ``` - 最后,愉快地登录喵崽,开始愉快的玩耍 - 如果上述步骤没看懂,我只能劝你放弃…… #### Linux - 安装 参考 [unidbg-fetch-qsign-shell](https://github.com/CikeyQi/unidbg-fetch-qsign-shell) - 更新 - 将icqq更新到最新 ```bash pnpm up icqq ``` - 将喵崽更新到最新版本 ```bash git pull ``` - 配置 - 更改喵崽配置文件(具体路径为Miao-Yunzai/config/config/bot.yaml) - 打开bot.yaml文件并修改: ```yaml sign_api_addr: http://0.0.0.0:8080/sign?key=114514 ``` 打开qq.yaml文件修改: ```yaml platform: 2 ``` - 最后,愉快地登录喵崽,开始愉快的玩耍 - 如果上述步骤没看懂,我只能劝你放弃…… ## 获取ticket ### 如何在Windows获取ticket - 浏览器:Edge - 复制滑动验证链接,到浏览器打开 - 按**F12**打开控制台,选择**网络** - 然后开始验证,验证完后找到下图圈的那个东西,单击 选择**预览**,复制**ticket** **(注意:复制ticket时不要把两边的双引号复制进去)** - 最后返回终端,粘贴刚刚复制的**ticket**,并回车 ### 如何在安卓获取ticket - 应用:滑动验证助手[(点击下载)](https://wwd.lanzoul.com/i1WYn1owugnc) - 复制滑动验证链接或请求码,打开**滑动验证助手APP** - 输入滑动验证链接或请求码,点击下一步 - 手动通过验证,复制**ticket** - 最后返回终端,粘贴刚刚复制的**ticket**,并回车 ## ffmpeg安装教程 1. 先下载压缩包 - ffmpeg下载链接[☞ffmpeg](https://wwrl.lanzouw.com/iK7uS0ixl0fi),密码114514 2. 下载完后解压,位置随便(路径中不能有空格!最好也不要有中文) 3. 之后找到ffmpeg.exe和ffprobe.exe,复制文件路径 4. 填写路径,有两种方法。 **直接修改配置文件** - 找到配置文件,如下图 - 最后把路径粘贴到下图的位置(注意:冒号后面有空格) > 冒号后面是有空格,一定要注意这一点。 > **锅巴里面设置** 1. 先登陆锅巴 2. 然后点配置管理-->基础配置 3. 把路径粘贴进去 4. 最后点保存 >注意事项: >路径不能有空格和中文!!!,必须用单引号,必须用反斜杠。 >有些时候日志提示 `请检查ffmpeg配置` 大概率是插件本身的问题,而不是你的 ffmpeg 没配置好 ## 常用链接 >下载链接(均为网盘)有密码的均为114514 | 名称 | 下载地址 | | ------ | ---------------------------------------------------- | | ffmpeg | [☞ffmpeg](https://wwrl.lanzouw.com/iK7uS0ixl0fi) | | 滑块验证助手 | [☞滑块验证](https://maupdate.rainchan.win/txcaptcha.apk) | ## 常用地址 | 名称 | 作者 | GitHub | Gitee | 备注 | | | --------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | --- | | Yunzai-Bot 索引库 | [@渔火Arcadia](https://gitee.com/yhArcadia) | [☞GitHub](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FyhArcadia%2FYunzai-Bot-plugins-index) | [☞Gitee](https://gitee.com/yhArcadia/Yunzai-Bot-plugins-index) | 云崽相关内容索引库 | | | Miao-Yunzai | [@喵喵](https://gitee.com/yoimiya-kokomi) | [☞GitHub](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2Fyoimiya-kokomi%2FMiao-Yunzai) | [☞Gitee](https://gitee.com/yoimiya-kokomi/Miao-Yunzai) | 喵版 Yunzai | | | TRSS-Yunzai | [@时雨🌌星空](https://gitee.com/TimeRainStarSky) | [☞GitHub](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FTimeRainStarSky%2FYunzai) | [☞Gitee](https://gitee.com/TimeRainStarSky/Yunzai) | Yunzai 应用端,支持多账号,支持协议端:go-cqhttp、ComWeChat、GSUIDCore、ICQQ、QQBot、QQ频道、微信、KOOK、Telegram、Discord、OPQBot | | | Yunzai-Bot | [@Le-niao](https://gitee.com/Le-niao) | [☞GitHub](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FLe-niao%2FYunzai-Bot) | [☞Gitee](https://gitee.com/Le-niao/Yunzai-Bot) | 原版 Yunzai | | | Yunzai-Bot | [@喵喵](https://gitee.com/yoimiya-kokomi) | [☞GitHub](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2Fyoimiya-kokomi%2FYunzai-Bot) | [☞Gitee](https://gitee.com/yoimiya-kokomi/Yunzai-Bot) | 喵喵维护版 Yunzai | | | Yunzai-Bot-lite | [@听语惊花](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FNwflower) | [☞GitHub](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FNwflower%2Fyunzai-bot-lite) | [☞Gitee](https://gitee.com/Nwflower/yunzai-bot-lite) | 轻量版,无原神功能 | | ## 常用目录结构 | 目录 | 说明 | | ------------------------ | --------------- | | config\config\qq.yaml | 可以修改登录方式,QQ 号 | | config\config\other.yaml | 可以修改主人 QQ | | data\face | 存放添加表情的位置 | | data\data\MysCookie | 存放 cookie 的位置 | | plugins\example | 存放 js 插件的位置 | | lugins | 存放大型插件的位置,如喵喵插件 |