Scriptio

Note

此插件 1.0.0 版本及以上最低支持 LiteLoaderQQNT 1.0.0，之前版本的 LiteLoaderQQNT 请使用 1.0.0 之前的 Release

LiteLoaderQQNT 插件，用于为 QQNT 加载任意渲染层的 JavaScript 片段。

你可能也感兴趣：Transitio，自定义 CSS 片段加载器。

🪄 具体功能

• 导入 js 代码片段
• 启用/禁用 js 代码片段
  • 约定：说明若以 * 开头，则启用/禁用此脚本需要重启/重载 被注入此脚本的窗口 生效，否则立即生效
  • 由于 js 代码的复杂性，立即生效由脚本自行实现，Scriptio 仅提供 scriptio-toggle 事件以供脚本监听 (参考 Wiki 中的 响应性脚本 章节)

🖼️ 截图

演示中使用了 MSpring-Theme，主题色为 #74A9F6。

📥 安装

插件商店

在插件商店中找到 Scriptio 并安装。

手动安装

• 稳定版: 下载 Release 中的 scriptio-release.zip，解压后放入数据目录下的 plugins/Scriptio 文件夹中即可。(若没有该文件夹请自行创建)
• CI 版: 若想体验最新的 CI 功能，可以下载源码后同上安装。(仅需下载下面列出的文件)

完成后的目录结构应该如下:

plugins (所有的插件目录)
└── Scriptio (此插件目录)
    ├── manifest.json (插件元数据)
    ├── main.js (插件脚本)
    ├── preload.js (插件脚本)
    ├── renderer.js (插件脚本)
    ├── settings.html (插件设置界面)
    └── icons/ (插件用到的图标)

🤔 使用方法

Warning

由于 js 代码的复杂性，禁用/修改部分脚本可能需要重启/重载生效

• 启用/禁用脚本：打开插件设置界面，将对应的脚本开关打开/关闭。
  • 注意：禁用脚本，实际上是在文件内第一行注释末尾添加了 [Disabled] 标记。
• 导入脚本：在配置界面导入 JS 文件，或将之放入 data/Scriptio/scripts/ 文件夹。
  • JS 文件首行的注释（若有）会被当作脚本说明，显示在设置界面中。
  • 可以在此文件夹下创建多层目录，插件会自动扫描所有 JS 文件，但是设置界面导入的还是默认直接放在 data/transitio/styles/ 下（v1.1.0 起）
• 删除脚本：点击删除按钮，或进入 data/Scriptio/scripts/ 文件夹删除对应文件。
  • 鼠标悬停在脚本标题上时，会显示其完整的相对路径。
• 修改脚本：修改对应文件即可。
• 更新脚本：重新导入即可。
• 重载脚本：双击 "导入脚本..."。

💻 调试

• 开发者模式：若您想要调试您的用户脚本，可以在插件设置界面打开开发者模式，此时插件会监控 data/scriptio/scripts/ 文件夹，当发生更改时，会自动重载。
• Debug 模式：若您想要调试此插件本身，可以使用 --scriptio-debug 参数启动 QQNT，此时插件会在控制台输出调试信息。

📜 用户脚本

Note

以下脚本均为由我/其它用户编写的用户脚本，不内置在插件中。

你可以下载后修改其内容来满足你的需求，随后将其导入到插件中来体验。或者，若你装有 插件商店，你可以直接在插件商店中点击安装它们（此项功能正在测试中）。

若你有愿意分享的脚本，欢迎提交 PR 或 Issue 来将它们添加到这里。编写脚本前推荐先阅读 Wiki。

Warning

请不要在文件名中使用诸如句点 ., 空格 , 加 + 等特殊字符，否则可能会导致插件无法正常工作。推荐仅使用字母、数字、下划线 _ 与连字符 -。 v1.1.0 起已支持多层目录以及文件名中含特殊字符。

名称	作者	说明	实时响应	链接
hitokoto	PRO-2684	输入框展示一言	✔️	GitHub
hook-vue	PRO-2684	Hook Vue 实例	✖️	GitHub
img-quick-close	PRO-2684	快速关闭图片	✖️	GitHub
msg-record-enhance	PRO-2684	查看聊天记录中部分发送者 QQ，需要 hook-vue.js 的支持	✖️	GitHub
open-in-browser	PRO-2684	小程序若可行则浏览器打开	✔️	GitHub
plugin-icon	PRO-2684	设置界面展示插件图标（若有）	✖️	GitHub
shortcutio	PRO-2684	添加一些常用的快捷键	✔️	GitHub
to-contact-list-top	lgc2333	添加一个回到聊天列表顶部的侧边栏按钮	✔️	GitHub
show-time	PRO-2684	消息显示时间，需要 hook-vue.js 的支持	✔️	GitHub