Desktop

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 对象。写操作仍按本文档中的确认规则执行。