、工具预览 

 Windows（系统）

Chrome（浏览器）

Git（仓库管理工具）

Phone（扫码必备）

Node.js（环境）

Redis（数据库）

二、准备教程

1.下载Chrome与Git(工具)

打开腾讯软件管理https://pc.qq.com/ 

搜索Chrome与Git，点击[下载]

2.下载Node.js（运行环境）

（1）打开官网https://nodejs.org/zh-cn/点击[长期维护版]

（2）验证Node.js版本：鼠标右键点击桌面，点击[Git bash]

node -v

3.Redis数据库

（1）下载Redis：https://github.com/tporadowski/redis/releases

点击下载安装包[redis-x64.msi]

要记住安装[位置]，后面一直点击[下一步]即可

（2）开机自启

按住Win图标+R打开并输入services.msc后回车

下滑找到Redis，点击配置成自动，并按右键，选择启动

三、安装Yunzai-Bot V3

（一） 复制代码

右键桌面，点击[git bash]输入

git clone --depth=1 -b main https://gitee.com/Le-niao/Yunzai-Bot.git

若拉取失败，可删除Yunzai-Bot文件，重新执行

（二）加载依赖

（Yunzai-Bot目录下执行）

下面三种依赖，尝试选择适合自己的一种

在[git bash]中输入  

npm install cnpm -g --registry=https://registry.npmmirror.com 

cnpm install 

npm install pnpm -g

pnpm install

npm install

（二）启动代码

（Yunzai-Bot目录下执行）

node app.js 

注：建议把账号的安全验证与设备同存开启，不开启将会有对登录的账号有一定影响

【登录验证？】

用chrome打开反馈出来的地址

加载后看到滑动图片，先不滑动

按F12打开开发者模式并点击网络

此时滑动并通过验证后会出现两个文件

点击右边的预览即可看到自己的ticket

【退出执行？】

按CTRL+C退出

（三）后台运行

（Yunzai-Bot目录下执行）

npm start   #后台npm运行app.js

npm stop   #停止npm运行app.js

注：不停止npm或不退出node.js执行，端口将被占用，重复执行运行，将会出现错误程序占用端口的情况，如何查询和关闭端口对应的程序，请自行百度。

（四）手动更新

（Yunzai-Bot目录下执行）

git   pull

Yunzai初始文件切莫改动，会导致无法更新

若因为插件最新版有报错而想回退，

可执行下面这条命令

git revert

（五）重新登录

（Yunzai-Bot目录下执行）

npm  run login

（六）切换仓库源

（Yunzai-Bot目录下执行）

git remote set-url origin https://gitee.com/Le-niao/Yunzai-Bot.git #切换

git fetch --all  #解决所有冲突

git reset --hard origin/main #更新代码

四、如何获取公共Cookie

无痕/私人模式打开{米游社官网}

https://bbs.mihoyo.com/ys/

登录社区账号，并按F12打开开发者控制板

点击控制台/Console

输入document.cookie回车（注意大小写）

注：部分用户无法正常识别cookie，可安装扫码插件，进行在线扫码登录

警告：切莫恶意收集用户ck，且不可暴露他人ck

五、插件索引库

https://gitee.com/ningmengchongshui

六、常见问题合集

1. 机器人私聊有反应，而群里没反应了？

答：机器人发消息频繁，TX对您的机器人账号进行风控。只需要上小号，找个不常发消息的群发一条消息，即可看到验证提示，完成验证即可解除

2.为什么滑动验证通过了，还是不能登录账号？

答：风险账号需要打开陌生设备登录验证和同设备登录，提高安全系数

3.签到失败、更新面板等请求失败了怎么办？

答：mihoyo更新了滑动验证，签到不稳定是正常现象，面板接口可等几天，无需慌张

4.使用插件后，机器人没反应

答：一般是插件错误，可以node app.js查看报错内容，即可知道是什么插件报错了，删除对应插件插件后，重新启动即可

5.语音js插件报错是为什么？

答：一般来说是缺少了语音包，需要打开js文件，查看需要安装的目录位置。第二还有的原因是js插件作者写的时候是.mp3格式语音，但是yunzai发送需要的是.amr格式语音，个人建议是把js文件里面的.mp3的字段改成.amr之后把amr格式的语音包放入对应位置即可

6.版本过低又是怎么回事？

答：按以上方法后仍然不行，使用npm run login换号登录即可，建议选择Ipad设备

7.cookie总是掉线？

答：如果不是自己的原因造成的，多半是redis数据库把cookie清除了。需要把redis配置文件中的appendonly no更改为appendonly yes

8.网络不稳定这么办？

答：首先确定的是网络问题，一般重启后重新登录即可解决，其次，可能是版本过低导致的，可先往上翻，按要求更改配置后，重新登录，最后的最后，都不行了，可以更换第二个账号解决，正常来说到这一步必然是搞定了，除非你是那个意外。此时账号多半也是废了。

9.为什么要获取ck?

答：是账号密码登录后所生成的字符，机器人可通过识别字符进行登录账号，只有登录账号才能获取游戏更多数据。

七、常见错误

1.没有权限？

答：使用管理原打开[git bash]并使用命令行切换到Yunzai-Bot目录，命令行知识请百度：命令行

八、其他系统安装教程

Android系统：站内视频教程

Linux安装：教程地址，https://gitee.com/ningmengchongshui/yunzai-bot-help

九、企鹅交流

806943302

2023/3/6 V1.9.0