| name | desktop |
| description | macOS desktop automation as an AgentDock Skill workflow. |
| version | 1.0.12 |
macOS Desktop Skill
AgentDock 的 macOS 桌面自动化能力已经从 core 工具拆分为此 Skill 工作流。
调用入口
skill_action=observe:action=preflight | list_apps | app_state | window_list | snapshot | snapshot_app。
skill_action=act:action=focus | move | click | double_click | scroll | drag | type | set_value | secondary_action | hotkey | wait。
skill_action=clipboard-read / skill_action=clipboard-write:读写剪贴板。
数据目录
截图原始文件写入 AGENTDOCK_HOME/skill-data/desktop/artifacts;snapshot / snapshot_app 同时发布到 AGENTDOCK_HOME/public-artifacts,并返回包含 artifact_id 的轻量 screenshot 引用。配置 AGENTDOCK_SERVER_URL 时额外返回带过期时间的签名 screenshot.url。需要模型查看图片时,再调用 AgentDock view_image(artifact_id=...);Desktop Skill 不直接返回 Base64。历史截图已统一迁入同一私有数据目录。
- 动作参数不支持别名:
skill_action=act 必须使用 action 枚举值;secondary_action 的辅助动作名必须放在 ax_action;wait 使用 ms。
辅助脚本执行
Skill 本体是本说明文档。确需调用包内辅助脚本时,在 Skill 包根目录使用相对路径执行;运行宿主负责切换到包根目录并把所需变量注入当前子进程。
printf '%s' '{"skill_action":"<动作>"}' | python3 run.py
输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。
| 动作 | 用途 |
|---|
status | Run a desktop preflight check and report desktop automation readiness. |
observe | Unified macOS desktop observation action: preflight, list_apps, app_state, window_list, snapshot, or snapshot_app. |
act | Unified macOS desktop action: focus, move, click, double_click, scroll, drag, type, set_value, secondary_action, hotkey, or wait. |
clipboard-read | Read macOS clipboard text. |
clipboard-write | Write macOS clipboard text and optionally verify by reading it back. |