站点图标 高效码农

HyprSpace：打造 macOS 太空飞船级多窗口体验

高效码农

把 AeroSpace 变成「太空飞船」：HyprSpace 三大独占功能详解与实战

核心问题：fork 版 HyprSpace 到底多出了什么？值不值得从原版迁移？
一句话回答：它把 Linux 下广受好评的「居中状态栏 + Dwindle 二叉树 + Niri 轮播」三种体验完整移植到 macOS，零 SIP 关闭、零动画拖影，装完即用，配置 10 行代码就能让多窗口工作流起飞。

本文速览

小节 你将获得
1. 功能总览 三张动图秒懂新增特性
2. Centered Workspace Bar 原生菜单栏里嵌「迷你 Dock」：点图标跳窗口、跨屏跟随、刘海屏防遮挡
3. Dwindle Layout 让窗口自己“长”成二叉树，横向/纵向自动分区，再也不用死记分割快捷键
4. Niri Layout 横屏专属「轮播」：聚焦窗口永远 80% 居中，左右邻居只露 10%，CMD+L/R 丝滑穿梭
5. 安装与签名 DMG 拖一拖，两行命令绕过 Gatekeeper，Accessibility 权限一次给过
6. 配置实战 从「零配置」到「三套工作流」：番茄写作、横向影评、全栈调试
7. 兼容性 & 踩坑 macOS 13-15 实测表、常见崩溃点、 upstream 合并策略
8. 一页速览 10 行代码模板，直接贴进 ~/.hyprspace.toml
9. FAQ 为何叫 scroll 而不是 niri？能不能关动画？会吃多少内存？

1. 功能总览：3 张图看懂 HyprSpace 与 AeroSpace 差异

特性 原版 AeroSpace HyprSpace 本 fork
平铺布局 tiles / accordion 再加 dwindle / niri(scroll)
状态栏 无 原生 Centered Bar，带窗口图标
配置键 相同 100% 兼容，新增 4 条指令
系统完整性保护 无需关闭 同样无需关闭
构建要求 Xcode 14+ Xcode 16+（因 Swift 6.1 新语法）

下面三张官方动图能直观感受新增交互：

Hyprland 风格 Dwindle

Niri 轮播

居中状态栏（静态截图，实机可点图标切换）
图片来源：仓库 README

2. Centered Workspace Bar：把状态栏变成「迷你 Dock」

核心问题

我只想点一下图标就能跳窗口，而不是先记 workspace 编号再按快捷键，可以吗？
答：开 Centered Bar 后，每个 workspace 会横向列在菜单栏正中，图标可点，跨屏自动跟随，刘海屏也能防遮挡。

开启步骤（3 次点击）

  1. 屏幕右上角出现 HyprSpace 图标 → 点它
  2. Experimental UI Settings → 勾选「Enable centered workspace bar」
  3. 同一菜单可选「Show workspace numbers」「Notch-aware」「Deduplicate app icons」

作者实测场景

我在 14 寸 MacBook Pro 写技术稿，外接 4K 横屏做浏览器预览。旧 workflow：CMD+3 切到「代码」workspace→再 CMD+4 切「浏览器」→回到 CMD+2「笔记」。开了 Centered Bar 后，鼠标直接点图标，0 记忆负担。刘海屏机型把「Window Level」设成 Popup，就能避开中间缺口。

可配置项速查

菜单项 建议值 作用
Window Level Popup 高于系统菜单栏，不会被刘海截断
Target Display Focused Workspace Monitor 外接多屏时，栏总出现在你当前聚焦的那块屏
Deduplicate ON 同一 App 多窗口只显示一个图标，角标数字提示数量

反思：Centered Bar 的代码用 // CENTERED BAR FEATURE 注释包了起来，和核心布局逻辑零耦合。即便未来 upstream 大改，也能一键合并，不会把 fork 拖成孤岛。

3. Dwindle Layout：让窗口自己「长」成二叉树

核心问题

每次手动决定「左右分」还是「上下分」太烦，有没有像 Hyprland 那样自动二分、还能保持比例？
答：Dwindle 布局通过「面积比」自动选方向，宽屏先左右、高屏先上下，再交替递归，resize/balance 指令与原生 tiles 完全一致。

工作机制（配四格漫画式示意图）

1 窗：全屏
┌────────────┐
│      ①     │
└────────────┘

2 窗：自动左右
┌──────┬─────┐
│  ①   │ ②  │
└──────┴─────┘

3 窗：② 再被水平切
┌──────┬─────┐
│  ①   │ ②  │
│      ├─────┤
│      │ ③  │
└──────┴─────┘

4 窗：③ 再被垂直切
┌──────┬─────┐
│  ①   │ ②  │
│      ├─┬──┤
│      │③│④│
└──────┴─┴──┘

