LiteLoaderQQNT

LiteLoaderQQNT 是 QQNT 的插件加载器，一般在 QQNT 的环境内简称为 LiteLoader。
它可以让你自由地为 QQNT 添加各种插件，并实现例如美化主题、增加功能等各种功能。

Telegram 闲聊群：https://t.me/LiteLoaderQQNT
LiteLoaderQQNT 主页：https://llqqnt.mukapp.top

⚠️ 注意事项

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

目前仍在开发当中，可能会存在一些问题和不足。
仅为个人兴趣而制作，开发目的在于学习和探索。
能力有限，随缘更新。不过也欢迎各位来提交PR。
由于项目特殊性，必要时会停止开发或删除仓库。

创建和谐社区环境，建设靠大家。开源社区需要你！
有问题请先发 issue，若是开发者可提交 PR 来帮助项目完善变得更好！
普通用户也可参与项目发展，提出新想法新建议，问题再小也是问题！
而不是进群吐槽抱怨，不仅污染社区环境，还不能解决实际问题。
更不建议去攻击他人，请从实际问题思考解决，而不是互相攻击。

💻 插件开发

如需上架插件市场，请参考最新的插件模板（暂未完工），也建议参考其他插件。
需要打包的插件请在仓库发布 Release，文件建议使用 Github Actions 打包。
插件模板：LiteLoaderQQNT-Plugin-Template
插件仓库：LiteLoaderQQNT-Plugin-List

高版本 QQNT 无法打开自身的 DevTools，请安装第三方调试插件（推荐 Chii Devtools 插件）

📖 安装教程

安装 LiteLoaderQQNT 之前，确保你安装好了基于 QQNT 架构的 QQ。安装分为从 Releases 中下载稳定版（推荐）和通过 git clone 安装。

新版本框架安装时新版 Windows QQNT 无需且不要修改 QQNT安装目录/resources/app/package.json。

Linux & MacOS 版仍然需要修改 QQNT安装目录/resources/app/package.json。

具体哪些版本需要修改package.json，参见下方安装方法中的支持矩阵。

若你的系统需要修改，请不要修改 LiteLoader 文件夹内的 package.json。应该修改 QQNT安装目录/resources/app/package.json。

安装位置

正常情况下，需要将含有 LiteLoaderQQNT 本体的文件夹放到 QQNT安装目录/resources/app 下。

对于不同系统，默认情况下此位置可能为：

Windows: C:\Program Files\Tencent\QQNT\resources\app
Linux: /opt/QQ/resources/app
MacOS: /Applications/QQ.app/Contents/Resources/app

安装完成后的目录结构应类似于这样：

├─app_launcher
├─LiteLoader    <- 含有 LiteLoader 本体的文件夹
│  ├─builtins
│  ├─src
│  ├─package.json
│  └─...
├─package.json  <- 具体哪些版本需要修改，参见下方安装方法中的支持矩阵
└─...

需要修改的 package.json 的示例（具体哪些版本需要修改，参见下方安装方法中的支持矩阵）：
将 "main": "./app_launcher/index.js" 改为 "main": "./LiteLoader"

{
    ...
    "homepage": "https://im.qq.com",
    "sideEffects": true,
-   "main": "./app_launcher/index.js",
+   "main": "./LiteLoader",
    ...
}

安装方法

支持矩阵

系统或版本	启动器（Launcher）	Patch脚本	手动修改Package.json
Linux QQ	无需	无需	需要
MacOS QQNT 6.9.18 及以上（不支持）	无法使用	无法使用	无法使用
MacOS QQNT 6.9.18 以下或者 App Store 版	无需	无需	需要
Windows QQNT 9.9.1 版本以下	无需	无需	需要
Windows QQNT 9.9.1-15717	无需	无需	需要
Windows QQNT 9.9.1版本及以上（不包含15717）	可用	可用	不要修改，若修改请恢复原状

对于 Windows QQNT 9.9.1 版本（除 15717 版本外）以上，安装后请阅读启动方法

从 Releases 中下载稳定版的方式进行安装（推荐）

