用途：在 macOS 上动手安装、配置并调试 AeroSpace 平铺窗口管理器，适合需要设置 Homebrew 安装、创建或修复 ~/.aerospace.toml、配置窗口与工作区绑定、排查启动失败或快捷键异常的场景。核心原则是优先用已安装的 aerospace CLI 实测验证，而不是凭文档或记忆猜测。
安装与运行验证：用 command -v brew、brew list --cask nikitabobko/tap/aerospace、aerospace --version 检查。若版本显示 server version: Unknown，说明当前命令上下文无法连接应用服务，可尝试在沙箱外提权运行后再判断。启动用 open -a AeroSpace 或 open -b bobko.aerospace。若启动后立即退出，检查辅助功能权限，需手动在系统设置中启用 /Applications/AeroSpace.app。
配置：用 aerospace config --config-path 确认实际生效的配置路径，不要假设 ~/.aerospace.toml 已生效，必要时 aerospace reload-config。可从自带默认配置复制：cp /Applications/AeroSpace.app/Contents/Resources/default-config.toml ~/.aerospace.toml。用 aerospace config --get mode.main.binding --json 确认服务器看到的活动绑定。跨显示器移动建议用 move-workspace-to-monitor --wrap-around，仅当用户明确要单个窗口加入目标显示器当前可见工作区时才用 move-node-to-monitor。避免 alt-shift-方向键作全局绑定，避免与终端标签切换冲突的 ctrl-alt-上下；若快捷键会输入字符或选中文本，应改绑而非继续调试移动逻辑。
测试：优先用 aerospace trigger-binding --mode main <binding> 触发绑定，再用 list-monitors、list-windows --focused 对比前后状态，避免依赖物理按键。可直接执行 aerospace move-workspace-to-monitor --wrap-around down 测试。
应用启动快捷键：用 exec-and-forget open -a 启动或聚焦应用，例如 alt-g = 'exec-and-forget open -a Ghostty'。避免用 cmd-c、cmd-g。
Ghostty 原生标签：其原生标签在系统窗口 API 中表现为独立窗口，AeroSpace 无法可靠区分，建议改用独立工作区/窗口、Ghostty 分屏或 tmux。
排查：沙箱外运行 aerospace --version，用 ps -ax 确认进程，用 log show 查看日志。另有诊断脚本 scripts/aerospace_diagnose.sh。其他细节如具体平台版本要求、收费信息暂未提供。