1.3 KiB
1.3 KiB
GM Commands Guide
目标
本项目 GM 体系采用双轨入口，并强制复用现有 ET 包能力，不额外新建 GM 框架。
双轨入口约定
- 服务端命令入口：
cn.etetet.console- 使用
[ConsoleHandler("CommandName")]注册 - 适合批量操作、压测、运维值守
- 使用
- 客户端调试入口：
cn.etetet.yiuigm- 使用
[GM(...)]+IGMCommand注册 - 仅用于 Debug 开发测试
- 使用
共享实现约定
- GM 业务逻辑必须下沉到共享静态帮助类
GMHelper - Console 与 Panel 只负责参数解析与转发，禁止各自复制业务逻辑
- GMHelper 内部必须调用正式业务系统接口（如
BagComponentSystem.AddItems），禁止直接改字段绕过校验
发布与安全
- 客户端
[GM]类必须使用#if ENABLE_GM条件编译包裹 - Release 构建不加载 GM 入口
- 所有 GM 操作应写审计日志（模块
GM）
建议命名规范
GM_*：客户端 panel 命令实现C_*：服务端 console 命令实现GMHelper.*：共享业务函数
待接入命令清单（第一批）
- 资源：
AddItem/RemoveItem/ShowBag - 英雄：
AddHero/SetHeroLevel/ShowHeroes - 抽卡：
Gacha/ShowGachaStats/SimulateGacha - 运维：
FlushDirty/SetLogLevel