Skip to content

Commit

Permalink
Update
Browse files Browse the repository at this point in the history
  • Loading branch information
mo-jinran committed Sep 26, 2024
1 parent 7ab9e3f commit c788643
Show file tree
Hide file tree
Showing 9 changed files with 1,205 additions and 1,559 deletions.
2,563 changes: 1,132 additions & 1,431 deletions package-lock.json

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@
"docs:preview": "vitepress preview"
},
"devDependencies": {
"vitepress": "^1.2.3"
"vitepress": "^1.3.4"
}
}
}
2 changes: 1 addition & 1 deletion src/docs/introduction.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# 开始你的第一个插件

::: warning 警告
此文档为 LiteLoaderQQNT 1.2.x 编写
此文档为 LiteLoaderQQNT 1.2.2 编写
:::


Expand Down
2 changes: 1 addition & 1 deletion src/docs/liteloader-api.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# LiteLoader API

::: warning 警告
此文档为 LiteLoaderQQNT 1.2.x 编写
此文档为 LiteLoaderQQNT 1.2.2 编写
:::


Expand Down
2 changes: 1 addition & 1 deletion src/docs/protocol-scheme.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# 自定义协议方案

::: warning 警告
此文档为 LiteLoaderQQNT 1.2.x 编写
此文档为 LiteLoaderQQNT 1.2.2 编写
:::


Expand Down
2 changes: 1 addition & 1 deletion src/docs/web-components.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Web Components

::: warning 警告
此文档为 LiteLoaderQQNT 1.2.x 编写
此文档为 LiteLoaderQQNT 1.2.2 编写
:::


Expand Down
119 changes: 35 additions & 84 deletions src/guide/install.md
Original file line number Diff line number Diff line change
@@ -1,126 +1,77 @@
# 安装

::: warning 警告
此文档为 LiteLoaderQQNT 1.2.x 编写
此文档为 LiteLoaderQQNT 1.2.2 编写
:::



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

一些社区开发的安装工具来帮助你快速安装,或跳过此条目来阅读官方安装教程

- https://github.com/Mzdyl/LiteLoaderQQNT_Install/
- https://github.com/huiyadanli/RevokeMsgPatcher
- https://github.com/NapNeko/NapCat-Windows-Boot
- https://github.com/Mzdyl/LiteLoaderQQNT_Install
使用 Python 编写的安装脚本,支持 Windows Linux MacOS

- https://github.com/huiyadanli/RevokeMsgPatcher
微信/QQ/TIM防撤回补丁,对 QQNT 安装 LiteLoaderQQNT

- https://github.com/NapNeko/NapCat-Windows-Boot
来自 NapCat 项目的启动器,可以一键启动,支持 Windows

## 下载

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

- **通过 Release**
## 安装前的准备工作

前往 LiteLoaderQQNT 仓库,在 Release 中 Latest 内,下载 `LiteLoaderQQNT.zip` 文件,将压缩包内 LiteLoaderQQNT 目录解压到任意位置
你需要先下载 LiteLoaderQQNT 到任意位置,以下有两种方式

LiteLoaderQQNT:https://github.com/LiteLoaderQQNT/LiteLoaderQQNT
- **Release**(推荐,正式发布版本)
前往 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 仓库,在 Release 的 Latest 下载 `LiteLoaderQQNT.zip` 文件,将压缩包内 `LiteLoaderQQNT` 目录解压到任意位置

- **通过 Clone**
- **Clone**(不推荐,开发中版本)
使用 Git 工具将 LiteLoaderQQNT 仓库 Clone 到本地任意位置
``` shell
git clone --depth 1 https://github.com/LiteLoaderQQNT/LiteLoaderQQNT.git
```

使用 Git 工具将 LiteLoaderQQNT 仓库 Clone 到本地任意位置
对于 Windows 系统用户,还需要去除 QQNT 文件校验,以下有两种方式

``` shell
git clone --depth 1 https://github.com/LiteLoaderQQNT/LiteLoaderQQNT.git
```
- [**DLLHijackMethod**](https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch/tree/DLLHijackMethod)(推荐,简单好用)
在 Release 下载 dll 文件,重命名为 dbghelp.dll 放入 QQ.exe 同级目录下即可

- [**QQNTFileVerifyPatch**](https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch)(不推荐,麻烦可能被检测)
在 Release 下载 exe 文件,运行将弹出文件选择框,进入 QQNT 安装目录选择 QQ.exe 或 QQNT.dll 开始修补,每次更新都需要重新修补


## 安装

