feat(v1.6): 新增 gui.await 等待条件能力(复盘短板之「语义」)

把 GUI 操作从「按一下→睡几秒→截图碰运气」变成**可断言**:四类条件
window / control / process / file,各复用 window.list / screen.find /
process.list / fs.stat(零新平台代码,平台行为与既有能力一致,只读低危)。
- present/absent 两种等待;超时正确返回 satisfied:false + note
- 轮询期单次异常**不视为失败**(启动中程序常短暂报错),超时才带回 last_error
- 参数非法分两层拒:schema 层(协议错误)与业务层(E_PARAM_INVALID)

本地真实验证(macOS,7 项全过):present 命中(1208ms/7 次轮询)、absent 命中、
超时返回、非法参数 2+1 拒绝、process 命中、底层报错不中断轮询(last_error 带回
辅助功能权限提示)、缺省参数可用。

能力数 42 → 43(数量守卫测试同步更新);README 补快捷键与 gui.await 用法章节。
This commit is contained in:
jkooe committed 2026-10-07 01:21:41 +08:00
1 parent 7037c7ff94
commit 2eb33587fe
17 files changed
+2607 -3

No files matched your search

+4
View File
@@ -1,5 +1,9 @@
# nodeagent 实战复盘:短板、瓶颈与改进优先级
> ⚠️ **本文写于 2026-09-28(当时 19 项能力),多数结论已过时。**
> 2026-10-07 逐项核查:P0 全部解决、P1 仅「定时采样」未做、P2 已补大半。
> **当前状态与下一步路线以 [`ROADMAP.md`](./ROADMAP.md) 为准**,本文保留作为「问题从哪来」的历史记录。
> 基于 2026-09-27 ~ 09-28 的真实使用(Windows 真机部署 + v2rayN 故障排查 + 重装前信息采集)
> 所有问题均来自**实际踩坑**,非理论推演。