Skip to content

Commit a15d441

Browse files
authored
Merge pull request #23 from kobe-koto/main
docs: update install instructions
2 parents d213600 + 9864106 commit a15d441

1 file changed

Lines changed: 52 additions & 28 deletions

File tree

src/guide/install.md

Lines changed: 52 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7,65 +7,89 @@
77

88
## 使用社区奇妙工具
99

10-
> 一些社区开发的安装工具来帮助你快速安装
10+
通过本段提供的方案完成安装后,直接跳到 [6. 检查是否安装成功](#%E6%A3%80%E6%9F%A5%E6%98%AF%E5%90%A6%E5%AE%89%E8%A3%85%E6%88%90%E5%8A%9F) 即可。
1111

12-
- <https://github.com/Mzdyl/LiteLoaderQQNT_Install>
13-
使用 Python 编写的安装脚本,支持 Windows Linux MacOS
12+
如果需要手动进行安装,请从 [2. 下载 LiteLoaderQQNT 本体](#下载-liteloaderqqnt-本体) 开始。
1413

15-
- <https://github.com/huiyadanli/RevokeMsgPatcher>
16-
微信/QQ/TIM防撤回补丁,对 QQNT 安装 LiteLoaderQQNT
14+
### 通过安装工具进行安装
1715

18-
- <https://github.com/NapNeko/NapCat-Windows-Boot>
19-
来自 NapCat 项目的启动器,可以一键启动,支持 Windows
16+
::: warning 警告
17+
在 Windows 上使用这些工具时,请做好 QQNT 无法通过文件校验的准备。
18+
19+
在遇到这种情况时,仍推荐阅读 [3. 在 Windows 上绕过 QQNT 文件校验](#在-windows-上绕过-qqnt-文件校验)
20+
:::
21+
22+
- <https://github.com/Mzdyl/LiteLoaderQQNT_Install>
23+
24+
使用 Python 编写的安装脚本,支持 Windows / Linux / MacOS。
25+
26+
- ~~<https://github.com/huiyadanli/RevokeMsgPatcher>~~
27+
28+
~~微信/QQ/TIM 防撤回补丁。~~
29+
30+
已在 v2.1 版本移除了 LiteLoaderQQNT 的安装。
2031

21-
使用 Arch Linux 系统可以通过 AUR 安装
32+
- <https://github.com/NapNeko/NapCat-Windows-Boot>
2233

23-
- <https://aur.archlinux.org/packages/liteloader-qqnt-bin>
24-
- <https://aur.archlinux.org/packages/liteloader-qqnt-git>
34+
来自 NapCat 项目的启动器,可以一键启动,支持 Windows
2535

26-
## 安装前的准备工作
36+
### 通过 AUR 安装 (Arch Linux)
37+
38+
- <https://aur.archlinux.org/packages/liteloader-qqnt-bin> 对应 Release 版本
39+
- <https://aur.archlinux.org/packages/liteloader-qqnt-git> 对应仓库最新提交
40+
41+
在卸载 `liteloader-qqnt` 时,推荐重新安装 QQNT 本体,以防止文件哈希不同于原版。
42+
43+
推荐阅读 [5. 更改插件数据目录](#更改插件数据目录-可选) ,以防止 LiteLoaderQQNT 试图在无权限目录下执行写操作。
44+
45+
## 下载 LiteLoaderQQNT 本体
2746

2847
你需要先下载 LiteLoaderQQNT 到任意位置,以下有两种方式
2948

30-
- **Release**
31-
前往 [LiteLoaderQQNT Release页](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT/releases/latest),下载 `LiteLoaderQQNT.zip` 文件解压到任意位置
49+
- **Release** (稳定版)
50+
前往 [LiteLoaderQQNT Release 页](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT/releases/latest),下载 `LiteLoaderQQNT.zip` 文件解压到任意位置
3251

33-
- **Clone**
52+
- **Clone** (最新提交)
3453
使用 Git 工具将 LiteLoaderQQNT 仓库 Clone 到本地任意位置
3554

3655
``` shell
3756
git clone --depth 1 https://github.com/LiteLoaderQQNT/LiteLoaderQQNT.git
3857
```
3958

40-
对于 Windows 系统用户,还需要绕过 QQNT 文件校验,可以通过下方链接下载
41-
<https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch/releases>
42-
,在Release中,有两个版本,分别是
59+
## 在 Windows 上绕过 QQNT 文件校验
4360

44-
- **DLLHijack**
61+
~~https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch/releases 暂无公开发布计划,请使用 Telegram 群内的版本。~~
4562

46-
下载 dll 文件后,重命名为 dbghelp.dll 放入 QQ 安装目录下即可
63+
对于 Windows 系统用户,还需要绕过 QQNT 文件校验。
4764

48-
- **Patcher**
49-
50-
下载 exe 文件,运行将弹出文件选择框,进入 QQNT 安装目录选择 QQ.exe 或 QQNT.dll 开始修补,每次更新都需要重新修补
65+
请根据你的操作系统架构在 Telegram 群内下载 `dbghelp_*.dll` 文件,将其重命名为 `dbghelp.dll` 后放入 `QQ.exe` 同级目录下。
5166

5267
## 修改文件手动安装
5368

5469
1. 转到 QQNT 安装目录
5570

5671
2. 查看 QQNT 安装目录,是否存在 `versions` 文件夹
57-
- 如果存在,则app路径为 `QQNT\versions\版本号\resources\app`
58-
- 否则app路径为 `QQNT\resources\app`
72+
- 如果存在,则 `app` 路径为 `QQNT\versions\版本号\resources\app`
73+
- 否则 `app` 路径为 `QQNT\resources\app`
74+
75+
3.`app\app_launcher` (若缺失 `app_launcher` 目录就自己创建)中创建一个 `LiteLoader.js` (文件名 `LiteLoader` 可随意设定, 需保留拓展名 `.js`)文件并写入以下内容:
5976

60-
3.`app\app_launcher`中创建一个`LiteLoader.js` 文件(如果没有app_launcher目录就自己创建),其中 `LiteLoader` 为文件名可随意设置,写入 ``require(String.raw`*`)`` 其中 \* 为 LiteLoaderQQNT 的路径,要填写绝对路径
77+
```javascript
78+
require(String.raw`修改为 LiteLoaderQQNT 的绝对路径,保留反引号`)
79+
```
6180

6281
4. 修改 `app\package.json` 文件,将 `main` 后值改为 `./app_launcher/LiteLoader.js`,其中 `LiteLoader` 可以改成你创建的文件名
6382

64-
## 更改插件数据目录
83+
```diff
84+
- "main": "./application.asar/app_launcher/index.js",
85+
+ "main": "./app_launcher/LiteLoader.js",
86+
```
87+
88+
## 更改插件数据目录 (可选)
6589

66-
支持设置 `LITELOADERQQNT_PROFILE` 环境变量指定 `data` `plugins` 存储位置,即可不在本体目录进行读写操作,比如 MacOS 与 Linux 平台 QQNT,以及类似于 flatpak 打包的 QQNT,让其实现成为可能
90+
支持设置 `LITELOADERQQNT_PROFILE` 环境变量指定 `data` `plugins` 存储位置,即可不在本体目录进行读写操作。当本体目录无写权限时(如 MacOS 与 Linux 平台 QQNT,以及类似于 flatpak 打包的 QQNT),请设定该变量到当前用户具有可读写权限的位置。
6791

68-
如果你想将本体与存储目录合并在一起需将 `LITELOADERQQNT_PROFILE` 环境变量删除,将 `data` `plugins` 移动回本体根目录下
92+
如果你想将本体与存储目录合并在一起需将 `LITELOADERQQNT_PROFILE` 环境变量删除,将 `data` `plugins` 移动回本体根目录下
6993

7094
## 检查是否安装成功
7195

0 commit comments

Comments
 (0)