fix(installer): 一键安装器点「立即安装」后不缩成角落进度卡——SHOW 钩子被路过的页吃掉（dev-board#356）

[zeweihan]

真机症状（用户 Mac 上的 Windows 虚拟机）：欢迎大卡片正常，点完「立即安装」界面塌回 NSIS 原生向导——进度条贴顶、原生「上一步(P)」按钮飘在窗口中间、窗口还是 760 宽的大卡片尺寸。原始需求是对齐搜狗：点完应当收成桌面右上角 360x132 的小进度卡。

根因

MUI2 的 MUI_PAGE_CUSTOMFUNCTION_SHOW 是「谁先展开谁吃掉」的一次性 define——Pages.nsh 里 MUI_PAGE_FUNCTION_CUSTOM 展开成 Call <fn> 紧跟一句 !undef。引擎原先把安装页的 SHOW 回调 AwdInstFilesShow（负责把主窗收成角落小卡片）挂在 AWD_UI_PAGE_WELCOME 宏里，赌「紧随其后的就是 MUI_PAGE_INSTFILES」。

Office 插件安装器确实如此，桌面端不是。electron-builder 的 assistedInstaller.nsh 页序是：

customWelcomePage → [licensePage] → PAGE_INSTALL_MODE → [MUI_PAGE_DIRECTORY]
→ customPageAfterChangeDir → MUI_PAGE_INSTFILES → customFinishPage

中间那张「安装模式」页（perMachine=false 才有）在编译期先把 SHOW 吃掉并 !undef；而它自己又被本仓的 customInstallMode（$isForceCurrentInstall=1）在 PRE 里 Abort 跳过，那句 Call AwdInstFilesShow 连跑都不会跑。两头都不响，回调从未执行——安装页于是保持 NSIS 原生形态。

CI 一直全绿是因为 ui-harness 走的是「欢迎页紧贴 INSTFILES」的理想页序，且「点完立即安装」那一步只截图不断言。

修法

• 引擎拆出 AWD_UI_INSTFILES_HOOK（只 define）与 AWD_UI_PAGE_INSTFILES（钩子 + 页的原子宏），欢迎页宏不再偷偷挂钩子；
• ui-harness / Office 插件安装器改用原子宏，页序由自己掌握，抢不走；
• 桌面端页序在 electron-builder 手里，钩子挂 customPageAfterChangeDir——那是唯一紧贴 INSTFILES 之前的钩子。升级 electron-builder 要回核这个页序（注释里已写死这条契约）。

红绿两轮（同一份用例代码，测试代码未变）

run	引擎	harness-eborder	理想页序的 zh/en
33479867391	未改	红：progress card: 760 x 568, native back button visible=True	绿
33480261799	已修	绿：360x132 小进度卡	绿（含 ARM 腿）

红轮的 shots/eborder/03-progress.png 与用户实机截图同形（进度条贴顶 + 「上一步」飘在中间）。

回归护栏

• ui-harness.nsi 新增 -DEB_PAGE_ORDER：按 multiUserUi.nsh 逐句复刻那张「运行期被 Abort 跳过、编译期照吃 MUI 定义」的页，smoke 工作流多编一个 harness-eborder.exe 实跑；
• installer-smoke.ps1 在「点完立即安装」后真做断言了：窗口宽度必须缩到小卡片，原生「上一步」按钮（IDC 3）必须不可见。老坑之所以能瞒过去，就是因为这一步只截图。

地雷入档 .claude/agents/eng-infra.md 6.5.5。

dev-board#356

🤖 Generated with Claude Code