Windows 窗口自动化 · UI 控件控制【律令·本地零联网】

Windows自动化与UI自动化：Win32 窗口枚举、UI控件（类名/标题/矩形）子控件枚举、窗口等待、前台切换、组合键。

常见的触发场景有：Windows UI 自动化、控件、控件树。

完整说明、版本记录和安装方式在 SkillHub 上的「Windows 窗口自动化 · UI 控件控制」页面。

按包内文档「核心能力」，它做这几件事：

1. windows：枚举窗口，按标题/类名精确过滤（返回 hwnd、类名、进程、矩形）
2. children：枚举某窗口的子控件树（类名/标题/矩形）——定位按钮/输入框的坐标依据
3. focus：聚焦指定窗口到前台
4. wait：轮询等待标题匹配的窗口出现（自动化同步神器，默认 15s 超时）
5. keys：向当前前台发送组合键
6. ui-hint：层次说明（Win32 摸不到的自绘控件 → 引导改用 screen-click）

本包只做职责范围内的事。下面这些情况它会明确转给兄弟技能，而不是硬做：

• 需要点击/输入/快捷键 → 转给 screen-click
• 要多步骤串起来跑 → 转给 rpa-flow
• 动作涉及删除/发送/支付等高危 → 转给 computer-use
• 目标是 Word/Excel/PPT 窗口 → 转给 office-automation

反向边界：只做控件树枚举与窗口状态，不做视觉定位、不做流程编排、不判断该不该做。用户只要点一下时直接转 screen-click，不要拦在中间。

写死在包里的红线，一条都不能碰：

• 进程注入、全局钩子、内存读取（本包代码也不含这些能力）
• 对管理员权限窗口绕过 UIPI
• 游戏客户端自动化

安装后，在支持 SkillHub 的 AI 客户端（如 WorkBuddy）里直接使用即可。

触发方式：对话里提到「Windows UI 自动化、控件、控件树」等场景，或把相关文件发给 AI，它就会自动响应。

也可以直接跑脚本，典型用法：python scripts/win_ui.py windows --class Notepad（完整参数见包内说明）。

或从客户端的「已安装技能」列表里手动唤起。

不发一个网络包——包的 frontmatter 声明 network: none，不声明就没有联网能力。三条验证路径任选：

① 安装后把网断掉再跑一遍，功能照常——它本来就没打算联网；

② 用抓包工具（Wireshark / Fiddler）观察该技能进程，零外部连接；

③ 直接翻源码：win32_native.py、win_ui.py 等源码全部公开可预览，没有一行网络代码。这是能逐行核对的技术事实，不是宣传口号。

不需要 API Key，全部技能免费安装。

许可为 BUSL-1.1：BUSL-1.1 源码可见，个人及企业内部可自由使用（含内部生产环境）；发布满 4 年自动转为 Apache-2.0。详见随包 LICENSE.md。

面向 Windows 环境（桌面能力走 Win32 系统接口）。

依赖情况以包内「环境准备」一节为准，SkillHub 安装页可直接预览 SKILL.md 全文。

唯一前置是本机装了 Python 3；客户端（如 WorkBuddy）会替你调用，一般不用手动敲命令。

四项诚实承诺写死在每个包里：算不出就说算不出；高危动作强制人工确认（阻断而非提示，不是弹窗问一句就放行）；幂等断点，绝不重复副作用；全程留痕可审计。

本包只做可逆、低风险的桌面操作（Windows自动化与UI自动化：Win32 窗口枚举、UI控件（类名/标题/矩形）子控件枚举、窗口），动作会写入审计日志（~/.win-ui/actions.log）；删除、发送类能力它根本没有。

两个出口：

① 微信公众号「AI技能工具箱」——每周更新实测与安装步骤，后台留言即可；

② 首页底部有公众号二维码（点此直达）；每个技能包内附完整 SKILL.md 与版本记录，多数问题翻文档就能解决。