5.7 KiB
5.7 KiB
title, type, tags, date
| title | type | tags | date | |||||
|---|---|---|---|---|---|---|---|---|
| Unity Architect Agent Personality | source |
|
2026-05-02 |
Source File
Summary（用中文描述）
- 核心主题：Unity 游戏架构中的数据驱动、模块化设计方法论，基于 ScriptableObject 构建可扩展系统
- 问题域：Unity 项目中常见的代码耦合、单体类蔓延、硬编码引用等架构腐败问题
- 方法/机制：ScriptableObject First Design + 单职责组件模式 + SO 事件通道 + RuntimeSet 追踪
- 结论/价值：消除 GameObject 中心主义，通过 SO 资产实现设计师友好、可测试、易扩展的架构
Key Claims（用中文描述）
- 所有共享游戏数据必须存于 ScriptableObject，不得通过 MonoBehaviour 字段跨场景传递
- 每个 MonoBehaviour 只解决一个问题，超过 150 行几乎必然违反 SRP
- 跨系统通信必须通过 SO 事件通道，禁止
GameObject.Find()、FindObjectOfType()、静态单例 - Prefab 必须完全自包含，放入空场景无错误；序列化脚本修改必须调用
EditorUtility.SetDirty()
Key Quotes
"Eliminate hard references between systems using ScriptableObject event channels" — SO 事件通道替代硬引用 "Every prefab dragged into a scene must be fully self-contained — no assumptions about scene hierarchy" — Prefab 自包含原则 "If a class exceeds ~150 lines, it is almost certainly violating SRP" — 代码行数红线
Key Concepts
- ScriptableObject：Unity 资产，可存储数据无需挂载到 GameObject，用于变量、事件、运行时集合
- Single Responsibility Principle：每个 MonoBehaviour 仅负责一个职责，超长组件必须拆分
- Event Channel Pattern：SO 事件通道（GameEvent）实现跨系统解耦通信
- RuntimeSet：ScriptableObject 管理的实体运行时集合，无单例开销
- Addressables：Unity 资源管理系统，替代 Resources.Load，支持细粒度内存控制和 DLC
- DOTS (Data-Oriented Tech Stack)：Unity ECS，Job System + Burst Compiler 优化性能关键路径
- Burst Compiler：将 C# Job 代码编译为近乎原生性能的机器码
- Data-Oriented Design：面向数据的设计，与面向对象互补，提升 CPU 缓存命中率
Key Entities
- UnityArchitect：角色名，资深 Unity 工程师，数据驱动模块化设计专家，拒绝 GameObject 中心主义
- FloatVariable：SO 变量资产示例，支持运行时值变更事件
- GameEvent：SO 事件通道资产，用于跨 MonoBehaviour 解耦通信
- RuntimeSetRegistrar：MonoBehaviour，在 OnEnable/OnDisable 时向 RuntimeSet 注册/注销
Connections
- Unity Multiplayer Engineer ← extends ← Unity Architect（多人网络扩展基础架构）
- Unity Shader Graph Artist ← extends ← Unity Architect（渲染管线基础架构）
- Unity Editor Tool Developer ← extends ← Unity Architect（Editor 工具基础架构）
- Godot Gameplay Scripter ← parallels ← Unity Architect（跨引擎设计模式对应）
- Roblox Systems Scripter ← parallels ← Unity Architect（跨平台代码架构模式）
Contradictions
- 与传统 Unity "Manager Singleton" 惯用法冲突：
- 冲突点：是否允许静态单例管理跨系统状态
- 当前观点：所有共享状态置于 SO 资产，通过 Inspector 引用，消除全局可变状态
- 对方观点：单例简单直接，访问全局状态无需显式依赖注入
Technical Deliverables（关键代码模式）
FloatVariable SO
[CreateAssetMenu(menuName = "Variables/Float")]
public class FloatVariable : ScriptableObject
{
[SerializeField] private float _value;
public float Value
{
get => _value;
set { _value = value; OnValueChanged?.Invoke(value); }
}
public event Action<float> OnValueChanged;
public void SetValue(float value) => Value = value;
public void ApplyChange(float amount) => Value += amount;
}
GameEvent Channel（解耦消息）
[CreateAssetMenu(menuName = "Events/Game Event")]
public class GameEvent : ScriptableObject
{
private readonly List<GameEventListener> _listeners = new();
public void Raise()
{
for (int i = _listeners.Count - 1; i >= 0; i--)
_listeners[i].OnEventRaised();
}
public void RegisterListener(GameEventListener listener) => _listeners.Add(listener);
public void UnregisterListener(GameEventListener listener) => _listeners.Remove(listener);
}
RuntimeSet（无单例实体追踪）
public abstract class RuntimeSet<T> : ScriptableObject
{
public List<T> Items = new List<T>();
public void Add(T item) { if (!Items.Contains(item)) Items.Add(item); }
public void Remove(T item) { if (Items.Contains(item)) Items.Remove(item); }
}
Workflow Process
- Architecture Audit：识别硬引用、单例、God Class，映射数据流
- SO Asset Design：创建 Variable SO、Event Channel SO、RuntimeSet SO，按领域组织
- Component Decomposition：拆分 God MonoBehaviour 为单职责组件，通过 SO 引用连接
- Editor Tooling：添加 CustomEditor/PropertyDrawer，[CreateAssetMenu]，构建时架构验证
- Scene Architecture：场景无持久数据，使用 Addressables + SO 配置驱动场景加载
Success Metrics
- 生产代码中零
GameObject.Find()或FindObjectOfType()调用 - 每个 MonoBehaviour < 150 行，仅处理一个关注点
- 每个 Prefab 可在空场景中独立运行无错误
- GC 分配在事件驱动路径上为零帧
- 设计师无需修改代码即可通过 Inspector 创建新游戏变量和事件