QQNT-Improved (简称 QQNTim) 是一个给 QQNT 的插件管理器，目前处于 Alpha 版本阶段，支持 Windows，Linux 等平台。
本程序不提供任何担保（包括但不限于使用导致的系统故障、封号等）。
QQNTim 是一个用于管理插件的程序，其功能需要通过安装插件实现。
安装前请确保电脑上已经安装了 QQNT (Windows 版需要有内测资格)。
请右键使用 PowerShell 运行 install.ps1 安装插件管理器，uninstall.ps1 卸载插件管理器。
注意: 如果遇到脚本无法打开的情况，请在运行 (Win+R) 中输入以下内容并点击“确定”以允许 PowerShell 运行脚本：
powershell -Command Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force安装前请确保电脑上已经安装了 QQNT。 我们提供了现有的快速安装脚本，你只需要在安装脚本目录下打开终端运行：
# 允许脚本运行
chmod +x ./install.sh ./uninstall.sh
# 安装插件管理器
sudo ./install.sh
# 卸载插件管理器
sudo ./uninstall.sh在任意 QQ 的窗口内按 F5 刷新当前页面，F12 打开开发者工具。
目前，你可以到 Plugins Galaxy 下载插件。
将下载的插件解压到插件文件夹下并重启 QQ，插件即可生效。
插件文件夹位于 用户文件夹\.qqntim\plugins
插件文件夹位于 用户文件夹/.local/share/QQNTim/plugins
一个示例配置文件如下所示：
{
// (可选) 插件加载相关设置
"plugins": {
// 插件加载黑、白名单
// (应指定插件的 ID，可以在插件的 qqntim.json 内的 id 栏查看)
// ----------------------------------------------------
// (可选) 插件加载白名单，指定后只有白名单内的插件才会加载
"whitelist": [],
// (可选) 插件加载黑名单 ，指定后只有黑名单内的插件会跳过加载
"blacklist": ["mica", "mica-ui"]
// ----------------------------------------------------
}
}配置文件位于 用户文件夹\.qqntim\config.json
配置文件位于 用户文件夹/.local/share/QQNTim/config.json
本项目使用 Yarn 3 作为包管理器，运行以下命令配置项目：
corepack enable
yarn运行以下指令构建项目，构建产物在 dist 文件夹下。
yarn build提示: 可参照 Plugins Galaxy 中的插件进行开发。
你需要在插件文件夹下创建一个文件夹以存放你的插件文件。
创建一个 qqntim.json 文件，里面应包含插件的基本信息。一个完整的 qqntim.json 示例如下：
{
// 此插件的唯一 ID，不能与其他插件重复
"id": "my-plugin",
// 显示名称
"name": "我的插件",
// 作者
"author": "我",
// (可选) 插件加载条件 (需要满足全部条件才会加载)
"requirements": {
// (可选) 限定插件支持的操作系统版本 (满足其中一个条件即可)
"os": [
{
// 插件支持的操作系统平台，可以是：
// win32 (Windows)，linux (Linux)，darwin (macOS)
"platform": "win32",
// ----------------------------------
// 可以使用多个项目来指定一个区间，例如：
// {
// "platform": "win32",
// "lte": "10.0.22621",
// "gte": "6.1"
// }
// 代表满足 Windows 7 <= 当前系统版本 <= Windows 11 22H2
// (6.1 <= 当前系统版本 <= 10) 时加载插件
"lte": "x", // (可选) 当前版本小于等于 x
"lt": "x", // (可选) 当前版本小于 x
"gte": "x", // (可选) 当前版本大于等于 x
"gt": "x", // (可选) 当前版本大于 x
"eq": "x" // (可选) 当前系统版本等于 x
// ----------------------------------
}
]
},
"injections": [
// 为 QQNT 注入脚本
// 为主进程注入脚本
{
"type": "main",
// (可选) 待注入的脚本文件
"script": "main.js"
},
// 为渲染进程注入脚本或 CSS 样式表
{
"type": "renderer",
// (可选) 只有网页 URL 匹配此正则表达式时此注入才生效
"pattern": ".*",
// (可选) 只有在指定窗口此注入才生效，可以是：
// login (登录窗口)，main (主窗口)，chat (独立聊天窗口)，settings (设置窗口)，others (其他)
"page": ["main", "chat", "login"],
// (可选) 待注入的脚本文件
"script": "main.js",
// (可选) 待注入的样式文件
"stylesheet": "style.css"
}
]
}脚本可以控制、更改 QQNT 的行为，而 CSS 只能修改样式。
脚本文件需要导出一个函数，该函数即为插件的入口，示例如下：
module.exports = (qqntim) => {
console.log("Say hello!", qqntim);
};其中，你可以通过 qqntim 与 QQNTim 进行交互。
主进程脚本可用于实现拦截窗口创建，修改消息等目的。
你可以查看 Electron 官方教程 了解主进程的概念。
要拦截窗口创建，为其添加额外的参数，请使用：
module.exports = (qqntim) => {
qqntim.interrupt.windowCreation((args) => {
return {
...args,
// 给窗口加上系统自带的边框 :)
frame: true,
};
});
};其中，args 是窗口参数，你需要在拦截函数内，返回一个新的修改后的窗口参数。
要拦截渲染进程到主进程的 IPC (进程间通讯)，请使用：
module.exports = (qqntim) => {
qqntim.interrupt.ipc((args) => {
console.log("截获到一条消息！", args);
// 返回 true 继续传达消息，返回 false 拦截消息
return true;
});
};你可以通过直接修改 args 修改消息内容。
渲染脚本可用于修改 UI 界面，修改交互逻辑等（相当于在一个网页上运行脚本）。
你可以查看 Electron 官方教程 了解渲染进程的概念。
要拦截主进程到渲染进程的 IPC (进程间通讯)，请使用：
module.exports = (qqntim) => {
qqntim.interrupt.ipc((args) => {
// 当受到新消息时
if (
args[1] &&
args[1][0] &&
args[1][0].cmdName == "nodeIKernelMsgListener/onRecvMsg"
) {
console.log("截获到一条新消息：", args);
// 有大约 50% 的概率，会抛弃此消息 :D
return Math.round(Math.random()) == 0;
}
// 返回 true 继续传达消息，返回 false 拦截消息
return true;
});
};你可以通过直接修改 args 修改消息内容。
有时，我们在加载插件时，页面还未完全加载，为了确保能选中自己需要的 DOM 元素，请使用：
module.exports = (qqntim) => {
qqntim.windowLoadPromise.then(() => {
// 此时基本所有 QQNT 的脚本和样式都已经加载完毕了，现在你可以对界面元素进行修改了
console.log("窗口加载完毕");
// 在窗口控制区域放一个按钮，按下就弹出：来自渲染进程的问候
qqntim.utils.waitForElement(".window-control-area").then((container) => {
// 在 container 最前方增加一个按钮
const button = document.createElement("button");
button.innerText = "点我";
button.addEventListener("click", () => {
alert("来自渲染进程的问候 :)");
});
container.insertBefore(button, container.firstElementChild);
});
});
};本程序使用 GNU Lesser General Public License v3.0 or later 协议发行。
请在此源代码树下的 COPYING 和 COPYING.LESSER 查看完整的协议。