未读计数:QQ 小表基准与共享快照
结果与来源
Desktop、Web、Remote 统一消费 UnreadInfoService.getUnreadInfos() 的结果。 普通私聊和群聊直接读取 QQ 的未读小表及最近会话表,不访问消息历史:
可写私聊/群聊的有效阅读下限 = max(41002, 41032)
未读数 = max(0, 最新序号 - 有效阅读下限 - 区间内去重减计数项)
减计数项来自 QQ 已维护的 41024.40003,只扣除 下限 < seq <= 最新序号。 最近会话表同时读取 40020 发送者;最新消息确认由当前账号发出时,将该序号并入减项, 避免跨端自发消息先更新最新序号、QQ 稍后补减项时短暂点亮未读。已观察的自发序号仅在内存 有界保留(最多 1024 个会话、每会话 64 项),QQ 减项接纳或阅读位置越过后释放,与 QQ 减项 去重,不抬高阅读位置、不清除已有未读;随后收到回复也不会重复计算这条自发消息。 发送者或自身 UID 缺失时不猜测方向,不为补偿读取消息历史。设备会话仍使用独立计数。 41027 是手动未读标志,不是条数;实际数量为零时显示最小标记。 设备会话分别消费独立计数字段,不套用普通会话序号差。缺水位不把全部历史序号当成未读, 有可用计数、标志或提醒时直接展示。提醒过滤和跳转位置使用同一阅读下限,不从数量倒推。
QQ 内存读取适配器保留为显式 compareQqCounts() 诊断,不自动定位、轮询或接管显示。 适配器支持 macOS arm64/QQ 7.0.3-54395 和 Windows x64/x64 QQ 9.9.37-54395; 读取端架构及 native 能力必须匹配对应布局,旧 native 不会启用 Windows 路径。 Windows 主进程、启动代、实际加载模块与账号持库关系在 native 内核验;换 PID 清理旧定位, 账号关闭时取消在途读取。冷定位不阻塞数据库角标,也不自动写入阅读位置。 Windows 群会话研究读取已实测,正式 N-API 的目标机运行、私聊及换号/重启仍需独立验证。 数据库已被 WeQ 标为已读、QQ 内存仍保留角标时,WeQ 按数据库显示,不来回切换来源。 此规则不表示 QQ 本体界面会因外部 SQL 立即更新。
启动与更新
账号初始化通过 getAllUnreadInfos() 一次读取两张小表,包含缺最近会话行的未读记录。 请求消费服务端共享快照;不同前端、不同请求批次共享初始化与刷新任务。 旧 watermarksOnly 参数仍可传入,但不再切换读取模式;生产结果不再使用 countPending。
前端首次并行获取传输批次,合并为一次状态提交,不等待聊天首屏或 QQ 内存定位, 不再逐会话精算。账号来源不变时 HMR/刷新器重建保留已显示角标和进行中的阅读保护。 Web/Remote 按 SuperJSON 序列化及 URL 编码后的实际长度拆分未读请求,遵守 HTTP 批次的 2048 字符上限;桌面 IPC 仍按最多 256 个会话分批。实时变化独立读取,不等待 首次全量快照完成;首次失败仍可展示后续成功的实时结果,迟到快照不覆盖较新的变化。
服务端复用文件变化通知,50ms 合并后重读小表,比较每个会话的字段并只通知变化目标。 有订阅者时共享每 1.5 秒补查,覆盖纯阅读变化;最后一个订阅者退出后停止定时补查。 新消息通知只请求小表刷新,不另行累加消息数。读取失败或单行损坏保留已有成功快照, 后续刷新自动修正,不用零覆盖,也不转入历史扫描。
操作与迁移
已读写入捕获时的固定位置,并清理范围内提醒及手动未读标志;重试不追随新消息。 手动未读只置标志,不降低阅读水位。撤销恢复本次操作字段,并合并后来新增的提醒。 同会话写入串行执行,后续操作取代旧的待执行/重试操作。
可写私聊和群聊不再读取或保存 WeQ 的本地操作覆盖。成功写入后仅回读受影响会话, 按实际数据库状态展示;自动已读写入失败时按固定位置重试,手动批量标记报告未保存的会话, 仅为成功项保留撤销记录。撤销回读 QQ 数据库,不从旧快照拼接提醒。
只读目录仍使用 unread.json,有效阅读下限同时考虑尚有效的本地操作。 数据线的独立计数字段不随普通已读写入更新,仍保留原本的本地阅读操作。 该文件不保存未读数、实时未读序号集合、历史基线或观察水位。旧的普通会话记录不再覆盖可写 QQ 库。
回归入口
packages/db/test/unread_snapshot.test.ts、unread_paging.test.ts 验证小表字段、全量快照与零历史扫描。 packages/service/test/local_unread.test.ts、unread_scheduling.test.ts 验证投影、迁移、共享刷新及操作。 apps/desktop/test/browser/run-unread-counts.mts 验证真实列表的批量绘制、深浅色及窄屏; apps/desktop/test/web_unread_requests.test.ts 使用真实 tRPC 验证大目录及特殊字符的传输分批; run-unread-hmr.mjs 验证保留组件状态的 HMR。 浏览器脚本支持 WEQ_PLAYWRIGHT_IMPORT 和 WEQ_BROWSER_EXECUTABLE 复用已安装运行时。
