You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何获取应用支持的函数列表?Hammerspoon macOS自动化场景问询

查询应用可调用接口的具体方法

Hammerspoon调用第三方应用功能的本质是对接macOS原生的AppleScript/JXA自动化体系,你要找的应用可用函数、参数规则都存储在应用自身的AppleScript接口字典里,可以通过以下几种方式查询:

  • 用系统自带脚本编辑器查看官方字典
    打开启动台「其他」分类里的「脚本编辑器」,点击顶部菜单栏「文件」->「打开字典」,在弹出的应用列表里选中你要查询的目标应用,就能看到完整的接口说明,包含所有可调用的命令、属性、参数取值范围和官方示例。
  • 用Hammerspoon控制台直接导出接口列表
    调试阶段可以直接在Hammerspoon控制台执行以下命令,直接获取目标应用的全量接口数据:
    hs.osascript.applescript([[tell application "目标应用名称" to return entire contents of dictionary]])
    控制台返回的结构化内容就是完整的可调用函数清单,可以直接保存下来做离线查询。
  • 先测试再封装到工作流
    建议你先在脚本编辑器里写AppleScript代码验证调用效果,确认逻辑符合预期后再转成Hammerspoon调用代码。比如调用Safari打开新标签的示例:
    先在脚本编辑器测试AppleScript代码:
    tell application "Safari"
        make new document at end of documents with properties {URL:"https://example.com"}
    end tell
    
    确认可用后转成Hammerspoon代码:
    hs.osascript.applescript([[
        tell application "Safari"
            make new document at end of documents with properties {URL:"https://example.com"}
        end tell
    ]])
    

注意:部分应用默认关闭AppleScript调用权限,你需要在「系统设置」->「隐私与安全性」->「自动化」里,找到Hammerspoon条目,开启对应目标应用的权限开关,否则调用会直接报错。

内容的提问来源于stack exchange,提问作者Andreas Rozek

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 15:18:04