Skip to content

PRO-2684/Scriptio

Repository files navigation

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

📥 安装

插件商店

在插件商店中找到 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
hook-fetch PRO-2684 Hook window.fetch ✖️ GitHub
img-quick-close PRO-2684 快速关闭图片 ✖️ GitHub
inspectio PRO-2684 添加各类提示信息,详见 README,需要 hook-vue.js 的支持 ✔️ GitHub
link-preview PRO-2684 链接预览:鼠标经过链接时尝试加载浏览,悬浮显示链接的标题和描述,需要 hook-vue.js 的支持 ✔️ GitHub
msg-record-enhance PRO-2684 查看聊天记录中部分发送者 QQ,需要 hook-vue.js 的支持 ✖️ GitHub
open-in-browser PRO-2684 小程序若可行则浏览器打开 ✔️ GitHub
pangu PRO-2684 编辑框内按下 Ctrl+P 后,自动在中英文、中文与数字之间添加空格,并进行合适的标点符号处理 ✔️ GitHub
plugin-icon PRO-2684 设置界面展示插件图标(若有) ✖️ GitHub
privacio PRO-2684 保护你的隐私:阻止 QQ 的一些追踪行为,需要 hook-fetch.js 的支持。 ✔️ GitHub
relay-self PRO-2684 允许接龙自己的消息,需要 hook-vue.js 的支持 ✔️ GitHub
shortcutio PRO-2684 添加一些常用的快捷键 ✔️ GitHub
show-time PRO-2684 消息显示时间,需要 hook-vue.js 的支持 ✔️ GitHub
smooth-transition PRO-2684 为页面间导航添加平滑过渡动画 ✔️ GitHub
to-contact-list-top lgc2333 添加一个回到聊天列表顶部的侧边栏按钮 ✔️ GitHub