feat(banner): 聊天 banner 卡片重做——头像位 + 来源小标题 + 加粗昵称 + 两行正文 + 箭头

之前只有「昵称 / 一行正文」两行灰字，信息量和辨识度都不够。

模块层（通用，对 pixiv 仍一无所知）：
- BannerRequest.Text 新增 caption（主题色小标题，「这条从哪来」的位置）
- 新增 BannerIconLoader：宿主注入图片加载，模块不引 Glide；没注入时 URL 图标直接不显示
- DefaultBannerViewBinder / banner_default.xml：44dp 圆形头像位（CardView outline 裁切，不引 CircleImageView）、
  caption 12sp 主题色、标题 15sp 加粗单行、正文 14sp 两行截断、带 deepLink 且无 action 时右侧显示箭头

宿主层（ChatBannerBridge / InAppBanners）：
- caption：私信 / 公屏闲聊，引用了自己的消息时追加「回复了你」（7 个语言文案补齐）
- 私信显示对方 pixiv 头像：按 uid 拉一次 user/detail，LruCache 64，最多等 1.5s 超时即退占位；
  公屏是匿名房，故意不拉真实头像（会去匿名化），只显示 Shaft logo；拉失败同样 Shaft logo
- illust-only 消息文案兜底「分享了一件作品」（服务端目前 text 必填，纯兜底）
- ⚠️ gateway.incoming 是 onBufferOverflow=SUSPEND 的 SharedFlow，collector 里做网络会挂住 WS 读循环
  殃及所有订阅方，bridge 前插 buffer(64, DROP_OLDEST) 隔离；取消异常不再被当成拉失败吞掉；
  拉头像期间用户已进该房间则不再弹

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017PpMNz7Xnv4trztaPfuSBu

Author: SoxiaLiSA

app/src/main/java/ceui/pixiv/banner/host/ChatBannerBridge.kt

@@ -1,7 +1,12 @@
 package ceui.pixiv.banner.host
 
+import android.content.Context
+import android.util.LruCache
+import ceui.lisa.R
+import ceui.loxia.Client
 import ceui.pixiv.banner.BannerCategory
 import ceui.pixiv.banner.BannerDisplayPolicy
+import ceui.pixiv.banner.BannerIcon
 import ceui.pixiv.banner.BannerManager
 import ceui.pixiv.banner.BannerPriority
 import ceui.pixiv.banner.BannerRequest
@@ -11,12 +16,16 @@ import ceui.pixiv.chat.api.ChatThreadId
 import ceui.pixiv.chat.api.ShaftChatGateway
 import ceui.pixiv.session.SessionManager
 import ceui.pixiv.websocket.IncomingMessage
+import kotlinx.coroutines.CancellationException
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Job
+import kotlinx.coroutines.channels.BufferOverflow
+import kotlinx.coroutines.flow.buffer
 import kotlinx.coroutines.flow.filterIsInstance
 import kotlinx.coroutines.flow.map
 import kotlinx.coroutines.flow.mapNotNull
 import kotlinx.coroutines.launch
+import kotlinx.coroutines.withTimeoutOrNull
 import timber.log.Timber
 import java.util.UUID
 
@@ -33,12 +42,24 @@ import java.util.UUID
  *
  * Newer messages in the same room use `Replace` (dedupKey="chat-<room>") so
  * they supersede the previous banner instead of stacking.
