面向 AI 智能体 | agent-desktop

agent-desktop 的可执行文件里内嵌了与它自己版本一致的指南。智能体在动手之前先把它们取出来，这样规则永远和你正在调用的那个二进制对齐，而不是和某份会过期的网页文档对齐。

agent-desktop skills get desktop      # 循环、ref、验证与重试规则
agent-desktop skills get platform     # 你所运行平台上的差异
agent-desktop <command> --help        # 单条命令的参数

装进智能体运行环境

从 skills.sh 安装这个技能：

npx skills add https://github.com/vercel-labs/agent-desktop --skill agent-desktop

写进 AGENTS.md

不想装技能，就把下面这段直接放进你的 AGENTS.md：

使用 `agent-desktop` 来查看并操作桌面应用。首次使用前先运行
`agent-desktop skills get desktop` 和 `agent-desktop skills get platform`，并按其中的说明执行。

智能体要遵守的契约

每条命令只打印一个信封，包含 ok 以及 data 或 error。

错误带有 code、disposition，通常还有 suggestion。
只有当 error.disposition.retry 为 safe 时才重试。 其他取值意味着重试会让情况更糟。
退出码用于粗筛：0 成功，1 结构化错误（ok: false），2 命令行解析错误。最终判断仍以信封里的 ok 与 error 为准。

完整的信封结构、错误码与退出码见 JSON 输出契约和错误与恢复。

网页版文档

这个站点本身也发布了智能体友好的形态，不装任何东西也能读：

资源	地址
全站索引	`/llms.txt`
全文合并	`/llms-full.txt`
任意页面的 Markdown	页面地址后接 `index.md`，例如 `/start/quickstart/index.md`

每篇文档页面右上角都有「复制本页」和「Markdown 版本」两个入口。

JEV 助手

可选的 JEV 助手会把屏幕描述发送给你配置的模型服务商。它与原生 CLI 彼此独立：不用它，agent-desktop 依然完整可用；用它，请把它当成一条会把桌面内容发出去的数据通道来看待，见隐私与数据处理。