从 Releases 中下载最新的 LiteLoaderQQNT.zip。
解压出 LiteLoaderQQNT.zip 内的 LiteLoader 文件夹到安装位置。
上方支持矩阵中，若你的QQ是需要修改 package.json 的系统或版本，请按照安装位置中的说明对package.json进行修改。
至此，安装完成。

使用 git clone 的方式安装（不推荐，适合高阶用户）

确保你的系统装有 Git。
在终端中打开上文提到的 LiteLoaderQQNT 需要安装到的位置。
输入 git clone https://github.com/LiteLoaderQQNT/LiteLoaderQQNT.git --recursive LiteLoader 拉取项目与子模块。
上方支持矩阵中，若你的QQ是需要修改 package.json 的系统或版本，请按照安装位置中的说明对package.json进行修改。
至此，安装完成。

通过 AUR 安装（仅限 Arch Linux 和 Arch-based Linux）

确保你没有安装 Linux QQ 或已从 AUR 安装非 linuxqq-appimage 包的 Linux QQ。
使用你的 AUR Helper 安装 liteloader-qqnt-bin 包（对于想要使用最新代码的用户，请安装 liteloader-qqnt-git 包）。
至此，安装完成。

启动方法

由于 Windows QQNT 9.9.1 版本和 MacOS QQNT 6.9.18 版本开始被添加文件校验，
MacOS 目前只能通过安装 App Store 版 QQNT 来解决（仍然不含文件校验），或安装老版本。
更老版本 QQNT 以及 Windows 9.9.1-15717 版本没有添加文件校验，所以无需阅读这段教程。

以下教程仅针对可用启动器或Patch脚本的QQ（参见上方支持矩阵）；而其他系统和版本的用户请忽略本节，正确按照上面安装方法操作后直接点开QQ就能用。

以下两种方式任选其一即可

使用 Launcher （闭源软件）：

若你之前修改过package.json，请将被修改的 package.json 文件内容还原（必须跟QQ原始的文件一样），如果无法恢复建议重装一次QQ；若是你新安装的QQ，则无需操作。
从 releases 中下载额外的 Launcher（LiteLoaderQQNT-Launcher_x64.exe 或 LiteLoaderQQNT-Launcher_x86.exe），Launcher 可以只用x86版本。
将额外下载的 Launcher 移动到 QQNT 安装目录下 QQ.exe 同级目录。
至此，安装完成。为了加载 LiteLoaderQQNT，你需要每次运行都使用 Launcher 而不是 QQ。（可以将QQ的快捷方式目标程序修改为 Launcher ）

使用 Patch （开源方法）：

若你之前修改过package.json，请将被修改的 package.json 文件内容还原（必须跟QQ原始的文件一样，一个字一个换行都不能变（换行是LF））；若是你新安装的QQ，则无需操作。
确保你有权限能够执行本地PowerShell脚本文件（系统设置 > 开发者选项 > PowerShell中的设置）
在 LiteLoader 目录内以管理员模式运行patch.ps1脚本
在弹出的新窗口直接点击下方按钮开始Patch（新版本Patch脚本无需再选择QQ版本）
至此，安装完成。经过 Patch 后去除了文件校验的 QQ.exe 将永久生效直到重新用安装包安装。
如果无法正常使用（例如Patch完毕后启动，提示QQ损坏），建议重装一次QQ并手动删除上次Patch遗留下来的QQNT安装目录/resources/app/backage.json文件。

如果 Launcher 或 Patch 运行失败无反应请尝试使用管理员权限运行重试

📂 数据目录

LiteLoaderQQNT 的默认数据文件夹在 用户目录/Documents/LiteLoaderQQNT，修改环境变量 LITELOADERQQNT_PROFILE 可指定目录位置。

数据目录结构：

LiteLoaderQQNT
    ├─plugins           <- 插件本体目录
    │   ├─my-plugin     <- 插件本体
    │   └─...
    ├─plugins_cache     <- 插件缓存目录
    │   ├─my-plugin
    │   └─...
    ├─plugins_data      <- 插件数据目录
    │   ├─my-plugin
    │   └─...
    └─config.json       <- LiteLoader配置文件

Mr-Ao-Dragon/LiteLoaderQQNT