# 云崽v3安装步骤

**Repository Path**: bling_yshs/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**: 343
- **Forks**: 27
- **Created**: 2022-10-01
- **Last Updated**: 2025-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 应要求该文档作屏蔽处理
<!-- 
# 新云崽登录方法

> 首先这个方法有一个副作用，就是你从今以后挂云崽的那台电脑的新版 QQ 就只能使用 9.9.2.16183 版本了，不能升级（但是你可以继续用旧版 QQ，也可以正常登录自己的大号 QQ，发消息什么的都 ok)
> 教程来自 <https://github.com/touchscale/Qsign> 感谢大佬们的无私付出

## 优缺点分析

优点：本人实测 9 天不冻结，目前为止仅收到一例冻结反馈（但是不确定是什么引起的），一例无法收到消息反馈（初步认定为账号问题）。可以正常发送各种文字、图片、转发消息。

缺点：只能使用电脑 QQNT 存在的功能，例如 `点赞` 这种只有手机能做到的功能可能就实现不了。并且有小部分功能没有适配，例如发送语音等等，会出现无法使用的问题。

## 正片教程

1. 首先我们先下载并安装官方的新版 QQ，一定要下我这里给的这个版本的，高版本不行 <https://dldir1.qq.com/qqfile/qq/QQNT/bef02a45/QQ9.9.2.16183_x64.exe> 然后安装完不需要登录，后面再登

2. 然后我们随便找个地方（最好别在云崽文件夹里），用 cmd 执行一下这条命令

    ```shell
    git clone --depth=1 https://gitee.com/bling_yshs/yz-sign-package
    ```

    会下载一个名为 `yz-sign-package` 的文件夹，里面有一堆的文件，大概是这些，后期不确定会不会再加，**下文中的 `材料库` 指的就是这个文件夹**
    <br/>
    <img src="picture/package01.png" width="50%">
    <br/>

3. 先安装 `VC_redist.x64.exe`

4. 然后在桌面上找到 QQ 的图标，右键打开所在文件所在位置，会打开一个文件夹，**下文中的 `QQNT 主目录`指的就是这个文件夹**
    <br/>
    <img src="picture/penguin-link.png" width="50%">
    <br/>
    <img src="picture/penguin-home.png" width="50%">
    <br/>

5. 从 `材料库` 里复制 `LiteLoaderQQNT-Launcher_x64.exe` 到 `QQNT 主目录` 并创建一个这个程序的**快捷方式到桌面**，方面以后开启
    <br/>
    <img src="picture/ll-quicklink.png" width="20%">
    <br/>

6. 从 `材料库` 里复制 `LiteLoader` 文件夹 到 `QQNT 主目录` 文件夹下的 `resources\app` 文件夹内，复制完长这样
    <br/>
    <img src="picture/ll-home.png" width="50%">
    <br/>

7. 右键**管理员权限启动**刚刚创建的**快捷方式**，并登录自己的机器人的账号（可以选择扫码登录）

8. 登陆完成后，找个群互相发送下消息，确保登录了机器人的 QQNT 里能正常显示，自己的 QQ 也能正常收到机器人的消息

9. 打开浏览器访问 [http://127.0.0.1:16530](http://127.0.0.1:16530) 如果显示 404 not found，像这样
    <br/>
    <img src="picture/not-404.png" width="50%">
    <br/>
    就说明**没问题**，如果是加载不出来或者其他情况，请联系我

10. 从 `材料库` 里复制 `apps.js` 到 `云崽根目录` 下
    <br/>
    <img src="picture/copy-apps.png" width="50%">
    <br/>

11. 使用 `终端`，也就是 `启动器-> 2. 云崽管理-> 3. 自定义终端命令` 执行

    ```shell
      git clone -b red --depth=1 https://gitee.com/xiaoye12123/ws-plugin.git ./plugins/ws-plugin/
    ```

    <br/>
    <img src="picture/ws-comm.png" width="50%">
    <br/>

12. 继续用 `终端` 安装下依赖

    ```shell
    pnpm install
    ```

13. **关键步骤，易错步骤：** 先在 `终端` 内执行 `node apps` ，然后等待插件全部加载完，但是这时候机器人**不会有任何反应**，很正常，继续往下

14. 从 `材料库` 里复制 `ws-config.yaml`  到 `Yunzai-bot\plugins\ws-plugin\config\config` 替换掉原有的东西，并用记事本打开它
    <br/>
    <img src="picture/ws-path.png" width="50%">
    <br/>
    <img src="picture/ws-config-context.png" width="50%">
    <br/>

15. **关键步骤，易错步骤：** 找到 `uin: 1460054346` 改成 `uin: 机器人的 QQ 号` ，注意 `uni:` 后面有个空格

16. 大功告成，使用 `启动器->云崽管理->以 node apps 方式启动`，就可以啦！

## 注意事项

QQNT 不能关闭，一关机器人就收不到也发不了消息了。并且一定要使用管理员权限运行 `LiteLoaderQQNT-Launcher_x64.exe`

## 常见问题

### 问题：上方教程最后一步运行完以后，遇到了终端红字提示：`[ws-plugin] QQNT 自动获取 Token 失败，请检查是否已安装 Chronocat 并尝试手动获取`

<details>
  <summary>解决方法（点击展开）</summary>

1. win+r 打开运行窗口，输入

    ```shell
    %appdata%/BetterUniverse/QQNT/
    ```

    会打开一个文件夹，里面会有一个文件

    <br/>
    <img src="picture/token-home.png" width="50%">
    <br/>

2. 用记事本打开这个文件，将里面的内容复制出来，然后粘贴到 ws-config.yaml 的 accessToken: 后面（再三强调，注意冒号后面的空格），例如

    ```yml
    # 连接服务列表
    servers: 
      - name: QQNT
        address: 127.0.0.1:16530
        type: 4
        accessToken: 507d2f3a18c6139a7b19a19a1c369388c088af0b2ce6b2b329a040092b2b943b
        reconnectInterval: 10
        maxReconnectAttempts: 0
        uin: 1460054346
        closed: false
    ```

3. 大功告成，使用 `启动器->云崽管理->以 node apps 方式启动`，就可以啦！

</details>

### 问题：我想使用旧版本 ICQQ 方式登录，如何撤销更改

<details>
  <summary>解决方法（点击展开）</summary>

1. 从 `云崽根目录` 里删除 `apps.js`

2. 删除 `/plugins/ws-plugin/` 文件夹

3. 使用 `启动器->云崽管理->启动签名 API 并启动云崽`，就可以啦！

</details>

### 问题：为啥这个 QQNT 没法退出

<details>
  <summary>解决方法（点击展开）</summary>

1. 打开任务管理器

2. 找到所有 QQ 的进程

3. 疯狂点击强制结束运行

</details> -->