Agent Desktop Ffi
C-ABI绑定库，直接调用桌面代理操作
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Agent Desktop Ffi。 它的用途是：C-ABI绑定库，直接调用桌面代理操作 完整的 Skill 内容见：https://321skill.com/skills/agent-desktop-ffi-x-9/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用Python加载agent-desktop-ffi动态库，初始化后获取当前Finder窗口的快照，找到第一个按钮并点击它。' 它会生成Python代码：使用ctypes加载libagent_desktop_ffi.dylib，调用ad_init验证版本，创建适配器，执行ad_snapshot获取JSON快照，解析出按钮的ref ID，再调用ad_execute_by_ref执行点击，最后释放内存。整个过程无需启动子进程，响应迅速。
介绍
这个Skill解决了在多种编程语言中高效调用桌面代理操作的问题。在实际开发中，开发者通常需要频繁与桌面应用交互（如获取界面快照、执行点击操作），传统方式是通过启动CLI子进程来调用，每次调用都会产生进程创建和销毁的开销，在高频场景下性能瓶颈明显。Agent Desktop Ffi 提供了C-ABI绑定，允许Python、Swift、Node.js、Go、C++、Ruby等语言直接链接动态库并调用ad_*函数，无需启动子进程，显著降低延迟。
使用方式很简单，你只需要先构建cdylib：cargo build --profile release-ffi -p agent-desktop-ffi，生成libagent_desktop_ffi.dylib（或.so/.dll）以及C头文件。之后就可以在目标语言中加载该动态库，按照规范流程调用：先调用ad_init(AD_ABI_VERSION_MAJOR)进行ABI握手验证，然后创建适配器ad_adapter_create_with_session，接着执行ad_snapshot获取界面快照，解析返回的JSON找到元素引用ID，再通过ad_execute_by_ref执行操作，最后释放字符串并销毁适配器。整个observe-act工作流清晰且可复用。
它非常适合需要高性能桌面自动化集成的团队或个人。尤其是那些已经使用agent-desktop平台、但希望从多种语言（如Python数据科学脚本、Node.js后端服务、Go微服务）中直接调用其能力，而不想为每种语言单独封装CLI调用的开发者。也适合构建跨语言桌面代理工具链的智能体开发者和全栈工程师。
建议在集成前仔细阅读references目录下的所有权、错误处理、线程安全等文档，特别是ad_free_string的调用时机，避免内存泄漏。需要注意的是，ABI版本必须严格匹配：编译时的AD_ABI_VERSION_MAJOR必须与加载的动态库一致，否则初始化会返回错误。预编译存档可在发布页面获取，但建议自行构建以确保版本一致。
核心特点
与直接调用agent-desktop CLI二进制不同，Agent Desktop Ffi通过C-ABI直接链接动态库，避免了每次操作都启动子进程的开销，在高频调用场景下延迟降低数倍；同时支持Python ctypes、Node ffi-napi、Go cgo等多种语言原生绑定，无需为每种语言单独封装CLI调用逻辑。
注意事项
需要手动管理内存（调用ad_free_string释放返回的字符串），且ABI版本必须与编译时一致，否则初始化失败；目前仅支持agent-desktop平台，不适用于其他桌面自动化框架。
常见问题
支持哪些编程语言？
支持Python（ctypes）、Swift、Node.js（ffi-napi）、Go（cgo）、C++、Ruby（fiddle）等能加载C动态库的语言。
如何获取预编译的动态库？
可以在GitHub Releases页面下载预编译的.dylib/.so/.dll文件，或自行用cargo build --profile release-ffi构建。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-desktop-ffi-x-9/raw/index.md 读取 Agent Desktop Ffi 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-desktop-ffi-x-9/raw/index.md（查看排版版本）