# 🍺 Brew 历史版本安装 — 使用说明 ## 简介 **brew-version-install** 能帮助你通过 Homebrew 安装任意历史版本的软件包。当你需要的版本不是 Homebrew 当前默认提供的最新稳定版时,只需告诉 Agent 你想要的软件和版本号,它会自动完成全部操作。 --- ## 使用方式 在 Agent 对话框中,用自然语言描述你的需求即可。例如: > **"帮我用 brew 安装 qt 6.8.2 版本"** > **"brew 安装 node@18.16.0"** > **"用 homebrew 装一个旧版的 python 3.10.4"** ### 触发关键词 以下关键词会自动触发该 Skill: - `brew install old version` - `install specific version with brew` - `brew 历史版本` - `brew 指定版本安装` - `brew 装旧版` --- ## 执行流程 Skill 被触发后,会按以下步骤自动执行: ``` ┌─────────────────────────────────────┐ │ Step 0: 前置检查 │ │ ├── 0.1 检查 Homebrew 是否已安装 │ │ │ └── 未安装 → 自动安装 Homebrew │ │ └── 0.2 检查目标包是否已安装 │ │ ├── 相同版本 → 直接结束 ✅ │ │ ├── 不同版本 → 卸载旧版本 │ │ └── 未安装 → 继续安装 │ ├─────────────────────────────────────┤ │ Step 1: 查看软件 formula 路径 │ ├─────────────────────────────────────┤ │ Step 2: 访问 GitHub 历史记录 │ ├─────────────────────────────────────┤ │ Step 3: 定位目标版本的 commit │ ├─────────────────────────────────────┤ │ Step 4: 下载 formula 并安装 │ ├─────────────────────────────────────┤ │ 验证安装结果 ✅ │ └─────────────────────────────────────┘ ``` > 💡 整个过程全自动,你只需要确认关键操作(如卸载旧版本)即可。 --- ## 使用示例 ### 示例 1:安装指定版本的 Qt **输入:** > 帮我用 brew 安装 qt 6.8.2 **执行结果:** ``` ✅ Homebrew 已安装 (v5.1.7) ⚠️ 检测到 qt 6.10.2 已安装,与目标版本不同 🗑 卸载 qt 6.10.2... 📥 下载 qt 6.8.2 formula... 🍺 安装 qt 6.8.2... ✅ qt 6.8.2 安装成功! ``` ### 示例 2:安装已有的相同版本 **输入:** > brew 安装 node 20.11.0 **执行结果:** ``` ✅ Homebrew 已安装 ✅ node 20.11.0 已安装,无需操作 ``` ### 示例 3:首次安装(无旧版本) **输入:** > 用 brew 装 ffmpeg 6.0 **执行结果:** ``` ✅ Homebrew 已安装 📋 未检测到 ffmpeg,开始安装... 📥 下载 ffmpeg 6.0 formula... 🍺 安装 ffmpeg 6.0... ✅ ffmpeg 6.0 安装成功! ``` --- ## 常见问题 ### Q: 支持哪些软件包? 所有在 [homebrew-core](https://github.com/Homebrew/homebrew-core) 仓库中有历史记录的软件包都可以安装。Cask 类软件(如 GUI 应用)暂不支持。 ### Q: 安装后怎么确认版本? ```bash brew list --versions <包名> ``` ### Q: 能同时安装多个版本吗? Homebrew 默认不支持同一软件包的多版本共存。安装新版本前会自动卸载旧版本。 ### Q: 找不到想要的历史版本怎么办? 部分非常旧的版本可能已从 homebrew-core 仓库中移除,此时无法通过此方法安装。 ### Q: 安装失败提示依赖冲突? AI 会尝试使用 `--ignore-dependencies` 处理,但会提醒你注意可能的依赖影响。 --- ## 注意事项 1. **网络要求**:需要能够访问 GitHub(下载历史 formula 文件) 2. **系统要求**:macOS 或 Linux(Homebrew 支持的系统) 3. **权限**:部分操作可能需要你确认授权 4. **Bottle 可用性**:较旧的版本可能没有预编译的 bottle,此时会从源码编译,耗时较长
# 🍺 Brew 历史版本安装 — 使用说明 ## 简介 **brew-version-install** 能帮助你通过 Homebrew 安装任意历史版本的软件包。当你需要的版本不是 Homebrew 当前默认提供的最新稳定版时,只需告诉 Agent 你想要的软件和版本号,它会自动完成全部操作。 --- ## 使用方式 在 Agent 对话框中,用自然语言描述你的需求即可。例如: > **"帮我用 brew 安装 qt 6.8.2 版本"** > **"brew 安装 node@18.16.0"** > **"用 homebrew 装一个旧版的 python 3.10.4"** ### 触发关键词 以下关键词会自动触发该 Skill: - `brew install old version` - `install specific version with brew` - `brew 历史版本` - `brew 指定版本安装` - `brew 装旧版` --- ## 执行流程 Skill 被触发后,会按以下步骤自动执行: ``` ┌─────────────────────────────────────┐ │ Step 0: 前置检查 │ │ ├── 0.1 检查 Homebrew 是否已安装 │ │ │ └── 未安装 → 自动安装 Homebrew │ │ └── 0.2 检查目标包是否已安装 │ │ ├── 相同版本 → 直接结束 ✅ │ │ ├── 不同版本 → 卸载旧版本 │ │ └── 未安装 → 继续安装 │ ├─────────────────────────────────────┤ │ Step 1: 查看软件 formula 路径 │ ├─────────────────────────────────────┤ │ Step 2: 访问 GitHub 历史记录 │ ├─────────────────────────────────────┤ │ Step 3: 定位目标版本的 commit │ ├─────────────────────────────────────┤ │ Step 4: 下载 formula 并安装 │ ├─────────────────────────────────────┤ │ 验证安装结果 ✅ │ └─────────────────────────────────────┘ ``` > 💡 整个过程全自动,你只需要确认关键操作(如卸载旧版本)即可。 --- ## 使用示例 ### 示例 1:安装指定版本的 Qt **输入:** > 帮我用 brew 安装 qt 6.8.2 **执行结果:** ``` ✅ Homebrew 已安装 (v5.1.7) ⚠️ 检测到 qt 6.10.2 已安装,与目标版本不同 🗑 卸载 qt 6.10.2... 📥 下载 qt 6.8.2 formula... 🍺 安装 qt 6.8.2... ✅ qt 6.8.2 安装成功! ``` ### 示例 2:安装已有的相同版本 **输入:** > brew 安装 node 20.11.0 **执行结果:** ``` ✅ Homebrew 已安装 ✅ node 20.11.0 已安装,无需操作 ``` ### 示例 3:首次安装(无旧版本) **输入:** > 用 brew 装 ffmpeg 6.0 **执行结果:** ``` ✅ Homebrew 已安装 📋 未检测到 ffmpeg,开始安装... 📥 下载 ffmpeg 6.0 formula... 🍺 安装 ffmpeg 6.0... ✅ ffmpeg 6.0 安装成功! ``` --- ## 常见问题 ### Q: 支持哪些软件包? 所有在 [homebrew-core](https://github.com/Homebrew/homebrew-core) 仓库中有历史记录的软件包都可以安装。Cask 类软件(如 GUI 应用)暂不支持。 ### Q: 安装后怎么确认版本? ```bash brew list --versions <包名> ``` ### Q: 能同时安装多个版本吗? Homebrew 默认不支持同一软件包的多版本共存。安装新版本前会自动卸载旧版本。 ### Q: 找不到想要的历史版本怎么办? 部分非常旧的版本可能已从 homebrew-core 仓库中移除,此时无法通过此方法安装。 ### Q: 安装失败提示依赖冲突? AI 会尝试使用 `--ignore-dependencies` 处理,但会提醒你注意可能的依赖影响。 --- ## 注意事项 1. **网络要求**:需要能够访问 GitHub(下载历史 formula 文件) 2. **系统要求**:macOS 或 Linux(Homebrew 支持的系统) 3. **权限**:部分操作可能需要你确认授权 4. **Bottle 可用性**:较旧的版本可能没有预编译的 bottle,此时会从源码编译,耗时较长