LiteLoaderQQNT - 防撤回插件
这是一个用于LiteLoaderQQNT的插件,提供较为完善的防撤回功能。 使用前需安装LiteLoaderQQNT,并在QQNT新版上使用。
建议加入更新日志频道,接收最新更新和使用提示https://t.me/llqqnt_xh。
由于工作原因暂无时间更新,欢迎有能力的朋友提交PR。 目前支持的版本:小于等于9.9.7-21453,高于此版本未经测试不做任何保证,如升级QQ后遇到问题建议降级,感谢理解。
使用方法
建议从LiteLoaderQQNT
应用商店中直接下载安装,方便快捷。(新版本1.0LiteLoaderQQNT
没有插件商店了,请遵循下面的手动安装方法)
手动安装:请前往版本发布页面下载最新版压缩包(qq-anti-recall.zip
),在LiteLoaderQQNT数据目录/plugins/
下新建文件夹(名称任意,建议为插件名称),将插件压缩包内容解压到此文件夹,重启QQNT即可。
直接克隆源码的话,记得需要手动执行npm install
。
版本不兼容提示:从0.2.29起,插件已适配1.0版本以上LiteLoaderQQNT
框架,同时不再兼容旧版框架,请遵循安装方法更新框架。
版本提示:从0.2.35起,自旧版本升级的用户会丢失配置和已撤回数据库,需要手动迁移,这是因为之前的数据目录写入错误。迁移过程:将LiteLoaderQQNT数据目录/qq-recalled-db
文件夹移动到LiteLoaderQQNT数据目录/anti_recall
文件夹内即可(最终路径:LiteLoaderQQNT数据目录/anti_recall/qq-recalled-db
。不建议迁移配置文件,可能已被其他配置文件覆盖,建议重新配置插件(配置项不多)。
注意:如果你是从旧版更新到新版(1.0)框架后,需要将LiteLoaderQQNT
数据目录中的plugins_data文件夹重命名为data,否则之前的记录和配置文件会丢失。(如果仍然丢失就没办法了)
反撤回失效的情况
- QQ接到消息时已经被撤回(只接到了撤回的消息)。
- QQ未在线时接到的消息(上线后已经被撤回)。
- 从接到某条消息开始到这条消息撤回,还收到了超过
MaxMsgSaveLimit(内存中消息最多缓存条数)
条消息(可以在配置界面里配置)。 - 插件出现错误。
重启QQ后反撤回失效?
请使用命令行运行QQ,并观察日志输出。
如果出现:数据库打开失败的提示,并且下面的cause类似于
cause: [Error: IO error: LockFile <LiteLoaderQQNT数据目录>\data\qq-recalled-db/LOCK...]
可能是你之前的QQ退出不完全,或者你开了两个QQ。
请完全关闭QQ进程,并重试。若还不行,可能是数据库文件损坏,考虑清空上面的路径(<LiteLoaderQQNT数据目录>\data\qq-recalled-db)中的LOCK文件,若还不行,清空所有文件(会导致之前反撤回内容丢失)。
简要说明
在NTQQ打开期间无论怎样操作,反撤回均能生效。
若开启数据库储存(默认关闭,请前往配置界面手动开启),NTQQ重启后可恢复已撤回的消息,目前已测试文本、表情、图片、转发消息均能正常恢复;文件若没下载则不能打开,但还能看见文件消息本身;其他消息类型未测试,不提供保证。
若不满意撤回的颜色、阴影和提示,也请前往配置界面手动调整。
若反撤回消息太多,累积在数据库里可能造成加载卡顿,现在已经做了优化,一般来说不需要清理,但如果觉得卡顿,如有必要,还是可以隔一段时间通过插件配置界面清理一次已储存的消息。
详细说明
所有被撤回的消息会被带上红框,下方会出现"已撤回"的小提示(均可通过配置关闭)。重新进入消息界面已撤回的消息仍然可以正常显示。
使用LevelDB进行数据持久化储存,默认不启用,需要手动去设置里开启。如果不开启,重启QQ消息会丢失。若开启,当前版本重启QQ后已能恢复文字、图片、转发和表情消息,其他消息不提供保证,若不能恢复请提ISSUE
。
LevelDB
有时候启动时会加载失败,导致无法加载反撤回数据库内容。如果发现之前的反撤回失效,重启QQ一般都能解决(目前正在尽力避免这种问题)。
如果你需要调整撤回样式,请前往插件的设置界面,手动修改调整。
不建议手动修改配置文件,修改后不会实时生效(需要重启QQ),建议用配置界面修改。
现在,即使图片在撤回之前未打开过,撤回后也能继续查看了,并且不止缩略图,点开看也是可以的!即使图片显示为灰色的损坏样式,你也可以双击试试能不能打开看。 但是如果不是在眼前撤回的,而是撤回后你才进入聊天界面查看,图片仍会转圈一段时间(请耐心等待)。推测这是因为QQ会先检查图片是否存在,撤回后还未下载所以不存在,因此会转圈;待插件下载好图片后,需要等待QQ重新检查,才能显示图片。
如果图片撤回得太快,反撤回后可能会一直加载不出来,这可能是因为图片已从服务器上删除,这种情况下是无法恢复的。
原理介绍
之前版本(已过时): 为什么在简介中说这是简易的呢?因为这个防撤回原理是通过拦截撤回消息的IPC实现的,这样消息就不会被删除。但是,如果重新打开消息界面,NTQQ似乎会重新向逻辑层拉取一次消息(旧版QQ的防撤回直接从通信层拦截了撤回包,所以没有这个问题;而本插件仅拦截到了渲染层的IPC,逻辑层仍是一个黑盒),导致消息仍然被撤回。
现在版本的变更: 在接收到消息后,会将消息存储在内存中。进入消息界面后,如果发现撤回,会拦截撤回包,并显示红色边框以及给文字添加删除线。如果重新进入消息页面,会遍历消息列表,若发现撤回提示,会寻找之前保存的消息。如果找到,则将撤回提示替换为之前保存的消息,并显示红色边框以及给文字添加删除线;如果未找到,则仍显示撤回提示。这样,重新进入消息界面仍然可以正确反撤回(包括打开独立聊天界面也可以)。
- 为避免占用过多内存,内存中缓存消息的上限默认为10000条。如有需要,可在插件设置界面修改。这个值的含义是,假设默认最多存10000条,那么在总接收到的消息中,10000条之前的消息如果被撤回则无法恢复。不过,如果一条消息在撤回后你查看了,并且反撤回生效(也就是只要你看到了这条消息出现红框和删除线),则这条消息会被额外存储到专门的"已撤回消息数组"中(如果开启数据库,也会同时存入数据库),这个数组没有容量上限,不受本限制约束。
- 为避免可能存在的并发问题,当消息超过上述限制后,每次接收到消息时,默认会删除内存缓存中的前500条消息,直到低于上述上限。这个500条你也可以通过插件设置页面来修改。建议修改为你平均每秒接收到的消息数量。
- 如果开启数据库存储功能,则任何撤回的消息都会存入本地数据库(位于LLQQNT的插件数据目录(
plugin_data
)中),以便于重启后读取已撤回的消息记录。数据库明文存储(后续会推出加密功能),请谨慎保管。
相关详细的原理和说明请参阅源码。
协议及免责声明
MIT协议 | 禁止用于任何非法用途,插件开发属学习与研究目的,仅供自用,未提供给任何第三方使用。任何不当使用导致的侵权问题,责任自负。