零门槛全场景：LiteLoaderQQNT插件加载器新手安装指南

解锁插件潜能，让QQ功能无限扩展。本教程专为零基础用户打造，通过环境诊断、智能部署、问题攻坚和效能提升四个阶段，帮助你轻松完成LiteLoaderQQNT的安装与配置，无需专业知识也能让QQ焕发新活力。

环境诊断：你的设备准备好了吗？

在开始安装LiteLoaderQQNT之前，我们先来做个全面的环境诊断，确保你的设备符合安装要求。

兼容性仪表盘

系统类型	最低版本要求	必要权限
Windows	Windows 10	管理员权限
macOS	macOS 10.15	终端完整磁盘访问权限
Linux	主流发行版	普通用户权限

环境检测三步曲

🔧 检查网络连接

ping -c 3 baidu.com

预期：显示时间数字表示网络正常；出现"请求超时"则需先解决网络问题。

🔧 确认QQ已安装 Windows用户：按下Win+R，输入appwiz.cpl查看已安装软件列表 Mac用户：在启动台查看是否有QQ图标 Linux用户：

which qq

预期：能找到QQ安装路径或看到QQ图标。

🔧 检查命令行工具 Windows PowerShell：

Get-Command curl

Mac/Linux终端：

curl --version

预期：显示curl版本信息。

💡 原理小贴士：curl是一个用于传输数据的命令行工具，安装脚本需要它来下载必要的文件。

智能部署：选择你的战场

根据你的使用场景，选择最适合的安装方式。

家庭用户：一键安装

Windows PowerShell（新手模式）：

irm https://gitcode.com/gh_mirrors/li/LiteLoaderQQNT_Install/raw/main/install.sh | iex

操作预期：脚本自动运行，出现提示时按Y继续 结果验证：安装完成后会显示"安装成功"提示

Mac/Linux终端（新手模式）：

bash <(curl -s -L "https://gitcode.com/gh_mirrors/li/LiteLoaderQQNT_Install/raw/main/install.sh")

操作预期：等待脚本自动运行，根据提示进行操作 结果验证：安装完成后会显示"安装成功"提示

开发者：自定义安装

# 克隆仓库（高手模式）
git clone https://gitcode.com/gh_mirrors/li/LiteLoaderQQNT_Install
cd LiteLoaderQQNT_Install

# 自定义安装路径
bash install.sh --ll-dir /你的自定义路径

操作预期：脚本会按照指定路径安装LiteLoaderQQNT 结果验证：安装完成后会显示安装路径和"安装成功"提示

企业环境：AppImage版本

# AppImage专用安装（高手模式）
bash install.sh --appimage

操作预期：脚本会为AppImage格式的QQ安装LiteLoaderQQNT 结果验证：安装完成后会显示"AppImage版本安装成功"提示

⚠️ 注意：Windows用户可能会看到用户账户控制弹窗，点击"是"；安装过程中保持终端窗口打开，不要关闭。

问题攻坚：症状-病因-处方

症状一：安装后QQ设置里找不到LiteLoader

病因：QQ进程未完全退出或安装未成功完成。

处方：

1. 关闭所有QQ窗口，确保QQ完全退出
2. 重新启动QQ
3. 如果问题依旧，尝试重新运行安装命令

症状二：Windows系统提示"权限不足"

病因：当前用户没有足够的权限执行安装操作。

处方：

1. 右键点击终端/命令提示符
2. 选择"以管理员身份运行"
3. 重新执行安装命令

症状三：Mac提示"无法验证开发者"

病因：macOS的安全设置阻止了未验证的开发者程序。

处方：

1. 打开"系统偏好设置→安全性与隐私"
2. 点击"仍要打开"
3. 授予终端完全磁盘访问权限

防坑预设

💬 用户可能误解的操作节点：

• 安装过程中不要关闭终端窗口，即使看起来没有反应
• 确保QQ已完全退出后再进行安装
• 使用管理员权限运行命令不是可有可无的步骤，特别是在Windows系统上

效能提升：性能调优三阶进阶

基础阶：保持插件精简

• 只保留常用插件，太多插件会让QQ变慢
• 定期在插件中心检查更新
• 遇到QQ卡顿，可先关闭不必要的插件试试

进阶阶：自定义配置

# 查看当前配置
bash install.sh --config

# 修改缓存路径
bash install.sh --cache-dir /新的缓存路径

操作预期：修改配置后需要重启QQ才能生效 结果验证：在LiteLoader设置中可以看到新的配置信息

专家阶：源码级优化

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/li/LiteLoaderQQNT_Install

2. 根据自己的需求修改源码：

   • 调整插件加载顺序：编辑LaunchQQ.py
   • 优化资源占用：修改get_qqnt.py中的资源加载策略

3. 重新构建安装脚本：

bash repack_appimage.sh

💡 原理小贴士：通过修改源码，你可以定制LiteLoaderQQNT的行为，使其更符合个人使用习惯和性能需求。

通过以上四个阶段的操作，你已经成功安装并优化了LiteLoaderQQNT插件加载器。现在，你可以在插件中心浏览并安装各种有趣的插件，让QQ变得更强大、更好用！如果遇到其他问题，可以查看项目中的README.md文档获取更多帮助。