diff --git a/homebrew/README.md b/homebrew/README.md
index a741ae5..26f2480 100644
--- a/homebrew/README.md
+++ b/homebrew/README.md
@@ -197,6 +197,36 @@ HB_TERMINAL_WIDTH=130 brewup
 
 通常是网络、Homebrew tap 或权限问题。先确认 Homebrew 可正常访问 GitHub 和对应 tap。
 
+### `brew doctor` 提示 warning
+
+`brew doctor` 的 warning 不一定代表脚本失败。脚本会继续执行，并打印：
+
+```bash
+Warning: 'brew doctor' detected issues. Manual review and resolution are recommended.
+```
+
+常见 warning 处理方式：
+
+- `Some installed casks are deprecated or disabled`：说明某些 Cask 已废弃或被禁用，例如 `ayugram`。可以自行寻找替代应用，或不再需要时卸载：
+
+  ```bash
+  brew uninstall --cask ayugram
+  ```
+
+- `Homebrew's "sbin" was not found in your PATH`：说明 shell 的 PATH 缺少 Homebrew 的 sbin 目录。Apple Silicon Mac 通常可加入：
+
+  ```bash
+  echo 'export PATH="/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
+  source ~/.zshrc
+  ```
+
+  Intel Mac 或 `/usr/local` 安装的 Homebrew 可加入：
+
+  ```bash
+  echo 'export PATH="/usr/local/sbin:$PATH"' >> ~/.zshrc
+  source ~/.zshrc
+  ```
+
 ## 注意事项
 
 - 脚本启用了 `set -e` 和 `set -o pipefail`，关键命令失败会终止流程。
diff --git a/homebrew/brew-upgrade-manager-bootstrap.sh b/homebrew/brew-upgrade-manager-bootstrap.sh
index 29712ba..9df7e9e 100755
--- a/homebrew/brew-upgrade-manager-bootstrap.sh
+++ b/homebrew/brew-upgrade-manager-bootstrap.sh
@@ -11,7 +11,7 @@ cleanup() {
 }
 trap cleanup EXIT INT TERM
 
-PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+PATH="/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:/usr/bin:/bin:/usr/sbin:/sbin"
 export PATH
 
 setup_sudo_askpass() {