用途
dym-agent-desktop 是 rheinmir/setup 下由 doyourmagic 生成的技能包,围绕 agent-desktop 这一用 Rust 编写的 CLI 展开。agent-desktop 通过 accessibility tree(无障碍树)操控桌面应用,提供 55 个命令,并支持 ref 在进程之间保持稳定。该技能包本身用于引导后续操作,并不直接执行桌面自动化,它把调用分发到三个层级的子技能文件,并由这些文件完成后续工作。
主要能力(按 slug 划分)
- install:安装带有范围锁定(pin scope)的二进制,检查 TCC 权限,并验证其可运行;该步骤应先于其他所有操作执行。
- drive:执行“观察—动作”循环,流程为 skeleton → drill → act → verify;包含 ref 体系与错误表。
- session:生成 session/trace/multi-agent cursor,输出 JSONL 与 HTML 证据,可供 /br qc、/fdk-poc 使用。
- route:在 agent-desktop、orca computer、claude-in-chrome、playwright-verify 之间选择合适的工具。
使用方式
输入 /dym-agent-desktop <slug>。如果没有提供 slug,就打印对应表格并停止。随后按以下顺序查找子文件,取第一个存在的文件,并且只读取这一个文件:
- .claude/skills/dym-agent-desktop-<slug>/SKILL.md
- .overstack/doyourmagic/agent-desktop/skills/dym-agent-desktop-<slug>/SKILL.md
- doyourmagic-bundles/agent-desktop/skills/dym-agent-desktop-<slug>/SKILL.md
然后按该文件中的 Steps 与 Rules 执行,不再读取其他子文件;如果三个位置都不存在,就明确说明并停止。
该工具自带文档:运行 agent-desktop skills get desktop --full 会从二进制中原样输出 SKILL 以及 5 个 references 文件。因此不建议把这些文档复制进仓库,否则会随版本变化而产生偏差。
适用场景
适合在 macOS 上通过 AI 智能体对桌面应用进行无障碍树驱动的操作与验证,也适合需要为质量检查(QC)或概念验证(POC)留存 JSONL/HTML 证据的流程。
限制
实际仅支持 macOS:npm 脚本 postinstall.js 中声明 SUPPORTED_PLATFORMS = ['darwin'],windows/linux 的 crate 各为 76 行占位代码。在 Linux/Windows 上应改用 orca computer。资料记录的测试环境为 macOS 24.6 arm64、版本 0.8.5,实际运行日期为 2026-09-09。其它平台、收费与价格信息暂未提供。