You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
38 lines
1.4 KiB
38 lines
1.4 KiB
# 计划：启动链规范收敛试点（Phase 2）
|
|
|
|
> 状态：进行中
|
|
> 日期：2026-08-17
|
|
> 关联：[遗留代码收敛方案.md](./遗留代码收敛方案.md)、[开发规范.md](./开发规范.md)
|
|
|
|
## 1. 范围
|
|
|
|
| 文件 | 改动类型 |
|
|
|------|----------|
|
|
| `assets/script/GameLaunch.ts` | JSDoc、回调类方法化、事件解绑、节点缺失 warn |
|
|
| `assets/mx/module/boot/BootPipeline.ts` | JSDoc 补全（接口/字段） |
|
|
| `test/启动链冒烟清单.md` | 手工回归清单 |
|
|
| `tools/规范审计.py` | 静态偏离统计 |
|
|
|
|
**不在本次试点**：改 Boot 失败策略、GameController.init 内部、AssetService 逻辑变更。
|
|
|
|
## 2. 收敛项对照
|
|
|
|
| 规范项 | GameLaunch 处理 |
|
|
|--------|-----------------|
|
|
| OOP / 无函数内函数 | `start` 内联箭头改为私有方法 |
|
|
| 回调在类中 | Boot 回调、战斗 UI 暂停钩子 |
|
|
| 无静默兜底 | 场景/相机/Loading 节点缺失 `warn`/`error` |
|
|
| 生命周期 | `onDestroy` 注销全部 `GEvent` |
|
|
| 文档注释 | 类与公开/关键私有方法 JSDoc |
|
|
|
|
## 3. 验收
|
|
|
|
- [x] 代码改动完成（`GameLaunch`、`BootPipeline`）
|
|
- [ ] 编辑器预览可正常冷启动进大厅
|
|
- [ ] 对照 `test/启动链冒烟清单.md` 手工通过
|
|
- [x] 无新增 linter 错误
|
|
|
|
## 4. 后续（本试点之后）
|
|
|
|
- `AssetService`、`BundleLifecycle` 同标准审计
|
|
- `GameController.init` 分帧与资源阶段门闩复核
|
|
|