工作经验
项目复盘与工程方法论
笔记列表 155
自动关联目录:批量资源加载:找到一部分不能算依赖集合就绪 核心判断:批量加载成功有两层含义:每个逻辑资源都解析成功,且解析出的对象都加载完成。只要找到一个路径就发请求,会把“部分解析”伪装成“整批 Ready”。 一、业务问题:组合表现…
自动关联目录:材质与特效:MID 能改参数,不能替你编译 Shader 核心判断:创作者看到的是“换材质、调颜色、挂特效”,UE 执行的却是“选择已 Cook 的 Shader 变体,再向实例写动态参数”。因此,材质数据不能只是 Mate…
自动关联目录:渲染伸缩:画质档位不是一组 CVar,而是一份降级契约 核心判断:设备档位只能给出初始预算,不能直接决定最终画面。真正可持续的渲染伸缩,必须把平台能力、用户选择、场景上下文、运行时压力和对象语义合成为多个独立预算,并用所有权…
自动关联目录:短名资产解析:第一个命中不是稳定身份 核心判断:短名适合作者输入,不适合作为规范资产身份。解析器若遍历多份映射并返回首个命中,结果就依赖容器顺序;若再返回指向共享暂存对象的引用,查询结果还会被下一次查询改写。 一、具体业务…
自动关联目录:粒子参数驱动:可编辑时间线不应直接变成永久Tick 核心判断:创作层的 Setter、关键帧和随机区间适合表达意图,不适合原样成为每个对象的运行时执行图。先编译通道,再按活跃集合调度,才能同时守住正确性和规模成本。 一、业…
自动关联目录:纹理与 UI 图片:ASTC 变小不等于运行时成本变小 核心判断:图片优化至少有三笔互不等价的账:下载与包体、GPU 驻留、UI 提交。ASTC 文件更小,不代表软件解码后的纹理仍是压缩格式;图片进了 Atlas,也不代表不…
自动关联目录:缓存安装:下载完成不等于资产可用 核心判断:缓存安装不是“把文件写到固定路径”,而是一次跨文件系统与元数据存储的提交协议。文件存在、数据库为 Ready 都只能说明候选制品可发现;只有绑定了制品身份和本次验证结果的凭证,才能…
自动关联目录:网格合批:减少 Draw Call 之前,先定义谁失去 Actor 核心判断:在 UE 中,合批不是把一组 Actor 换成一个 ISM,而是把可编辑对象编译成另一种运行时表示。编译前必须回答四个问题:谁保留逻辑身份,谁拥有…
自动关联目录:资产身份:路径能找到文件,但不能证明文件正确 核心判断:虚拟文件层适合兼容引擎的路径读取接口,但不能充当资产系统的事实源;资产身份必须由“逻辑 ID + 内容修订 + 运行目标”决定,路径只能是解析后的物理位置。 一、业务…
自动关联目录:资产诊断:总加载时间不能解释内容为什么没显示 核心判断:资产与渲染诊断不能只记录“加载耗时”和“当前 FPS”。每个指标必须绑定逻辑资产、目标变体、请求代际、World、运行时对象和生命周期阶段;否则只能证明结果变差,不能解…
自动关联目录:运行时驻留:Actor 已生成不等于画面已就绪 核心判断:UE 运行时不能用一个 Loaded 集合同时表达“空间上需要”“Actor 已生成”“依赖已驻留”和“画面可见”。AActor 存活只证明对象已经在游戏线程物化,不…
自动关联目录:多目标资产构建:单目标重建不能覆盖其他制品 核心判断:多目标构建的提交单元不是“本次命令产出的目录”,而是“一个逻辑资产修订下的完整变体集合”;单目标重建只能替换自己的槽位,不能把其他已验证变体从索引中抹掉。 一、业务冲突…
自动关联目录:复制依赖:Owner变化不该靠每帧全表巡检 核心判断:子 Actor 跟随父 Actor 的相关性是一条有生命周期的图边。注册时读取一次 Owner 不够,但用每帧扫描全部子 Actor 修复,也只是把正确性债务搬进复制准备…
自动关联目录:复制路由:bReplicates只说明能复制,不说明发给谁 核心判断:bReplicates 只声明 Actor 可以进入复制系统,不能回答它应进入全局、Owner、组、空间、依赖还是兼容相关性集合。路由策略必须是可观测、可…
自动关联目录:复制预算:每帧N个Actor不是网络预算 核心判断:Actor 数量可以做保险丝,却不能代表带宽或 CPU。一个首次开 Channel 的复杂 Actor,可能比几十个无变化 Actor 更贵;预算必须作用于每个连接,并同时…
自动关联目录:滚动限频:平均分桶不能证明最大等待时间 核心判断:把全量状态均匀分成若干桶,可以降低平均每帧候选数,却没有自动保证最大等待时间、变更紧急度和成员变化时的公平性。兼容相关性全扫描则只能作为有规模上限的迁移通道。 一、业务冲突…
自动关联目录:空间Cell:降频更新必须用运动包络兜住漏同步 核心判断:二维网格减少的是每连接候选数;把动态 Actor 的 Cell 更新改成每隔若干帧执行,会引入一段“位置已变、成员关系未变”的时间。没有运动包络或越界事件,这不是降精…
自动关联目录:组相关性:退出一个连接的视野不等于ActorTearOff 核心判断:组相关性是“连接订阅哪些 Actor”的关系;TearOff 是“服务器永久停止该 Actor 的权威复制”的全局生命周期决定。用后者实现前者,会把局部退…
自动关联目录:主线程预算:每帧最多 N 个任务不是时间预算 核心判断:数量预算只能限制吞吐,不能限制帧耗时。只要任务成本分布有长尾,一个“每帧一个”的 Mesh、Material 或脚本回调仍可能独占整帧。 一、业务冲突:异步完成越快,…
自动关联目录:加载解码:二进制只消掉解析,不会消掉物化尖峰 核心判断:把 JSON 换成二进制,只能减少字节解析和中间对象构造;如果恢复后的数据仍在游戏线程同步创建脚本对象、Actor 和 Component,首帧尖峰只是从 Parse …
自动关联目录:可玩就绪:Decode 成功不是首帧 Ready 核心判断:加载完成必须按玩家承诺定义。场景能解码、Actor 已生成、资源已绑定、角色可控制和世界完整同步是不同里程碑,任何一个都不能代替 Playable。 一、业务冲突…
自动关联目录:性能基准:Client 和 Server 不是报告里的两个标签 核心判断:把同一段循环分别标成 Client 和 Server,只能验证统计器,不能证明两个运行目标的性能。可信基准必须真正经过目标的调度、脚本、对象、网络与生…
自动关联目录:性能窗口:平均 FPS 会掩盖连续超预算 核心判断:平均 FPS 回答“总吞吐怎么样”,不能回答“玩家是否连续卡住”。加载、流式和大规模玩法必须同时记录分位数、连续超预算、队列等待和阶段归因。 一、业务冲突:平均值变好,体…
自动关联目录:流式回收:释放越积极不等于内存越稳定 核心判断:流出策略不能只看“当前离玩家多远”。过度释放会把内存问题转换成重复下载、解码、UObject 创建和渲染资源重建;真正稳定的策略必须同时观察内存压力与重载成本。 一、业务冲突…
自动关联目录:海量对象:编辑身份不等于 Actor 身份 核心判断:创作者需要几十万“可选择、可保存、可引用”的对象,不代表运行时需要几十万个 Actor。稳定身份属于内容模型;Actor、Component、ISM Instance 和…
自动关联目录:跨目标降级:散落的 DS 判断不能组成能力契约 核心判断:在 Actor、网格、粒子、GUI 和材质代码中分别判断“是不是 DS/移动端”,可以快速止损,却无法证明整个对象没有加载错误依赖。跨目标交付需要一份从制品解析到运行…
自动关联目录:集中调度:去掉对象 Tick 以后仍可能每帧全扫描 核心判断:把上万个 ActorTick 合并成一个 Subsystem Tick,能减少 UE Tick 注册、虚调用和散乱生命周期成本;但如果 Subsystem 每帧仍…
自动关联目录:AnimNotifyState:通知资源不是播放实例 核心判断:UAnimNotifyState 属于动画资产上的共享配置。来源角色、生成组件、当前时间和清理权都属于某次播放;把任何一项写回通知对象,就会把“资产实例”误当成…
自动关联目录:动画同步:复制播放命令不等于复制动画状态 核心判断:网络动画的复制单位应是可重建的播放快照,而不是一次性的 Play RPC。快照必须钉住稳定轨道身份、单调代际、资产版本、权威时钟和停止阶段;动画事件默认只是本地表现事实,只…
自动关联目录:动画生命周期:Play 是时间意图,不是对 Sequence 的调用 核心判断:Play 应立即创建一条带独立时钟和播放代际的逻辑会话;Mesh、UAnimInstance 和 UAnimSequence 都只是可能晚到或被…
自动关联目录:动画资产契约:能加载,不等于能在当前骨架播放 核心判断:UAnimSequence 成功反序列化只证明运输完成。只有源语义、目标骨架、姿势数据、依赖闭包和当前宿主代际同时通过校验,动画才有资格绑定;否则必须保留占位姿势,并返…
自动关联目录:姿势合成:Priority 不是覆盖顺序,而是逐骨骼的剩余权重预算 核心判断:跑动、上半身动作、过渡、Additive、脚本骨骼覆盖和 IK 不能靠“最高优先级覆盖整个人”组合。Priority 应按骨骼分配剩余权重,Mas…
自动关联目录:角色状态:状态名不能同时充当物理事实和网络协议 核心判断:接地、速度等物理事实,跳跃等玩法意图,层级状态,UE MovementMode,动画意图和网络确认必须是不同数据。状态机负责在事实与意图上做确定性归约;网络策略属于转…
自动关联目录:角色规模化:去掉 Skinned Mesh,不等于去掉每实例更新 核心判断:把大量角色从 USkeletalMeshComponent 降级为 VAT + ISM,只消除了逐骨骼求值和部分 Draw Call,并没有自动消除…
自动关联目录:角色重建:Actor 是可替换的表示,不是角色身份 核心判断:角色身份、玩法状态和动画意图必须活在可重建的 UE 表现之上。ACharacter、身体 Actor、USkeletalMeshComponent、骨架、挂件和 …
自动关联目录:共享下载:工作可以合并,所有权不能合并 核心判断:同一制品只执行一次物理获取是正确优化,但订阅者不能只保存成回调数组;没有独立需求身份,就无法正确取消单个调用方,也无法在高优先级调用方退出后降权。 一、业务冲突:三个调用方…
自动关联目录:客户端工程决策手册:从问题到契约与证据 这不是另一篇架构总览,而是一张入口表:先把症状归类,再找到必须建立的契约和可以证明结果的证据。具体实现、反例和取舍仍以链接文章为准。 一、先定位问题属于哪一层 客户端问题 ├─ 数据…
自动关联目录:客户端工程复盘 这不是某个产品的项目总结,也不是功能列表。它要回答的是一个更长期的问题: 当客户端同时承担创作工具、内容运行时、多人玩法、DS 玩法逻辑和跨平台交付时,怎样把不断增加的能力组织成可演进、可验证、可降级的系统?…
自动关联目录:发布恢复:远端结果未知时禁止自动重放 核心判断:上传或远端保存超时后,“本地没收到成功”不等于“远端没生效”。无法查询或幂等确认结果时,自动重放比停止更危险。 一、业务冲突 内容发布包含分配身份、上传源文件、上传平台制品、…
自动关联目录:导入提交:Submit 必须冻结 Revision 与 PlanDigest 核心判断:导入按钮提交的不是“当前草稿 ID”,而是一次不可变执行意图;只有同时冻结草稿 Revision、源文件指纹、计划摘要和工具能力版本,异…
自动关联目录:导入映射:名称不能承担跨工具节点身份 核心判断:本地预览器与 UE Cook 工具会为同一源文件生成不同临时 NodeId;跨工具迁移选择、动画和材质配置时,名称只能参与判别,不能成为身份。 一、业务冲突 创作者在轻量预览…
自动关联目录:工具分发:复制可执行目录不等于生成可验证 SDK 核心判断:UE Cook 工具能在开发机运行,不代表它可以独立分发;一个 SDK 必须声明最小文件闭包、插件与配置白名单、协议版本和每个文件摘要,并拒绝额外内容。 一、业务…
自动关联目录:检查点写入:原子替换失败时旧状态必须仍可读 核心判断:检查点的首要职责不是“尽快写出最新 JSON”,而是无论共享冲突、磁盘满还是进程崩溃,都至少保留一份可解析的旧状态。 一、业务冲突 Cook 与发布可能持续很久,桌面 …
自动关联目录:模块边界:Editor Guard 不等于运行时依赖已经移除 核心判断:在 C++ 调用点包一层 #if WITH_EDITOR 只能裁掉代码分支;只要 Runtime Module 的 Build.cs 仍依赖编辑模块、公…
自动关联目录:目标裁剪:禁用插件列表不是可证明的能力矩阵 核心判断:UE Target 中不断追加 DisablePlugins 能快速缩小包体,却只能表达“不要什么”;可维护的轻量运行时必须先声明“需要哪些能力”,再由构建系统推导模块、…
自动关联目录:管线进度:百分比必须来自已确认工作账本 核心判断:Stage 名称只能说明“正在做哪类工作”,不能计算可信百分比;可恢复管线的进度必须由提交前冻结的工作集合和已确认完成项推导。 一、业务冲突 一个导入任务可能产生多个产品、…
自动关联目录:缺失引用:自动补图不能越过材质槽语义 核心判断:一张外部图片“文件名相似”不能证明它应绑定到某个材质;自动修复必须同时锁定源材质对象、槽位语义和原引用,歧义时宁可阻塞。 一、业务冲突 模型文件常只保存外部贴图路径。路径失效…
自动关联目录:自动化验证:静态契约测试不能代替真实运行证据 核心判断:检查 Target.cs、Build.cs、脚本参数和 Manifest 能快速阻止配置回归,但它只能证明“声明看起来正确”;启动、跨进程通信、资产加载和 DS 行为仍…
自动关联目录:诊断闭环:Stage 必须绑定本次运行与制品身份 核心判断:日志写出 stage=cook 只能帮助搜索;要证明一次慢或失败发生在哪份输入、哪个目标和哪组制品上,Stage 必须与 Intent、Run、ArtifactSe…
自动关联目录:质量门禁:Error、Warning 与 Retryable 是三个维度 核心判断:严重度回答“能否继续”,可重试性回答“原输入不变时再跑是否可能成功”,二者不能合成一个成功/失败布尔值。 一、业务冲突 导入失败可能来自缺…
自动关联目录:资产引用门禁:字符串Contains不能代表包目录归属 核心判断:UE 资产引用规则判断的是“源包通过哪类依赖边指向哪个目标包”。对路径做 Contains 只能判断字符出现过,不能证明目录归属,更不能说明依赖语义。 一、…
自动关联目录:跨语言合约:同一 Schema 必须拥有规范化身份 核心判断:桌面 UI、Python 服务和 UE 工具各有一份 Schema 文件并不等于共享合约;只有明确唯一来源、规范化身份、派生规则和跨实现向量,才能阻止格式相同但语…
自动关联目录:SplineMesh:控制点必须先转换到组件局部空间 核心判断:USplineMeshComponent::SetStartAndEnd 接收的是组件局部空间的位置与切线。把 World 坐标直接写进去,Actor 位于原点…
自动关联目录:临时关闭物理:一个布尔值无法表达重叠占用 核心判断:临时改变物理状态不是“记住一个旧布尔值,结束时写回”。只要两个区间重叠、不同 Body 原状态不同,或 Physical Animation 同时写入,恢复动作就必须知道自…
自动关联目录:物理属性:一次变更必须原子提交到 Body 与接触过滤 核心判断:密度、质量、摩擦、弹性、Anchored、碰撞响应和接触事件不是互不相关的 Setter。UE 中若某一步触发 RecreatePhysicsState 或 …
自动关联目录:物理快照:分片可以乱序,约束岛不能分帧提交 核心判断:网络包是传输单位,约束岛的一帧状态才是应用单位。大快照可以被拆成多包并乱序到达,但只有 Sender、epoch、拓扑、配置、成员身份、覆盖区间和完整性全部验证后,才能用…
自动关联目录:物理所有权:Desired Owner 不是 Committed Authority 核心判断:选出“应该由谁模拟”只是仲裁结果,不是权威已经转移。真正的切权必须证明目标端身份、拓扑、配置和执行帧已就绪,并经过冻结、提交、首…
自动关联目录:物理规模化:先缩小每帧工作集,再降低模拟精度 核心判断:海量物理对象的第一优化对象不是 Solver 精度,而是每帧被访问的集合。注册对象、可接触对象、本帧发生接触的对象、活跃刚体、需要发送的对象和需要呈现的对象必须是不同集…
自动关联目录:碰撞表示:可共享的是形状数据,不是运行时 Body 核心判断:编辑形状、Cooked 碰撞数据和物理场景中的 Body 是三种生命周期。前两者可以不可变共享,Body 必须按实例持有并以真实 shape/pose 校验;只比…
自动关联目录:约束拓扑:Attachment 定义帧,Constraint 连接物理宿主 核心判断:Attachment 是约束帧的来源,不一定是刚体节点;Constraint 真正连接的是两个最终物理宿主。只有先把“内容父子树”解析为“…
自动关联目录:角色移动:冲量必须进入 SavedMove,不能只改 Velocity 核心判断:在 UE 预测移动里,冲量、持续力、Dash 和特殊移动不是某一帧对 Velocity 的修改,而是必须可被记录、合包判断、上行、重放和纠正的…
自动关联目录:FastArray:DirtyItem是状态提示不是可靠事件 核心判断:Fast Array 的职责是让每个连接最终收敛到最新集合状态。MarkItemDirty 不是一次可靠业务事件;缓存 TArray 元素裸指针、混用 …
自动关联目录:如何复盘复杂客户端系统 功能清单只能证明做过很多事,不能证明理解了这些事。真正有价值的复盘,要能回答:为什么当时这样设计、什么变化让它失效、怎样更早识别问题、下一版用什么契约避免重演。 从“做了什么”切换到“解决什么” 同一个…
自动关联目录:AI感知:Stimulus 是观察,不是攻击目标 核心判断:FAIStimulus 只能证明某个 Sense 在某时刻观察到了什么。它不能直接证明目标仍存活、可达、可攻击,也不能替代仇恨、任务阵营和攻击槽位规则。 一、业务…
自动关联目录:AI战斗:状态机编排意图,Ability 提交结果 核心判断:PreAttack、Attacking、PostAttack 适合表达 AI 的战术阶段,Ability 适合拥有一次攻击的提交、命中、消耗和取消。两边都用自己的…
自动关联目录:AI池化:复用 Actor,不能复用上一世 核心判断:Actor Pool 节省的是构造、注册与复制初始化尖峰,不是一次普通的显隐切换。AI 回池前必须终止行为树、路径、Ability、Timer、感知注册和委托;出池后的任…
自动关联目录:AI状态:复制决策结果,不要让客户端重跑决策 核心判断:DS 负责感知、选敌和状态迁移;客户端只消费带版本的决策结果并恢复表现。同步 Idle/Chasing/Attacking 等状态,不等于把行为树、脚本计时器和迁移条件…
自动关联目录:AI规模化:表现 LOD 不能替代 DS 模拟 LOD 核心判断:把远处 SkeletalMesh 换成低成本表示,只减少客户端渲染和部分动画成本;DS 上的感知、行为树、寻路、目标统计、Movement 和复制频率若不降级…
自动关联目录:AI诊断:没有关联 ID 的绿线解释不了失败 核心判断:Gameplay Debugger、Visual Logger 和场景 DebugDraw 能回答“此刻看到了什么”,但无法单独回答一次攻击为什么没发生。必须用同一条关…
自动关联目录:AI选敌:不要在排序比较器里寻路 核心判断:候选排序应比较已经计算好的分数。把同步寻路和全场 AI 枚举放进比较或候选循环,会把一次“选最近目标”放大成不可控的 DS 尖峰。 一、业务冲突:既要选得合理,又不能让所有怪同时…
自动关联目录:交互占用:PlayerId 只能说明是谁,不能证明哪一次 核心判断:互斥交互需要的是一份有代际、有期限、可撤销的服务器 Lease。单独复制“当前玩家是谁”只能表达占用结果,无法拒绝同一玩家上一轮交互的迟到释放。 一、业务…
自动关联目录:交互同步:一次 RPC 不能同时承担命令、状态与事件 核心判断:Command 是请求,Receipt 是请求结果,State 是可恢复事实,Event 是只消费一次的瞬时信号。它们对可靠性、合并、晚加入和重放的语义不同,不…
自动关联目录:交互规模化:空间候选集必须替代每帧全量扫描 核心判断:距离过滤写在循环内部,仍然是全量扫描。高密度交互的第一步不是降低每个 Actor 的 Tick 频率,而是让绝大多数对象不进入本帧工作集,并让未被关注的交互物只保留紧凑描…
自动关联目录:交互资格:客户端可以发现目标,DS 必须重新证明 核心判断:客户端发现“看起来可以交互”的目标,是为了低延迟提示;DS 证明“此刻允许修改玩法状态”,才是资格判定。两者可以使用不同精度,但不能共用一个布尔结果。 一、业务冲…
自动关联目录:异步选敌:TraceHandle完成不代表仍属于本次施法 核心判断:FTraceHandle 只能证明某次 Chaos 查询可以取结果,不能证明这份结果仍属于当前能力尝试。异步选敌必须同时冻结“哪次施法”和“在哪个空间、用哪…
自动关联目录:能力组合:GA 是动作事务,不是交互物基类 核心判断:Gameplay Ability 适合表达角色发起的、有激活条件、消耗、冷却、取消和预测窗口的动作事务;交互物的空间发现、长期状态、占用、持久化和大规模索引应由组件与服务…
自动关联目录:兼容协商:一个版本号不能描述整条资产管线 核心判断:预览解析、场景计划、UE Cook、Bundle、上传 Journal 和渲染后端可以独立升级;用一个“工具版本”全局判兼容,要么误杀可复用阶段,要么放过真正不兼容的组合。…
自动关联目录:UGC客户端架构面试复盘:从创作模型到运行时边界 核心判断:面试官问“UGC 客户端架构”时,期待的不是功能清单或中间件名称,而是创作数据、编辑器、脚本运行时、引擎宿主和平台服务如何分层,状态如何跨越线程、VM、World …
自动关联目录:共享时钟:ServerTime 不是把本地 Now 复制给客户端 核心判断:跨端时间不是一个浮点数,而是“权威 epoch + 单调时钟映射 + 误差边界”;没有这三项,冷却、动画和 UI 倒计时无法判断自己是否仍在同一时间…
自动关联目录:到达数据:跨 World 载荷不能用一次性事件交付 核心判断:跨世界数据必须先于目标 World 到达,并在目标运行时完成首帧读取前持续有效;因此它是带迁移身份的快照,不是一次广播事件。 一、业务冲突 跨世界时,数据由源端…
自动关联目录:启动就绪:Initialize 完成不等于 World 已可用 核心判断:Initialize() 只证明 Subsystem 被构造,不证明 GameInstance、NetDriver、PhysicsScene、端口监听…
自动关联目录:异步提交:WeakObjectPtr 防崩溃,不证明结果仍有效 核心判断:弱引用只能回答 UObject 还在不在;异步结果能否提交,还必须证明它仍属于当前 World、对象代次、属性槽和用户意图。 一、业务冲突 资产、声…
自动关联目录:生命周期归属:Subsystem 可全局访问不等于它活得够久 核心判断:选择 UE Subsystem 不是选择一种方便的单例,而是在声明状态由谁创建、能跨过哪些销毁边界、必须在什么时候失效。 一、业务冲突 编辑 Worl…
自动关联目录:目标架构:按事实、执行、投影与制品划分边界 核心判断:复杂客户端的根问题不是管理器不够多,而是编辑事实、构建产物、运行状态和 UE 表示互相越权;目标架构必须让真相唯一,让投影可丢,让异步结果只能带证据提交。 一、从实际问…
自动关联目录:端到端延迟:RPC RTT 不能解释动作为什么慢 核心判断:玩家感知的是“输入到首个可见反馈”,网络 RTT 只覆盖其中一段;没有贯穿输入、权威提交和表现物化的动作身份,就只能知道慢,不能知道慢在哪里。 一、业务冲突 一次…
自动关联目录:角色对称:Client 与 DS 应共享契约,不应共享启动时序 核心判断:Client 与 DS 应在身份、命令、快照和场景事实上对称,但 UE 为两者提供依赖的时机不同;强行复用同一启动路径,会把生命周期偶然性写进业务协议…
自动关联目录:试玩隔离:Suppress Dirty 不能阻止运行时状态污染创作数据 核心判断:屏蔽属性广播和 Dirty 标记只能隐藏一次写入,不能把运行时状态从创作真相中隔离出去。 一、业务冲突 编辑器希望进入 Play 后让物理真…
自动关联目录:跨世界迁移:目标进程 Ready 不等于玩家可以 Commit 核心判断:目标 DS 已启动、客户端已连上、玩家状态已准备和权威已切换是四个不同事实;只有带证据的 Commit 才能决定玩家属于哪个世界。 一、业务冲突 跨…
自动关联目录:UI桥接:JSON 能传消息,不等于它是一份协议 核心判断:把自定义 UI 与脚本运行时直接连通能显著降低开发成本,但原始 JSON 字符串、全局函数和一条无界消息队列只解决了“能传”,没有解决版本、所有权、流控和销毁一致性…
自动关联目录:VM销毁:关闭脚本堆前必须先让原生回调失去提交权 核心判断:lua_close 不是销毁流程的开始,而是最后一步。网络、Profiler、对象缓存和异步客户端必须先收到 Closing 屏障,撤销所有进入 Lua 的权利。 …
自动关联目录:增量UI投影:避免整树重建后,别陷入平行Map地狱 核心判断:用数据对象树驱动 UWidget/Slate 增量投影,比每次变化重建整棵 UI 正确;但若每个属性、控件和暂态都拥有一张独立 Map,创建、更新、销毁和诊断会形…
自动关联目录:撤销架构:统一栈不应成为所有编辑域的巨型联合体 核心判断:多个编辑前端共享同一条权威历史是正确的;但若每增加一种编辑能力,都向中央记录结构追加枚举和一组可空字段,统一栈会从一致性中心退化为全系统耦合点。 一、实际设计解决了…
自动关联目录:结构撤销:恢复子树必须携带一次性能力 核心判断:删除对象后的完整子树快照不是普通数据,而是能够重新物化对象、占用身份并改写层级的高权限能力;它必须绑定记录、会话代次和所有者,并且只能消费一次。 一、为什么结构 Undo 比…
自动关联目录:编辑事务:能撤销不等于操作已经原子 核心判断:Undo 记录只能证明“以后可能恢复”,不能证明一次编辑在失败时没有留下半成品。编辑命令必须先准备、再原子提交,撤销只是提交后的逆操作。 一、业务问题:失败不能把作品留在中间态…
自动关联目录:编辑作用域:撤销分栈不等于拥有完整会话 核心判断:场景与 Prefab 使用不同 Undo 栈避免了历史串台,但真正的编辑作用域还必须拥有选择、Gizmo、相机、预览 World、Dirty Revision 和异步 gen…
自动关联目录:脚本热重载:清除模块缓存不能撤销世界副作用 核心判断:package.loaded[name] = nil 只保证下一次 require 会重跑模块,不会自动断开旧 Delegate、Timer、网络 handler,也不会…
自动关联目录:脚本隔离:独立 VM 不等于最小权限沙箱 核心判断:编辑、客户端和 DS 使用独立 lua_State,能隔离全局变量、模块缓存和对象注册表;但只要每个 VM 都打开相同标准库并注册整套引擎 API,它就只是状态隔离,还不是…
自动关联目录:脚本预算:超时看门狗不能代替可调度预算 核心判断:看门狗擅长在“已经卡死”后止损,预算调度则在卡死前限制每个脚本本帧能消耗多少 CPU、内存和原生调用成本。两者不是同一层机制。 一、实际演进:从进程级超时到单 VM 中断 …
自动关联目录:行为图编译:编辑树不能直接成为运行时状态机 核心判断:创作者行为树包含可编辑身份、层级和宽松字段;运行时需要确定顺序、已验证 Schema 和不可变程序。两者之间必须有编译边界,不能让 DS 在执行途中解释脏编辑数据。 一…
自动关联目录:行为调度:帧预算必须同时约束队列年龄与原子工作 核心判断:集中调度、错峰和时间片能压平 DS 平均成本,但只限制“调度器循环用了多久”仍不够;一个不可抢占的行为步就能击穿帧预算,持续延期的低优先级任务也会变成玩法错误。 一…
自动关联目录:远程事件:连接证明发送者,载荷仍只是请求 核心判断:DS 可以信任“这条消息来自哪条连接”,不能信任客户端随消息传来的玩家、对象、位置、伤害或完成结果。 一、实际设计:传输层已经守住两条底线 创作者远程事件在发送前递归拒绝…
自动关联目录:连续编辑:拖拽预览与最终提交不能共享进程级会话 核心判断:滑杆和 Gizmo 的高频预览应合并成一次用户意图;但“当前正在编辑哪个对象和属性”若保存在进程级变量中,就无法抵御多面板、多文档、嵌套工具和迟到结束事件。 一、连…
自动关联目录:黑板事务:共享键值表必须有Schema、模式与提交代次 核心判断:黑板一旦同时服务创作、Undo、DS 运行时和观察者,就不再是 Map<String, Variant>;它需要类型 Schema、写入模式、不可…
自动关联目录:AI寻路:NavLink 是并发协议,不是一段停顿时间 核心判断:门、跳跃点和窄通道上的 Smart NavLink 是多个 AI 竞争的共享资源。暂停几秒再继续只能解决单 AI 演出,不能解决并发占用、取消、关门和迟到回调…
自动关联目录:原生回调:进程单例解决入口,不解决结果属于谁 核心判断:JNI、NAPI 或 Objective-C 回调需要一个稳定的进程入口,但入口对象长期存活不代表返回值仍属于当前页面、当前 World 或最近一次请求。跨语言异步必须…
自动关联目录:反射重置:把UPROPERTY拷回模板不等于恢复Actor 核心判断:反射可以恢复一部分声明式值,却看不见 TimerManager、外部 Registry、网络通道和大量原生运行时状态。对象池完成的判据不能是“属性像模板”…
自动关联目录:后台写盘:线程安全队列不等于可关闭管线 核心判断:互斥锁只能保护一次入队或出队;可靠后台写盘还必须回答何时拒绝新数据、停止时写完还是丢弃、怎样唤醒等待者、何时可以释放线程对象。 一、业务冲突:操作记录不能卡主线程,也不能在…
自动关联目录:延迟Spawn:FinishSpawning之前不能发布半成品Actor 核心判断:Deferred Spawn 的价值是在 Construction Script 和 BeginPlay 前注入构造输入。FinishSpa…
自动关联目录:异步资源槽:Tag能去重,不能拒绝旧回调 核心判断:Tag 只能说明“这是网格槽还是动画槽”,不能说明“这是该槽的第几次请求”。旧请求完成后再按 Tag 查询当前路径,会把旧回调和新意图拼成一次不存在的操作。 一、业务冲突…
自动关联目录:归档异步:GC保活不等于工作线程可以操作UObject 核心判断:FGCObjectScopeGuard 只保证作用域内对象不会被 GC 回收,不保证捕获它的排队空窗安全,也不赋予 UObject 工作线程访问权,更不保证同…
自动关联目录:攻击窗口:Timer只能调度,不能定义一次技能事务 核心判断:循环 Timer 可以决定“何时再检查一次”,一次性 Timer 可以提示“时间到了”,但攻击是否仍有效、由谁结算、如何取消以及表现何时收口,必须属于同一个有代际…
自动关联目录:池化Actor:局部循环Timer会把上一世带进下一世 核心判断:池化 Actor 回池后仍是有效 UObject。局部句柄创建的循环 Timer 不会因为隐藏、禁 Tick 或“业务 EndPlay”自动停止;每次借出都会…
自动关联目录:看门狗线程:只能报告超时,不能跨线程修改VM 核心判断:后台看门狗可以测量截止时间并发布超时信号,但不能在脚本正由 Game Thread 执行时,从工作线程读取或替换 VM Hook。中断必须由 VM 所在线程在受支持的 …
自动关联目录:编辑器模块卸载:解绑委托还不够,注册工厂也必须撤销 核心判断:编辑器模块把回调注册进更长寿命的全局 Registry 后,Registry 就持有了对模块实例或模块代码的调用能力。ShutdownModule 必须撤销每一项…
自动关联目录:软类预热:加载句柄取消不等于初始化已经失效 核心判断:FStreamableHandle 能管理一次资源加载,却不能替业务定义 Loading、Ready、Failed 和 Closed。池是否初始化、类是否驻留、模板是否构…
自动关联目录:Prefab覆盖:没有基线版本的 Diff 只是一次猜测 核心判断:Prefab 实例的 Override 不是“当前值与模板值不同”,而是“实例相对某个明确模板 Revision 的结构化补丁”。没有基线身份,Apply、…
自动关联目录:二进制兼容:格式能解析不代表可以安全回退 核心判断:二进制兼容至少包含格式、数据 Schema、编译器 ABI、内容身份和恢复副作用五层。只有在失败前没有物化任何对象时,才能安全回退到另一种编码。 一、业务问题:双读并不等…
自动关联目录:保存快照:后台保存不能重读活对象树 核心判断:后台保存的输入必须是主线程一次冻结得到的不可变快照。若 JSON、二进制和 Manifest 分别读取持续变化的对象树,它们即使都写成功,也可能描述三个不同瞬间。 一、业务问题…
自动关联目录:内容安全:摘要、来源信任和加密不能互相替代 核心判断:摘要证明字节是否变化,签名或可信来源证明谁发布了它,加密隐藏内容,沙箱限制内容能做什么。四者解决不同威胁,不能用“文件已加密”代替完整性与执行边界。 一、业务问题:客户…
自动关联目录:切换关卡:Load 与 Unload 必须组成可补偿事务 核心判断:编辑态切关同时修改磁盘版本、活对象树和当前关卡身份。它不是两个函数的顺序调用,而是带提交点和补偿动作的 Saga。 一、业务问题:切关失败后不能只显示错误…
自动关联目录:多关卡不是大世界:切关模型不能直接承担空间流式 核心判断:多关卡解决“同一项目有多个互斥可编辑场景”,大世界解决“多个空间分区并发驻留并持续进出”。前者的活动关卡事务不能直接扩展成后者的流式系统。 一、实际边界:当前模型一…
自动关联目录:多文件保存:Manifest 最后写不等于真正原子 核心判断:把 Manifest 放在最后写,是正确的发布屏障;但多个文件逐个替换仍不是文件系统事务。进程崩溃、回滚失败和外部修改都需要 generation 级恢复。 一…
自动关联目录:对象身份:ObjectId 不是跨 VM 的全局身份 核心判断:整数 ObjectId 适合在一棵已装载对象树中快速寻址,但不能单独证明对象属于哪个项目、关卡、VM、World 和生命周期。跨这些边界的引用必须携带稳定身份与…
自动关联目录:层级修改:Parent 不是可独立写入的普通属性 核心判断:修改 Parent 会同时改变拓扑、Transform 语义、选择集、撤销记录和引用有效性。它必须是一条结构事务,不能退化成通用属性面板的一次赋值。 一、业务问题…
自动关联目录:派生索引:Manifest 不一致不一定是内容损坏 核心判断:内容事实、派生分类和物理存放位置必须分开。派生索引可以从权威内容重算;字节缺失、路径归属变化和摘要不符则是真正的数据损坏,不能用“重建索引”掩盖。 一、业务问题…
自动关联目录:跨关卡引用:共享层不能反向依赖私有层 核心判断:公共层可以独立存在,因此不能引用只在某一关卡存在的私有对象;关卡私有对象可以引用公共层。引用方向必须与生命周期包含关系一致。 一、业务问题:拆文件之前必须先拆生命周期 把单一…
自动关联目录:UI命中:布局与输入必须使用同一坐标快照 核心判断:渲染位置与命中位置必须由同一个 Viewport/Safe Area 快照推导。布局晚一帧可以接受,用新坐标命中旧布局不可以。 一、业务冲突:布局适合批处理,输入却要求当…
自动关联目录:UI物化:数据树是真相,UWidget 只是可丢弃投影 核心判断:创作者 UI 的权威状态在文档树,UWidget/Slate 只是当前 World 和 Viewport 的运行时投影。投影可以晚建、重建和丢弃,但不能反过来…
自动关联目录:反馈编排:一次 Multicast 不能代替表现事务 核心判断:权威结果、预测反馈和远端观察表现具有不同时间语义。Multicast 只能运输一次消息,不能提供确认、纠正、取消和跨通道幂等。 一、业务冲突:本地必须即时,D…
自动关联目录:相机生命周期:跨 World 恢复需要会话快照 核心判断:编辑态相机恢复不是“记住几个字段”,而是跨 World 的一次事务。快照必须活得比旧 World 久,又不能长到污染下一次会话。 一、业务冲突:Play 会销毁保存…
自动关联目录:相机身份:逻辑 Camera 不等于 ViewTarget Actor 核心判断:逻辑相机保存创作与脚本语义,ACameraActor 是当前 World 的可替换表示,PlayerController::ViewTarge…
自动关联目录:跨世界呈现:加载界面不能归 World 所有 核心判断:需要遮住 World 切换的呈现对象,生命周期必须高于 World;但它只能保存最小显示快照,不能把旧 World、脚本 VM 或 UObject 图一起带过去。 一…
自动关联目录:输入样本:坐标必须携带它所属的 Viewport 世代 核心判断:指针坐标不是两个浮点数,而是“在哪个 Viewport、哪一代尺寸和安全区规则下测得”的不可变事实。丢掉上下文后,再精确的坐标也可能命中错误对象。 一、业务…
自动关联目录:输入路由:Begin 被消费后,Move 和 End 不能重新判定 核心判断:输入消费是一次手势的所有权协议,不是每帧重新执行的 if-else。Begin 由谁接管,后续 Move、End 或 Cancel 就必须到达同一…
自动关联目录:音频会话:Play 是意图,PlayingId 才是本次播放 核心判断:异步音频里,Play 只是当前意图;一次真实播放必须由 LoadGeneration、PlayingId 和持有的媒体生命周期共同定义。 一、业务冲突…
自动关联目录:音频限流:准入与记账必须是同一次事务 核心判断:数量裁剪不是“播放前看一次 Count,播放后再加一”。检查和占位之间只要存在启动窗口,多个请求就能同时越过上限;若开始与结束又使用不同规则,计数会进一步漂移。 一、具体业务…
自动关联目录:音频预算:静音 Voice 仍然不是零成本 核心判断:把超预算声音音量设为零,只解决听感竞争,不等于停止中间件 Voice、空间更新、RTPC、组件同步和容器遍历成本。 一、业务冲突:海量声音要保持时间连续,又不能都付完整…
自动关联目录:Actor迁移:先抽离真相,再替换运行时表示 核心判断:从全 Actor 迁移到数据化运行时,最危险的不是慢,而是快路径漏掉旧路径隐含的不变量;迁移顺序必须先抽离身份和真相,再替换投影。 一、业务冲突 Actor/Comp…
自动关联目录:Work Experience 这一分类记的是在项目里真正遇到过、解决过的问题,而不是教程里读到的知识。 与另外几个分类的分工: 分类 记什么 回答什么 Base Knowledge 原理 为什么 Progr…
自动关联目录:Work Experience Work Experience 记的是在现场踩过的坑,所以这一页收的资料有个共同点:都是"出事之后回来查"的东西,不是学习型资料。 用法:遇到具体问题回来找线索;如果想系统补…
自动关联目录:Efficiency 工程效率的本质是缩短"改完到看到结果"的间隔。这个间隔越长,每次试错越贵,人就越倾向于"一次性改一大堆"——然后调试成本指数上升。 所以优化顺序是:先看哪里在等,再…
自动关联目录:UE Project Git Pull&Build 目的:用 UGit 管理项目,设置定时任务每日自动唤醒计算机并执行该脚本——早上到工位时,代码已经是最新的、编辑器已经编译好并打开了。 省下的是每天开工前那 10~3…
自动关联目录:Security 客户端安全的第一原则:客户端是不可信的。任何只在客户端做的判断,都等价于没有判断。 这不是说客户端不用防,而是要先想清楚防的目标: 目标 手段的位置 不能改数值(金币、血量) 必须服务端权威 …
自动关联目录:哈希函数 哈希函数把任意长度数据映射成固定长度的值。它不是一个东西,而是两类需求——用错类别是最常见的问题。 两类哈希 类别 要求 代表 用途 非密码学哈希 快、分布均匀 FNV、MurmurHash、CityH…
自动关联目录:Json Json 的优势只有一个,但很重要:人能读、能改、能 diff。这决定了它的主战场是配置、调试数据、对外接口,而不是高性能或大数据量场景。 数据类型 Json 说明 常见坑 object 键值映射 键顺…
自动关联目录:Protobuf Protobuf 的核心设计是用字段编号代替字段名。字节流里只有编号,没有键名——这一条同时解决了体积、解析速度和版本兼容三个问题。 message PlayerState { int32 …
自动关联目录:Serialization 序列化要同时满足三件事:跨端一致、能演进、够快。三者互相拉扯,选型的本质就是决定牺牲哪一个。 本目录 笔记 内容 Json 文本格式:可读性、调试、配置 Protobuf 二进制格…
自动关联目录:Agent评测:任务完成率不能代表工程收益 核心判断:客户端 Agent 的评测单位不是一次对话,而是“从冻结起点到可验证变更”的完整运行;完成率必须和错误变更、修复成本、审查成本、回滚与资源消耗一起看。 一、业务冲突 D…
自动关联目录:上下文装配:更长 Prompt 不能替代可追溯 Grounding 核心判断:Agent 需要的不是尽可能长的聊天记录,而是与本次任务相关、带来源和版本的事实;摘要只能压缩上下文,不能把不可靠记忆变成事实。 一、业务冲突 …
自动关联目录:写入回滚:文件快照不能替代跨编辑器事务 核心判断:写前快照只能恢复被识别出的文件内容;AI 同时修改多文件、UE 对象、资产索引和外部服务时,必须提交结构化 ChangeSet,而不是事后猜哪些副作用要撤销。 一、业务冲突…
自动关联目录:取消语义:Abort Signal 不能撤销已经发生的副作用 核心判断:取消只表示调用方不再等待;工具是否停止、外部效果是否发生和能否重试是三个不同事实,必须分别记录。 一、业务冲突 用户点击停止时,模型请求、并行读取、文…
自动关联目录:工具权限:Tool Schema 不是执行授权 核心判断:Tool Schema 只约束参数形状;能否执行必须由宿主根据会话、目标资源、影响类型、预算和用户许可重新裁决。 一、业务冲突 同一个 write_file 既可能…
自动关联目录:生成资产:预览可见不等于可以进入内容库 核心判断:生成服务只产生候选字节;只有完成格式校验、资产导入、平台构建、动画与物理兼容、性能预算和人工确认后,它才是客户端资产。 一、业务冲突 生成图片、模型或动画的速度越来越快,但…
自动关联目录:能力边界:模型负责提出变更,不负责证明变更正确 核心判断:AI 可以扩展“提出候选方案”的带宽,但编译器、验证器、Client/DS 运行证据和责任人共同决定方案能否接受;把模型接上工具,不等于把工程权威交给模型。 一、业…
自动关联目录:动态组件:NetMode不等于Actor的本地角色 核心判断:NetMode 描述这个 World 运行在哪类进程,LocalRole 描述这个 Actor 在本机的网络角色,IsLocallyControlled 描述控制…