+ *
+ * What the card shows (see [toBannerRequest]):
+ *  - caption: `私信` / `公屏闲聊`, plus `回复了你` when the message quotes one of ours
+ *  - title: sender display name
+ *  - message: the text, or "分享了一件作品" for illust-only messages
+ *  - icon: the peer's pixiv avatar for 1v1 (resolved once per uid, bounded by
+ *    [AVATAR_FETCH_TIMEOUT_MS]); the global room is anonymous so it only ever
+ *    gets the Shaft logo — never fetch a real profile for it.
  */
 class ChatBannerBridge(
+    private val context: Context,
     private val bannerManager: BannerManager,
     private val scope: CoroutineScope,
 ) {
 
+    /** uid → avatar url. Only successful lookups are cached; failures retry on the next message. */
+    private val avatarCache = LruCache<Long, String>(64)
+
     private var job: Job? = null
 
     fun start() {
@@ -48,6 +69,11 @@ class ChatBannerBridge(
                 .filterIsInstance<IncomingMessage.Text>()
                 .map { ChatFrameDecoder.decode(it.text) }
                 .filterIsInstance<ChatFrame.Msg>()
+                // ⚠️ 下游 toBannerRequest 会做网络（拉头像，最多 AVATAR_FETCH_TIMEOUT_MS）。
+                // gateway.incoming 底层是 onBufferOverflow=SUSPEND 的 SharedFlow，任何一个慢订阅者
+                // 把缓冲填满都会挂住 WS 读循环、殃及聊天 UI / 持久化等所有订阅方。这里切出独立缓冲，
+                // 突发时宁可丢掉最旧的几条 banner，也绝不让上游等我们。
+                .buffer(BANNER_BUFFER, BufferOverflow.DROP_OLDEST)
                 .mapNotNull { toBannerRequest(it) }
                 .collect { bannerManager.enqueue(it) }
         }
@@ -59,24 +85,40 @@ class ChatBannerBridge(
         job = null
     }
 
-    private fun toBannerRequest(msg: ChatFrame.Msg): BannerRequest.Text? {
+    private suspend fun toBannerRequest(msg: ChatFrame.Msg): BannerRequest.Text? {
         val selfUid = SessionManager.loggedInUid
         if (selfUid != 0L && msg.uid == selfUid) return null
+        val isGlobal = msg.room == ChatThreadId.ROOM_GLOBAL
         // 试验性开关只 gate 公开/全局房 banner(默认关)。1v1 私信 banner **故意不 gate**:
         // 私信入口是用户主页的「发消息」按钮(UserActivityV3,独立于侧边栏「聊天室入口」开关),
         // 是用户主动发起的会话;若按聊天室入口开关把回复通知静默掉,反而是更严重的 bug。
         // ⚠️ 别为了「一致性」把这条收紧成 !showChatRoomEntry 就 return —— 会吞掉私信通知。
-        if (msg.room == ChatThreadId.ROOM_GLOBAL && !publicChatBannerEnabled()) {
+        if (isGlobal && !publicChatBannerEnabled()) {
             return null
         }
         if (isViewingRoom(msg.room)) {
             Timber.tag(TAG).d("suppress banner: foreground is room=%s", msg.room)
             return null
         }
         val body = msg.text?.takeIf { it.isNotBlank() }
-            ?: msg.illustId?.let { "[illust:$it]" }
+            ?: msg.illustId?.let { context.getString(R.string.chat_banner_shared_illust) }
             ?: return null
         val sender = msg.displayName?.takeIf { it.isNotBlank() } ?: "uid ${msg.uid}"
+        val caption = buildList {
+            add(context.getString(if (isGlobal) R.string.chat_room_global_title else R.string.chat_banner_caption_dm))
+            if (selfUid != 0L && msg.replyTo?.uid == selfUid) add(context.getString(R.string.chat_banner_caption_reply_to_you))
+        }.joinToString(" · ")
+        // 公屏是匿名房（display_name 是「匿名_xxx」），拉真实头像等于把人去匿名化 —— 只给 Shaft logo。
+        val icon: BannerIcon = if (isGlobal) {
+            PLACEHOLDER_ICON
+        } else {
+            avatarFor(msg.uid)?.let { BannerIcon.Url(it) } ?: PLACEHOLDER_ICON
+        }
+        // 拉头像期间用户可能已经点进了这个房间（首屏正好在会话列表时最常见），再确认一次。
+        if (isViewingRoom(msg.room)) {
+            Timber.tag(TAG).d("suppress banner after avatar fetch: foreground is room=%s", msg.room)
+            return null
+        }
         // 1v1 room id is a hashed pair → cannot reverse to peer uid. But the
         // sender (msg.uid, already filtered against self) IS the peer for 1v1,
         // so encode that directly. Global rooms drop the peer param.
@@ -89,6 +131,8 @@ class ChatBannerBridge(
             id = UUID.randomUUID().toString(),
             title = sender,
             message = body,
+            caption = caption,
+            icon = icon,
             dedupKey = "chat-${msg.room}",
             priority = BannerPriority.NORMAL,
             category = BannerCategory.Chat,
@@ -102,6 +146,26 @@ class ChatBannerBridge(
         )
     }
 
+    /**
+     * 私信对方的 pixiv 头像。首次按 uid 拉一次 `user/detail`，之后命中缓存零延迟；
+     * 网络慢时最多等 [AVATAR_FETCH_TIMEOUT_MS]，超时 / 失败就退回占位图，绝不让 banner 干等。
+     */
+    private suspend fun avatarFor(uid: Long): String? {
+        avatarCache.get(uid)?.let { return it }
+        val url = withTimeoutOrNull(AVATAR_FETCH_TIMEOUT_MS) {
+            try {
+                Client.appApi.getUserProfile(uid).user?.profile_image_urls?.findMaxSizeUrl()
+            } catch (e: CancellationException) {
+                throw e // 超时 / bridge.stop() 的取消必须冒泡，不能当成「拉失败」吞掉
+            } catch (e: Exception) {
+                Timber.tag(TAG).v(e, "avatar fetch failed for uid=%d", uid)
+                null
+            }
+        }
+        if (!url.isNullOrBlank()) avatarCache.put(uid, url)
+        return url
+    }
+
     /**
      * Is the user already looking at the chat room that produced [msgRoom]?
      *
@@ -130,5 +194,9 @@ class ChatBannerBridge(
 
     companion object {
         private const val TAG = "Chat-Banner-Bridge"
+        private const val AVATAR_FETCH_TIMEOUT_MS = 1500L
+        private const val BANNER_BUFFER = 64
+        /** 匿名发言 / 头像拉不到时的头像位：Shaft 自己的 logo，而不是任何 pixiv 品牌图。 */
+        private val PLACEHOLDER_ICON = BannerIcon.Resource(R.drawable.icon_shaft_with_bg)
     }
 }

app/src/main/java/ceui/pixiv/banner/host/InAppBanners.kt

@@ -6,13 +6,18 @@ import android.content.Context
 import android.content.Intent
 import android.net.Uri
 import android.os.Bundle
+import android.widget.ImageView
+import ceui.lisa.R
 import ceui.lisa.activities.TemplateActivity
+import ceui.lisa.utils.GlideUrlChild
 import ceui.pixiv.banner.BannerEvent
 import ceui.pixiv.banner.BannerHostInstaller
+import ceui.pixiv.banner.BannerIconLoader
 import ceui.pixiv.banner.BannerManager
 import ceui.pixiv.banner.BannerViewBinder
 import ceui.pixiv.banner.DefaultBannerViewBinder
 import ceui.pixiv.banner.RealBannerManager
+import com.bumptech.glide.Glide
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.SupervisorJob
@@ -66,7 +71,7 @@ object InAppBanners {
         if (!bootstrapped.compareAndSet(false, true)) return
 
         val binders = mapOf<String, BannerViewBinder>(
-            BannerViewBinder.DEFAULT_KEY to DefaultBannerViewBinder(),
+            BannerViewBinder.DEFAULT_KEY to DefaultBannerViewBinder(iconLoader = GlideBannerIconLoader),
         )
         manager = RealBannerManager(binders = binders)
         manager.start()
@@ -80,7 +85,7 @@ object InAppBanners {
             installer.installNow(it)
         }
 
-        ChatBannerBridge(manager, scope).start()
+        ChatBannerBridge(app, manager, scope).start()
 
         scope.launch {
             manager.events
@@ -122,6 +127,24 @@ object InAppBanners {
         }
     }
 
+    /**
+     * 宿主侧的 [BannerIcon.Url] 加载器：走 Glide + [GlideUrlChild]（pximg 需要 referer），
+     * 圆形裁切，占位用 Shaft 自己的 logo（与 [ChatBannerBridge] 的匿名 / 失败兜底一致；
+     * 不用 chat_avatar_placeholder —— 它依赖 Material 的 colorSurfaceContainerHigh，
+     * AppCompat 主题的 MainActivity 上解析不了）。
+     */
+    private object GlideBannerIconLoader : BannerIconLoader {
+        override fun load(target: ImageView, url: String) {
+            runCatching {
+                Glide.with(target)
+                    .load(GlideUrlChild(url))
+                    .placeholder(R.drawable.icon_shaft_with_bg)
+                    .circleCrop()
+                    .into(target)
+            }.onFailure { Timber.tag(TAG).w(it, "banner icon load failed") }
+        }
+    }
+
     /**
      * Cheapest possible foreground-activity tracker. WeakReference so we never
      * keep an Activity alive past `onDestroy`, and we only care about which

app/src/main/res/values-en/strings.xml

@@ -2273,6 +2273,10 @@
     <string name="network_test_overall_clean_sub_fallback">DNS resolution, handshake, size probe, image downloads OK.</string>
     <string name="chat_drawer_entry">Chat Room</string>
     <string name="chat_room_global_title">Public Lounge</string>
+    <!-- 应用内 banner（ceui.pixiv.banner.host.ChatBannerBridge）的小标题 / 正文兜底 -->
+    <string name="chat_banner_caption_dm">Direct message</string>
+    <string name="chat_banner_caption_reply_to_you">replied to you</string>
+    <string name="chat_banner_shared_illust">Shared an artwork</string>
     <string name="chat_preview_you_prefix">You:</string>
     <string name="chat_room_count">%1$d conversations</string>
     <string name="chat_new_messages">%1$d new messages</string>

app/src/main/res/values-ja/strings.xml

@@ -2256,6 +2256,10 @@
     <string name="network_test_overall_clean_sub_fallback">DNS 解決、ハンドシェイク、サイズ検証、画像ダウンロードも正常です。</string>
     <string name="chat_drawer_entry">チャットルーム</string>
     <string name="chat_room_global_title">公開ラウンジ</string>
+    <!-- 应用内 banner（ceui.pixiv.banner.host.ChatBannerBridge）的小标题 / 正文兜底 -->
+    <string name="chat_banner_caption_dm">ダイレクトメッセージ</string>
+    <string name="chat_banner_caption_reply_to_you">あなたに返信</string>
+    <string name="chat_banner_shared_illust">作品をシェアしました</string>
     <string name="chat_preview_you_prefix">自分:</string>
     <string name="chat_room_count">%1$d 件のトーク</string>
     <string name="chat_new_messages">新着 %1$d 件</string>

app/src/main/res/values-ko/strings.xml

@@ -2256,6 +2256,10 @@
     <string name="network_test_overall_clean_sub_fallback">DNS 해석, 핸드셰이크, 크기 검사, 이미지 다운로드도 정상입니다.</string>
     <string name="chat_drawer_entry">채팅방</string>
     <string name="chat_room_global_title">공개 라운지</string>
+    <!-- 应用内 banner（ceui.pixiv.banner.host.ChatBannerBridge）的小标题 / 正文兜底 -->
+    <string name="chat_banner_caption_dm">다이렉트 메시지</string>
+    <string name="chat_banner_caption_reply_to_you">나에게 답장</string>
+    <string name="chat_banner_shared_illust">작품을 공유했습니다</string>
     <string name="chat_preview_you_prefix">나:</string>
     <string name="chat_room_count">대화 %1$d개</string>
     <string name="chat_new_messages">새 메시지 %1$d개</string>

app/src/main/res/values-ru/strings.xml

@@ -2256,6 +2256,10 @@
     <string name="network_test_overall_clean_sub_fallback">Разрешение DNS, рукопожатие, определение размера, загрузка изображений в порядке.</string>
     <string name="chat_drawer_entry">Чат</string>
     <string name="chat_room_global_title">Общий чат</string>
+    <!-- 应用内 banner（ceui.pixiv.banner.host.ChatBannerBridge）的小标题 / 正文兜底 -->
+    <string name="chat_banner_caption_dm">Личное сообщение</string>
+    <string name="chat_banner_caption_reply_to_you">ответил(а) вам</string>
+    <string name="chat_banner_shared_illust">Поделился(-ась) работой</string>
     <string name="chat_preview_you_prefix">Вы:</string>
     <string name="chat_room_count">Диалогов: %1$d</string>
     <string name="chat_new_messages">Новых: %1$d</string>

app/src/main/res/values-tr/strings.xml

@@ -2256,6 +2256,10 @@
     <string name="network_test_overall_clean_sub_fallback">DNS çözümlemesi, el sıkışma, boyut testi, görsel indirmeleri sorunsuz.</string>
     <string name="chat_drawer_entry">Sohbet Odası</string>
     <string name="chat_room_global_title">Genel Sohbet</string>
+    <!-- 应用内 banner（ceui.pixiv.banner.host.ChatBannerBridge）的小标题 / 正文兜底 -->
+    <string name="chat_banner_caption_dm">Özel mesaj</string>
+    <string name="chat_banner_caption_reply_to_you">size yanıt verdi</string>
+    <string name="chat_banner_shared_illust">Bir eser paylaştı</string>
     <string name="chat_preview_you_prefix">Siz:</string>
     <string name="chat_room_count">%1$d sohbet</string>
     <string name="chat_new_messages">%1$d yeni mesaj</string>

app/src/main/res/values-zh-rTW/strings.xml

@@ -2272,6 +2272,10 @@
     <string name="network_test_overall_clean_sub_fallback">DNS 解析、握手、尺寸探測、圖片下載一切正常。</string>
     <string name="chat_drawer_entry">聊天室</string>
     <string name="chat_room_global_title">公屏閒聊</string>
+    <!-- 应用内 banner（ceui.pixiv.banner.host.ChatBannerBridge）的小标题 / 正文兜底 -->
+    <string name="chat_banner_caption_dm">私訊</string>
+    <string name="chat_banner_caption_reply_to_you">回覆了你</string>
+    <string name="chat_banner_shared_illust">分享了一件作品</string>
     <string name="chat_preview_you_prefix">你:</string>
     <string name="chat_room_count">%1$d 個對話</string>
     <string name="chat_new_messages">%1$d 則新訊息</string>

app/src/main/res/values/strings.xml

@@ -2523,6 +2523,10 @@
     <!-- Chat subsystem (borrowed from Peanut; see ceui.pixiv.chat.*) -->
     <string name="chat_drawer_entry">聊天室</string>
     <string name="chat_room_global_title">公屏闲聊</string>
+    <!-- 应用内 banner（ceui.pixiv.banner.host.ChatBannerBridge）的小标题 / 正文兜底 -->
+    <string name="chat_banner_caption_dm">私信</string>
+    <string name="chat_banner_caption_reply_to_you">回复了你</string>
+    <string name="chat_banner_shared_illust">分享了一件作品</string>
     <string name="chat_preview_you_prefix">你:</string>
     <string name="chat_room_count">%1$d 个对话</string>
     <string name="chat_new_messages">%1$d 条新消息</string>

banner/src/main/java/ceui/pixiv/banner/BannerIcon.kt

@@ -5,6 +5,10 @@ sealed interface BannerIcon {
     /** Resource id from the host module's `R.drawable`. */
     data class Resource(val resId: Int) : BannerIcon
 
-    /** Remote image to be fetched and decoded by the image pipeline. */
+    /**
+     * Remote image. The banner module has no image pipeline of its own — the
+     * host supplies a [BannerIconLoader] to [DefaultBannerViewBinder]; without
+     * one, URL icons are simply not shown.
+     */
     data class Url(val url: String) : BannerIcon
 }