补充聊天室前端关键逻辑注释

resources/js/chat-room/preferences-status.js

@@ -169,7 +169,7 @@ export function bindSoundMuteControl(onChange) {
 }
 
 /**
- * 绑定系统播报屏蔽菜单打开与菜单内点击拦截事件。
+ * 绑定功能菜单、每日状态编辑与系统播报屏蔽的统一事件代理。
  *
  * @returns {void}
  */
@@ -198,6 +198,7 @@ export function bindBlockMenuControls() {
             return;
         }
 
+        // 功能菜单由 Blade 动态渲染，使用 document 代理避免重复绑定新节点。
         const featureMenuTrigger = event.target.closest("[data-chat-feature-menu-toggle]");
         if (featureMenuTrigger) {
             event.preventDefault();
@@ -206,6 +207,7 @@ export function bindBlockMenuControls() {
             return;
         }
 
+        // 每日状态编辑器仍保留存量全局函数，这里只负责把 data-* 事件转发出去。
         const dailyStatusCloseButton = event.target.closest("[data-chat-daily-status-close]");
         if (dailyStatusCloseButton) {
             event.preventDefault();
@@ -246,6 +248,7 @@ export function bindBlockMenuControls() {
             return;
         }
 
+        // 快捷功能区包含本地清理、签到和跳转类动作，统一收口到当前代理入口。
         const localClearButton = event.target.closest("[data-chat-feature-local-clear]");
         if (localClearButton) {
             event.preventDefault();
@@ -289,6 +292,7 @@ export function bindBlockMenuControls() {
             return;
         }
 
+        // 系统播报屏蔽菜单需要阻止内部点击冒泡，避免点击复选框时菜单被外层关闭。
         const trigger = event.target.closest("[data-chat-block-menu-toggle]");
         if (trigger) {
             event.preventDefault();