个人理解拍脸系统（M_V_C）

发表于2026-08-27|更新于2026-08-27|研发手记拍脸系统

|浏览量:

完整的三层架构设计
Pasted image 20260806111259.png
1.数据驱动层：数据来源主要是两类配置表数据，以及热更数据
配置表数据：由excel根据proto协议结构转成pbin结构，再有PushFaceTable进行合表读取。绝大多数拍脸配置是稳定的，随版本打包即可，加载快、不依赖网络
热更数据：当需要紧急上线/下线某个拍脸时，不用等发版，改 KV 配置即可实时生效

PushFaceTable的作用：

① 读静态配表
   PushFace.pbin（P_拍脸.xlsx 导出的数据，结构定义在 ResPushFace.proto）
   → 提供 GetPushFaceData()（合表）/ GetPushFaceDataById(id)（查单行）/ GetPushFaceData_TotalConfig()（单分表）

② 融合动态配置
   LoadWebConfig() 从 KV 系统异步拉线上配置（触发精度 id=10001000）存成 WebConfig
   → 在场景查询时合并进去，和静态表一视同仁

③ 给拍脸系统提供两个业务查询
   GetPushfaceConfigBySceneId(场景id) → 返回该场景所有候选拍脸项数组（静态+动态融合）
   GetPushfaceConfigByActivityId(活动id) → 按活动 id 直查某一行

本文从 LearnByCompany 原始文档自动同步。

文章作者: 岁迹

文章链接: https://lifeatlas.cn/dev-notes/%E6%8B%8D%E8%84%B8%E7%B3%BB%E7%BB%9F-%E4%B8%AA%E4%BA%BA%E7%90%86%E8%A7%A3%E6%8B%8D%E8%84%B8%E7%B3%BB%E7%BB%9F%EF%BC%88M_V_C%EF%BC%89/

版权声明: 本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源岁迹！

研发手记拍脸系统

相关推荐

04_拍脸系统运行原理_易懂版

拍脸系统运行原理（易懂版）本文依据 iWiki docid=4021586551 的主题结构整理，并使用当前工作区源码、导出配置和本地运行日志交叉验证。若 iWiki、旧知识库与当前实现存在差异，以本文“来源与事实分级”中列出的当前源码和配置为准。 0. 阅读说明0.1 阅读目标本文说明拍脸系统如何完成以下过程：业务时机触发一个 Scene；框架加载静态配置和 Web 动态候选；候选项依次经过通用条件、业务条件和频率检查；通过检查的候选项进入分 Scene 队列并排序；调度器根据全局状态和 Scene 状态选择下一项；通用入口调用动态 Item 的 HandleShow；根据返回值或窗口关闭事件继续处理下一项。 0.2 适用读者需要接入新拍脸配置的客户端开发者；需要定位“配置存在但没有弹出”的开发者或测试人员；需要理解 Scene、配置行、Lua Item、目标 UI 之间关系的维护人员；需要核对 Scene19 本地教学实例执行链路的人员。 0.3 阅读完可以回答的问题 Scene、SceneId、sceneKey 和 checkFunc 分别...

01_新增拍脸活动_通用模板

新增拍脸活动：通用模板适用范围：LetsGo 当前 PushFaceModel 配表驱动拍脸框架。核心原则：先分类，再查重，再配表，再写 Item；不要先改 PushFaceModel。禁止事项：禁止手改导出的 PushFaceData_Total.txt、.pbin 或自动生成 Lua；必须修改 letsgo_common/excel/xls/P_拍脸.xlsx，再执行 Compile → Pbin。 0. 先判断属于哪种新增0.1 类型决策表类型识别条件是否改 PushFaceModel 配表改动 Lua Item 目录额外动作 1. 主玩法/大厅/普通活动拍脸使用已有 SceneId；featureName 为空；在大厅、回大厅、停留大厅等已有时机触发通常不改拍脸内容新增一行；选择已有 sceneIds LetsGo/Content/LetsGo/Script/PushFace/Items/PushFace_<codeName>.lua 查重 ID、codeName、SceneId、同 Scene 排序与频率 ...

03_具体类型_新增SceneId_新手奖励入口准备完成

具体类型：新增 SceneId——新手奖励入口准备完成本文参照 iWiki《如何新增一个拍脸活动》的步骤式结构，记录“新手奖励入口首次准备完成”这一具体实例。当前状态（已按本地文件核验） PushFaceModel.lua：已实现 _isNoviceRewardEntryReady、_hasTriggeredNoviceRewardEntryReady、_isNoviceRewardEntryTriggering、_pushFaceSceneGeneration 四项状态，以及 OnNoviceRewardEntryReady()、CheckNoviceRewardReady()；generation 在 OnInit() 基于旧值加一，跨 OnReset() 保持单调递增。 GetSceneIdByKey()：缓存命中时直接返回；未命中时会强制重建一次 Scene 配置缓存并再查一次。 TriggerPushFaceListBySceneId()：已支持可选 CompletionCallback(success, hasSceneConfig)，并用 generation...

02_具体类型_打开已有系统界面的拍脸

具体类型：打开已有系统界面的拍脸（新手奖励本地实例）本文只讲：复用已有 SceneId，通过一个拍脸 Item 直接打开已存在的 Window。当前实例目标 Window：_MOE.WindowName.UI_NoviceReward_MainView。当前配置和 Lua 均为本地链路实例，不是新需求可直接复制的正式 ID/排序/业务条件。 0. 先判断是否属于“打开已有系统界面”的新增0.1 类型对比情况识别条件是否使用本文应转向直接打开已有 Window WindowName 已存在；当前场景允许打开；不需要 ActivityModel 根据活动配置选页是按本文 Step 1～6 按活动 ID 打开活动详情已有真实 activityId，且 ActivityModel:ShowPushFaceActivity 已有活动映射否通用模板“通过 ActivityModel 打开活动页”分支目标 UI 尚不存在 Window、资源或打开入口尚未实现否先完成 UI/业务功能，再接拍脸；不要在 Item 中虚...

核心数据流12345678910111213141516171819202122┌─────────────────────────────────────────────────────────────────────┐│ ① 大厅点击"热购"按钮 ││ ↓ ││ ② MallModel:OpenMallView() → UIManager:OpenWindow(UI_NewMall_MainView) ││ ↓ ││ ③ UI_NewMall_MainView:OnOpen() → 创建 ShopTagTree 页签树 ││ ↓ ...

C++ 内存管理 · 第四讲 Loki allocator 来源：xubenshan.github.io — 第四讲 Loki allocator作者：小熊 | 2026/7/19 本讲剖析 Loki 库中 SmallObjAllocator 的三个 class 嵌套结构（chunk → FixedAllocator → SmallObjAllocator），并讨论其实现中的一个小 bug 及修复方法。三个 class 结构嵌套的数据结构设计：最底层是 chunk，chunk 有三个成员，firstAvailableblock 代表下次可以用的第一个区块索引；blocks available 代表可用区块的数量。依次往上，最高层是 smallobjallocator。用户看到的是 smallobjallocator。 chunk 类中有一些函数：重点来看 reset 中有一个流水号索引设置。i 的类型是 unsigned int，代表一个字节大小的无符号整数。用 int 的话，4 个字节，会增加开销。空闲 block 第一个字节用于保存下一个 bloc...