[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"package:cask:hammerspoon:zh":3,"releases:stats:cask:hammerspoon:zh":491,"related:cask:hammerspoon:zh":492,"markdown:3:1897:14bn55j":548},{"accentColor":4,"artifacts":5,"autoUpdates":46,"categories":47,"conflictsWith":54,"dependsOn":57,"deprecated":50,"description":68,"descriptionEn":69,"developer":70,"disabled":50,"displayName":71,"downloadSha256":72,"downloadSize":73,"downloadUrl":74,"editorChoice":50,"formulaeUrl":75,"homepage":76,"iconUrl":77,"installCommand":78,"installs":79,"installs30d":80,"isFont":50,"isLibrary":50,"kegOnly":50,"kind":83,"latestRelease":84,"machineTranslated":50,"minMacos":67,"name":71,"names":103,"platforms":105,"primaryCategory":470,"rank30d":471,"releaseCount":472,"releaseStats":473,"repoUrl":478,"screenshots":479,"sourceLocale":97,"sourceUrl":480,"summary":481,"summaryTranslation":482,"supports":484,"tags":486,"tap":490,"token":104,"version":102,"versionChangedAt":88},"#FBAB1D",{"apps":6,"binaries":8,"entries":10,"pkgs":45},[7],"Hammerspoon.app",[9],"hs",[11,18,25,32],{"declaration":12,"phase":16,"sources":17,"type":16},{"uninstall":13},[14],{"quit":15},"org.hammerspoon.Hammerspoon","uninstall",[],{"declaration":19,"phase":22,"sources":23,"target":21,"type":24},{"app":20,"target":21},[7],"\u002FApplications\u002FHammerspoon.app","install",[7],"app",{"declaration":26,"phase":22,"sources":30,"target":29,"type":31},{"binary":27,"target":29},[28],"$APPDIR\u002FHammerspoon.app\u002FContents\u002FFrameworks\u002Fhs\u002Fhs","$HOMEBREW_PREFIX\u002Fbin\u002Fhs",[28],"binary",{"declaration":33,"phase":42,"sources":43,"type":44},{"zap":34},[35],{"trash":36},[37,38,39,40,41],"~\u002F.hammerspoon","~\u002FLibrary\u002FApplication Support\u002Fcom.crashlytics\u002Forg.hammerspoon.Hammerspoon","~\u002FLibrary\u002FCaches\u002Forg.hammerspoon.Hammerspoon","~\u002FLibrary\u002FPreferences\u002Forg.hammerspoon.Hammerspoon.plist","~\u002FLibrary\u002FSaved Application State\u002Forg.hammerspoon.Hammerspoon.savedState","cleanup",[],"zap",[],true,[48],{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},"lucide:wrench",false,"系统工具","utilities","zh-CN",{"casks":55,"formulae":56},[],[],{"arch":58,"casks":61,"formulae":62,"macos":63,"requirements":64},[59,60],"arm64","x86_64",[],[],">= 13",{"macos":65},{">=":66},[67],"13","Hammerspoon 是一款 macOS 桌面自动化应用，通过 Lua 脚本引擎连接系统 API。它面向熟悉编写小型脚本、希望自定义键盘快捷键、窗口工作流和事件驱动自动化的用户。仅安装应用并不会提供一套现成的自动化功能：具体行为取决于你的配置。\n\n## 功能\n- 绑定快捷键，并自动调整窗口位置、执行应用操作和桌面工作流。\n- 通过 Lua 回调响应屏幕、网络、电源及其他系统事件。\n- 检查并控制受支持的音频设备、剪贴板和输入行为。\n- 通过可用 API 显示通知、菜单和自定义界面。\n- 集成 shell 任务、AppleScript 以及受支持的应用或系统扩展。\n- 安装可选的可复用 Lua 插件 Spoons；每个 Spoon 都有自己的设置和依赖项。\n\n## 安装与配置\n安装 `brew install --cask hammerspoon`，或下载官方 ZIP，解压后将 Hammerspoon.app 移至“应用程序”。启动应用并创建 `~\u002F.hammerspoon\u002Finit.lua`。使用菜单编辑并重新加载配置；通过控制台检查错误并进行交互式 Lua 实验。可以从将快捷键绑定到通知这样的简单配置入手，再逐步扩展为窗口或应用自动化。官方入门指南和 API 文档提供了可运行的示例。\n\n如果要自动化桌面应用或输入操作，请在 macOS“系统设置”中为 Hammerspoon 授予“辅助功能”权限。其他操作可能需要各自的系统权限，例如“自动化”或“屏幕录制”。仅启用配置所需的权限。脚本和 Spoons 会以你的用户权限运行；安装前请审查代码。\n\ncask 还会链接到随附的 `hs` 命令行工具。命令行通信通过 Hammerspoon 的 IPC 模块配置；仅建立链接并不会启用所有 IPC 功能。\n\n## 系统与依赖项\n当前的1.1.1版本和 Homebrew Cask 要求 macOS13 或更高版本。Cask列出的平台包括 Intel 和 Apple Silicon Mac。Hammerspoon仅适用于 Mac；其 macOS API 集成不提供 Windows、Linux、iOS 或 Android 客户端。旧版本的要求不能代替1.1.1的要求。官方资料未规定最低 RAM 或磁盘空间。\n\n官方1.1.1 ZIP 根据 GitHub 发布资源元数据，大小为9,704,557字节。已安装的应用、脚本和缓存还会占用额外空间。Lua 和应用扩展已随应用提供；cask未声明额外的 formula 依赖项，也未明确说明存在 cask 冲突。编译源代码需要 Xcode 和构建工具，但使用发布版应用不需要这些工具。可选的 Spoons、shell 命令和集成可能需要另行安装工具或服务账户。\n\n自定义快捷键和窗口自动化可能与其他地方配置的快捷键或窗口管理器相冲突。这类交互取决于具体配置，并非已声明的软件包冲突。必要时请禁用或调整重复绑定。操作系统变更以及目标应用的辅助功能行为可能影响个别自动化 API。\n\n## 数据、账户、费用与许可证\n核心本地自动化不需要 Hammerspoon 账户或订阅。该项目免费且采用 MIT 许可证；在保留规定声明的前提下，允许使用和修改，包括商业用途。随附库和可选 Spoons 各自遵循其许可证；脚本调用的托管服务可能另有费用和账户要求。官方常见问题说明，崩溃报告默认启用，可在“偏好设置”中关闭；请查阅项目的隐私政策。\n\nHomebrew zap 包含 `~\u002F.hammerspoon`、应用偏好设置、缓存和已保存状态。该配置目录包含自定义 Lua 脚本和 Spoons，因此进行彻底清理前请先备份。移除应用不会撤销脚本执行的所有外部操作，也不会删除集成所用的账户。\n\n## 官方参考资料\n- 产品：https:\u002F\u002Fwww.hammerspoon.org\u002F\n- 入门指南：https:\u002F\u002Fwww.hammerspoon.org\u002Fgo\u002F\n- API 文档：https:\u002F\u002Fwww.hammerspoon.org\u002Fdocs\u002F\n- 常见问题与隐私：https:\u002F\u002Fwww.hammerspoon.org\u002Ffaq\u002F 和 https:\u002F\u002Fwww.hammerspoon.org\u002Fprivacy.html\n- 源代码、MIT 许可证和发布版本：https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\n- 官方 Spoon 仓库：https:\u002F\u002Fgithub.com\u002FHammerspoon\u002FSpoons\n","Desktop automation application","Hammerspoon contributors","Hammerspoon","11bb1c90faf5427f37c7bd4fe7eab9774ae43e1d5cb020c5b3088dac32849efa",9704557,"https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\u002Freleases\u002Fdownload\u002F1.1.1\u002FHammerspoon-1.1.1.zip","https:\u002F\u002Fformulae.brew.sh\u002Fcask\u002Fhammerspoon","https:\u002F\u002Fwww.hammerspoon.org\u002F","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fc783517bbc3e\u002F321bed83a25f-256.png","brew install --cask hammerspoon",{"d30":80,"d365":81,"d90":82},3858,52098,14846,"cask",{"bodyMarkdown":85,"brewCommittedAt":86,"hasNotes":46,"id":87,"isLatest":46,"isPrerelease":50,"machineTranslated":46,"publishedAt":88,"sections":89,"source":96,"sourceLocale":97,"summary":98,"title":99,"translation":100,"version":102},"# Hammerspoon 1.1.1\n\n修正发布归档，使意外的资源分支不再干扰 macOS Gatekeeper；需要 macOS13+。\n\n## 打包\n\n- 从可下载的归档中移除意外的资源分支。\n- 防止归档元数据混淆 macOS Gatekeeper。\n- 官方发布将 macOS13.0 列为最低要求。\n\n[官方特定版本发布](https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\u002Freleases\u002Ftag\u002F1.1.1)。本编辑摘要涵盖所记录的版本；源 PR 链接和实现细节可在发布者的发布条目中获取。\n","2026-02-26T13:10:49Z",548,"2026-10-07T09:38:36.653349Z",[90],{"area":91,"items":92},"打包",[93,94,95],"从可下载归档中移除意外的资源分叉。","防止归档元数据对 macOS Gatekeeper 造成干扰。","官方版本将 macOS13.0 列为最低要求。","editorial","en-US","修正发布归档，使意外的资源分叉不再干扰 macOS Gatekeeper；需要 macOS13+。","Hammerspoon 1.1.1",{"locale":53,"machineTranslated":46,"sourceLocale":97,"status":101},"machine","1.1.1",[71,104],"hammerspoon",[106,143,179,216,252,289,325,362,398,434],{"arch":60,"artifacts":107,"conflictsWith":131,"dependsOn":134,"downloadSha256":72,"downloadUrl":74,"macos":141,"minMacos":67,"requiresRosetta":50,"tag":142,"version":102},{"apps":108,"binaries":109,"entries":110,"pkgs":130},[7],[9],[111,116,120,124],{"declaration":112,"phase":16,"sources":115,"type":16},{"uninstall":113},[114],{"quit":15},[],{"declaration":117,"phase":22,"sources":119,"target":21,"type":24},{"app":118,"target":21},[7],[7],{"declaration":121,"phase":22,"sources":123,"target":29,"type":31},{"binary":122,"target":29},[28],[28],{"declaration":125,"phase":42,"sources":129,"type":44},{"zap":126},[127],{"trash":128},[37,38,39,40,41],[],[],{"casks":132,"formulae":133},[],[],{"arch":135,"casks":136,"formulae":137,"macos":63,"requirements":138},[60],[],[],{"macos":139},{">=":140},[67],"27","golden_gate",{"arch":59,"artifacts":144,"conflictsWith":168,"dependsOn":171,"downloadSha256":72,"downloadUrl":74,"macos":141,"minMacos":67,"requiresRosetta":50,"tag":178,"version":102},{"apps":145,"binaries":146,"entries":147,"pkgs":167},[7],[9],[148,153,157,161],{"declaration":149,"phase":16,"sources":152,"type":16},{"uninstall":150},[151],{"quit":15},[],{"declaration":154,"phase":22,"sources":156,"target":21,"type":24},{"app":155,"target":21},[7],[7],{"declaration":158,"phase":22,"sources":160,"target":29,"type":31},{"binary":159,"target":29},[28],[28],{"declaration":162,"phase":42,"sources":166,"type":44},{"zap":163},[164],{"trash":165},[37,38,39,40,41],[],[],{"casks":169,"formulae":170},[],[],{"arch":172,"casks":173,"formulae":174,"macos":63,"requirements":175},[59],[],[],{"macos":176},{">=":177},[67],"arm64_golden_gate",{"arch":60,"artifacts":180,"conflictsWith":204,"dependsOn":207,"downloadSha256":72,"downloadUrl":74,"macos":214,"minMacos":67,"requiresRosetta":50,"tag":215,"version":102},{"apps":181,"binaries":182,"entries":183,"pkgs":203},[7],[9],[184,189,193,197],{"declaration":185,"phase":16,"sources":188,"type":16},{"uninstall":186},[187],{"quit":15},[],{"declaration":190,"phase":22,"sources":192,"target":21,"type":24},{"app":191,"target":21},[7],[7],{"declaration":194,"phase":22,"sources":196,"target":29,"type":31},{"binary":195,"target":29},[28],[28],{"declaration":198,"phase":42,"sources":202,"type":44},{"zap":199},[200],{"trash":201},[37,38,39,40,41],[],[],{"casks":205,"formulae":206},[],[],{"arch":208,"casks":209,"formulae":210,"macos":63,"requirements":211},[60],[],[],{"macos":212},{">=":213},[67],"26","tahoe",{"arch":59,"artifacts":217,"conflictsWith":241,"dependsOn":244,"downloadSha256":72,"downloadUrl":74,"macos":214,"minMacos":67,"requiresRosetta":50,"tag":251,"version":102},{"apps":218,"binaries":219,"entries":220,"pkgs":240},[7],[9],[221,226,230,234],{"declaration":222,"phase":16,"sources":225,"type":16},{"uninstall":223},[224],{"quit":15},[],{"declaration":227,"phase":22,"sources":229,"target":21,"type":24},{"app":228,"target":21},[7],[7],{"declaration":231,"phase":22,"sources":233,"target":29,"type":31},{"binary":232,"target":29},[28],[28],{"declaration":235,"phase":42,"sources":239,"type":44},{"zap":236},[237],{"trash":238},[37,38,39,40,41],[],[],{"casks":242,"formulae":243},[],[],{"arch":245,"casks":246,"formulae":247,"macos":63,"requirements":248},[59],[],[],{"macos":249},{">=":250},[67],"arm64_tahoe",{"arch":60,"artifacts":253,"conflictsWith":277,"dependsOn":280,"downloadSha256":72,"downloadUrl":74,"macos":287,"minMacos":67,"requiresRosetta":50,"tag":288,"version":102},{"apps":254,"binaries":255,"entries":256,"pkgs":276},[7],[9],[257,262,266,270],{"declaration":258,"phase":16,"sources":261,"type":16},{"uninstall":259},[260],{"quit":15},[],{"declaration":263,"phase":22,"sources":265,"target":21,"type":24},{"app":264,"target":21},[7],[7],{"declaration":267,"phase":22,"sources":269,"target":29,"type":31},{"binary":268,"target":29},[28],[28],{"declaration":271,"phase":42,"sources":275,"type":44},{"zap":272},[273],{"trash":274},[37,38,39,40,41],[],[],{"casks":278,"formulae":279},[],[],{"arch":281,"casks":282,"formulae":283,"macos":63,"requirements":284},[60],[],[],{"macos":285},{">=":286},[67],"15","sequoia",{"arch":59,"artifacts":290,"conflictsWith":314,"dependsOn":317,"downloadSha256":72,"downloadUrl":74,"macos":287,"minMacos":67,"requiresRosetta":50,"tag":324,"version":102},{"apps":291,"binaries":292,"entries":293,"pkgs":313},[7],[9],[294,299,303,307],{"declaration":295,"phase":16,"sources":298,"type":16},{"uninstall":296},[297],{"quit":15},[],{"declaration":300,"phase":22,"sources":302,"target":21,"type":24},{"app":301,"target":21},[7],[7],{"declaration":304,"phase":22,"sources":306,"target":29,"type":31},{"binary":305,"target":29},[28],[28],{"declaration":308,"phase":42,"sources":312,"type":44},{"zap":309},[310],{"trash":311},[37,38,39,40,41],[],[],{"casks":315,"formulae":316},[],[],{"arch":318,"casks":319,"formulae":320,"macos":63,"requirements":321},[59],[],[],{"macos":322},{">=":323},[67],"arm64_sequoia",{"arch":60,"artifacts":326,"conflictsWith":350,"dependsOn":353,"downloadSha256":72,"downloadUrl":74,"macos":360,"minMacos":67,"requiresRosetta":50,"tag":361,"version":102},{"apps":327,"binaries":328,"entries":329,"pkgs":349},[7],[9],[330,335,339,343],{"declaration":331,"phase":16,"sources":334,"type":16},{"uninstall":332},[333],{"quit":15},[],{"declaration":336,"phase":22,"sources":338,"target":21,"type":24},{"app":337,"target":21},[7],[7],{"declaration":340,"phase":22,"sources":342,"target":29,"type":31},{"binary":341,"target":29},[28],[28],{"declaration":344,"phase":42,"sources":348,"type":44},{"zap":345},[346],{"trash":347},[37,38,39,40,41],[],[],{"casks":351,"formulae":352},[],[],{"arch":354,"casks":355,"formulae":356,"macos":63,"requirements":357},[60],[],[],{"macos":358},{">=":359},[67],"14","sonoma",{"arch":59,"artifacts":363,"conflictsWith":387,"dependsOn":390,"downloadSha256":72,"downloadUrl":74,"macos":360,"minMacos":67,"requiresRosetta":50,"tag":397,"version":102},{"apps":364,"binaries":365,"entries":366,"pkgs":386},[7],[9],[367,372,376,380],{"declaration":368,"phase":16,"sources":371,"type":16},{"uninstall":369},[370],{"quit":15},[],{"declaration":373,"phase":22,"sources":375,"target":21,"type":24},{"app":374,"target":21},[7],[7],{"declaration":377,"phase":22,"sources":379,"target":29,"type":31},{"binary":378,"target":29},[28],[28],{"declaration":381,"phase":42,"sources":385,"type":44},{"zap":382},[383],{"trash":384},[37,38,39,40,41],[],[],{"casks":388,"formulae":389},[],[],{"arch":391,"casks":392,"formulae":393,"macos":63,"requirements":394},[59],[],[],{"macos":395},{">=":396},[67],"arm64_sonoma",{"arch":60,"artifacts":399,"conflictsWith":423,"dependsOn":426,"downloadSha256":72,"downloadUrl":74,"macos":67,"minMacos":67,"requiresRosetta":50,"tag":433,"version":102},{"apps":400,"binaries":401,"entries":402,"pkgs":422},[7],[9],[403,408,412,416],{"declaration":404,"phase":16,"sources":407,"type":16},{"uninstall":405},[406],{"quit":15},[],{"declaration":409,"phase":22,"sources":411,"target":21,"type":24},{"app":410,"target":21},[7],[7],{"declaration":413,"phase":22,"sources":415,"target":29,"type":31},{"binary":414,"target":29},[28],[28],{"declaration":417,"phase":42,"sources":421,"type":44},{"zap":418},[419],{"trash":420},[37,38,39,40,41],[],[],{"casks":424,"formulae":425},[],[],{"arch":427,"casks":428,"formulae":429,"macos":63,"requirements":430},[60],[],[],{"macos":431},{">=":432},[67],"ventura",{"arch":59,"artifacts":435,"conflictsWith":459,"dependsOn":462,"downloadSha256":72,"downloadUrl":74,"macos":67,"minMacos":67,"requiresRosetta":50,"tag":469,"version":102},{"apps":436,"binaries":437,"entries":438,"pkgs":458},[7],[9],[439,444,448,452],{"declaration":440,"phase":16,"sources":443,"type":16},{"uninstall":441},[442],{"quit":15},[],{"declaration":445,"phase":22,"sources":447,"target":21,"type":24},{"app":446,"target":21},[7],[7],{"declaration":449,"phase":22,"sources":451,"target":29,"type":31},{"binary":450,"target":29},[28],[28],{"declaration":453,"phase":42,"sources":457,"type":44},{"zap":454},[455],{"trash":456},[37,38,39,40,41],[],[],{"casks":460,"formulae":461},[],[],{"arch":463,"casks":464,"formulae":465,"macos":63,"requirements":466},[59],[],[],{"macos":467},{">=":468},[67],"arm64_ventura",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},54,3,{"brewLag":474,"cadence":477,"count30d":475},{"compared":472,"earlierCount":475,"medianMinutes":476},1,153722867,"irregular","https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon",[],"https:\u002F\u002Fgithub.com\u002Fhomebrew\u002Fhomebrew-cask\u002Fblob\u002FHEAD\u002FCasks\u002Fh\u002Fhammerspoon.rb","免费的 MIT 许可 macOS 自动化工具，通过 Lua 脚本、快捷键、窗口控制、系统事件和可选的可复用 Spoons 实现自动化。",{"locale":53,"machineTranslated":50,"sourceLocale":97,"status":483},"manual",{"arm64":46,"requiresRosetta":50,"status":485,"x86_64":46},"known",[71,487,488,489],"Lua","Spoons","MIT","homebrew\u002Fcask",null,[493,505,516,526,538],{"accentColor":494,"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":495,"editorChoice":50,"iconUrl":496,"installs30d":497,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":498,"primaryCategory":499,"rank30d":500,"sourceLocale":97,"summary":501,"token":502,"version":503,"versionChangedAt":504},"#4E476E","Karabiner-Elements","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F0f84cf748365\u002F262bb536fb3b-256.png",2959,"Karabiner Elements",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},70,"免费的 macOS 键盘自定义工具，支持简单重映射、条件复杂规则、设备专属映射和输入事件检查。","karabiner-elements","16.3.0","2026-10-07T09:38:37.849603Z",{"accentColor":506,"autoUpdates":50,"deprecated":50,"disabled":50,"displayName":507,"editorChoice":50,"iconUrl":508,"installs30d":509,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":46,"name":510,"primaryCategory":511,"rank30d":512,"sourceLocale":97,"summary":513,"token":514,"version":515,"versionChangedAt":88},"#FBB346","Homebrew (BrewUI)","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F8389ec6e95b5\u002Feed40c5f9fb2-256.png",6838,"Homebrew",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},31,"Homebrew 官方原生 Mac 界面，用于发现软件包、查看已安装的软件、升级软件包以及检查命令输出。","homebrew-app","0.5.0",{"accentColor":517,"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":518,"editorChoice":50,"iconUrl":519,"installs30d":520,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":518,"primaryCategory":521,"rank30d":522,"sourceLocale":97,"summary":523,"token":524,"version":525,"versionChangedAt":504},"#4789DB","LinearMouse","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F46d5b4315178\u002Fd0174388bf37-256.png",2873,{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},72,"免费的 Mac 鼠标和触控板工具，可调整滚动、指针加速度与速度、按键操作，并按设备或应用设置配置文件。","linearmouse","0.12.0",{"accentColor":527,"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":528,"editorChoice":50,"iconUrl":529,"installs30d":530,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":531,"primaryCategory":532,"rank30d":533,"sourceLocale":97,"summary":534,"token":535,"version":536,"versionChangedAt":537},"#E9C071","AppCleaner","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F0e91200483e4\u002F833a9c1068cf-256.png",2602,"FreeMacSoft AppCleaner",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},81,"Mac 卸载工具，可查找应用关联文件，并供你检查要移除的内容。","appcleaner","3.7","2026-10-07T09:38:25.801627Z",{"accentColor":539,"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":540,"editorChoice":50,"iconUrl":541,"installs30d":542,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":540,"primaryCategory":543,"rank30d":544,"sourceLocale":97,"summary":545,"token":546,"version":547,"versionChangedAt":537},"#7489E6","BetterDisplay","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fc8ab5c259e1f\u002F872d50d0c7af-256.png",5612,{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},37,"macOS 显示控制工具，可调亮度、分辨率和布局；Pro 提供 HiDPI 缩放、虚拟屏幕与串流等功能。","betterdisplay","5.1.1","\u003Cp>Hammerspoon 是一款 macOS 桌面自动化应用，通过 Lua 脚本引擎连接系统 API。它面向熟悉编写小型脚本、希望自定义键盘快捷键、窗口工作流和事件驱动自动化的用户。仅安装应用并不会提供一套现成的自动化功能：具体行为取决于你的配置。\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">功能\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>绑定快捷键，并自动调整窗口位置、执行应用操作和桌面工作流。\u003C\u002Fli>\n\u003Cli>通过 Lua 回调响应屏幕、网络、电源及其他系统事件。\u003C\u002Fli>\n\u003Cli>检查并控制受支持的音频设备、剪贴板和输入行为。\u003C\u002Fli>\n\u003Cli>通过可用 API 显示通知、菜单和自定义界面。\u003C\u002Fli>\n\u003Cli>集成 shell 任务、AppleScript 以及受支持的应用或系统扩展。\u003C\u002Fli>\n\u003Cli>安装可选的可复用 Lua 插件 Spoons；每个 Spoon 都有自己的设置和依赖项。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 class=\"on-md-heading-1\">安装与配置\u003C\u002Fh3>\n\u003Cp>安装 \u003Ccode>brew install --cask hammerspoon\u003C\u002Fcode>，或下载官方 ZIP，解压后将 Hammerspoon.app 移至“应用程序”。启动应用并创建 \u003Ccode>~\u002F.hammerspoon\u002Finit.lua\u003C\u002Fcode>。使用菜单编辑并重新加载配置；通过控制台检查错误并进行交互式 Lua 实验。可以从将快捷键绑定到通知这样的简单配置入手，再逐步扩展为窗口或应用自动化。官方入门指南和 API 文档提供了可运行的示例。\u003C\u002Fp>\n\u003Cp>如果要自动化桌面应用或输入操作，请在 macOS“系统设置”中为 Hammerspoon 授予“辅助功能”权限。其他操作可能需要各自的系统权限，例如“自动化”或“屏幕录制”。仅启用配置所需的权限。脚本和 Spoons 会以你的用户权限运行；安装前请审查代码。\u003C\u002Fp>\n\u003Cp>cask 还会链接到随附的 \u003Ccode>hs\u003C\u002Fcode> 命令行工具。命令行通信通过 Hammerspoon 的 IPC 模块配置；仅建立链接并不会启用所有 IPC 功能。\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">系统与依赖项\u003C\u002Fh3>\n\u003Cp>当前的1.1.1版本和 Homebrew Cask 要求 macOS13 或更高版本。Cask列出的平台包括 Intel 和 Apple Silicon Mac。Hammerspoon仅适用于 Mac；其 macOS API 集成不提供 Windows、Linux、iOS 或 Android 客户端。旧版本的要求不能代替1.1.1的要求。官方资料未规定最低 RAM 或磁盘空间。\u003C\u002Fp>\n\u003Cp>官方1.1.1 ZIP 根据 GitHub 发布资源元数据，大小为9,704,557字节。已安装的应用、脚本和缓存还会占用额外空间。Lua 和应用扩展已随应用提供；cask未声明额外的 formula 依赖项，也未明确说明存在 cask 冲突。编译源代码需要 Xcode 和构建工具，但使用发布版应用不需要这些工具。可选的 Spoons、shell 命令和集成可能需要另行安装工具或服务账户。\u003C\u002Fp>\n\u003Cp>自定义快捷键和窗口自动化可能与其他地方配置的快捷键或窗口管理器相冲突。这类交互取决于具体配置，并非已声明的软件包冲突。必要时请禁用或调整重复绑定。操作系统变更以及目标应用的辅助功能行为可能影响个别自动化 API。\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">数据、账户、费用与许可证\u003C\u002Fh3>\n\u003Cp>核心本地自动化不需要 Hammerspoon 账户或订阅。该项目免费且采用 MIT 许可证；在保留规定声明的前提下，允许使用和修改，包括商业用途。随附库和可选 Spoons 各自遵循其许可证；脚本调用的托管服务可能另有费用和账户要求。官方常见问题说明，崩溃报告默认启用，可在“偏好设置”中关闭；请查阅项目的隐私政策。\u003C\u002Fp>\n\u003Cp>Homebrew zap 包含 \u003Ccode>~\u002F.hammerspoon\u003C\u002Fcode>、应用偏好设置、缓存和已保存状态。该配置目录包含自定义 Lua 脚本和 Spoons，因此进行彻底清理前请先备份。移除应用不会撤销脚本执行的所有外部操作，也不会删除集成所用的账户。\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">官方参考资料\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>产品：\u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002F\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>入门指南：\u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Fgo\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Fgo\u002F\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>API 文档：\u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Fdocs\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Fdocs\u002F\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>常见问题与隐私：\u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Ffaq\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Ffaq\u002F\u003C\u002Fa> 和 \u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Fprivacy.html\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Fprivacy.html\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>源代码、MIT 许可证和发布版本：\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>官方 Spoon 仓库：\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FHammerspoon\u002FSpoons\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fgithub.com\u002FHammerspoon\u002FSpoons\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n"]