# YunzaiBot-teaching-help
**Repository Path**: hetangx/yunzai-bot-teaching-help
## Basic Information
- **Project Name**: YunzaiBot-teaching-help
- **Description**: 手机云崽安装教程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-01-25
- **Last Updated**: 2023-01-25
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 云崽部署教程(群号:279071460)
原教程作者(石神千空)已跑路,现由向日葵支持更新教程(我也会摆)
#### 介绍
整理的较为完整的手机termux部署Yunzai-Bot V3教程
## 禁止在QQ聊天以外的渠道宣传云崽!尤其是米游社!
#### 安装教程
#### 1.首先需要下载或查看以下(emmm素材?)
#### !!!所有需要密码的都是123456
1.[termux](https://f-droid.org/repo/com.termux_118.apk)
2.[应急食品app](https://gtool.mukapp.top/) /[米哈游cookies获取app](https://wwu.lanzoul.com/iw1c00csrsgh)(二选一)
3.[体力查询帮助](https://docs.qq.com/doc/DUWNVQVFTU3liTVlO)
4.[质感文件](https://wwu.lanzoul.com/iRG5F08yvkji)
5.[滑动验证助手](https://github.com/KasukuSakura/mirai-login-solver-sakura/releases)
因原神更新大版本更新抽卡记录获取方式失效,安卓用户需要使用提瓦特小助手官方提供的工具[yuanshenlink](https://www.lelaer.com/app)
#### 2.准备
云崽长久运行准备
手机设置完全允许termux的后台运行,开启后台锁,电池设置关闭termux的耗电优化,授予通知权限并在termux通知选择“Acquire wakelock”;
如果使用闲置手机运行云崽,推荐将所有能联网的应用(当然termux除外)全部强制停止运行,然后开发者设置“禁用锁屏”(设置完后,以后运行时点按电源键熄屏也会保持满血的前/后台运行)
如果觉得太麻烦建议下载[termux:float](https://f-droid.org/repo/com.termux.window_15.apk)开启通知与悬浮窗权限即可
#### 3.正题
打开termux
输入以下命令
- 遇到选项直接回车
```
pkg update
```
```
pkg install proot git python -y
```
```
git clone https://gitee.com/Le-niao/termux-install-linux.git
```
```
cd termux-install-linux
```
```
python termux-linux-install.py
```
之后输入1,安装Ubuntu
Ubuntu安装完成后
启动Ubuntu
```
cd ~/Termux-Linux/Ubuntu
```
```
./start-ubuntu.sh
```
更新索引
```
apt update
```
安装curl
```
apt install curl -y
```
安装nodesource,很多人在这里报错,请注意一下这里有没有wait 20 seconds的提示
```
curl -sL https://deb.nodesource.com/setup_17.x | bash -
```
安装node
```
apt-get install -y nodejs
```
检查node版本是否为17版本,如果不是,删了重装
```
node -v
```
安装并启动redis
```
apt-get install redis -y
```
```
redis-server --daemonize yes --save 900 1 --save 300 10
```
安装chromium
```
apt install chromium-browser -y
```
安装中文字体
```
apt install -y --force-yes --no-install-recommends fonts-wqy-microhei
```
安装git
```
apt install git -y
```
安装cnpm(自选)
```
npm install cnpm -g --registry=https://registry.npmmirror.com
```
克隆云崽项目
```
git clone --depth=1 https://gitee.com/Le-niao/Yunzai-Bot.git
```
安装云崽依赖
```
cd Yunzai-Bot
```
```
npm install pnpm -g
```
```
pnpm install -P
```
很多人在安装pnpm的时候报错,我遇见过萌新的报错,一般是npm掉了,我也不清楚原因
试试apt-get install npm
云崽安装完成,接下来不要做其他多余的动作,选择安装你需要的插件
若不安装插件直接node app启动即可
#### 云崽项目插件库:
https://gitee.com/Hikari666/Yunzai-Bot-plugins-index
需求在本教程以外的话,自己选择插件安装吧
#### 5.在以下七个插件中选择心仪的吧
在Yunzai-Bot目录下选择下载插件
喵喵插件:
```
git clone --depth=1 https://gitee.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin
```
喵喵插件依赖安装:
```
pnpm i image-size --save -w
```
菜单命令是#喵喵帮助
逍遥插件:
```
git clone --depth=1 https://gitee.com/Ctrlcvs/xiaoyao-cvs-plugin.git ./plugins/xiaoyao-cvs-plugin
```
菜单命令是#图鉴帮助,煌佬也开发了扫码登录功能,最近的获取ck软件容易寄,加我们群获取扫码插件
抽卡插件:
```
git clone --depth=1 https://gitee.com/Nwflower/flower-plugin.git ./plugins/flower-plugin
```
菜单命令是#抽卡设置
戏天插件:
```
git clone https://gitee.com/XiTianGame/xitian-plugin.git ./plugins/xitian-plugin/
```
菜单命令是#插件帮助
成就查漏插件:
```
git clone --depth=1 https://gitee.com/zolay-poi/achievements-plugin.git ./plugins/achievements-plugin
```
菜单命令是#成就帮助
锅巴插件:
```
git clone --depth=1 https://gitee.com/guoba-yunzai/guoba-plugin.git ./plugins/guoba-plugin
```
锅巴插件依赖安装:
```
pnpm i --filter=guoba-plugin
```
很多人pnpm安装锅巴插件会卡住甚至寄,试试cnpm
```
cnpm install express multer body-parser jsonwebtoken
```
菜单命令是#锅巴帮助
土块插件(语音功能需要ffmpeg):
```
git clone --depth=1 https://gitee.com/SmallK111407/earth-k-plugin.git ./plugins/earth-k-plugin
```
菜单命令是#土块帮助
## 宵鸟(py)插件:
两个分支中只能选一个
#### main分支:
```
git clone -b main https://gitee.com/realhuhu/py-plugin.git ./plugins/py-plugin
```
py插件依赖安装:
```
pnpm install @grpc/grpc-js @grpc/proto-loader -w
```
菜单命令是#py帮助
#### V3(主分支)
```
git clone --depth=1 https://gitee.com/realhuhu/py-plugin.git ./plugins/py-plugin
```
py插件依赖安装
```
pnpm install iconv-lite @grpc/grpc-js @grpc/proto-loader -w
```
新的宵鸟插件还未完善,暂时没有菜单,敬请期待
#### 6.关于ffmpeg和py插件的配置
#### py插件配置:
#### 第一种,使用宵鸟服务器的远程服务(仅适用于v3分支)
在云崽目录下输入该命令即可
1. 使用脚本开启远程(跟手动大同小异)
```
bash <(curl -l https://gitee.com/txlx/yunzai-help/raw/tx/pyport)
```
2. 手动开启远程
```
cp ~/Yunzai-Bot/plugins/py-plugin/config_default.yaml ~/Yunzai-Bot/plugins/py-plugin/config.yaml
```
```
sed -i "s/.*host.*/host: 159.75.113.47/g" ~/Yunzai-Bot/plugins/py-plugin/config.yaml
```
如果想关闭远程服务的话
```
sed -i "s/.*host.*/host: 127.0.0.1/g" ~/Yunzai-Bot/plugins/py-plugin/config.yaml
```
#### 第二种,使用本地服务(两种分支都可使用该方法)
在云崽目录下逐步输入以下命令
```
apt update
```
```
apt-get install -y software-properties-common
```
```
add-apt-repository ppa:deadsnakes/ppa
```
```
add-apt-repository ppa:jonathonf/python-3.9
```
```
apt-get install -y python3.9
```
```
rm /usr/bin/python
```
```
ln -s /usr/bin/python3.9 /usr/bin/python
```
```
apt install -y python3.9-distutils
```
```
wget -c https://gitee.com/txlx/yunzai-help/releases/download/python-pip/pip.py
```
```
python3.9 pip.py
```
这一步可能需要等待很久
等他真正停下来的时候,输入下面两个命令检查是否安装完成
```
pip -V
```
```
python -V
```
如果输出对应的版本号,就说明安装完成了
接下来,输入下面的命令进行开启本地服务
跳转到插件目录
```
cd /root/Yunzai-Bot/plugins/py-plugin
```
保险起见更新索引
```
apt update && apt upgrade -y
```
安装poetry
```
curl -sSL https://install.python-poetry.org | python -
```
为poetry创建软链接
```
ln -s $HOME/.local/bin/poetry $HOME/usr/bin/poetry
```
或者用pip安装
```
pip install poetry
```
等他真正停下来的时候,输入下面的命令查是否安装完成
```
poetry -V
```
如果输出对应的版本号,就可以继续下一步了,如果没有版本号,可以尝试重新进行上面的步骤
然后用你的poetry运行宵佬预设的install文件夹(推荐)
```
poetry install
```
或者使用这个方法:
v3分支:
```
poetry run pip install -r requirements.txt --trusted-host mirrors.aliyun.com
```
main分支:
```
poetry run pip install -r requirements.txt --trusted-host mirrors.aliyun.com
```
安装完成后再安装插件依赖
如果启动云崽后显示像“python服务器启动完成”的字样
恭喜你,py插件可以正常使用了!
#### ffmpeg配置
直接安装ffmpeg(不推荐,需要编译后才可正常使用)
```
apt install ffmpeg -y
```
或
用溪姐上传的脚本
```
bash <(curl -l https://gitee.com/txlx/yunzai-help/raw/tx/ffmpeg)
```
或者手动下载
```
apt install wget -y
```
```
wget -c https://gitee.com/txlx/yunzai-help/releases/download/ffmpegarm64/ffmpeg
```
```
mv ffmpeg /usr/bin && chmod 777 /usr/bin/ffmpeg && ffmpeg
```
如果输出了很多文字,其中还夹杂一行黄颜色的字,那么恭喜你,ffmpeg已经配置完成了,土块插件或其他插件的语音功能可以正常使用了!
#### 7.启动并登录云崽机器人
7.1 在云崽项目下
7.2 输入node app
7.3 等待云崽启动
7.4 然后输入你的小号QQ号
7.5 输入密码
(直接回车是选择扫码,可以选择输入密码,这里为了保护隐私,输入的密码不显示)
7.6 选择设备标识
7.7 输入1到5中的其中一个数字,选择你需要的设备
(个人推荐使用iPad标识)
7.8 若无法启动云崽,cd到云崽目录
```
pnpm install
```
再重新node app即可
登录完成!你可以尽情使用云崽了!
#### 8.ck获取
如果你想要正常使用云崽机器人,使用下面的方法获取ck
取得ck后直接私聊发送给机器人即可(机器人必须是开机运行状态)
8.1 使用“应急食品”获取
请按步骤执行操作
1 打开“应急食品”app(如有新版本请及时更新)
2 选择下方导航栏的“工具”
3 选择“米游社账号管理”
4 选择屏幕右下角的“添加账号”
5 选择“账号密码登录”
6 这里正常登录即可
7 为账号记录命名,这里随意,能用就行
8 长按刚才记录的账号
9 选择“复制cookies”
10 然后将复制来的cookie私聊发给机器人即可
8.2 使用“米哈游cookie获取”获取
请按步骤执行操作
1 打开“米哈游cookie获取”app
2 选择右上角的头像
3 这里正常登录即可
4 选择下方导航栏的“获取数据”
5 选择第一个的“复制”字样
6 然后将刚才得到的cookie私聊发给机器人即可
也可以向机器人发送消息“#体力帮助”以了解过程
或参考该教程:
```
https://www.wolai.com/gGvRqkvkhcKL5G2cv2zbiy
```
#### 9.启动云崽
如果关闭了termux,以后还想启动
打开termux
输入以下命令
启动系统
```
cd ~/Termux-Linux/Ubuntu
```
```
./start-ubuntu.sh
```
转到云崽项目并启动redis
```
cd Yunzai-Bot
```
```
redis-server --daemonize yes --save 900 1 --save 300 10
```
启动云崽
```
node app
```
#### 10.个性化
如果需要改变喵喵插件帮助的封面图片、菜单透明度等
termux挂到后台,可以不启动云崽机器人
更改“#帮助”触发词:
用质感文件打开termux路径:Termux-Linux/Ubuntu/ubuntu-fs/root/Yunzai-Bot/plugins/miao-plugin/apps/help.js
打开该文件,找到以下部分内容:
```
6 | let app = App.init({
7 | id: 'help',
8 | name: '喵喵帮助',
9 | desc: '喵喵帮助'
10 | })
11 |
12 | app.reg('help', help, {
13 | rule: /^#?(喵喵)?(命令|帮助|菜单|help|说明|功能|指令|使用说明)$/,
14 | desc: '【#帮助】 #喵喵帮助'
15 | })
16 |
17 | app.reg('version', versionInfo, {
18 | rule: /^#?喵喵版本$/,
19 | desc: '【#帮助】 喵喵版本介绍'
20 | })
```
把第13行的“喵喵”改成自己喜欢的名字即可,其他的不要瞎改
增添和修改菜单内容:
用质感文件打开termux路径:Termux-Linux/Ubuntu/ubuntu-fs/root/Yunzai-Bot/plugins/miao-plugin/config/help.js
自己领悟吧,这个解释不[doge]
更改封面图片:
【默认尺寸下】准备一张宽高比例为9:16的图片
用质感文件打开termux路径:Termux-Linux/Ubuntu/ubuntu-fs/root/Yunzai-Bot/plugins/miao-plugin/resources/help/theme/default,
在这替换主图main.png,pg.png可以删除且不做替换
(注:替换后的图片要与原图同名)
更改喵喵帮助字体颜色
跟上面一样,termux放入后台
用质感文件打开termux路径:Termux-Linux/Ubuntu/ubuntu-fs/root/Yunzai-Bot_v2/plugins/miao-plugin/resources/help/theme/default,
选择文件contig.js,打开方式选择质感文件图标的文本编辑器,根据注释修改颜色和透明度
PS:还可通过#喵喵版本,知道该如何改变菜单,或通过锅巴插件修改
#### 11.其他
如果嫌手动部署麻烦,可以选择使用
[时雨星空的一键安装脚本](https://gitee.com/TimeRainStarSky/TRSS_Yunzai)
[云溪院一键部署脚本](https://gitee.com/txlx/yunzai-help)
- 严禁用于任何商业用途和非法行为