Pelmet核心设计哲学:为什么『集合而非位置』是菜单栏管理的终极答案?一次删除2345行代码的重构

原创2026-10-24 12:00:441,678 阅读

Pelmet核心设计哲学:为什么『集合而非位置』是菜单栏管理的终极答案?一次删除2345行代码的重构

Pelmet 是一款面向 macOS 27 的菜单栏图标管理工具,核心功能是"把你不需要的图标藏起来,需要时再唤出"。它的 0.3.0 版本做了一次大胆的核心重构:彻底放弃"按位置管理图标",改为"按集合管理图标"——一次删除 2,345 行代码,却让悬停唤出从几百毫秒提速到几十毫秒。本文带你读懂这套设计哲学,以及它对任何做系统级 UI 管理的开发者都有借鉴价值。

重构前的痛点:为什么"位置管理"是个坑

在 0.2.x 时代,Pelmet 为了让图标"整齐分组",采用了一个物理策略:把每个图标钉在编辑器里画好的槽位上。这意味着:

  • 每次隐藏、唤出、新应用启动、重启、菜单栏溢出,都可能触发一次模拟 ⌘-拖拽(synthetic ⌘-drag walk)把图标"拖回去";
  • 模拟拖拽要和 macOS 原生的 « 溢出箭头抢位置,和其他菜单栏管理器抢位置,甚至会和用户自己的点击打架;
  • 为了掩盖模拟拖拽的视觉痕迹,还需要屏幕录制权限、封面遮罩窗口(cover)和"完成图"生命周期等一大堆配套机制。

设计者用实测数据验证了三件关键事实,才敢动刀(见 docs/CORE-SETS.md):

  1. 系统的"图标位置表"对存活的图标其实是死数据——写入的位置值在隐藏/恢复时会被直接忽略;
  2. 只有真实的 HID ⌘-拖拽才能触发系统的拖拽会话,模拟事件投递根本不会重排图标;
  3. 屏幕录制权限无法靠更好的抓取机制绕开,只能靠功能降级变可选。

💡 结论:位置对"隐藏"这件事从来就不重要,它只为"分组外观"服务。既然如此,就把分组从核心逻辑里拆出去,变成一个可开关的显式策略。

什么是『集合而非位置』:5 条设计原则

重构后的核心(sets core)只有四条铁律,全部写在 docs/CORE-SETS.md 里:

  1. 成员关系才是产品:一个图标只有三种状态——Visible(常显)、Hidden(悬停/点击唤出)、Always Hidden(需要时才显示)。改变成员关系永远不移动图标;
  2. 菜单栏的物理顺序是唯一的真相:Pelmet 只读取它,绝不存储。存下来的只有成员关系 + 待应用的编辑;
  3. 模拟拖拽只发生在一处:用户按下 Apply 按钮时,绝不在后台、悬停、唤出、启动等场景发生;
  4. 自己的图标走同一扇门:媒体控制、AirDrop、计时器等自建图标和用户图标一样,只由 Apply 移动;
  5. 没有为拖拽准备的遮罩:因为根本没有后台拖拽了。

对应到代码模型(纯 Swift 包,125 个单测),就变成四个类型:

