补充好友和图片预览说明注释

resources/js/chat-room/friend-panel.js

@@ -153,6 +153,7 @@ function appendEmpty(container, text) {
 function resolveFriendAvatar(headface) {
     const avatar = String(headface || "1.gif");
 
+    // 后端可能返回 storage 相对路径或头像文件名，这里统一转成可直接使用的图片地址。
     return avatar.startsWith("storage/") ? `/${avatar}` : `/images/headface/${avatar}`;
 }
 
@@ -191,6 +192,7 @@ function makeFriendRow(friend) {
     const button = document.createElement("button");
     button.className = "fp-action-btn fp-btn-remove";
     button.textContent = "删除";
+    // 好友行是接口返回后动态创建的，按钮监听直接挂在当前行元素上即可。
     button.addEventListener("click", () => {
         void friendAction("remove", username, button);
     });
@@ -260,6 +262,7 @@ async function friendAction(action, username, button) {
                 Accept: "application/json",
             },
             body: JSON.stringify({
+                // 房间 ID 用于后端生成房间内通知或校验上下文，不参与前端判权。
                 room_id: roomId(),
             }),
         });
@@ -316,6 +319,7 @@ export async function friendSearch() {
                 Accept: "application/json",
             },
             body: JSON.stringify({
+                // 搜索添加也带上当前房间，保持和用户卡片添加好友入口一致。
                 room_id: roomId(),
             }),
         });