全员速查表

摘要：本文聚焦「全员速查表」，梳理核心概念、关键方法与落地实践。

Status: LAW (宪法) > 执行力: 违反本表红线导致的 Bug 或 性能事故，将被视为严重失职。请所有成员将对应部分背诵并在 Code Review / 资源提交时严格对照。

​

1. 💻 程序员 (Code: The Foundation)

​

🔴 绝对红线 (Must Not)

1. 禁止在主线程处理战斗逻辑: 伤害计算、索敌、Buff 结算必须走 Job System / Burst。主线程只负责发令。
2. 禁止每帧分配内存 (No GC in Update):
   • ❌ string text = "HP: " + hp;
   • ❌ new List<Enemy>()
   • ❌ foreach (var x in list) (在老版本编译器会有 GC，养成习惯用 for)。
3. 禁止直接 Destroy/Instantiate: 任何高频对象（子弹、特效、怪物、伤害数字）必须走 ObjectPoolManager。
4. 禁止硬编码文本: UI 上不允许出现任何中文/英文字符串，必须使用 Localization.Get("KEY")。
5. 禁止在 Release 包开启 Log: Log 必须封装在 DebugUtil 中，并确保 [Conditional("DEBUG")]。字符串拼接的 Log 是手机发热的元凶。

​

🟢 核心原则 (Must)

1. 防御式编程 (Null Checks): GetComponent 必须缓存。外部传来的数据默认是脏的。
2. 数据驱动 (Data Driven): 技能效果不写死在代码里，而是由 EffectID + Params 驱动。
   • 正确: ApplyEffect(EffectType.Damage, 100)
   • 错误: target.hp -= 100;
3. 断线重连优先: 网络层设计必须假设随时会断网。所有请求必须有 Retry 和 Timeout，且在重连后能自动恢复状态。

​

2. 🎨 美术 (Art: The Face)

​

🔴 绝对红线 (Must Not)

1. 禁止无限制的 Overdraw: 特效粒子数严格限制（见 VFX 标准）。一个火球爆炸不能覆盖全屏 3 层像素。
2. 禁止使用 Standard Shader: 所有材质必须使用项目定制的 Toon/Mobile Shader。Standard Shader 是性能杀手。
3. 禁止半透明物体乱序: 透明材质（UI、特效）必须手动指定 RenderQueue，防止显示层级错乱。
4. 禁止非压缩贴图: Android 必须是 ASTC，iOS 必须是 ASTC/PVRTC。禁止 RGBA32 (UI 除外)。
5. 禁止 Model 轴心不在脚底: 怪物和塔的 Pivot 必须在 (0,0,0) 且位于底部中心，否则寻路和放置会对不齐。

​

🟢 核心原则 (Must)

1. 视觉层级 (Hierarchy): 玩家技能 > 怪物技能 > 死亡特效。做特效前先看 视觉层级指南。
2. 合批优先 (Batching): 场景物件必须共用材质球。能用一张 2048 图集解决的，绝不拆成 4 张 1024。
3. LOD (Levels of Detail): 超过 500 面的单位必须有 LOD1 (减面 50%)。

​

3. 🧠 策划 (Design: The Soul)

​

🔴 绝对红线 (Must Not)

1. 禁止“乘法堆叠”无上限: 伤害公式中，独立乘区 (More Damage) 不能超过 3 个。必须引入边际收益递减。
2. 禁止修改已上线 ID: 任何配置表里的 ID 一旦推上线，永不修改，只能废弃 (Deprecated) 并新增。否则玩家存档会坏。
3. 禁止无提示的机制杀: 玩家死了一定要让他知道“怎么死的”。不能有“看不见的秒杀光环”。
4. 禁止空投新机制: 任何新机制（如：带护盾的怪）必须先在简单的关卡单独出现一次（教学），然后再混入怪群。

​

🟢 核心原则 (Must)

1. Excel 注释: 每一个配表字段，必须写清楚单位（秒、毫秒、百分比）。Speed: 100 是 100 米/秒 还是 100%？
2. 保底机制 (Pity): 任何随机掉落（Roguelike 选卡、装备掉落）必须有伪随机保底。不能让非酋连续 10 次选不到核心卡。
3. 预期管理: 技能描述里的数值必须是最终值（绿色高亮），而不是基础值。

​

4. 🎵 音频 (Audio: The Vibe)

​

🔴 绝对红线 (Must Not)

1. 禁止无限制叠加音效: 同一帧播放同一个音效超过 3 次，必须被 AudioManager 拦截。
2. 禁止 BGM 不循环: 背景音乐必须完美 Loop，不能有明显的“断点”。
3. 禁止 2D/3D 混用: 只有 UI 音效是 2D 的。战场音效必须是 3D 的（或经过虚拟耳朵处理），否则玩家听声辨位会乱。

​

🟢 核心原则 (Must)

1. 侧链压缩 (Ducking): 关键音效（大招、升级）播放时，必须自动压低背景音乐和杂音。
2. 随机化: 高频音效（普攻、脚步）必须有 Pitch/Volume 的微小随机扰动，防止机关枪效应。

​

5. 📦 版本与流程 (Pipeline)

​

🔴 绝对红线 (Must Not)

1. 禁止提交“红名”代码: 提交前必须本地编译通过，且无 Error Log。
2. 禁止周五下午发版: 除非你想毁了全组人的周末。
3. 禁止私自升级 Unity 版本: 引擎升级是全组的大事，必须由主程评估。

​

🟢 核心原则 (Must)

1. Commit Message: 必须清晰。Fix bug 是垃圾提交。Fix: 修复了箭塔在 30 级时攻速溢出的 Bug 是好提交。
2. 美术资源命名: 严格遵守 T_Icon_Sword_01 (Type_Category_Name_Variant) 的命名规范。

​

📚 扩展阅读与技术标准 (References)

​

🚀 性能优化

• Unity Performance Best Practices (Official Unity)
  • 官方白皮书。必读章节：Memory Management 和 Asset Auditing。
• 10000 Update() calls vs 10000 Array iterations (Unity Blog)
  • 用数据证明了为什么 Update 是性能杀手，以及为什么你应该用 Manager 统一轮询。

​

🎨 美术规范

• The Technical Art of Sea of Thieves (GDC 2018)
  • 盗贼之海 的技术美术分享。展示了如何用最少的 DrawCall 实现最绚丽的风格化海洋。
• Optimizing Graphics in Unity
  • Unity Learn 上的官方课程，详细讲解了 DrawCall Batching 和 GPU Instancing 的触发条件。

​

💻 代码架构

• Level Up Your Code with Game Programming Patterns (Bob Nystrom)
  • 必读: Object Pool 和 Data Locality 章节。这是高性能游戏编程的基石。