大家好，最近做了一个小工具：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 索引。
于是平时就会变成：
- 打开 GitHub 或官网
- 找最新 release
- 判断 arm64 / x64 / universal
- 下载 dmg 或 zip
- 拖到 Applications
- 后续更新继续手动重复
我希望把这类应用也尽量放回 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 应用的朋友。