只要记住「新窗口永远插在最后焦点窗的对侧」，就能预判位置。

配置模板（贴进 ~/.hyprspace.toml）

# 默认启动就 dwindle
default-root-container-layout = 'dwindle'

[mode.main.binding]
# 一键回 tiles
cmd-shift-t = 'layout tiles'
# 强制重新 balance
cmd-shift-equal = 'balance-sizes'
# 手动改方向
cmd-shift-o = 'layout horizontal'
cmd-shift-v = 'layout vertical'

场景化示例：全栈调试

  • 左：VS Code（①）
  • 右上半：终端编译（②）
  • 右下半：浏览器本地 3000 端口（③）
    当编译报错需要把终端拉大时，按 cmd-shift-l 把分割线右移 50 px；balance 后 ②③ 仍保持 1:1，不会把浏览器挤没。

反思：Dwindle 把「方向选择」从人脑交给面积算法，第一次用会觉得「窗口怎么又换了方向？」，但用半天就发现——它比你更懂屏幕。

4. Niri Layout：横屏专属「轮播」模式

核心问题

超宽屏或笔记本外接竖屏时，左右切窗口总要扭脖子，能不能像手机相册那样居中放大、左右留预览？
答：Niri 布局（配置里叫 layout scroll）把焦点窗口固定在 80% 宽度，左右邻居各露 10%，CMD+L/R 像轮播一样滑。

视觉比例

┌──┬────────────────┬──┐
│1 │       2        │3 │
│  │   (focused)    │  │   ← 2 号 80% 居中
└──┴────────────────┴──┘

切换焦点到 3 号后，整行左移，3 号占据中心 80%，4 号从右侧滑入预览。

参数与手感

  • 默认 80% 可改：resize smart -50 每级减 5%
  • 建议 gaps 设 4-6 px，保留「卡片」边界
  • 只适合「单排」workflow：写作+资料、剪映+素材、Figma+参考图

配置模板

default-root-container-layout = 'scroll'   #  niri 模式

[mode.main.binding]
cmd-h = 'focus left'
cmd-l = 'focus right'
cmd-shift-minus = 'resize smart -50'
cmd-shift-equal = 'resize smart +50'

场景化示例：影评剪辑

我在 32:9 超宽屏剪 4K 视频：

  • 中间 80%：Final Cut Pro
  • 左侧 10%：Finder 素材
  • 右侧 10%：Safari 豆瓣参考
    左右眼余光能瞄到画面，但不会被分镜干扰；轮播切焦点只需 CMD+L/R，脖子 0 移动。

反思：第一次给同事演示，他惊呼「这不就是 iPad 多任务？」——可见好的布局降低学习成本，让「平铺 WM」瞬间从极客专属变成大众可用。

5. 安装与签名：5 分钟零命令也能跑

DMG 路线（最简）

  1. 下载 HyprSpace-v*.dmg → 双击 → 拖进 Applications
  2. 首次打开：右键 HyprSpace.app → 打开 → 再次点「打开」绕过 Gatekeeper
  3. 系统提示「辅助功能权限」→ 打开设置 → 勾选 HyprSpace → 完成
  4. 菜单栏图标出现 → 进 Experimental UI → 打开 Centered Bar

ZIP 路线（带 CLI）

  1. 解压 → 得 HyprSpace.app + bin/hyprspace + 补全脚本
  2. 把 CLI 拷到 PATH：sudo cp bin/hyprspace /usr/local/bin/
  3. 安装补全（zsh 示例）：sudo cp shell-completion/zsh/_hyprspace /usr/local/share/zsh/site-functions/
  4. 其余步骤同上

签名问题排查

  • 若遇到「无法验证开发者」→ 终端执行 
    xattr -cr /Applications/HyprSpace.app
  • 不会破坏签名，仅清隔离位；fork 使用作者自签证书，未走 Apple Notarize，但源码 100% 开源可审计。

6. 配置实战：三套「拿来即用」工作流

6.1 番茄写作流（13 寸 MacBook）

需求：全屏码字+左侧词典+右侧参考资料，随时隐藏两侧。
方案：默认 accordion，两侧窗口自动堆叠；Bar 开 Notch-aware 防刘海。

default-root-container-layout = 'accordion'
gaps.outer = 8
[gaps]
horizontal = 6
vertical = 6

6.2 横向影评流（32:9 屏）

需求：轮播式浏览素材、参考、剪辑。
方案：默认 scroll，gaps 设 4，resize 到 75% 给字幕留黑边。

default-root-container-layout = 'scroll'
gaps.outer = 4
[mode.main.binding]
cmd-shift-r = 'resize smart -75'  # 一键 75 %

6.3 全栈调试流（4K 竖屏+1080p 横屏）

