传统模式 · 配置参考
模块
传统模式下工程模块的归属、迁移和引用边界。
# 模块配置参考
# 入口与前置
在传统工作台左侧打开 模块管理。模块是工程资源的归属边界，不是运行时页面，也不是玩家可见的分类；纯 AI 模式会隐藏这个工作区。
# 字段与操作
| 项目 | 作用 | 修改影响 |
|---|---|---|
| 模块名称 | 列表中显示的名称 | 只影响识别，不改变资源 ID |
| 模块描述 | 记录用途和依赖 | 不参与运行时 |
| 当前模块 | 限定列表和新建资源的归属 | 可能让同名资源不可见 |
| 新建模块 | 创建新的资源边界 | 不会自动迁移旧资源 |
| 迁移资源 | 把实体移到另一个模块 | 引用仍使用原 ID，需重新检查 |
# 记录模块依赖合同
每个模块都应记录：
- 它负责的玩法范围；
- 其他模块会读取的公开实体 ID；
- 它依赖的外部实体 ID；
- 暴露它的入口场景或插件；
- 验收使用的测试存档和预览路径。
模块描述只是工程文档，不是运行时隔离。运行时仍加载一张完整项目图，跨模块引用依然可能形成循环依赖和隐藏耦合。
# 操作语义
| 操作 | 可以依赖的事实 | 必须继续检查 |
|---|---|---|
| 新建 | 初始为空 | 创建实体前先写用途和归属 |
| 选择 | 改变列表与新实体归属 | 每个工作区都确认当前模块 |
| 重命名 | 保留资源 ID | 更新工程说明和同名判断 |
| 迁移 | 保留被迁移实体 ID | 检查入站/出站引用与脚本文本 |
| 删除 | 不应再包含必需实体 | 搜索间接引用并保留恢复版本 |
# 执行顺序
- 先列出要迁移的属性、控件、事件、对象类、表格和插件。
- 保存项目版本。
- 创建目标模块并记录用途。
- 批量迁移后按 ID 检查脚本、绑定和插件配置。
- 在调试区重新加载项目并验证发布内容。
# 边界与风险
模块不会隔离运行时存档，也不会自动修复脚本中拼接的字符串。删除模块前必须清空资源并检查引用；只改名称不能解决同名实体歧义。
# AI 与手动归属交接
纯 AI 项目通常由编辑工具维护资源归属。手动迁移 AI 创建的实体后，应把不变的实体 ID、源/目标模块、受影响引用和验收版本告诉 AI。不要让 AI 在目标模块重新创建同一实体，否则会产生新 ID，并留下旧引用。
# 失败诊断
| 现象 | 常见原因 |
|---|---|
| 列表中找不到实体 | 当前选择了另一个模块 |
| 迁移后运行时引用失效 | 脚本或插件保存了间接/硬编码 ID |
| 两个实体看起来完全相同 | 不同模块存在重复显示名称 |
| 新实体归属错误 | 创建前当前模块发生变化 |
| 模块无法安全删除 | 仍存在隐藏或间接引用 |
# 验收
切换模块后目标资源可定位；迁移前后 ID 不变；引用无断裂；刷新、读取测试存档和发布预览结果一致。
下一页：公式。