牌面文字反复重新布局和渲染

调查结论

直接证据

lua
function Client.BuildPlayingUI()
    if uiRoot_ then uiRoot_:Destroy() end

lua
uiRoot_ = UI.Panel { ... }
UI.SetRoot(uiRoot_)

为什么真人投币会闪两次以上

text
点击左牌或右牌
→ Client.MakeChoice()
→ 本地把自己标记为已选择
→ 向服务器发送 CHOOSE_CARD
→ Client.BuildPlayingUI()

text
服务器收到 CHOOSE_CARD
→ BroadcastPlayerChoiceReady(slot)
→ 所有客户端收到 PLAYER_CHOICE_READY
→ Client.BuildPlayingUI()

lua
playerChoiceReady_[slot] = true
if phase_ == Shared.PHASE.PLAYING then
    Client.BuildPlayingUI()
end

1. 本地点击后重建一次；
2. 服务端确认本机选择后再重建一次。

为什么 AI 投币又会继续闪

lua
Client.BuildPlayingUI()

截图中几个红框为什么同步异常

• 左牌标题、说明、状态图标；
• 右牌标题、说明；
• P1～P4 底部投币槽。

• 底部投币槽发生变化是正常需求；
• 左右牌文字跟着重绘是不必要的副作用；
• AI 每投一枚币，左右牌又被重建一次。

与 NanoVG 的关系

• 牌名和效果说明是 UI.Label：scripts/bullbear/ClientUIPlaying.lua:175-195
• raw NanoVG 主要负责航线、事件气泡、飞币动画等；
• ClientRender*.lua 中没有再次绘制 leftName/rightName/leftEffect/rightEffect。

• DPR 或分辨率模式错误；
• 字体每帧重新创建；
• 两个渲染层同时绘制相同文字；
• Update 每帧调用 BuildPlayingUI()。

后续修复方向

1. 最佳方案：保持中央牌面 UI 稳定，只局部更新对应玩家的投币槽。
2. 通过控件引用或 FindById() 更新某个 P 位；
3. 不再让 PLAYER_CHOICE_READY 调用 BuildPlayingUI()；
4. 这是从根本上消除闪烁的方案。
5. 对服务端确认做幂等去重。
6. 若 playerChoiceReady_[slot] 已经为 true，不再刷新；
7. 能消除本机“本地更新 + 服务端回执”的重复刷新；
8. 但其他 AI 投币时仍会重建，所以只能缓解，不能根治。
9. 保留揭示阶段的一次完整切换。
10. 飞币结束后进入 REVEAL 的一次重建属于阶段切换，可以保留；
11. 需要避免的是每个 PLAYER_CHOICE_READY 都重建中央牌面。
12. 次选方案：合并同一帧或短时间内的多条刷新请求。
13. 可以减少 AI 集中投币时的连续重建；
14. 但仍然比局部更新代价大，不建议作为最终方案。

实现内容

• 为每个玩家投币槽增加稳定 ID：
• scripts/bullbear/ClientStatusCards.lua:190
• 格式为 playing_coin_slot_<slot>
• 自定义投币槽和 fallback 控件都支持定位。
• 新增局部刷新接口：
• scripts/bullbear/ClientUIPlaying.lua:14
• 通过 uiRoot_:FindById() 定位指定 P 位投币槽；
• 只调用 SetProp("spinning", false) 停止铜钱旋转；
• 不销毁状态栏，不重建左右牌面。
• 本机普通遭遇点击改为局部更新：
• scripts/bullbear/ClientUIPlaying.lua:753
• 普通遭遇不再调用 BuildPlayingUI()；
• Buff、技能节点仍保留全量更新，因为它们会改变实际卡片内容。
• 服务端投币确认改为局部更新并增加幂等保护：
• scripts/bullbear/ClientCore.lua:777
• AI 或其他真人投币时，只更新对应玩家投币槽；
• 重复收到同一 P 位确认不会再次刷新。

调用链复核

text
本机点击 / AI 投币确认
→ playerChoiceReady_[slot] = true
→ RefreshPlayerChoiceCoin(slot)
→ coinSlot:SetProp("spinning", false)

text
uiRoot_:Destroy()
→ 重建左右牌文字
→ UI.SetRoot()

验证结果

• Lua LSP：0 Error
• 官方多人构建：成功
• 多人配置保持正确：
• background_match=true
• free_match_with_ai
• immediately_start=true
• match_timeout=3
• player_number=4
• 单机截图验证工具不支持多人项目，因此未用无服务端环境制造无效测试结果。