SuperAPI AI 工具集

roblox-architecture

编程与开发

查看项目

更新于 10-16 09:41

技能介绍

用途

本技能适用于 Roblox 项目的架构相关工作:新增、移动、重构或评审功能归属、代码布局、依赖关系、启动流程,以及客户端与服务器边界。当涉及所有权、集成、边界、启动或模块拆分时加载。

主要能力

从单一归属者出发

针对每个行为,需要明确:

  • 权威状态及其可变操作者;
  • 公开操作与调用方;
  • 所拥有的 Roblox 实例、连接与任务;
  • 持久化或网络边界;
  • 启动与销毁条件。

当按功能分组能让一次变更保持在一起时,就按功能分组。仅当运行边界要求时才拆分服务端、客户端与共享代码。共享代码不得包含密钥或权威可变状态。

使用最小的依赖形态

直接模块调用是默认方式。只有当一个发布者存在真正独立的观察者时才使用信号。不要为了掩盖普通依赖而添加事件总线、依赖容器、管理器类或 Init/Start 仪式。

保持模块顶层工作轻量且不阻塞。由一个小型引导负责需要排序的启动;顺序调用并让失败可见。并发必须显式且安全,而不是到处自动 task.spawn。

当依赖通过复制到达时,对 WaitForChild 设置边界;无界等待会把缺失实例变成静默挂起。

强制运行时权威

客户端负责呈现与预测;服务端负责校验与决策。Remotes 是带有类型、边界、所有权、滥用控制与失败行为的 API。相关细节分别参见 roblox-networking 与 roblox-security。

仅在证据充分时拆分

当存在以下情况时拆分:独立的生命周期或权威边界、独立的持久化契约、可独立测试的纯核心,或无关的变更理由。

数据导向的替代方案:仅在证据充分时采用

仅当大量相似实体每帧按顺序无关的逻辑更新,或横切查询取代了纠缠的单实体脚本时,ECS 才值得其成本;钩子用于强制不变量,有序系统用于决策。版本相关陷阱参见 full.md 中的 "ECS on Roblox"。

使用方式

集成工作流见 full.md,完整细节见 references/full.md。复用经过验证的项目模块,而不是重新构建;检查契约以及失败与清理路径。

评审要点

每次变更只有一个规范归属者,没有隐藏的启动阻塞或复制的信任决策,清理显式,结构最小且可追踪。标签用于发现,属性用于配置,附加与移除清理只有一个归属者。

限制

资料未提供该技能支持的具体 Roblox 版本范围、安装方式、平台与收费信息。