jkooe
d56556d3c3
feat(v12.3): macOS 端 GUI 能力对齐 —— window.list / window.focus / screen.find
## 动机
此前 window.* 与 screen.find 只在 Windows 可用（UNSUPPORTED_PLATFORM）。本版让
macOS 也能作为被控端被 GUI 操作，兑现「Mac 与 Windows 双向接管」。
## 实现（apps/agent/src/capabilities/darwin.ts）
| 能力 | Windows | macOS |
|-------------|-------------------------|-------------------------------------------|
| window.list | Win32 EnumWindows | AppleScript System Events（需辅助功能权限） |
| window.focus| SetForegroundWindow+兜底 | AppleScript frontmost + AXRaise |
| screen.find | UIA → OCR(WinRT) | 无 UIA 等价物 → 截图 + **Vision OCR** |
要点：
- AppleScript 经 stdin 传入（base64 解码），彻底规避引号/换行转义
- Vision OCR 用 Swift 源码 + `swiftc -O` 按需编译，二进制缓存在数据目录 bin/naocr；
源码变化时自动重编（首编约 15s，之后毫秒级）
- 权限错误翻译成可执行指引：实测 -10004「发生权限违例」→ 提示去「辅助功能」授权；
-1743 → 「自动化」授权
## 真机踩坑（本轮最重要的一条）
**Retina 屏上 screencapture 产出 2x 像素图**，而窗口坐标为逻辑点 —— 直接返回会让
点击偏移一倍。修法：解析 PNG 的 IHDR 取像素尺寸，除以请求区域点数得到缩放比，
换算后再叠加区域偏移（返回体注明已换算）。
## 顺带修掉一个参数缺口
screen.find 的实现读 region 但 schema 未声明 → 带 region 的调用被参数校验拒绝
（E_PARAM_INVALID）。已补 region 到 manifest，并让 Windows 的 OCR 路径同样支持
「显式区域优先 > 指定窗口 > 整屏」（区域越小 OCR 越快越准）。
## 真机验证（本机 macOS 27.2，M3 Max）
- window.list：AppleScript 生效，但本机未授予辅助功能权限 -> 返回可执行提示（预期路径）
- screen.capture：984KB 有效 JPEG（3024x1964）
- Vision OCR 独立验证：对含中文/英文的真实截图识别出「WorkBuddy 编辑 查看 窗口 帮助」等
- screen.find（全屏）：命中 3 处，坐标稳定
- screen.find（区域 0,0,1600,120）：命中且坐标全部落在区域内 —— 证明 Retina 换算正确
- 等待语义（wait_ms）在 macOS 路径同样生效
单测 89/89、e2e 21/21 全绿