jiuyhfdj/wdsm_cocos_lua_debug_shell

1# MAX START HERE - WDSM Cocos-Lua Debug Shell2 3更新时间：2026-07-09 16:43:09  4项目路径：`D:\UU\wdsm_cocos_lua_debug_shell`5 6## 你现在要接手什么7 8这是从 APK 逆向整理出来的 Cocos2d-x Lua 调试壳工程。当前目标不是重新做网页预览，也不是转成 Cocos Creator / Unity，而是在 **Win32 Cocos2d-x Lua 调试壳**里继续恢复/修改原游戏 UI 和功能。9 10## 第一批必读文件11 121. `D:\UU\wdsm_cocos_lua_debug_shell\MAX_START_HERE.md`：本文件。132. `D:\UU\wdsm_cocos_lua_debug_shell\MAX_RUNBOOK.md`：怎么启动、怎么验证、怎么修改。143. `D:\UU\wdsm_cocos_lua_debug_shell\MAX_TASK_STATE.md`：当前做到哪、还差什么。154. `D:\UU\wdsm_cocos_lua_debug_shell\MAX_PROJECT_INDEX.md`：目录索引、关键源码、配置链路。165. `D:\UU\wdsm_cocos_lua_debug_shell\work\mission-state.md`：完整阶段记录。176. `D:\UU\wdsm_cocos_lua_debug_shell\MAX_PREVIEW.md`：Max/Cocos 预览入口说明。18 19## 当前可运行入口20 21运行：22 23```powershell24D:\UU\wdsm_cocos_lua_debug_shell\run_max_preview.bat25```26 27调试壳 exe：28 29```text30D:\UU\wdsm_cocos_lua_debug_shell\simulator\win32\wdsm_cocos_lua_debug_shell.exe31```32 33主要 Lua 入口：34 35```text36D:\UU\wdsm_cocos_lua_debug_shell\src\main.lua37```38 39原 APK 入口备份：40 41```text42D:\UU\wdsm_cocos_lua_debug_shell\src\main_original.lua43```44 45当前主要修复文件：46 47```text48D:\UU\wdsm_cocos_lua_debug_shell\src\debug_shell\ui_module_picker.lua49```50 51## 当前已完成的功能52 53- 真实主城地图 / 建筑对象层已经接入调试壳。54- 建筑点击链路已接通：hit overlay -> `SceneTouchManager:clickBuilding()` -> `MainBuilding:toOpen()` -> `ModuleManager:open()`。55- Armory 四类工厂已接入：56  - `102` 坦克工厂：15 个兵种。57  - `103` 特种兵营：14 个兵种。58  - `117` 直升机场：14 个兵种。59  - `118` 导弹工厂：13 个兵种。60- 生产队列页已按源码风格恢复：生产、加速、领取、取消已验证。61- 非 Armory 建筑不会再弹旧的通用调试黑框面板。62 63## 不要重复踩坑64 65- 不要覆盖 `src\main.lua`；原 APK 入口在 `src\main_original.lua`。66- 不要从零新建项目，继续在 `D:\UU\wdsm_cocos_lua_debug_shell` 修改。67- 不要优先网页预览；用户已明确不需要网页端。68- 修改 `src\debug_shell\ui_module_picker.lua` 前先备份到 `work\`。69- `simulator\win32\Resources\src` 是 junction 指向项目 `src`，改 `src` 后重启模拟器即可。70 71## 下一步建议72 73优先继续恢复其它建筑的专用功能页，例如：`104` 改装工厂、`105` 研究所、`106/107` 仓库、`108` 军官学院、`110` 配件工厂、`122` 港口、`131` 商船。做法参考当前 Armory 恢复层：先找 `JianZhuCfg.operate -> JianZhuOperateCfg.openId -> ModuleCfg -> 源码模块`，再为无法直接跑的模块写安全恢复 UI。74