docs: 上游吸收审查修补（注释纠偏/上游标点恢复/交叉引用闭合）

- test_lead_push_cc: 两处"双钉"注释与模块头改为如实的跨文件互补分工
  (常量同源钉本文件,字节级措辞钉 test_lead_push_service.py /
  test_email_rendering.py)
- chat_rest: _server_ip/_merge_client_info docstring 与调用点注释恢复
  上游半角标点原文(逐字同步,便于将来 diff 式跟上游)
- chat.py WS 自报注释补 REST 侧交叉引用,闭合悬空不对称说明

全量回归 459 passed(不变)

Co-Authored-By: Claude Code <noreply@anthropic.com>

app/engine/routes/chat.py

@@ -80,7 +80,9 @@ async def ws_chat(websocket: WebSocket):
                 )
                 merged_info = {**client_info, **(init_msg.get("client_info") or {})}
                 # 服务端 XFF 优先于客户端自报 ip（客户端自报可伪造，可伪造面最小）；
-                # 无 XFF 时保留客户端自报，user_agent 等其他字段不受影响
+                # 无 XFF 时保留客户端自报，user_agent 等其他字段不受影响。
+                # （REST 侧已同步上游用直连 host，WS 保持自报——见
+                #   tests/test_chat_rest_ip.py）
                 if forwarded:
                     merged_info["ip"] = forwarded
                 # Task 10 复审: 专用 site 字段同样赢过 init_msg.client_info

app/engine/routes/chat_rest.py

@@ -34,16 +34,16 @@ class SessionRequest(BaseModel):
 
 
 def _server_ip(request: Request) -> str:
-    """服务端可信 IP：XFF 第一段优先，否则直连 host；全空返回空串。
+    """服务端可信 IP:XFF 第一段优先,否则直连 host;全空返回空串。
 
-    同步自上游 ai-kefu(app/api/routes/chat_rest.py)：REST 路径原先只在有
-    XFF 时覆盖自报 ip，直连(无代理)场景自报假 IP 原样落库。"""
+    同步自上游 ai-kefu(app/api/routes/chat_rest.py):REST 路径原先只在有
+    XFF 时覆盖自报 ip,直连(无代理)场景自报假 IP 原样落库。"""
     xff = request.headers.get("x-forwarded-for", "").split(",")[0].strip()
     return xff or (request.client.host if request.client else "")
 
 
 def _merge_client_info(client_info: dict | None, server_ip: str) -> dict:
-    """服务端 IP 覆盖自报 ip 键；服务端为空时保留自报（空串不得冲掉客户端值）。"""
+    """服务端 IP 覆盖自报 ip 键;服务端为空时保留自报(空串不得冲掉客户端值)。"""
     merged = dict(client_info or {})
     if server_ip:
         merged["ip"] = server_ip
@@ -58,8 +58,8 @@ async def chat_session(req: SessionRequest, request: Request):
     `raw_info` (only when non-None). `client_info` is stored for analytics only
     (ip/ua/device-id/lang) and never fed to the AI prompt.
     """
-    # 服务端可信 IP 同步自上游 ai-kefu：XFF 第一段优先，无 XFF 用直连 host
-    # 覆盖客户端自报（可伪造面最小）；全空保留自报。?site= 处理不变。
+    # 服务端可信 IP 同步自上游 ai-kefu:XFF 第一段优先,无 XFF 用直连 host
+    # 覆盖客户端自报(可伪造面最小);全空保留自报。?site= 处理不变。
     client_info = _merge_client_info(req.client_info, _server_ip(request))
 
     # Task 10: ?site=<slug> 记入 client_info 作会话站点标(与 WS init 的