找到 QQNT 安装目录,编辑 `resources\app\app_launcher\index.js` 文件,在最前端插入一行``require(String.raw`此处为你 LiteLoaderQQNT 目录路径`);``
## 修改文件手动安装

``` javascript
require(String.raw`C:\LiteloaderQQNT`); // 此处换成你 LiteLoaderQQNT 目录位置
require('./launcher.node').load('external_index', module);
```
先找到 app 文件夹的路径,修改里面的两个文件

::: warning 警告
请确保拥有 QQNT 安装目录的读写权限!如果不想给予 QQNT 安装目录读写权限
- 查看 QQNT 根目录,是否存在 `versions` 文件夹
- 是,则路径为 `QQNT\versions\版本号\resources\app`
- 否,则路径为 `QQNT\resources\app`

- 按照下文 `存储位置` 一节进行设置
- 首次启动将显示教程,根据提示手动移动文件夹

LiteLoaderQQNT 会在第二步骤的文件不一致或没有文件时自动复制,也就是说在更新本体后需再进行一次这步骤
:::
在 app 目录中,创建一个文件,修改一个文件

- 创建 `app/app_launcher/*.js` 文件,其中 * 为文件名可随意设置,写入 ``require(String.raw`*`)`` 其中 * 为 LiteLoaderQQNT 的路径
- 修改 `app/package.json` 文件,将 `main` 后面的路径改为 `./app_launcher/*.js` 其中 * 为你刚才创建的文件名


## 修补

::: warning 警告
此条目仅需 Windows 用户查看,其他系统无需继续阅读此条目
:::

由于 Windows 系统平台 QQNT 被添加文件完整性验证,你需要额外步骤来解除限制,有下列四种方式:

- **DLLHijackMethod**
## 更改插件数据目录

在 Release 下载 dll 文件,重命名为 dbghelp.dll 放入 QQ.exe 同级目录下即可
https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch/tree/DLLHijackMethod

- **QQNTFileVerifyPatch**

在 Release 下载 exe 文件,运行将弹出文件选择框,进入 QQNT 安装目录选择 QQ.exe 开始修补,每次更新都需要重新修补
https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch

- **PatcherNFixer**

在 Release 下载 zip 文件,解压后运行 exe 将弹出图形化界面,根据软件界面提示选择相应选项与修补方式,每次更新都需要重新修补
https://github.com/xh321/LiteLoaderQQNT-PatcherNFixer
支持设置 `LITELOADERQQNT_PROFILE` 环境变量指定 `data` `plugins` 存储位置,即可不在本体目录进行读写操作,比如 MacOS 与 Linux 平台 QQNT,以及类似于 flatpak 打包的 QQNT,让其实现成为可能

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

此方式目前过于麻烦,且需要自行寻找对应的 RVA 偏移量,只说明此方式的可行性,需自行探索使用方式
https://github.com/ShellWen/v8_killer


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

按照上述教程完成安装后,有两种方法检查 LiteLoaderQQNT 是否成功安装

- 运行 QQNT 并打开设置,查看左侧列表是否出现 `LiteLoaderQQNT` 选项
- 使用终端运行 QQNT 查看是否有 LiteLoaderQQNT 相关内容输出显示

如果有显示,即安装成功,玩的开心!



## 存储目录

支持设置 `LITELOADERQQNT_PROFILE` 环境变量指定 `data` `plugins` 存储位置,即可不在本体目录进行读写操作,比如 MacOS 与 Linux 平台 QQNT,以及类似于 flatpak 打包的 QQNT,让其实现成为可能

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



## 更新QQNT

每次更新 QQNT 都需要重新根据上述教程重新修补



## 卸载

### 自动
在设置界面的插件列表处,找到需要卸载的插件,点击右侧 `管理` 按钮即可看到删除选项

### 手动

其实非常简单,根据上述安装教程的操作将修改还原即可

- 删除 `resources\app\app_launcher\index.js` 添加的内容
- 删除 `LITELOADERQQNT_PROFILE` 环境变量以及指定的目录
- 删除 `QQNT/resources/app/versions/此处为版本号/application` 目录
- 删除 `LiteLoaderQQNT` 本体目录
- 使用修补工具还需参照修补工具的教程
如果有显示,即安装成功,玩的开心!
24 changes: 11 additions & 13 deletions src/guide/introduction.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,34 @@
# 介绍

::: warning 警告
此文档为 LiteLoaderQQNT 1.2.x 编写
此文档为 LiteLoaderQQNT 1.2.2 编写
:::



## 这是什么

