QQListener 班级群消息监听器

xxt8582753

注：本程序不一定所有班都用得到，它在我们班上工作正常。我们学校每个班希沃上都有一个班级公用QQ号方便接收老师信息。本程序也不仅局限于教育相关用途。另外我自己写的代码一坨屎，这里感谢 @ hxabcd 帮我重构项目，虽然已经重构成我本人都看不懂了

官网：QQListener

GitHub：QQListener GitHub

老师经常在班级QQ群内发送通知（比如提醒同学打电话给家长，或者发布参考答案等）电脑端QQ会以Toast形式展现，但它在班级大屏上太不显眼了，很容易错过重要通知。所以我决定用Python编写一个监听器，实时获取QQ群消息并在大屏幕上以更显眼的方式展示。

主要功能

毫秒级悬浮通知

采用 Fluent 风格设计的半透明悬浮窗，醒目又不遮挡视线。

个性化配置中心

化繁为简。在这里你可以轻松配置监听关键词和人员、通知外观和声音，支持高度自定义的 JSON 导出。

超级呼叫模式

在呼叫模式下，QQListener 会播放电话铃声和动画效果，直到有同学响应，确保信息传达到位。

适配所有用户

自动深浅色切换 + 内置 22 套主题 + 支持简体中文/英语/日语 3 种语言（但是就我这N5都够不着的水平后面都懒得翻了），确保每位用户都能获得最佳体验。

核心亮点

极速响应

底层采用原生 WinSDK 接口，低延迟捕捉每一条群消息。

智能播报

集成 Edge-TTS 神经网络语音，AI帮你催作业。

多级控制

智能识别一般、重要、紧急事件，支持分级通知管理和消息过滤。

界面美观

纯正 PySide6 开发，采用 Fluent Design 风格，适配班级大屏。

极简配置

自动适配大多数 QQ 版本，JSON 配置文件支持高度自定义。

安全无虞

本地化数据处理，不上传隐私信息，代码完全透明可见。

注意事项

使用本程序必须更新到Win10 1903版本，因为它依赖WinSDK
打开 Windows 设置 -> 系统，关闭专注模式，并禁用自动启用专注模式
必须用NT QQ，旧版QQ无法发通知
具体见详情

CreeperAWA

我以前也做过一个，不过目前停止维护了，在筹备 C# 的版本，目前这个版本的动画我觉得太卡顿了
CreeperAWA/ToastBannerSlider
全部用的 Vibe Coding，不过经过了长时间的打磨，应该没有什么很致命的 Bug。目前的已知 Bug 就是横幅太多了以后，后面横幅的滚动动画不能正确开始，文字位置不能正常计算，但实际使用场景应该做不到满屏横幅

然后我没有做 TTS，班上用不到，不过 C# 的版本我是有准备 TTS 的（而且考虑做个廉价版的 TTS 引擎，能把每个字的读音按文件放进去，根据读音拼接，可以把班上老师的放进去，识别发送人播报〔火车站说是〕），而且考虑搭配 OpenCV 识别黑板是否关上（可以平时没有 TTS，如果黑板被关上后就开始播放〔化学老师：怎么回事，怎么办〕）

hxabcd

CreeperAWA
😨 这个功能又是怎么产生的

CreeperAWA

hxabcd 看 Releases，里面有写，大概是 10 月 6 号的一个
这就不得不提我们电教主任了……

