Files

Orion 3c980ec87a refactor(core): ♻️ 移除 brew 脚本中的 sudo 密码注入并重构代码

移除 Homebrew 升级脚本中硬编码的 sudo 密码处理逻辑，改为依赖用户预先认证（sudo -v），提高安全性并简化 PTY 转发逻辑。同步更新文档说明及 sntp 脚本的类型校验。

- 脚本: 移除 SUDO_PWD 相关变量及自动注入逻辑，升级版本至 v5.3
- 文档: 更新 README 建议使用 sudo -v 刷新凭据，重写交互说明
- 工具: 在 sntp-rename.js 中增加对非字符串名称的防御性校验

2026-05-04 01:50:00 +08:00

2.6 KiB

Raw Blame History

Homebrew Upgrade Manager

brew-upgrade-manager.sh 是一个 macOS Homebrew 升级脚本，用来按固定流程更新仓库、检查环境、升级命令行工具和 GUI 应用，并清理旧缓存。

功能

执行 brew update -v 更新 Homebrew 仓库。
执行 brew doctor 做健康检查，发现问题时给出警告但不中断后续流程。
自动检查并安装 buo/cask-upgrade，用于提供 brew cu。
使用 brew upgrade --formula 升级命令行 Formula。
使用 brew cu -yaq 升级 Cask GUI 应用。
使用 Python PTY 包装 brew cu，用于处理交互输入转发和终端尺寸问题。
执行 brew cleanup --prune=all 清理旧版本与缓存。

依赖

macOS
Homebrew
Bash
Python 3
可访问 Homebrew tap 的网络环境

可先检查：

brew --version
python3 --version

使用方法

进入目录并赋予执行权限：

cd homebrew
chmod +x brew-upgrade-manager.sh

运行：

./brew-upgrade-manager.sh

指定终端宽度：

./brew-upgrade-manager.sh --width 130
./brew-upgrade-manager.sh --width=130

也可以通过环境变量指定：

HB_TERMINAL_WIDTH=130 ./brew-upgrade-manager.sh

优先级为：命令行 --width 高于 HB_TERMINAL_WIDTH，再高于自动检测值。

sudo 认证

脚本不会保存、传递或自动注入 sudo 密码。如果你的 brew cu 流程会触发 sudo，建议在运行脚本前先刷新 sudo 凭据：

sudo -v
./brew-upgrade-manager.sh

如果 sudo 凭据过期，脚本内的 PTY 逻辑只会把你的键盘输入转发给子进程，不会嗅探 Password: 提示，也不会替你填写密码。

执行流程

打印分隔线并更新 Homebrew 仓库。
执行 brew doctor。
检查 buo/cask-upgrade tap。
升级 Formula。
升级 Cask。
清理 Homebrew 缓存。

常见问题

`brew cu` 不存在

脚本会自动执行：

brew tap buo/cask-upgrade

如果失败，通常是网络、Homebrew tap 或权限问题。

表格渲染或 Ruby 报终端宽度错误

使用固定宽度运行：

./brew-upgrade-manager.sh --width 130

sudo 卡住

先在交互终端运行 sudo -v，确认 sudo 凭据有效后再执行脚本。非交互环境中请避免依赖脚本内输入密码。

注意事项

脚本启用了 set -e 和 set -o pipefail，关键命令失败会终止流程。
升级 GUI 应用可能关闭或替换已安装应用，建议在重要工作保存后执行。
如果你使用公司设备或受管 macOS，先确认 Homebrew、Cask 和 sudo 策略是否允许自动升级。

2.6 KiB Raw Blame History Unescape Escape