做了一个 Homebrew 外部命令：从 GitHub Release 或直接下载地址安装任意 Mac 应用

大家好，最近做了一个小工具：ghcask。

项目地址：

https://github.com/oxsean/homebrew-ghcask

网站：

https://oxsean.github.io/homebrew-ghcask-site/

它是一个 Homebrew external command ，目标是解决一个我自己经常遇到的问题：

很多 Mac 应用其实已经提供了可用的 .dmg、.zip、.tar.gz、.tgz 安装包，尤其是一些开源项目会直接放在 GitHub Releases 里，但这些应用不一定已经进入了官方 Homebrew Cask 索引。

于是平时就会变成：

1. 打开 GitHub 或官网


2. 找最新 release


3. 判断 arm64 / x64 / universal


4. 下载 dmg 或 zip


5. 拖到 Applications


6. 后续更新继续手动重复

我希望把这类应用也尽量放回 Homebrew 工作流里，所以做了 ghcask。

基本用法

brew tap oxsean/ghcask

brew ghcask install owner/repo

比如某个 GitHub 仓库有 macOS release asset ，ghcask 会尝试：

• 找到合适的 release


• 选择适合当前机器架构的 macOS 安装包


• 下载并计算 sha256


• 推导 .app 名称


• 生成一个本地 Homebrew cask


• 把下载好的包移动到 Homebrew 的 cask cache


• 最后交给 Homebrew 安装

也支持直接 URL：

brew ghcask install cask-name --url https://example.com/download/App.dmg

这个主要是给那些不在 GitHub 上发布，但能拿到稳定下载地址的软件用。

它不做什么

这个项目不是想替代 Homebrew Cask 。

它也不会把生成的 cask 发布到官方索引，所有生成的 cask 都只保存在本地。实际安装、重装、升级、卸载还是交给 Homebrew 处理。

我的理解是：

• 官方 Homebrew Cask 适合稳定、公开、可维护的应用索引


• ghcask 更适合个人临时或长期使用的本地补充工作流

也就是说，它解决的不是“让所有软件进入官方 cask”，而是“我自己这台机器上想用 Homebrew 管更多软件”。

目前支持的能力

• 从 GitHub Releases 安装


• 从直接 package URL 安装


• 支持 .dmg、.zip、.tar.gz、.tgz


• 自动计算 sha256


• 尽量自动推导 app 名称、版本和架构


• 支持指定版本安装


• 支持 prerelease


• 支持 pin / unpin


• 支持 update / outdated / upgrade


• 支持 reinstall ，并且 direct URL 可以通过 reinstall 换 URL


• 支持 dump / restore ，把生成的本地 cask 状态带到新机器


• 优先使用本地已经登录的 gh，没有的话再回退到 curl

举几个场景

1. 某个开源 Mac App 只有 GitHub Release

以前可能要自己去网页里找 dmg 。

现在可以：

brew ghcask install owner/repo

2. 想安装某个指定版本

brew ghcask install owner/repo --version v1.2.3

指定版本默认会被 pin 住，后续 update 不会自动跳到最新版。

如果以后想回到正常更新轨道：

brew ghcask unpin cask-name

3. 想用 prerelease

brew ghcask install owner/repo --prerelease

或者之后切换：

brew ghcask reinstall cask-name --prerelease

brew ghcask reinstall cask-name --stable

4. 直接从 URL 安装

brew ghcask install app-name --url https://example.com/download/App.dmg

如果 URL 方式的软件之后要升级，可以换 URL 重新安装：

brew ghcask reinstall app-name --url https://example.com/download/App-2.0.dmg

5. 新机器恢复

旧机器：

brew ghcask dump --global --force

新机器：

brew tap oxsean/ghcask

brew trust --tap oxsean/ghcask

brew ghcask restore --global

brew bundle

Brewghcask.json 只保存生成的 cask 定义和 metadata ，不包含安装包和 app 本体。

为什么不用自己写 cask ？

当然可以自己写。

但我自己的痛点是：很多时候只是想快速安装一个 GitHub Release 里的 dmg ，并不想为了一个私人使用的软件维护一份完整 cask 。

ghcask 做的是把这件事自动化一点：

• release 选择


• asset 选择


• sha256


• cask 生成


• Homebrew cache


• 后续 update / reinstall

最终仍然可以检查生成的 cask ，不是黑盒安装。

欢迎大家提建议，尤其是经常用 Homebrew Cask 管 Mac 应用的朋友。