故事：
2024 年 11 月 10 日，学校莫名其妙新来了一个老师，又莫名其妙突然当上电教主任，再莫名其妙的给全校一体机重装系统，安装希沃管家。我检查了一下，又发现有冰点还原，那既然如此，我肯定也要莫名其妙的发脾气，所以我莫名其妙的给班上一体机选择了在升旗的时候重装系统。我直接插上随身携带的 PE U 盘，复制了一个看得顺眼的镜像（原版 Win10 22H2），然后把 EasyRC 也甩进去了，开个自动部署就走人。但！是！我忘记关冰点还原了，所以重启了没自动引导到 PE，失败了（不过还好忘记关冰点还原，要不然数学老师来了我还得装展台）。
虽然失败了，但是这并不能阻挡我（毕竟本来就有过重装系统的打算，Win7 触摸不好用），我直接跟班主任打报告，说做操我不下去了，我重装系统，班主任给了我一摞作业，让我一边装系统一边发了。很顺利，莫名其妙的没有出现任何意外。
但既然学校刚刚装了希沃管家，那肯定是要看的，所以不出意外，第三天中午就有人来补装希沃管家。当时希沃的下载页面是一大堆版本放在一起的，第一个是 arrch64 版本，他看都不看就下那个，结果研究折腾了半天都装不上（x64 的 Win10，下的 Linux 版本的怎么可能被他装上。当时折腾了半天，我甚至去上了个厕所），后面中午上课了，我看他还用的是密码绑定（边上还有同学说某国核弹密码），装完拍照就走了。
不能忍不能忍！我要卸载。
卸载后过了几天没事，第二周周一我还用电工胶布把摄像头贴上了。后来期中考试，我因为月考发挥比较好（经典入学第一次考的最好，一学期里第一次考得最好，上学以后休息不行，每天昏昏欲睡），就在自己班的教室考。考试的时候那个电教主任发消息要求所有监考老师把一体机打开，然后把黑板拉上，还贴心的强调了学生不需要看一体机。但希沃管家早已被我解决，自然无事发生。
（当时考的英语，我其实还有点担心会不会用这个放听力，不过我快就得到答案了，学校依然用的广播放）
考完以后那个电教主任就到班上了，默默补装。当时我还把网线拔掉了，他尝试用希沃管家的悬浮窗（桌面助手说是）的网络那里，连学校 Wi-Fi（那个是操作的 Android 的网络），输密码的时候，我和我朋友就凑过去看，他还说不许看（不看就不看，反正我知道的比他还早）。
已经装了三次了，那我肯定也要防一防了，所以我当时装了火绒
这里还有个小插曲。我有个喜欢囤安装包的朋友，有个 5 版本的火绒，我当时图方便就用了，毕竟我为了防止意想不到的事情发生，就拔网线了。但是……这个日子，这个 Windows 版本，这个火绒版本，记性好反应快的人应该就想到会发生什么了，但可惜我不是那种人。所以我当然就直接装上了，然后 explorer.exe 就进隔离区了。当时本来打算直接关机，反正也没人用，但是我另一个朋友把 HibitUninstaller 弄出来了，所以就把火绒卸载了，用卸载程序还原了隔离区文件，重启就好了。
那肯定就是联网装新版火绒喽。装上以后一通设置，把密码也打开了，密码用的是 Intel 无线网卡的序列号（钥匙扣说是），当时还开了网络控制，上课的时候我就在用鼠标悄悄选允许还是拒绝(
不巧的是，后面有一节公开课，我们班要去录播室上课，电教主任偷偷潜入，居然想办法把管家装上，还连上学校了（估计是网络拦截那里没设置好，软件安装拦截也没自动拒绝，弹窗他选允许了）
当时回来上的数学课，还没有出什么事，摄像头上的胶布也还在，而且还可以看到亮着灯（偷窥被知道了吧！）
结果第四节课物理就不爽了，快下课了那个主任把我们班主任叫过来了，问有没有叫 xxx 的同学（很显然是问班主任，知道了管一体机的同学的名字），然后反复询问，其中有一句名言：「谁给火绒上的密码？」。那位同学表示不是他自己干的，电教主任听了又说：「不是你干的，你说出是谁干的？」（班上同学都在笑，但这其实还真是事实。我还听见有同学大声说我昨天不在，绝对不是我干的，在这里感谢一下）。他并没有举报我，我还是挺感谢他的（）
后来班主任把我和另一位同学拉上去，我故作镇定，随手翻了一下（实际上腿都在抖，转移话题那俩朋友还不理我），当时班主任在边上问：「这个怎么办？」，电教主任不假思索的回答：「这个得请希沃的工程师来给这台希沃做恢复。」（这是我们班的名言了），我就趁机问电教主任：「有没有键盘？有键盘我就有办法解决。」，电教主任直接表示没有，那我只能保持沉默。当时我心里想的是：「学校又不是没有信息室，信息室里一大堆，他自己办公室又不是没有，怕不是想要打着请希沃工程师的名号要赔钱，然后自己把钱拿了贪掉，周末偷偷弄。这破学校一天天一大堆跟教学无关的破事（不局限于电教），死都不赔钱（窗户当时还有防跳楼设施，搞笑）」我过了一会儿又问：「有没有键盘？」他才去办公室拿键盘来。有键盘就好说，重启进安全模式删掉就是了（因此就留下了一个病根，后来在系统上用火绒剑的时候还是会弹这个密码）。
其实就算他不给键盘我也会重启进 PE 解决，但是我不能让电教主任看到我有 PE U 盘，要不然怕有麻烦，所以如果不给我就是中午解决了再让班主任沟通。
本来电教主任说问题解决就算了，结果班主任还是把他爸请来了，据他所说，他回家挨了一顿痛扁。
中午我秉承着省电的原则，把一体机关了，结果那个主任去跟班主任套近乎，推掌上看班，但是我关机了就显示离线，他就来开机，说：「以后不许关机！」（所以我晚上就从来不关机了，后面天热了他要中午关机我就拔网线）。摄像头上的胶带还没撕，又看不见，他问：「谁干的？」然后撕掉。被痛扁的那位同学直接怼过去：「你说实话，这个软件是不是能偷窥能监控？侵犯学生隐私！」电教主任又一名言出现：「公共场合你没有隐私！」（真的后悔没有设备记录，又没法去摇同学，要不然我过几个月就可以附上录音甚至视频了）。当时演示功能，班主任还发了「请不要动一体机！」（所以这个程序有一个希沃管家样式的横幅通知，就是为了内涵这个。其实之前版本的完全是一比一仿制，除了动画的处理不太一样，后面为了统一和方便查看，我就改了个加粗。）
既然兄弟被伤害，那肯定不能忍着，就算没有实质性伤害也要侮辱一下，后面就衍生了一点梗，然后他被改名叫老鼠，办公室是老鼠窝，被印成立牌摆在桌上。
第二学期开学四天，我们听到他不干了的消息，直接当场表演 30s 速通卸载希沃管家，后面不知情的班主任要我在班上登 QQ 用来通知的时候，问我能不能开机自启，我还没回答可以呢，她就说是不是冰点还原的问题，我直接告诉她其实我们三个都知道密码（其实那时候希沃管家已经没了）
后面物理老师叫我朋友去办公室，要我的程序，我朋友问：「是谁要的？」物理老师看向了那个前电教主任（是的，他是初三物理老师），既然他这么整我朋友，那肯定是被拒绝。我们直接摆明：我们的物理老师要，可；老鼠要，不可。
所以这个许可证就是干这个用的，怕他又偷偷潜入来偷窃软件。

不过，其实也可以有感谢他地方。他给我们提供了许多乐子，还帮助我了解到了 HugoAura 这么个优质项目，以及这个论坛

坚持晚上不关机（）
3 月 4 号离线了一下是破学校又断网了

最长有过 9 天。不过虽说不关机，中途还是会重启一下，要不然越来越卡

doudou0720 全开源的，生成器在 license_generator_app 文件夹，自己签个许可证就是了
先生成密钥对，把公钥放在程序目录，然后把你的 key 文件甩进去就行了

doudou0720

hxabcd 如果这个项目用的是MIT且没有特殊说明是混合许可证，是自由软件，你可以直接把这段代码删了)