类型 职责 源码
Roster 三个成员集合,按规范化 sectionKey 索引 Roster.swift
RosterRule 没见过的新图标的默认归属(新应用默认隐藏、系统宿主不可管理等) MenuBarPolicy.swift
OrderEdits 编辑器里尚未应用的排序变更,退出也不丢失 SectionModel.swift
MovePlan 纯函数:(菜单栏实际顺序, OrderEdits) -> <a href="https://link.gitcode.com/i/507d9673defb99b8179f2d1f1c2eee34" target="_blank">Move],最小移动次数 [MovePlan.swift

设置界面里"新图标去哪里"的三个分段选择,正是这套集合模型的用户视角:

Pelmet菜单栏图标管理的三个集合:Visible、Hidden、Always Hidden

一次删除 2345 行的重构清单:删掉了什么

M3 里程碑的核心是"生存/删除地图"(Survive / Delete map),净结果:删 2,345 行、加 147 行,涉及 20 个文件,且没有任何功能回退开关(见 docs/ARCHITECTURE-REVIEW.md 第 3.1 节)。被删除的重灾区:

文件 行数 命运
App/PlacementController.swift 932 行 ❌ 删除,ApplyPass(324 行)成为唯一移动者
App/OverflowChevron.swift 207 行 ❌ 删除,« 箭头再也不被程序点击
Core/PlacementLedger.swift + OrderDrift.swift 251 行 + 测试 ❌ 删除,"弹跳预算"缩成 3 行
Engine/AgentPrefsWatcher.swift — ❌ 删除,用户拖拽改由带区监听器接管
App/AppState.swift 瘦身 丢掉布局队列、漂移修正、救援、溢出闸门等分支

Pelmet内置自建设施(Pelmet items):媒体控制、摄像头/麦克风指示器等,和用户图标一样参与集合管理

值得强调的是 BarAdoption.swift 差点被删却留了下来:它的 reconcile 函数正是"用户自己 ⌘-拖拽后,从菜单栏读回新成员关系"的幸存逻辑——Pelmet 永不主动移动图标,只记录用户移动的结果。

重构后的用户体验变化:0.3.0 得到了什么

这次重构在 docs/release-notes/v0.3.0.md 里兑现成了可感知的变化:

  • 编辑器变成了"图纸":重新排序、跨集合拖动、添加分隔符——按 Apply 之前菜单栏上什么都不会动。Apply 一次性布局整条栏(光标隐藏片刻),并在按钮旁逐项报告结果;
  • 唤出快了一个量级:热路径的 reveal/conceal 从几百毫秒稳定到几十毫秒,栏画面在悬停后的前几帧就能上屏;
  • 升级零破坏:0.2.x 存下的顺序如果和屏幕不一致,只会出现一次"待应用编辑"——Apply 复现旧布局,Discard 保持现状;
  • ⌘-拖拽变得精确:图标落在你放下的位置,跨箭头拖动即改变集合归属。

唤出方式(悬停延迟、快捷键 ⌥⌘,、动画风格 Instant/Smooth/Fade 等)全部保留在 General 设置页里,与集合模型完全解耦:

Pelmet菜单栏管理设置页:快捷键唤出隐藏图标、屏幕录制权限等选项

"保持分组":外观策略与核心解耦

老用户最怀念的"分组整块唤出"外观被降级为一个默认开启的策略开关(Keep sections grouped):它复用同一个 ApplyPass,只在"集合状态与物理栏不一致"时自动触发,且只移动物理侧与集合不符的图标,绝不重新排序。想彻底纯净?关掉开关,就等于"Apply 之外永不发生模拟拖拽"。策略可任意开关,无需数据迁移——这正是集合模型解耦的胜利。

给开发者的 3 条可迁移经验

  1. 先问"真相在谁手里":Pelmet 的教训是——系统位置表对活图标根本不生效,花大力气维护一份"存储副本"不如承认物理栏即真相,只读不存;
  2. 副作用只留一道门:模拟拖拽这种高风险副作用,从"多处隐式触发"收敛为"一个按钮显式触发",bug 类(与原生 UI 抢位置、和用户操作打架)随之消失;
  3. 删代码是最好的重构验收:2,345 行的删除量 + 125 个纯函数单测,比任何"优化了架构"的措辞都有说服力。相关纯逻辑集中在 Packages/PelmetCore,唯一移动器在 ApplyPass.swift,引擎侧收敛决策见 AgentBarEngine.swift,可自行深入阅读。

一句话总结:隐藏图标只需要集合,好看的外观只是策略。当设计把这两件事分开后,代码量、延迟和 bug 类同时塌缩——这大概就是"集合而非位置"成为菜单栏管理终极答案的原因。

登录后查看全文
dimble