萌卡 NT v2.0.4

Mengka NT v2.0.4 版本说明

新增

• 新增萌卡原生事件目录，统一提供消息、通知、请求和系统四类事件。
• 新增精确事件监听器：好友与群消息、消息发送确认、好友和群请求、好友关系、消息撤回、群成员变化、群管理变化、群系统提示、表情回应、戳一戳、资料点赞、输入状态、插件生命周期、插件心跳和账号离线。
• 所有事件新增 event_id、occurred_at、category、event_type、self_id 与 client_type 公共字段，方便去重、追踪和按协议账号处理。
• 新增好友申请原生推送链路：收到提示后由框架回读 QQ 好友系统消息，再生成带不透明 flag 的请求事件。
• 新增群系统卡片规范化：输出稳定的摘要和已确认参与人，并将管理员、群文件、群名片、群名称、群头衔、群精华、表情回应与戳一戳变化分流到独立事件。

优化

• 正向与反向 Node.js SDK 可直接监听具体事件，不再要求插件重复解析 post_type + sub_type。
• 同一个事件可同时投递给大类监听器和具体监听器，事件 ID 保持一致。
• 插件连接认证会根据已注册的具体监听器自动计算所需事件权限。
• 群系统卡片不再把易变化的原始 XML 暴露为公共契约；无法确认的字段不填 0，也不使用猜测值。
• 插件心跳与 WebSocket 控制帧心跳同步，业务层可以直接确认事件通道存活。
• 固化在线更新的多线路并发探测、测速排序和逐线路降级；Release 元数据使用 ETag、本地缓存和并发请求合并，不再重复消耗匿名 GitHub 配额。
• 在线更新继续强制校验资源大小与 SHA-256，并按 Windows、Linux 分别执行替换、重启和缓存登录恢复。

修复

• 修复 request 已出现在事件能力目录但连接权限结构未真正接收和校验请求事件的问题。
• 修复除入群、禁言以外的大量群系统提示被后端直接丢弃的问题。
• 修复插件只能订阅粗粒度事件、无法稳定区分同类通知的问题。
• 修复在线更新将 GitHub 限流、网络超时、线路下载失败、压缩包校验失败和服务重启失败统一显示为 502 的问题；当前版本会返回可区分的失败阶段与是否可重试信息。

插件升级说明

1. 推荐将 group_notice、friend_notice 等大类监听逐步改为具体事件监听器；大类监听仍可用于统一日志或审计。
2. 正向连接必须在 connect() 前注册事件，SDK 才能在认证阶段声明对应权限。
3. 插件应使用 event_id 去重，使用 event_type 判断业务类型，不要依赖可读摘要识别事件。
4. flag、request_id、request_type 等请求标识必须原样传回处理接口，不要自行拼接。
5. group_system_tip 只表示框架确认收到一条未归类系统提示；插件不得从 summary 猜测缺失的账号、文件或消息标识。
6. 从 v2.0.3 升级可直接使用在线更新。v2.0.2 及更早版本若反复在在线更新阶段显示 502，请先完整备份 data 目录并手动替换一次 v2.0.4 程序包；旧进程内的更新器无法被尚未安装的新修复反向替换，完成这一次手动升级后，后续版本即可使用新版多线路更新链路。