yizhilanzhu

虽然我们根本就没有搞班上的公用QQ

但是

awmc

wry000000000000

yizhilanzhu 你说了我才注意到壁纸上有舞萌。。。

doudou0720

awoc看错了

doudou0720

CreeperAWA 我们看的是一个仓库吗BSOD-MEMZ/QQListener

哦好吧不是

[未知用户] 那也是自由软件

SXZ11454

CreeperAWA 我是被那个神人电教主任骂的家伙。其实当时们物理老师（为方便说明，下文以“LS”代替）要程序是这么一回事：她在班上的希沃大屏上发了一个消息，叫我到老鼠窝去，我去了以后，她就直接问我说，你那个程序是怎么回事啊，然后说我作业没写好，要把一个知识点罚抄 20 遍。然后我就说不给程序。后来有一节体育课，上课铃打了以后，我没直接下楼，而是去了一趟物理办公室，就是想弄清楚到底是谁要的程序（所以说我已经心知肚明）。到了办公室我就问 LS 说，我的软件是谁要的？LS 瞟了老鼠一眼。我就留下了四个大字（其实算上标点符号应该是 6 个字符）：“免谈，免谈。”还特别大声。自那以后，老鼠暂时没来找过我们的茬了。

WCB-zj

CreeperAWA 我也喜欢囤安装包

ZWH

CreeperAWA 本来电教主任说问题解决就算了，结果班主任还是把他爸请来了，据他所说，他回家挨了一顿痛扁。

啊这

MacrosMeng

doudou0720 我看它repo有LICENSE吧）是GPL3（

yizhilanzhu

doudou0720

@CreeperAWA 提的是他自己写的那个

至于那个机器码许可证

估计是用来防火防盗防主任的（

CreeperAWA

yizhilanzhu 估计是用来防火防盗防主任的（

答对。那个整我的电教主任想要来偷我软件

yizhilanzhu

CreeperAWA

那很既要当婊子，又要立牌坊了😰

CreeperAWA

小作文写好了，来看 @yizhilanzhu @doudou0720
文笔比不上论坛某些人，但故事本身应该还挺有趣的

话说我要不要把这个单独发个贴（）

Sylphy

很好的Toast监听,,,比用协议端一类稳(写过类似用协议端的项目, 不过嘛,,在学校QQ上装NapCat已经导致封了一个号&踢下线多次了,,不敢弄了./.)

CreeperAWA

Sylphy 不过速度不是很快，我是只写了 1s 扫一次。如果运气不好在刚刚一轮扫描以后发消息，可能延迟会有将近 2s
我是想做 NapCat 的，无头 QQNT 也可以减小性能开销

yizhilanzhu

wry000000000000

不止

图4软件页面里面还有一只盐巴

lincube

您好，可以联系一下吗