~~一个名为沫烬染的Furry闲着研究QQNT后决定狠狠的注入福瑞代码开发了此插件框架~~

LiteLoaderQQNT 是 QQNT 的插件加载器,一般在 QQNT 的环境内简称为 LiteLoader
它可以让你自由地为 QQNT 添加各种插件,并实现例如美化主题、增加功能等各种功能
支持 QQNT 桌面端 全架构 最低 `25765` 版本到 `27597 ` 版本
支持 QQNT 桌面端 全架构 最低 `25765` 版本到官网最新版本(一般情况是这样的)

:::warning 注意
个人兴趣而制作,开发目的在于学习和探索,一切开发皆在学习,请勿用于非法用途
因使用本项目产生的一切问题与后果由使用者自行承担,项目开发者不承担任何责任
:::



## 外部链接

### Telegram

群聊:https://t.me/LiteLoaderQQNT
频道:https://t.me/LiteLoaderQQNT_Channel

### LiteLoaderQQNT
- **Telegram**
群聊:https://t.me/LiteLoaderQQNT
频道:https://t.me/LiteLoaderQQNT_Channel

框架本体:https://github.com/LiteLoaderQQNT/LiteLoaderQQNT
插件模板:https://github.com/LiteLoaderQQNT/Plugin-Template
插件列表:https://github.com/LiteLoaderQQNT/Plugin-List
- **LiteLoaderQQNT**
框架本体:https://github.com/LiteLoaderQQNT/LiteLoaderQQNT
插件模板:https://github.com/LiteLoaderQQNT/Plugin-Template
插件列表:https://github.com/LiteLoaderQQNT/Plugin-List



Expand Down
46 changes: 21 additions & 25 deletions src/guide/plugins.md
Original file line number Diff line number Diff line change
@@ -1,57 +1,53 @@
# 插件

::: warning 警告
此文档为 LiteLoaderQQNT 1.2.x 编写
此文档为 LiteLoaderQQNT 1.2.2 编写
:::



## 安装

### 手动安装

如果你有现成的插件,请先确保是与 LiteLoaderQQNT 兼容的,并且拥有对应依赖插件
- **正常操作**
在设置界面即可看到安装插件功能,阅读描述了解支持的类型,选择文件后重启即可

- **手动操作**
如果你有现成的插件,请先确保是与 LiteLoaderQQNT 兼容,并且拥有对应依赖插件
将插件目录移动到 `LiteLoaderQQNT/plugins` 文件夹内,如果插件是压缩包请先解压

- `plugins` - LiteLoaderQQNT 插件目录
- `xxx` - 你安装的插件根目录
- `manifest.json` - 插件的清单文件
- ...

### 自动安装

- **插件操作**
可以先手动安装社区内开发的插件市场类插件,在其中安装插件



## 卸载

目前并没有提供卸载插件的快捷操作,或使用社区内开发的插件,一些插件市场类插件会提供插件卸载功能
`plugins` 目录中删除对应插件目录。若不想保留插件数据,可根据插件 `manifest.json``slug` 字段在 `data` 目录下删除对应目录



## 寻找
- **正常操作**
在设置界面的插件列表中,找到需要卸载的插件点击管理按钮即可看到卸载相关

### 插件列表
- **手动操作**
`plugins` 目录中删除对应目录,不想保留插件数据在 `data` 目录下删除对应目录

官方维护着一份插件列表,收录了已知的大部分插件,可在官网首页中查看详情
- **插件操作**
使用插件市场类插件,可能会提供卸载插件的功能,找到你想卸载的插件即可

### 通过搜索

LiteLoaderQQNT 的插件基本发布在 GitHub,善用搜索可以快速的找到所需插件

比如在搜索框键入关键词`LiteLoader``插件`,即可找到大量[LiteLoaderQQNT生态的插件](https://github.com/search?q=LiteLoader+%E6%8F%92%E4%BB%B6&type=repositories)
## 寻找

### 官网首页
有几种方式可以找到大量插件

- **官网首页**
LiteLoaderQQNt 官网下面已列出全部已收录插件,点击卡片即可跳转至对应仓库

### 插件市场
- **插件市场**
有一些社区内开发的插件市场,安装后可列出大量插件,官网首页即可找到此类插件

有一些社区内开发的插件市场,手动安装后可列出大量插件
- **插件列表**
官方维护着一份插件列表,收录了已知的大部分插件,可在官网首页中查看详情

- **通过搜索**
LiteLoaderQQNT 的插件基本发布在 GitHub,善用搜索可以快速的找到所需插件


## 开发
Expand Down

0 comments on commit c788643

Please sign in to comment.