免打扰状态必须存服务端redis并实时同步，不能仅存localstorage；需通过channel广播更新、websocket连接健康检查及推送前三层过滤确保一致性。
免打扰状态不能存在前端 localStorage 里
用户点击“开启免打扰”后，如果只把 status 存到 localStorage，那换设备、清缓存、多标签页就立刻不同步。更严重的是：服务端根本不知道这个状态，没法在推送前做拦截——结果就是“我明明关了提醒，怎么还收到短信？”
正确做法是把状态写到服务端权威存储，比如 Redis 的哈希表：hset dnd:uid:1001 status all_muted，并设过期时间（如 7 天）。HTTP 接口收到设置请求后，立刻 publish 到 Channel 主题，触发所有同 uid 的 WebSocket 连接同步 UI。
- 不要用数据库存这种高频读写的状态，Redis 延迟低、原子操作强
- 状态值必须用字符串枚举（
all_muted/custom），别用布尔值，否则扩展新策略时要改全链路 - 客户端首次连接 WebSocket 后，必须主动发一次
{"type":"get_dnd"}拉取当前状态，避免白屏期
跨进程推送必须走 Channel，不能直连 $connection
HTTP Worker 收到“用户 A 开启免打扰”请求时，它和 WebSocket 进程内存隔离，$connection 对象根本不可见。硬写 $clients[1001]->send() 会报 Fatal error: Call to a member function send() on null，而且多实例部署下映射表完全不一致。
唯一可靠路径是用 Webman 内置的 Channel 中转：
- WebSocket 进程启动时调用
Channel::getInstance()->subscribe('dnd_update', $callback) - HTTP 接口里执行
Channel::getInstance()->publish('dnd_update', ['uid' => 1001, 'status' => 'all_muted']) -
$callback中遍历static $clients映射表，对每个$connection->uid === 1001的连接调用$connection->send() - 务必在
onClose回调里unset($clients[$connection->uid])，否则内存泄漏，php start.php status看 RSS 持续涨
推送前必须服务端过滤，不能依赖前端静音
浏览器 Notification API 不支持运行时静音，silent: true 已废弃，JS 无法阻止系统弹窗。所谓“前端免打扰”，本质是服务端决定“这条消息要不要发出去”。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
千万级用户场景下，推送前必须做三层过滤：
- 查 Redis 获取用户当前
dnd:uid:1001状态，status === 'all_muted'就跳过本次推送 - 结合时间维度：如果状态是
custom，再查dnd:uid:1001:rules（JSON 字符串），判断当前时间是否落在静音区间 - 如果是站内信或 APP 推送，还要叠加用户渠道偏好（如
user:1001:preference中标记"push_enabled": false）
这些逻辑必须压在推送服务层（比如用 Laravel Job 或独立的 PushWorker），不能塞进 HTTP 接口里——否则高并发时直接拖垮主服务。
心跳和连接清理不做好，免打扰就变成“假静音”
用户手机锁屏、浏览器失焦、NAT 超时后，WebSocket 连接其实已断，但服务端还留着 $clients[1001]。这时你发一条免打扰状态变更，它会尝试 $connection->send()，触发 warning 甚至 crash 进程，而真正在线的设备收不到更新。
必须手动实现连接健康检查：
- 客户端每 25 秒发一次
{"type":"ping"}，服务端onMessage中记录$connection->last_ping = time() - 用
Timer::add(30, function () { ... })定期遍历$clients，对time() - $connection->last_ping > 45的连接调用$connection->close() -
onClose回调里除了unset，还要删掉 Redis 中该连接绑定的临时 key（如ws:conn:xxx）
没这三步，免打扰逻辑在真实网络环境下三天内失效率超 60%，不是代码问题，是连接态管理缺失。
