# 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指南
# 公告
# 玩云崽死路一条!
## 简介
[]()
- 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)。

你可以根据不同平台系统选择你需要的 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)

本文实例以 v0.10.26 版本为例,其他版本类似, 安装步骤:
步骤 1 : 双击下载后的安装包 **v0.10.26**,如下所示:

步骤 2 : 点击以上的Run(运行),将出现如下界面:

步骤 3 : 勾选接受协议选项,点击 next(下一步) 按钮 :

步骤 4 : Node.js默认安装目录为 "C:\Program Files\nodejs\" , 你可以修改目录,并点击 next(下一步):

步骤 5 : 点击树形图标来选择你需要的安装模式 , 然后点击下一步 next(下一步)

步骤 6 :点击 Install(安装) 开始安装Node.js。你也可以点击 Back(返回)来修改先前的配置。 然后并点击 next(下一步):

安装过程:

点击 Finish(完成)按钮退出安装向导。

检测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版本

### 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 ,将出现如下界面 :

点击 Run(运行)按钮将出现命令行窗口:

### 版本测试
进入 node.exe 所在的目录,如下所示:

如果你获得以上输出结果,说明你已经成功安装了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/)。

完成安装之后,就可以使用命令行的 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/)
安装界面如下所示:

#### 安装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 | 存放大型插件的位置,如喵喵插件 |