jiuyhfdj/wdsm_cocos_lua_debug_shell

1# MAX RUNBOOK - 启动 / 修改 / 验证手册2 3更新时间：2026-07-09 16:43:094 5## 1. 打开项目6 7完整工程在：8 9```text10D:\UU\wdsm_cocos_lua_debug_shell11```12 13建议用 VS Code / Cursor / Max 支持的本地文件编辑器直接打开这个目录，不要只打开交接压缩包。14 15## 2. 启动 Win32 调试壳16 17```powershell18D:\UU\wdsm_cocos_lua_debug_shell\run_max_preview.bat19```20 21等窗口出现后，从主城点击建筑验证。当前已经验证的重点是 `buildId=102` 坦克工厂。22 23`run_max_preview.bat` 不启动网页预览；它会进入 Cocos2d-x Lua Win32 调试壳，并自动准备 `simulator\win32\Resources` 下的运行目录 junction。24 25## 3. 修改前备份26 27主要修改文件：28 29```text30D:\UU\wdsm_cocos_lua_debug_shell\src\debug_shell\ui_module_picker.lua31```32 33修改前建议执行：34 35```powershell36$ts = Get-Date -Format yyyyMMdd_HHmmss37Copy-Item "D:\UU\wdsm_cocos_lua_debug_shell\src\debug_shell\ui_module_picker.lua" "D:\UU\wdsm_cocos_lua_debug_shell\work\ui_module_picker.before_$ts.lua"38```39 40## 4. 语法检查41 42```powershell43node D:\UU\wdsm_cocos_lua_debug_shell\work\verify_armory_lua.js44```45 46成功时会输出 Lua 解析通过；如果失败，先修 Lua 语法再启动模拟器。47 48## 5. 功能验证脚本49 50完整坦克工厂链路：51 52```powershell53powershell -NoProfile -ExecutionPolicy Bypass -File D:\UU\wdsm_cocos_lua_debug_shell\work\verify_full_chain_tank_queue_actions.ps154powershell -NoProfile -ExecutionPolicy Bypass -File D:\UU\wdsm_cocos_lua_debug_shell\work\verify_queue_receive_correct.ps155```56 57坦克工厂 15 个兵种分页：58 59```powershell60powershell -NoProfile -ExecutionPolicy Bypass -File D:\UU\wdsm_cocos_lua_debug_shell\work\verify_tank_all_units_pages.ps161```62 634 类 Armory 工厂切换：64 65```powershell66powershell -NoProfile -ExecutionPolicy Bypass -File D:\UU\wdsm_cocos_lua_debug_shell\work\verify_armory_factory_switches.ps167```68 69## 6. 恢复新建筑功能页的固定链路70 71每做一个建筑，按这个链路查：72 73```text74src\config\JianZhuCfg.lua75  -> 建筑 id / operate76src\config\JianZhuOperateCfg.lua77  -> operate id / openId78src\config\ModuleIdCfg.lua 或 ModuleCfg.lua79  -> openId / modName80src\able\module\...81  -> 原模块源码82src\debug_shell\ui_module_picker.lua83  -> 写 Win32 安全恢复层并接入 ModuleManager:open()84```85 86## 7. 当前 Armory 已接入点87 88在 `ui_module_picker.lua` 内搜索：89 90```text91DEBUG_ARMORY_INDEX_BUILD_ID92DEBUG_ARMORY_BUILD_ID_INDEX93DEBUG_ARMORY_OPEN_OP94open_debug_building_module95draw_armory_mod96draw_armory_queue_overlay97install_safe_build_modules98ModuleManager:open99```100 101## 8. 常见问题102 103- 如果改完没变化：确认 `simulator\win32\Resources\src` 是 junction 指向 `D:\UU\wdsm_cocos_lua_debug_shell\src`，然后重启模拟器。104- 如果黑屏：先运行 `node work\verify_armory_lua.js`，再看模拟器 log 是否有 `picker error`。105- 如果弹出旧的矮黑框 UI：说明非 Armory suppress 或 `show_safe_generic_module_panel()` 被重新接回，需要回到 `ModuleManager:open()` 分支修。106- 如果窗口底部被任务栏挡住：这是 Win32 窗口尺寸超过当前屏幕可视区，不是 Cocos panel 没全屏。107- 不要继续维护 `web_preview`，用户已明确不需要网页端。108