jkooe
8ee8dc7f41
feat(v15): screen.find 图像模板匹配（补齐自绘 UI 盲区）+ 一串真机根因修复
## 新能力：method=image 图像模板匹配
审查报告 §5.2 指出「screen.find(image) 图像模板匹配未做，纯图标/无文字的控件是定位盲区」。
UIA 靠控件树、OCR 靠文字，两者对纯图标都无能为力；本版补上第三条腿。
实现（随常驻助手预加载，C# + System.Drawing，零新依赖）：
- 灰度化（LockBits + ITU-R BT.601 整数近似）
- 零均值归一化互相关 ZNCC（对亮度/对比度变化不敏感）
- **粗到精**：1/4 分辨率全图扫描 → 候选在全分辨率 ±8px 精修
（全分辨率逐像素在 3440x1440 上约 190 亿次，不可行）
- 非极大值抑制去重；返回中心坐标 + score，可直接喂 input.mouse.click
- 参数：template（被控端图片路径）、threshold（默认 0.85）；支持 region 限定搜索区
- 出口：screen.find(method=image) + CLI/MCP 同步暴露
真机实测：3440x1440 全屏搜索 **~580ms**，score 0.9745 命中可用坐标；
对「模板纯色/低对比」会显式报错（E_PARAM_INVALID + variance），而不是静默返回空。
## 本轮为打通它而修掉的 7 个真机根因（都值得记档）
1. **预加载段拼接静默失败**：WIN_HELPER_PRELUDE 是多行模板串，替换串写成单行 \n 不匹配且
无 assert → OCR/图像两段从未拼入 → 被 esbuild tree-shake → 运行时才报「找不到类型」。
现已导出并加回归断言（四段齐全 + 顺序）。
2. **助手启动超命令行上限**：bootstrap 含内嵌 C#（编码后 ~36KB）超过 Windows ~32KB 限制，
spawn 直接 ENAMETOOLONG → 每次静默降级到慢路径。改为落地临时脚本 + -File。
3. **一次性降级路径同样超限**：ENAMETOOLONG。同样改为临时脚本 + -File（UTF-8 BOM）。
4. **统计记账掩盖根因**：ensureStarted 在 try 之外，spawn 失败不计入 failures，
表现为「spawned 一直涨、calls 恒为 0」。现已纳入 try，并暴露 ps_helper 状态
（enabled/calls/hits/failures/spawned/avg_ms/lastError）到 system.info。
5. **Add-Type 在中文系统上乱码**：C# 源码按系统 ANSI(GBK) 落盘，中文注释必乱码 → 编译失败。
已把内嵌 C# 全部改为纯 ASCII，并加断言「C# 块不得含非 ASCII」。
6. **Add-Type 缺 -ReferencedAssemblies**：只 Add-Type -AssemblyName System.Drawing 不够，
编译期仍报「命名空间 System.Drawing 中不存在 Imaging」。已补 -ReferencedAssemblies。
7. **TS 模板串吃掉 \" 转义**：在模板字符串里写 \" 会得到裸引号 → C# 编译失败（踩了两次）。
统一改用 C# 字符常量 Q 拼 JSON，并加断言（不得残留裸引号 JSON 形态 / Q 不得重复声明）。
另外把「粗层预筛」从 threshold-0.05 放宽到 threshold-0.30 并始终保留最优候选 ——
降采样会拉低真位置的分数，过严的预筛会让正确答案在精修前就被丢弃（这曾让所有匹配返回空）。
## 单测 105 -> 114
新增 win-prelude 回归 9 例：四段齐全与顺序 / C# 纯 ASCII / 无裸引号 JSON / Q 不重复声明 /
Win32+UIA+OCR+图像 各段关键标记（含 -ReferencedAssemblies）。
这些断言的价值在真机验证过：3 个 bug 都是先被断言抓住、才避免了再次上线静默坏掉。
2026-09-30 01:27:37 +08:00
..
2026-09-29 11:27:52 +08:00
2026-09-27 17:04:21 +08:00
2026-09-29 11:27:52 +08:00
2026-09-30 01:27:37 +08:00
2026-09-27 17:04:21 +08:00
2026-09-29 14:33:01 +08:00
2026-09-27 17:04:21 +08:00
2026-09-29 14:38:53 +08:00
2026-09-29 14:25:35 +08:00
2026-09-30 00:19:10 +08:00
2026-09-30 00:51:56 +08:00
2026-09-27 17:04:21 +08:00
2026-09-27 17:04:21 +08:00
2026-09-30 01:27:37 +08:00