桌面自动化 · 窗口与文件批量操作【律令·本地零联网】

本地窗口管理与桌面自动化：窗口枚举、窗口切换、激活与状态管理，打开应用、文件打开与 URL 走系统关联方式，纯 ctypes 零依赖零网络。

常见的触发场景有：桌面自动化、窗口管理、激活窗口。

完整说明、版本记录和安装方式在 SkillHub 上的「桌面自动化 · 窗口与文件批量操作」页面。

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

1. windows：枚举可见窗口（标题/类名/进程/矩形），可按标题或类名过滤
2. find / activate：按标题定位窗口并聚焦到前台
3. state：最小化 / 最大化 / 还原 / 隐藏
4. open：打开文件、文件夹、URL——走系统文件关联（os.startfile），无命令行注入面
5. foreground / screen：当前前台窗口信息、屏幕分辨率

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

• 要按控件操作窗口内部 → 转给 win-ui-automation
• 要点击或输入 → 转给 screen-click
• 要多步骤串起来跑 → 转给 rpa-flow
• 目标是 Word/Excel/PPT → 转给 office-automation
• 要观察-决策-行动的复杂桌面闭环 → 转给 computer-use

反向边界：本包是 computer-use 的轻量子集（ctypes 零依赖：启动、打开、窗口切换与状态查询），不做控件操作、不做截图点选、不做复杂决策闭环——那些转 win-ui-automation / screen-click / computer-us…

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

• 用本包启动来历不明的可执行文件
• 绕过 computer-use 的门禁直接执行 high 风险后续动作（本包只开窗口，后面的"做"要走门禁）

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

触发方式：对话里提到「桌面自动化、窗口管理、激活窗口」等场景，或把相关文件发给 AI，它就会自动响应。

也可以直接跑脚本，典型用法：python scripts/desktop_auto.py windows --title "报表" # 找窗口（完整参数见包内说明）。

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

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

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

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

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

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

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

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

纯 Python 标准库实现，不需要 pip install 任何东西，也就没有环境冲突要调。

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

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

本包只做可逆、低风险的桌面操作（本地窗口管理与桌面自动化：窗口枚举、窗口切换、激活与状态管理，打开应用、文件打开与 URL 走系统关），动作会写入审计日志（~/.desktop-automation/actions.log）；删除、发送类能力它根本没有。

两个出口：

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

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