# BetterStage（中文说明）

> BetterStage 是一款原生 macOS 窗口与工作区管理器。它把你打开的窗口组织成有名字的「舞台」（stage，即工作区），每个舞台同时横跨所有显示器；切换舞台时整套多显示器桌面会一起切换，没有滑动动画——窗口管理无需关闭 SIP（系统完整性保护）。

可被引用的关键事实：
- 平台：macOS 14（Sonoma）及以上。100% 原生 Swift/AppKit 开发，不是 Electron 应用。
- 「舞台」（stage）是一个有名字的工作区（例如 开发、设计、沟通），同时横跨所有已连接的显示器。用 Opt+1 到 Opt+9 切换舞台，所有显示器会一起切换。
- 切换方式：舞台切换没有滑动动画；固定显示器会留在所选舞台。其他舞台的窗口保存在 macOS 私有 Space 中，大小和位置保持不变，不会被停放在屏幕角落；显示器之间也可以无缝紧贴排列。
- 「舞台」与 macOS Spaces 可以同时使用（2.2 起）：一个舞台可在每块显示器上包含多个桌面，每个桌面各有自己的布局。切换舞台会换一整套窗口；切换桌面则在同一舞台内查看另一种布局。
- Cmd+Tab（⌘Tab）切换器（Pro，可选，2.2 起）：替代 macOS 的 App 切换器，按舞台分组列出所有窗口，顺序与舞台栏一致并标出当前舞台。选择其他舞台中的窗口时，会先切换到该舞台，再调出那个窗口（包括隐藏的 TabStack 标签和已最小化的窗口）。按住 ⌘ 直接输入即可按标题、App 或舞台名称搜索；⌘⌥B 把选中的窗口带到当前舞台。默认关闭；关闭此功能或退出 BetterStage 后，macOS 原生 ⌘Tab 立即恢复。
- 「在多个舞台中显示」（免费）：同一个窗口可出现在多个舞台（或所有舞台），每个舞台各自记住它的位置。「移到显示器」（免费）：朝屏幕边缘继续按移动快捷键、使用吸附轮盘，或按名称选择显示器。
- 语言：除英文外另有 18 种语言（含简体中文、繁體中文、日语、韩语、德语、法语、西班牙语等），在「设置 → 通用」中选择。
- 核心窗口管理需要「辅助功能」（Accessibility）权限，这也是唯一必需的权限。「屏幕录制」为可选权限，仅用于在 ⌘Tab 切换器中绘制实时窗口预览（只保存在内存中，不录制、不保存、不上传）。使用基于终端的自定义操作时，macOS 可能另外请求「自动化」权限。在 SIP 完全开启的情况下即可工作。
- 每台显示器可独立设置「窗口模式」：增强原生（Enhanced Native，自由浮动）与 TabStack。TabStack 把窗口自动平铺到可调整大小的分区，多余窗口以标签页叠放，并支持拆分、合并、交换以及「重新排成网格」。每台显示器、每个舞台都会记住各自的模式。
- AI 编排（AI Staging）：在面板里编辑 Recipe（输入 @ 可提及显示器、舞台、窗口或 App），点击 Arrange windows，预览方案后再 Apply。窗口只在 Apply 时移动；可用面板 Undo 或 ⌘Z 撤销。自带 API Key，内置 25 个服务商预设（OpenAI、Claude、Gemini、DeepSeek、Qwen 通义千问、Kimi、GLM 智谱），也支持 Ollama、LM Studio 等本地服务。BetterStage AI 是托管选项，无需填写密钥。
- 16 个吸附区（snap zones）和一个可自定义的环形「吸附轮盘」（Snap Wheel），用于快速布局。其中 Center 可通过 Ctrl+Opt+C 把窗口放在屏幕正中，尺寸为屏幕宽高各一半。
- 「自定义操作（实验性）」（Custom Actions）可打开应用或文件、运行命令，或运行 Apple 快捷指令；可使用自定义 SF Symbol，并放入用户创建的吸附轮盘子菜单。
- 支持按标题匹配、按顺序执行的「App 路由」，可把窗口送往舞台或固定显示器；「Float App」规则可让指定 App 保持在受管理布局之外。
- 「设置备份」可导出并恢复偏好设置、App 例外、窗口规则、显示器偏好、App 路由、AI Recipe、吸附轮盘配置、已保存工作区快捷键和自定义 TabStack 布局。密钥、舞台、已保存工作区和自定义操作仍留在本机。保存/加载工作区快捷键可快速调用命名工作区快照。
- 价格：免费版（3 个舞台、窗口吸附、吸附轮盘、快捷键、多显示器支持，永久免费）。Pro 是一次性买断、非订阅：$19.99（1 台设备）、$39.99（3 台设备）、$49.99（5 台设备）。符合条件的 Mac 可开启 7 天 Pro 试用，无需信用卡；重新下载或更换账号不会重置已有试用。符合条件的免费用户每 24 小时还可体验 Pro 15 分钟。托管 AI 额度另计。
- 窗口恢复：正常退出 BetterStage 时会恢复受管理的窗口。如果意外中断后找不到窗口，请重新打开 BetterStage 并参阅故障排查文档。
- 当前稳定版：v2.2.0（2026 年 10 月 2 日）。2.2.0 改用 macOS 私有 Space 隐藏其他舞台的窗口，不再把窗口停放在屏幕角落；一个舞台可跨越每块显示器上的多个 macOS Space；新增可选的 Pro 版 ⌘Tab 切换器，按舞台列出窗口；同一个窗口可属于多个舞台；TabStack 标签可置于任意边缘并可选自动隐藏；新增“移到显示器”，可在显示器之间移动窗口；支持 18 种语言。当前平铺模式为 TabStack；Bento Box 仅作为「Bento Box（旧版）」保留。16 个吸附区（含 Center）。可调整 TabStack 标签高度、活动与非活动文字颜色和空分区关闭按钮；为指定的已保存工作区设置快捷键。可选 Clean Load 会先退出工作区以外的 App 并移除其他舞台，不会强制退出 App。加载工作区时，断开的显示器可选择新建舞台或合并到目标显示器。2.2 保存的舞台无法被更早的版本打开。
- 设备额度按许可证密钥独立计算。同一账号拥有多个密钥时，各密钥的设备上限不会叠加或合并。

