/LiteLoaderQQNT

QQNT的插件加载器:LiteLoaderQQNT —— 轻量 · 简洁 · 开源

Primary LanguageJavaScriptMIT LicenseMIT

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 中下载稳定版的方式进行安装(推荐)

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

使用 git clone 的方式安装(不推荐,适合高阶用户)

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

通过 AUR 安装(仅限 Arch Linux 和 Arch-based Linux)

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

启动方法

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

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

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

使用 Launcher (闭源软件):

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

使用 Patch (开源方法):

  1. 若你之前修改过package.json,请将被修改的 package.json 文件内容还原(必须跟QQ原始的文件一样,一个字一个换行都不能变(换行是LF));若是你新安装的QQ,则无需操作。
  2. 确保你有权限能够执行本地PowerShell脚本文件(系统设置 > 开发者选项 > PowerShell中的设置)
  3. 在 LiteLoader 目录内以管理员模式运行patch.ps1脚本
  4. 在弹出的新窗口直接点击下方按钮开始Patch(新版本Patch脚本无需再选择QQ版本)
  5. 至此,安装完成。经过 Patch 后去除了文件校验的 QQ.exe 将永久生效直到重新用安装包安装。
  6. 如果无法正常使用(例如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配置文件

📜 开源协议

MIT License
Copyright (c) 2023 LiteLoaderQQNT