# 云崽v3安装步骤
**Repository Path**: oliverzzq/Yunzai-v3-Installation-Steps
## Basic Information
- **Project Name**: 云崽v3安装步骤
- **Description**: 云崽v3安装步骤
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 27
- **Created**: 2023-01-31
- **Last Updated**: 2023-01-31
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 云崽 bot-v3 安装步骤
> 本教程支持的操作系统：Win10 及以上版本、Windows Server 2012 及以上版本
## 本体安装步骤
> **下方密码统一为 0000**
> **以下命令如果没有特别指明的话，都是在云崽根目录下执行**
> **视频内的命令可能有误，一切步骤以本安装教程内的为准**
- 下载 node,git,redis [https://yshs.lanzouy.com/b09zk5u1g](https://yshs.lanzouy.com/b09zk5u1g)
- 下载安装云崽本体： `git clone --depth 1 -b main https://gitee.com/Le-niao/Yunzai-Bot.git`
- 进入文件夹
- 安装 pnpm： `npm install pnpm -g`
- 问题：输完卡住不动了怎么办？或者提示 `npm ERR！`？或者其他的报错？
原因：你的服务器网络太差了，下载不动
解决方案：执行命令来更换淘宝镜像源 `npm config set registry https://registry.npmmirror.com` 然后再执行安装 pnpm 的命令 `npm install pnpm -g`
后遗症：更换镜像源后有微小概率导致后续安装出现问题，所以如果你更换了镜像源以后遇到任何问题请勿向我提问;w;
- 安装依赖：
- 先执行
`pnpm config set puppeteer_download_host=https://npmmirror.com/mirrors`
- 再执行 `pnpm install -P` (视频里没有执行第一条命令，请以本教程为准)
> 提示：pnpm: command not found?
> 你上一步的 pnpm 没装好或者安装报错了
- 启动云崽： `node app`
- 一键启动脚本 [https://yshs.lanzouy.com/b09zlibch
](https://yshs.lanzouy.com/b09zlibch)
---
## 基础操作
- 启动云崽： `node app`
- 查看日志： `npm run log`
- 关闭云崽： 对着机器人发送 `#关机`
- 功能列表： `#帮助`
- 更新云崽： `#全部更新`
- 重置云崽的机器人 QQ 号： `npm run login`
---
## 目录说明
| 目录 | 说明 |
| ------------------------ | ------------------------------ |
| config\config\qq.yaml | 可以修改登录方式，QQ 号 |
| config\config\other.yaml | 可以修改主人 QQ |
| data\face | 存放添加表情的位置 |
| data\MysCookie | 存放 cookie 的位置 |
| plugins\example | 存放 js 插件的位置 |
| Yunzai-Bot\plugins | 存放大型插件的位置，如喵喵插件 |
## 额外说明
| 功能说明 | 样例 | 备注 |
| --------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ffmpeg 配置样例 | `ffmpeg_path: 'D:\云崽v3测试别删\Yunzai-Bot\bin\ffmpeg.exe'` | 锅巴里直接填路径就好，比如 `D:\云崽v3测试别删\Yunzai-Bot\bin\ffmpeg.exe` 路径不能有空格，必须用单引号，必须用反斜杠。 ffmpeg 下载地址 [https://yshs.lanzouy.com/b09znfb7g](https://yshs.lanzouy.com/b09znfb7g)
p.s. 有些时候日志提示 `请检查ffmpeg配置` 可能是插件本身的问题，而不是你的 ffmpeg 没配置好 |
---
## 插件安装步骤
### 云崽插件库：[https://gitee.com/yhArcadia/Yunzai-Bot-plugins-index](https://gitee.com/yhArcadia/Yunzai-Bot-plugins-index)
### [喵喵插件](https://gitee.com/yoimiya-kokomi/miao-plugin)
- 喵喵插件安装命令：`git clone --depth 1 -b master https://gitee.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin/`
- 喵喵依赖安装命令： `pnpm add image-size -w`
- 帮助菜单命令： `#喵喵菜单`
- 插件设置命令： `#喵喵设置`
- 推荐执行： `#喵喵更新图像` 以及 `#喵喵设置帮助 开启`
### [锅巴插件](https://gitee.com/guoba-yunzai/guoba-plugin)
- 锅巴插件安装命令：`git clone --depth=1 https://gitee.com/guoba-yunzai/guoba-plugin.git ./plugins/Guoba-Plugin/`
- 锅巴依赖安装命令： `pnpm install --no-lockfile --filter=guoba-plugin -w`
- 外网登录的话需要在服务器后台放行端口，具体看 `#锅巴帮助`
- 帮助菜单命令： `#锅巴帮助`
### [逍遥插件(图鉴插件)](https://gitee.com/Ctrlcvs/xiaoyao-cvs-plugin)
- 逍遥插件安装命令：`git clone --depth=1 https://gitee.com/Ctrlcvs/xiaoyao-cvs-plugin.git ./plugins/xiaoyao-cvs-plugin/`
- 逍遥依赖安装命令： `pnpm add promise-retry -w` 再 `pnpm add superagent -w`
- 安装完需要先 `#图鉴更新` 一次
- 帮助菜单命令： `#图鉴菜单`
- 插件设置命令： `#图鉴设置`
### [py 插件(宵鸟插件)](https://gitee.com/realhuhu/py-plugin)
- 先安装 [Python3.10.8](https://yshs.lanzouy.com/b09zlrj8f)
- 记得勾选 `Add python.exe to PATH`
- py 插件安装命令：`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`
- 进入 `Yunzai-Bot\plugins\py-plugin` 文件夹，点击地址栏，删掉里面的内容，并且输入 `cmd` 然后回车，会打开命令行窗口，如下图所示
- 我们先更换一下下载源，因为 python 的官方源下载很慢。我们在打开的 cmd 里先执行 `pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple` 然后继续在 cmd 里执行 `python install`
- 当提示安装完成后，**关掉 cmd** 再按同样的方法**再开一次 cmd**，在里面执行 `poetry install`
- 等待安装完后就代表 py 插件安装成功了
- py 插件获取插件的方法请查看 [py 插件获取插件教程](https://gitee.com/realhuhu/py-plugin#221-%E8%8E%B7%E5%8F%96%E6%8F%92%E4%BB%B6) 这里不再赘述
- 启动时候提示 python 服务器已关闭？
- 我不知道怎么解决，python 破事多..
- **任何 py 插件的问题都不要来问我，我不知道**
### [js 格式插件通用安装方法](https://gitee.com/yhArcadia/Yunzai-Bot-plugins-index?_from=gitee_search#js%E6%8F%92%E4%BB%B6%E7%B4%A2%E5%BC%95)
- 很简单，将插件下载好后放入 `Yunzai-bot/plugins/example` 里即可 
---
## 常用命令
- [云崽本体常用命令](https://github.com/Le-niao/Yunzai-Bot/tree/main/plugins/genshin)
---
## 尚未解决的问题
- 
当前网络不稳定，登录失败，推荐使用常用设备或手机号登录。这个我是真不知道咋办，不过听说可以用 [版本过低的解决办法](#bbgd) 来解决，不确定是否有效
- 米游社接口遇见验证码
- 或许有用的解决办法：
> 进入米游社打开旅行工具 打开原神战绩（其他应该也行）正常后退出就行了。
- **请求失败，可能是服务负载较高，请稍后重试...？**
- 大概率是更新面板服务器炸了，等修复吧
---
## 常见问题
- cookie 绑定失败？
- 请把云崽 `#更新` 一下 然后看 [新的 cookie 获取方法](https://www.bilibili.com/video/BV1TN4y1N74E?p=9) ，这是电脑的方法，手机的解决方法请看[https://github.com/Le-niao/Yunzai-Bot/issues/956](https://github.com/Le-niao/Yunzai-Bot/issues/956)
- 米游社接口报错，暂时无法查询：error
- [https://docs.qq.com/doc/DTnB4Qkh1RGRCeVFU](https://docs.qq.com/doc/DTnB4Qkh1RGRCeVFU)
- 装完 node 但是还是提示 `npm:command not found`
- 自行百度搜索 `如何打开windows环境变量设置`
- 在用户环境变量的 Path 变量中点击编辑，添加 `C:\Program Files\nodejs` 与 `C:\Users\把这段中文替换成你自己的用户名\AppData\Roaming\npm` 字段
- 重启电脑即可
- 签到显示 `验证码失败` ?
- 正常，米游社签到有概率出现验证码，无解
- 提示 `qq版本过低` ？
- 
此图来源于喵喵插件群
- 提示 `请配置公共ck` ？
- `#使用全部ck`
- 公共 ck 查询次数已用完，暂无法查询新 uid？
- `#使用全部ck`
- `node app` 后提示 puppeteer chromium 启动失败？Chromium 实例关闭或崩溃？
1. 下载这个压缩包 (随便选一个网盘下载就行，都是一样的) [123 网盘(推荐 无需登录)](https://www.123pan.com/s/tsd9-FYCJv) [阿里云盘](https://www.aliyundrive.com/s/eiecbp69vpb) [百度云盘](https://pan.baidu.com/s/19x4kTaxdyDUhBLoqkxb6aQ?pwd=0000) [天翼云盘 访问码：gel8](https://cloud.189.cn/web/share?code=2EfANfAzIFZv)
2. 解压
3. 将里面的文件复制到 `Yunzai-bot/node_modules\puppeteer` 替换掉这个文件夹里原本的文件
4. 正常启动即可
- 下载安装云崽本体提示 `could not create work tree dir` ？ 或者 `计算机积极拒绝连接` ？
- 换一个盘安装
- redis 数据库打不开怎么办？
- 在 redis 目录下建一个名称为 start.txt 文本(需要打开文件扩展名显示)，打开输入`redis-server.exe redis.conf`并且保存。修改后缀名为 bat(修改后名为 start.bat )，双击打开 start.bat 即可。
- 还是打不开的话，打开 redis-cli.exe，输入`shutdown`，回车，输入`exit`，回车，再去打开 start.bat，正常来说就可以了。
- 输完密码提示：需要获取滑动验证码 ticket？
- [点击跳转教程](https://www.bilibili.com/video/BV1TN4y1N74E?p=10)
- 登录有风险，无法登陆? 登陆需要密保手机扫二维码验证，但是二维码刷新不出来？
- 可以改用扫码登录。再不行就服务器先开着 QQ，挂几分钟再退出登录，然后再登录，重复三四遍再试试能不能登录，还是不行的话就最后再挂几个小时，再看看能不能登录。
- `#更新面板` 用不了？ `#更新面板` 显示服务器负载过高？
- 解决办法：进入`Yunzai-Bot\plugins\miao-plugin\config`文件夹，找到`profile_default`文件，复制粘贴一份，并将新的那一份改名为`profile`，右键编辑`profile`，找到
```js
export const enkaApi = {
url: "https://enka.network/", // 请求API地址，可从上方提供的API地址中进行选择
proxyAgent: "", // 请求的proxy配置，如无需proxy则留空
};
```
将 `url: 'https://enka.network/` 改为 `url: 'https://enka.microgg.cn/`
**最后保存重启即可**
- 改完还是不行？
- 我的建议是，**等修复**
- 
MISCONF Redis is configured to save RDB
snapshots
- 控制面板->系统和安全->系统->高级系统设置->高级选项卡下方第一个卡片“性能”里的设置按钮->高级选项卡->虚拟内存->更改->勾选最上方自动管理所有驱动器的分页文件大小->重启电脑
- 机器人进群自动退了怎么办
- 锅巴插件->配置管理->其它->退群人数改成 0 就行
- Cannot find package 'oicq'?
- 你依赖没装
- 如何删除插件?
- 在 `Yunzai-bot/plugins` 文件夹里找到对应的插件右键删除即可
- 如何关闭入群欢迎?
- 在 `Yunzai-bot/plugins/example` 文件夹里找到入群欢迎插件，右键删除
- 机器人被冻结了，怎么办？
- 没啥好办法，这是 QQ 的问题，可以多备几个小号。关闭私聊，减少冻结频率。
- xx 功能报错，xx 功能异常？机器人打不开? 机器人坏了?
- 重置云崽步骤(数据会保留)：在云崽根目录下打开 git bash 输入`git pull`，然后再`git reset --hard origin/main`，最后再手动重启即可解决。
- 喵喵插件的 `#xx照片` `xx图片` 功能用不了？
- 
把 `Yunzai-Bot/plugins/miao-plugin/resources` 的 `character-img` 文件复制一份到 `Yunzai-Bot/plugins/miao-plugin/resources/miao-res-plus` 里就好
- 机器人群聊消息发不出去，但是私聊正常？
- 这是触发了 QQ 新版群聊风控，私聊机器人发送 然后拿出你的手机，并登录机器人的手机 QQ，从机器人的手机 QQ 里打开个链接，验证就行了。
- 安卓怎么挂机器人？
- [安卓教程](https://www.bilibili.com/video/BV1Fe4y1K7Jn)
- 十连次数怎么修改？
- [锅巴插件](#锅巴插件) 里可以配置
- 主人 QQ 输错了怎么办？
- `Yunzai-Bot\config\config\other.yaml` 用记事本打开，修改里面的 masterQQ，改为以下格式(注意空格和换行**必须完全一致**)
```yaml
masterQQ:
- 377178599
```
我口头描述下：masterQQ**英文冒号**，紧接着换行，**空两格**减号**空一格**输入自己的 QQ
- 服务器推荐？
- 平时服务器都会比较贵，只有新用户和购物节会特别便宜，所以大家各凭本事吧，反正只要服务器能联网就能搭这个机器人。
- 插件除了这些还有别的吗
- 更多的插件都在云崽官方群里，但是官方群它不对外开放...