/update_now。
xcode-select --install）shellframeshellframesfctl權限彈窗一直卡住：裝完跑一次 sfctl permissions，預先授予隱私權限與防火牆，避免全域熱鍵失效。
git 不存在（macOS）：先 xcode-select --install 裝好 Command Line Tools 再重跑。
沒有 Homebrew：安裝器會自動嘗試安裝；若失敗，手動裝 brew 後重跑。
App 開啟被 Gatekeeper 擋：在「系統設定 → 隱私權與安全性」按一次「仍要打開」，或重跑安裝器（會重簽 ad-hoc 簽章）。
iex 被執行原則擋住：先在同一個 PowerShell 視窗執行
Set-ExecutionPolicy -Scope Process Bypass -Force，再貼安裝指令。
python 打開 Microsoft Store：那是假殼。安裝器會用 winget 裝真正的 Python；若仍失敗，到 設定 → 應用程式 → 應用程式執行別名，關掉 python 的別名。
TUI 工具（Claude Code 等）顯示亂碼：缺 pywinpty。執行
%USERPROFILE%\.local\apps\shellframe\.venv\Scripts\pip install pywinpty 後重啟。
視窗白畫面 / 開不起來：缺 WebView2 Runtime，到 Microsoft 裝 Evergreen 版。