## 与同类工具的区别（简述）
- 对比 macOS 台前调度（Stage Manager）：BetterStage 提供 9 个可命名、横跨所有显示器的舞台，键盘瞬间切换，没有占用屏幕的侧边栏。
- 对比 macOS Spaces（调度中心虚拟桌面）：无滑动动画切换；舞台可命名；每台显示器一起切换。
- 对比 Rectangle / Magnet / Moom：在窗口吸附之外，额外提供工作区管理、自动平铺与标签布局。
- 对比 yabai / Amethyst / AeroSpace：无需关闭 SIP、无需改配置文件，用原生图形界面配置；舞台切换没有 Spaces 滑动动画，同时也能与原生 macOS 桌面配合使用。
- 对比 AltTab：AltTab 是免费开源的专用窗口切换器（AltTab Pro 增加搜索等功能）；BetterStage 的 ⌘Tab 切换器属于工作区管理器的一部分，能识别窗口所在的舞台。

## 核心页面
- [官网首页](https://betterstage.app)
- [价格](https://betterstage.app/pricing)：免费版与一次性买断的 Pro 许可。
- [常见问题 FAQ](https://betterstage.app/faq)：权限、SIP、多显示器、价格、AI 编排、系统要求。
- [更新日志](https://betterstage.app/changelog)
- [Mac 最佳窗口管理器对比（2026）](https://betterstage.app/best-macos-window-manager)
- [完整对比列表](https://betterstage.app/compare)
- [BetterStage vs AltTab](https://betterstage.app/compare/alttab)
- [Mac 上按窗口切换的 ⌘Tab](https://betterstage.app/mac-cmd-tab-window-switcher)：对比 macOS ⌘Tab 与 ⌘`、调度中心、AltTab 和 BetterStage。

## How-to 短片字典
- [免费体验 Pro 15 分钟](https://betterstage.app/how-to/license/try-pro-for-15-minutes)：符合条件的 Mac 每 24 小时可开启一次 15 分钟 Pro 体验；与 7 天试用分开，不含付费 AI 额度。
- [选择单个窗口的布局行为](https://betterstage.app/how-to/window-modes/choose-window-behavior)：自动检测、加入布局、保持浮动，以及特殊窗口的匹配规则。
- [调整 TabStack 拖放区域](https://betterstage.app/how-to/window-modes/tabstack/adjust-drop-zones)：预览并调整分割区域，独立控制常规交换区域。
- [通过每日 Pro 体验试用 TabStack](https://betterstage.app/tutorials/try-tabstack-with-a-pro-preview)：在 15 分钟内体验窗格、标签和窗口行为。
一条动作一页；步骤以英文页面为准。TabStack 没有独立 /how-to/tabstack/ 入口。
- [How-to](https://betterstage.app/how-to): Short one-action pages. Video on top when published, the same steps underneath. Distinct from /docs (reference) and /tutorials (long guides).
- TabStack URLs are https://betterstage.app/how-to/window-modes/tabstack/<slug>. There is no /how-to/tabstack/ hub.
- [Getting started](https://betterstage.app/how-to/getting-started): Install, permissions, activate, and first-run choices.
- [How to install BetterStage](https://betterstage.app/how-to/getting-started/install): Getting started.
- [How to turn off macOS Stage Manager](https://betterstage.app/how-to/getting-started/turn-off-stage-manager): Getting started.
- [How to grant Accessibility permission](https://betterstage.app/how-to/getting-started/grant-accessibility): Getting started.
- [How to activate a Pro license](https://betterstage.app/how-to/getting-started/activate-a-license): Getting started.
- [How to pick Standard vs European shortcuts](https://betterstage.app/how-to/getting-started/keyboard-layout-preset): Getting started.
- [How to launch BetterStage at login](https://betterstage.app/how-to/getting-started/launch-at-login): Getting started.
- [Snap Wheel](https://betterstage.app/how-to/snap-wheel): Open the radial menu and place Custom Actions on it.
- [How to open, use, and customize the Snap Wheel](https://betterstage.app/how-to/snap-wheel/open-snap-wheel): Snap Wheel.
- [How to create a Custom Action](https://betterstage.app/how-to/snap-wheel/create-a-custom-action): Snap Wheel.
- [How to put Custom Actions in a Snap Wheel submenu](https://betterstage.app/how-to/snap-wheel/custom-action-submenu): Snap Wheel.
- [Stages](https://betterstage.app/how-to/stages): Create, switch, send windows, and use the Stages Bar.
- [How to reveal the Stages Bar](https://betterstage.app/how-to/stages/open-stages-bar): Opt+Up. Stages.
- [How to create or remove stages](https://betterstage.app/how-to/stages/create-or-remove-stages): Opt+N / Opt+X. Stages.
- [How to rename a stage](https://betterstage.app/how-to/stages/rename-a-stage): Stages.
- [How to reorder stages](https://betterstage.app/how-to/stages/reorder-stages): Stages.
- [How to merge all stages](https://betterstage.app/how-to/stages/merge-all-stages): Opt+M. Stages.
- [How to switch stages](https://betterstage.app/how-to/stages/switch-stages): Opt+1–9. Stages.
- [How to move a window between stages](https://betterstage.app/how-to/stages/send-window-to-stage): Opt+Shift+1–9. Stages.
- [How to follow after sending a window](https://betterstage.app/how-to/stages/auto-switch-stages): Stages.
- [How to keep Cmd+` inside the current stage](https://betterstage.app/how-to/stages/cmd-backtick-active-stage): Cmd+`. Stages.
- [How to turn on the BetterStage ⌘Tab Switcher](https://betterstage.app/how-to/stages/turn-on-command-tab-switcher): Cmd+Tab. Stages.
- [How to search all windows with ⌘Tab](https://betterstage.app/how-to/stages/search-windows-with-command-tab): Cmd+Tab, then type. Stages.
- [How to bring a window into the current Stage from ⌘Tab](https://betterstage.app/how-to/stages/bring-window-here-with-command-tab): Cmd+Opt+B. Stages.
- [How to show window previews in the ⌘Tab Switcher](https://betterstage.app/how-to/stages/command-tab-window-previews): Stages.
- [How to go back to the macOS ⌘Tab](https://betterstage.app/how-to/stages/turn-off-command-tab-switcher): Stages.
- [How to show one window in several Stages](https://betterstage.app/how-to/stages/show-window-in-several-stages): Stages.
- [How to use macOS Spaces inside a Stage](https://betterstage.app/how-to/stages/use-spaces-inside-a-stage): Stages.
- [How to exclude an app from staging](https://betterstage.app/how-to/stages/exclude-app-from-staging): Stages.
- [How to customize the Stages Bar](https://betterstage.app/how-to/stages/customize-stages-bar): Stages.
- [Window Modes](https://betterstage.app/how-to/window-modes): Switch mode, then TabStack, then snap windows, floats, and defaults.
- [TabStack how-tos](https://betterstage.app/how-to/window-modes/tabstack): TabStack is a Window Mode subdirectory, not a sibling hub.
- [How to use Window Modes / TabStack](https://betterstage.app/how-to/window-modes/switch-window-mode): Opt+B. Window Modes.
- [How to turn on TabStack](https://betterstage.app/how-to/window-modes/tabstack/turn-on-tabstack): Window Modes.
- [How to apply a layout preset](https://betterstage.app/how-to/window-modes/tabstack/apply-layout-preset): Window Modes.
- [How to set TabStack default layout and entry](https://betterstage.app/how-to/window-modes/tabstack/default-tabstack-layout): Window Modes.
- [How to split a pane by dropping on an edge](https://betterstage.app/how-to/window-modes/tabstack/split-pane-by-edge-drop): Window Modes.
- [How to split a pane from the ⋯ menu](https://betterstage.app/how-to/window-modes/tabstack/split-pane-from-menu): Window Modes.
- [How to split a tab from the tab menu](https://betterstage.app/how-to/window-modes/tabstack/split-tab-from-menu): Window Modes.
- [How to join windows as tabs](https://betterstage.app/how-to/window-modes/tabstack/join-windows-as-tabs): Window Modes.
- [How to swap two panes](https://betterstage.app/how-to/window-modes/tabstack/swap-two-panes): Window Modes.
- [How to insert a window on a divider](https://betterstage.app/how-to/window-modes/tabstack/insert-window-on-divider): Window Modes.
- [How to move a TabStack window to another display](https://betterstage.app/how-to/window-modes/tabstack/move-tabstack-window-across-displays): Window Modes.
- [How to fill an empty pane](https://betterstage.app/how-to/window-modes/tabstack/fill-empty-pane): Window Modes.
- [How to remove empty panes](https://betterstage.app/how-to/window-modes/tabstack/remove-empty-panes): Window Modes.
- [How to set TabStack pane behavior](https://betterstage.app/how-to/window-modes/tabstack/tabstack-pane-behavior): Window Modes.
- [How to switch tabs](https://betterstage.app/how-to/window-modes/tabstack/switch-tabs): Ctrl+Opt+] [. Window Modes.
- [How to reorder tabs](https://betterstage.app/how-to/window-modes/tabstack/reorder-tabs): Window Modes.
- [How to move one tab to another pane](https://betterstage.app/how-to/window-modes/tabstack/move-one-tab): Window Modes.
- [How to move a whole tab stack](https://betterstage.app/how-to/window-modes/tabstack/move-tab-stack): Window Modes.
- [How to close tabs](https://betterstage.app/how-to/window-modes/tabstack/close-tabs): Window Modes.
- [How to drop a file onto a background tab](https://betterstage.app/how-to/window-modes/tabstack/drop-file-on-background-tab): Window Modes.
- [How Terminal and Ghostty native tabs work in TabStack](https://betterstage.app/how-to/window-modes/tabstack/native-tabs-in-tabstack): Window Modes.
- [How to launch an app into a pane](https://betterstage.app/how-to/window-modes/tabstack/launch-app-into-pane): Window Modes.
- [How to quit or relaunch an app from a tab](https://betterstage.app/how-to/window-modes/tabstack/quit-or-relaunch-from-tab): Window Modes.
- [How to zoom and restore a pane](https://betterstage.app/how-to/window-modes/tabstack/zoom-and-restore-pane): Window Modes.
- [How to resize panes](https://betterstage.app/how-to/window-modes/tabstack/resize-panes): Window Modes.
- [How to even out TabStack panes](https://betterstage.app/how-to/window-modes/tabstack/retile-tabstack): Opt+Down. Window Modes.
- [How to reflow panes as a grid](https://betterstage.app/how-to/window-modes/tabstack/reflow-as-grid): Cmd+Opt+G. Window Modes.
- [How to undo a TabStack layout change](https://betterstage.app/how-to/window-modes/tabstack/undo-tabstack-layout): Window Modes.
- [How to bring hidden floating windows in front of TabStack](https://betterstage.app/how-to/window-modes/tabstack/raise-floats): Window Modes.
- [How to focus the neighboring pane](https://betterstage.app/how-to/window-modes/tabstack/focus-neighboring-pane): Cmd+Opt+I J K L. Window Modes.
- [How to move a window to the neighboring pane](https://betterstage.app/how-to/window-modes/tabstack/move-window-neighboring-pane): Cmd+Opt+Shift+I J K L. Window Modes.
- [How to save the current layout as a preset](https://betterstage.app/how-to/window-modes/tabstack/save-current-layout): Window Modes.
- [How to create and edit a layout preset](https://betterstage.app/how-to/window-modes/tabstack/create-and-edit-layout-preset): Window Modes.
- [How to delete a custom layout preset](https://betterstage.app/how-to/window-modes/tabstack/delete-layout-preset): Window Modes.
- [How to choose where new windows open in TabStack](https://betterstage.app/how-to/window-modes/tabstack/new-window-placement): Window Modes.
- [How to customize TabStack appearance](https://betterstage.app/how-to/window-modes/tabstack/customize-tabstack-appearance): Window Modes.
- [How to put TabStack tabs on the side or bottom](https://betterstage.app/how-to/window-modes/tabstack/tab-bar-position): Window Modes.
- [How to auto-hide the TabStack tab bar](https://betterstage.app/how-to/window-modes/tabstack/auto-hide-tab-bar): Window Modes.
- [How to snap a window to a half, third, or center](https://betterstage.app/how-to/window-modes/snap-a-window): Ctrl+Opt+…. Window Modes.
- [How to tidy windows into a grid (Retile)](https://betterstage.app/how-to/window-modes/retile-and-restack): Opt+Down. Window Modes.
- [How to set the default Window Mode for new stages](https://betterstage.app/how-to/window-modes/default-window-mode): Window Modes.
- [How to use a different Window Mode per monitor](https://betterstage.app/how-to/window-modes/per-monitor-window-modes): Window Modes.
- [How to float an app](https://betterstage.app/how-to/window-modes/float-an-app): Window Modes.
- [How to float an app’s secondary windows](https://betterstage.app/how-to/window-modes/float-secondary-windows): Window Modes.
- [How to exclude an app from auto-tiling](https://betterstage.app/how-to/window-modes/exclude-app-from-auto-tiling): Window Modes.
- [How to show Bento Box (Legacy)](https://betterstage.app/how-to/window-modes/enable-bento-box-legacy): Window Modes.
- [Workspaces](https://betterstage.app/how-to/workspaces): Save, load, and restore the desk after quit.
- [How to save a Workspace](https://betterstage.app/how-to/workspaces/save-a-workspace): Workspaces.
- [How to load a Workspace](https://betterstage.app/how-to/workspaces/load-a-workspace): Workspaces.
- [How to rename or delete a Saved Workspace](https://betterstage.app/how-to/workspaces/manage-saved-workspaces): Workspaces.
- [How BetterStage restores your desk after quit](https://betterstage.app/how-to/workspaces/restore-after-quit): Workspaces.
- [Displays](https://betterstage.app/how-to/monitor-management): Pin a display and recover an unplugged monitor.
- [How to pin and unpin a display](https://betterstage.app/how-to/monitor-management/pin-a-display): Displays.
- [How to recover windows from an unplugged display](https://betterstage.app/how-to/monitor-management/recover-unplugged-display): Displays.
- [How to move a window to another display](https://betterstage.app/how-to/monitor-management/move-window-to-another-display): Displays.
- [How to set screen padding and gaps for one display](https://betterstage.app/how-to/monitor-management/per-display-spacing): Displays.
- [AI Staging](https://betterstage.app/how-to/ai-staging): Arrange windows, Recipes, and providers.
- [How to use AI Staging](https://betterstage.app/how-to/ai-staging/use-ai-staging): Opt+Z. AI Staging.
- [How to save an AI Recipe](https://betterstage.app/how-to/ai-staging/save-an-ai-recipe): AI Staging.
- [How to manage AI Recipes](https://betterstage.app/how-to/ai-staging/manage-ai-recipes): AI Staging.
- [How to choose an AI provider](https://betterstage.app/how-to/ai-staging/choose-ai-provider): AI Staging.
- [App Routing & Custom Actions](https://betterstage.app/how-to/app-routing-and-actions): Route new windows to a stage. Create Custom Actions on the Snap Wheel.
- [How to create an App Routing rule](https://betterstage.app/how-to/app-routing-and-actions/create-app-routing-rule): App Routing & Custom Actions.
- [Shortcuts & settings](https://betterstage.app/how-to/settings): Rebind controls, customize the menu bar, and back up settings.
- [How to customize shortcuts](https://betterstage.app/how-to/settings/customize-shortcuts): Shortcuts & settings.
- [How to customize the menu bar](https://betterstage.app/how-to/settings/customize-menu-bar): Shortcuts & settings.
- [How to back up and restore settings](https://betterstage.app/how-to/settings/settings-backup): Shortcuts & settings.
- [How to change BetterStage's language](https://betterstage.app/how-to/settings/change-language): Shortcuts & settings.
- [License & updates](https://betterstage.app/how-to/license): Move a license and choose an update channel.
- [How to move a license to another Mac](https://betterstage.app/how-to/license/move-license): License & updates.
- [How to update BetterStage](https://betterstage.app/how-to/license/update-betterstage): License & updates.
- [Troubleshooting](https://betterstage.app/how-to/troubleshooting): Find missing windows, fix permissions, and reset exceptions.
- [How to find windows that went off-screen](https://betterstage.app/how-to/troubleshooting/find-off-screen-windows): Troubleshooting.
- [How to fix Accessibility permission](https://betterstage.app/how-to/troubleshooting/fix-accessibility): Troubleshooting.
- [How to fix shortcuts that aren’t working](https://betterstage.app/how-to/troubleshooting/fix-shortcuts): Troubleshooting.
- [How to quit BetterStage and restore all windows](https://betterstage.app/how-to/troubleshooting/quit-and-restore): Troubleshooting.
- [How to reveal the diagnostic log](https://betterstage.app/how-to/troubleshooting/reveal-debug-log): Troubleshooting.
- [How to reset App Exceptions](https://betterstage.app/how-to/troubleshooting/reset-app-exceptions): Troubleshooting.

## 文档
- [快速上手](https://betterstage.app/docs/getting-started)
- [舞台 Stages](https://betterstage.app/docs/stages)：包括与 macOS Spaces 配合使用，以及在多个舞台中显示同一个窗口。
- [工作区与连续性](https://betterstage.app/docs/workspaces)
- [Cmd+Tab（⌘Tab）切换器](https://betterstage.app/docs/command-tab-switcher)：按舞台分组、搜索、⌘⌥B、窗口预览与屏幕录制权限。
- [窗口模式](https://betterstage.app/docs/window-modes)：增强原生与 TabStack，每台显示器可独立设置。
- [TabStack](https://betterstage.app/docs/tabstack)：自适应自动平铺与可定制分区，支持分区内标签页、上下文菜单和在分区中启动 App。
- [布局预设](https://betterstage.app/docs/layout-presets)：内置与自定义 TabStack 布局预设。
- [吸附区](https://betterstage.app/docs/snap-zones)：16 个吸附位置，包含 Center。
- [AI 编排](https://betterstage.app/docs/ai-staging)
- [自定义操作](https://betterstage.app/docs/custom-actions)：实验性的打开应用/文件、运行命令与快捷指令。
- [快捷键](https://betterstage.app/docs/keyboard-shortcuts)
- [多显示器管理](https://betterstage.app/docs/monitor-management)：移到显示器、按显示器设置间距、固定显示器，以及拔插显示器后的自动恢复。
- [设置备份](https://betterstage.app/docs/settings-backup)：导出并导入可移植的 BetterStage 设置。

English version: https://betterstage.app/llms.txt