QQListener - QQ通知监控软件

让每一条重要通知都能被听见 - 班级群消息监听器 本程序由 @HxAbCd 使用 AI 重构，代码结构已发生较大变化

✨ 功能特性

• 极速响应 - 底层采用原生 WinSDK 接口，低延迟捕捉每一条群消息
• 智能播报 - 集成 Edge-TTS 神经网络语音，AI帮你催作业
• 多级控制 - 智能识别一般、重要、紧急事件，支持分级通知管理和消息过滤
• 界面美观 - 纯正 PySide6 开发，采用 Fluent Design 风格，适配班级大屏
• 极简配置 - 自动适配大多数 QQ 版本，JSON 配置文件支持高度自定义
• 安全无虞 - 本地化数据处理，不上传隐私信息，代码完全透明可见

📋 系统要求

• 操作系统: Windows 10 1903+ (Win7/8/8.1 不支持)
• QQ 版本: 必须使用 NT QQ (新版 QQ)

🚀 快速开始

1. 下载安装

从 GitHub Releases 下载最新的安装包，运行安装程序。

2. 基础配置

1. 找到聊天记录保存位置: 打开 QQ 设置 → 存储管理，复制"聊天记录默认保存到"路径
2. 填写 QQ 号: 在 QQListener 设置中填入你的 QQ 号
3. 设置保存目录: 将复制的路径粘贴到"聊天信息保存文件夹"

3. 权限设置

• 关闭 Windows 专注模式
• 允许 QQ 发送通知
• 确保 QQListener 在系统托盘中运行

📖 使用指南

通知捕获模式

QQListener 支持两种消息捕获模式：

模式	说明	推荐度
WinSDK 模式	通过监听 Windows 通知中心（Toast）实现，功耗极低，几乎不占资源	⭐⭐⭐⭐⭐
UIA 模式	通过 UI 自动化技术直接从窗口元素获取消息，识别准确率较低	⭐⭐

重要功能设置

重要人物

在设置中添加重要联系人的 QQ 昵称，这些人的消息会触发重要通知。

重要关键词

添加关键词如"作业"、"通知"、"考试"等，包含这些词的消息会高优先级提醒。

黑名单

添加不想接收通知的群或联系人，自动过滤其消息。

老师呼叫功能

设置呼叫关键词（如"呼叫"），当老师发送包含关键词的消息时，会触发长时间弹窗和循环铃声直到响应。

TTS 语音播报

• Edge TTS: 基于神经网络的高质量语音，需要联网。目前已知很多操作系统无法使用
• 系统 TTS: 使用 Windows 自带语音引擎，离线可用

提示: 如果 Edge TTS 无法使用，请在设置中切换到系统 TTS

❓ 常见问题

通知捕获不工作？

1. 确保使用的是 NT QQ（新版 QQ）
2. 检查 Windows 通知权限是否开启
3. 在设置 → 调试页面运行 mainsdk
4. 检查系统托盘是否有 QQListener 图标

Edge TTS 无法使用？

• 属于网络问题，如果无法解决请在设置中切换到系统 TTS
• 确保系统已安装语音包

QtCore 报错？

• 更新 Windows 系统版本
• Win7/8/8.1 不支持，需要 Win10 1903+

程序闪退？

• 检查是否安装了所有依赖
• 查看命令行输出获取错误信息
• 确保配置文件格式正确

🛠️ 开发相关

此项目使用了 AI 参与开发，并借助其对此项目进行过重构。

如果你是开发者，想要参与项目开发或进行二次开发，请查看 DEVELOPMENT.md 获取详细的开发指南。

📄 许可证

本项目采用 MIT 许可证开源，详见 LICENSE 文件。

---

⚠️ 免责声明: 本程序仅供学习交流使用，请勿用于非法用途。使用本程序产生的任何后果由用户自行承担。