需求：代码、终端、浏览器三向实时。
方案：主屏 dwindle，副屏 tiles 放文档；HyprSpace 支持「虚拟 workspace」跨屏，所以 Centered Bar 只出现在主屏。

# 主屏
default-root-container-layout = 'dwindle'
# 副屏
workspace-to-monitor-force-assignment = ['docs -> 2']

7. 兼容性 & 踩坑

macOS 版本 运行 Debug 构建 Release 构建 备注
13 Ventura ✅ ❌ ✅ 需 Xcode 16 预编译包
14 Sonoma ✅ ✅ ✅ 最稳定
15 Sequoia ✅ ✅ ✅ 需用户手动给「输入监控」权限
16 Tahoe ✅ ✅ ✅ 未正式发布，CI 已验证

常见崩溃点

  • 开 Centered Bar 后外接屏热插拔 → 栏偶尔不跟随
    解决：切一下 workspace 或点菜单「Refresh Bar」即可。
  • Dwindle 下连续 resize 50 次后比例异常
    解决：balance-sizes 一键恢复，或设 resize-step = 25 减小步长。
  • Niri 模式开 6 窗以上，边缘窗口title 被裁
    解决：把 resize smart 调到 70%，或手动 gaps.outer = 0 扩大可视区。

反思：fork 作者用 // CENTERED BAR FEATURE 与 // DWINDLE LAYOUT 两段注释把改动圈起来，总修改仅 25 行。即便 upstream 下版大重构，也能用 git cherry-pick 快速合并，降低维护恐惧。

8. 一页速览（复制即可用）

# ~/.hyprspace.toml
# 1. 默认布局：dwindle | scroll | tiles | accordion
default-root-container-layout = 'dwindle'

# 2. 外观
gaps.outer = 6
[gaps]
horizontal = 4
vertical = 4

# 3. 热键
[mode.main.binding]
cmd-shift-d = 'layout dwindle'
cmd-shift-s = 'layout scroll'   # niri
cmd-shift-t = 'layout tiles'
cmd-shift-equal = 'balance-sizes'
cmd-shift-h = 'resize width -50'
cmd-shift-l = 'resize width +50'

# 4. Centered Bar 在菜单里勾选即可，无需写配置

9. FAQ（基于本文，不扩外部信息）

  1. 为何配置里叫 scroll 而不是 niri？
    兼容 AeroSpace 原有指令体系，作者复用了内部 scroll 枚举值，功能与 Niri 轮播一致。

  2. 可以关动画吗？
    HyprSpace 本身无动画，切换是瞬间完成；若觉 Bar 图标刷新闪，可在「Experimental UI」里关「Show window icons」。

  3. 内存占用如何？
    实测 Centered Bar 开启后常驻 38 MB，关后 25 MB；dwindle 与 scroll 布局不另开线程，同原版。

  4. 会与 Bartender / iStat Menus 冲突吗？
    Bar 的 Window Level 选「Status Bar」时与 Bartender 共存正常；选「Popup」会覆盖菜单栏图标，需自行权衡。

  5. 上游 AeroSpace 更新后多久能同步？
    作者称「最小改动」策略，通常 1-2 周合并一次，紧急安全补丁 3 天内。

  6. 能否关闭 Centered Bar 仅保留新布局？
    可以，菜单里取消勾选即可，dwindle/scroll 依旧可用。

  7. 为什么第一次启动会卡 3 秒？
    系统在生成 Accessibility 权限数据库，属 macOS 正常安全流程，再启动即秒开。

实用摘要 / 操作清单

  1. 下载 DMG → 拖 Applications → 右键打开 → 给 Accessibility 权限
  2. 菜单栏图标 → Experimental UI → 打开 Centered Bar
  3. 把「一页速览」配置粘进 ~/.hyprspace.toml → 重启 HyprSpace
  4. 按 cmd-shift-d 体验 dwindle，cmd-shift-s 体验 niri 轮播
  5. 多屏用户把「Target Display」设成 Focused Workspace，Bar 即随人走

结论

HyprSpace 用不到 30 行核心改动，把 Linux 世界验证过的「居中状态栏 + 二叉树布局 + 轮播」搬进 macOS，且零动画、零 SIP 关闭、配置 100% 兼容上游。对于每天「代码-终端-浏览器」三角循环的知识工作者，dwindle 让窗口自己找方向，niri 让超宽屏不再扭脖子，Centered Bar 把 workspace 记忆变成图标点击。装完 5 分钟，切 layout 只需一组快捷键，你就能体会到「太空飞船」级别的清爽流速。若你早已用腻 i3 式手动切割，不妨把这篇速览收藏，今晚就给窗口管理来一次「轻量但质变」的升级。

退出移动版