助手 v17 —— 修复「注入窗口一闪而过」(2026-10-08)

问题现象

v16 把助手窗口 SetParent 成游戏主窗口的子窗口后，窗口只闪一下就消失、再也看不见。

根因

热血江湖是 D3D 渲染的游戏，每帧把整个客户区用 Direct3D 重绘一遍。<br>普通 GDI 子窗口会被压在游戏渲染层下面：

• 窗口创建的第一帧露了一下（闪一下），
• 之后游戏每帧重绘就把子窗口盖死，再也看不见。

结论：把普通窗口 SetParent 成 D3D 游戏窗口的子窗口，对这类游戏天生无效（除非去 hook D3D 的 present，那是另一套大工程）。v16 的方向走错了。

修复方案：独立置顶窗口 + 跟随游戏移动

不再做子窗口，改为：

1. 保留顶层窗口 + 加 WS_EX_TOPMOST（0x8）样式 → 浮在游戏窗口之上，

因为不再进游戏 D3D 渲染层，所以永远不会被画面盖掉。

1. 200ms 定时器（id 9973 → 吸附定时回调）按游戏窗口的屏幕坐标（GetWindowRect）把助手贴到

左下角：x = 游戏左、y = 游戏底 - 助手高（左对齐 + 下对齐）。

1. 只有游戏窗口位置/尺寸变化时才重新贴一次，平时不干活、不抢前台、不卡。
2. 游戏最小化（IsIconic 非 0）→ 临时 MainDialogWnd.可视 = 假 隐藏；

还原后按 吸附_用户可见（Home 键意图）恢复显隐，与原有 Home 切换互不打架。

视觉上仍是你要的：左对齐、下对齐、随游戏窗口移动就移动，但这次真能一直看见。

改动清单（文本主本）

• 常量.e.txt：+ 界面_WS_EX_TOPMOST = "8"（原 界面_WS_CHILD/WS_POPUP/GWL_STYLE/SWP_NOACTIVATE 已无用，保留为未引用声明，无害）
• DLL.e.txt：+ IsIconic_API（user32 IsIconic，判断最小化）；SetParent/GetClientRect_API 改为未引用，保留无害
• 全局变量.e.txt：
• 删除 吸附_上次宽/吸附_上次高
• 新增 吸附_用户可见(逻辑型)、吸附_上次左/上/右/下(整数型，记录游戏窗口屏幕矩形)
• 吸附_游戏窗口句柄/吸附_已启用 语义改为「跟随」参照
• 代码/窗口程序集_MainDialogWnd.form.e.txt：
• _MainDialogWnd_创建完毕 吸附块：去掉 SetParent/WS_CHILD/GetClientRect，改为加 WS_EX_TOPMOST + 用 GetWindowRect 定位左下角（带矩形有效性保护，游戏未就绪时保持默认位置等定时器自愈）
• 吸附定时回调：改为屏幕坐标跟随 + 最小化隐藏 + 按用户意图恢复
• 显示窗口（Home 键）：末尾同步 吸附_用户可见 = MainDialogWnd.可视

验证（四道门禁全过）

• tools/_check_blocks.py 控制块配对 0 处
• tools/_check_decls.py 声明体检 69 数组 / 0 误声明
• t2e 编译 0 错误 0 警告 → 旧版本更新_修复后_v17.e
• e2t 回转 0 错误 0 警告，新代码完整保留，旧 SetParent/GetClientRect 写法已清除
• 用户原 旧版本更新_修复后.e 时间戳未变（未被覆盖）

使用

• 用易语言 F7 编译 旧版本更新_修复后_v17.e，覆盖各机器 test.dll，别点「旧版覆盖」。
• v16 已废弃，不要再编译 旧版本更新_修复后_v16.e（会一闪而过）。
• 游戏须开窗口化/无边框窗口化（独占全屏仍看不到任何浮层，这是系统限制）。
• config\Default.ini [config] 吸附游戏窗口 = 0 可关掉跟随，恢复独立窗口（默认开）。
• 跟随窗口因 WS_EX_TOPMOST 会始终浮在最前（含切到别的程序时也浮着），属正常 overlay 行为。

补丁：修复编译错误 10044（2026-10-08 01:5x）

• 现象：F7 编译报 错误(10044): 不能将"逻辑型"数据转换到"整数型"数据，指向 .如果真 (IsIconic_API (吸附_游戏窗口句柄) ≠ 0)。
• 根因：IsIconic_API 在 DLL.e.txt 声明为返回 逻辑型，而 ≠ 0 要求两侧都是整数型 → 类型冲突。
• 修法：把 IsIconic_API 返回类型改为 整数型（Win32 IsIconic 返回 BOOL=int，本就该是整数），调用处 ≠ 0 不动即合法。
• 教训：e2txt/t2e 不做类型检查，只有易语言 F7 才查；凡是 DLL 命令要拿去 ≠ 0 比较，声明必须写「整数型」而非「逻辑型」。
• 已扫描工程：其余所有 ≠ 0 的左操作数都是整数型（线程句柄、位与结果），无同类隐患。
• 重编 旧版本更新_修复后_v17.e：0 错误 0 警告，用户原 .e 未被触碰。

补丁：消除黑月编译卡死（2026-10-08 02:0x）

• 现象：F7 编译 v17.e 卡在「正在编译…」不动（黑月编译器死循环特征，非报错）。
• 根因：v17 吸附代码里有 3 处「且」链（168 行 4 连、120/181 行 2 连）。5.95 + 黑月对长布尔链 / 单行 If 解析极易死循环卡死（工程铁律：别用「或/且」链 + 深层嵌套，优先拆成平铺的多个 .如果真）。
• 修法：全部拆成平铺多行完整块——168 行用 吸附_没变 标志变量承接（5 个 .如果真… .如果真结束），120/181 行各拆 2 层嵌套；并弃用单行 .如果真 (X) Y 写法（门禁脚本不识别会误报未闭合）。
• 验证：_check_blocks.py 0 处（此前单行写法误报 1 处未闭合，改完整块后通过）、t2e 0 错误 0 警告、吸附代码已无任何「且」链。重编 旧版本更新_修复后_v17.e。
• 教训：交付前不仅要过类型检查（10044），还要保证无「或/且」链——这是黑月卡死而非编译报错，t2e/e2t 抓不到，只有易语言 F7 才暴露。