个人 macOS 菜单栏工具箱 / Personal macOS menu bar toolkit
一个 app 装一堆个人需要的小功能。当前包含：远程连接自动熄屏、鼠标/触控板独立滚动方向控制、分屏（窗口吸附）、菜单栏图标管理、防止睡眠。
A single app for a grab-bag of small personal utilities. Currently: remote-connection auto screen-off, Mos-style independent scroll-direction control, MaxTo-style window tiling, a Bartender-style menu bar icon manager, and a Caffeine-style sleep guard.
- 当有人通过 RustDesk 或 macOS 屏幕共享（VNC）远程连接到你的 Mac 时，本地屏幕自动变黑，防止旁人看到远程操作内容
- 多显示器自动镜像：连接时自动将多个屏幕合并为一个，远程端只看到一个屏幕
- 连接前保存多显示器镜像状态，断开后按快照恢复；菜单提供手动恢复扩展显示器
- 自动切换分辨率：连接时切换到 1512×982 HiDPI，断开后恢复
- Dock 自动移到左侧并关闭自动隐藏，断开后恢复原始位置
- 远程连接断开后，屏幕自动恢复并锁屏
- 远程端画面不受影响，正常显示桌面
- 菜单栏显示当前状态（监控中 / 已熄屏 / 已停用）
- 菜单「远程连接自动熄屏」可整体开关此监控；停用时若正黑屏会立即恢复（不锁屏），选择自动持久化
- 支持 FileVault AuthRestart（免密重启）
- 鼠标和触控板独立反转滚动方向，互不影响
- 默认：鼠标反转（传统方向）、触控板保持系统设置（自然方向）
- 菜单栏可即时切换两个开关，状态自动持久化
- 需要授予「辅助功能」和「输入监控」权限
- 双击窗口标题栏：把窗口放大到它所在的布局格子（与窗口重叠面积最大的格子）；再次双击还原到吸附前位置
- ⌘ + 拖动标题栏：显示半透明网格浮层并高亮光标所在格，松手把窗口吸进该格
- 多显示器：每屏独立布局，格子基于
NSScreen.visibleFrame（自动排除菜单栏和 Dock） - 布局 = 递归二叉分割树；菜单「编辑分屏布局…」在每块真实屏幕盖一层半透明编辑面：点选格子、拖分隔线调比例、右键分割/合并，浮动工具条支持重置此屏/复制到所有屏/保存/取消，Esc 随时取消
- 配置按显示器 UUID 持久化到
~/Library/Application Support/Bento/config.json，重启/插拔显示器不丢布局 - 需要授予「辅助功能」权限（未授权时菜单栏图标变为警告标志）
- 菜单栏图标太多被刘海/系统挤掉时，可以选择哪些显示、哪些隐藏（隐藏 = 收进系统「«」溢出区，点 « 仍可临时查看和使用）
- 菜单「管理菜单栏图标…」弹出清单：勾选 = 显示，取消勾选 = 隐藏，即时生效并记住选择
- 拖动清单行即可调整图标在菜单栏里的左右顺序（上 = 菜单栏左），顺序持久保存
- 电池 / Wi-Fi / 用户切换等系统模块也在清单里，同样可隐藏、可排序；时钟与控制中心被系统固定，无法管理
- Bento 自己的图标作为一行参与排序，但不可隐藏
- 原理：直接改写 macOS 27 菜单栏（MenuBarAgent）的位置偏好字典，不用合成拖拽（唯一的合成事件是收起「»」展开条的一次坐标点击）；因此需要 macOS 27+
- 局限：macOS 27 没有强制隐藏的原语，菜单栏空间充裕时被隐藏的图标可能重新出现（拥挤时稳定）
- 需要授予「辅助功能」权限
- 永久防睡：勾选后一直保持唤醒，再点一次关闭
- 定时防睡 ▸：30 分钟 / 1 小时 / 2 小时 / 4 小时预设，点已勾选的那项即停止；菜单项会显示剩余时间
- 「防睡设置…」可设自定义分钟数（1–1440）、选择是否允许屏幕自行熄灭（只防系统睡眠）、设置低电量自动停止阈值
- 到期由系统 powerd 兜底释放，Bento 被强杀也不会把机器永久钉醒
- 状态不跨启动保存：重启后不会自动恢复防睡，避免静默耗电
- 无法阻止合盖睡眠（Apple Silicon 上没有不装内核扩展的做法），设置窗口里有说明
- 不需要任何额外权限
./build_app.sh
open Bento.app- 启动后菜单栏出现眼睛图标
- 首次启动会请求权限（用于滚动方向控制）。在「系统设置 → 隐私与安全性」里确认 Bento 已允许「辅助功能」和「输入监控」，然后退出 app 重开
- 开机自启已自动配置，无需操作
- 点击菜单栏图标可看状态、切换各功能开关、编辑分屏布局、管理菜单栏图标、退出
- macOS 14.0 (Sonoma) 或更高版本；菜单栏图标管理需要 macOS 27+
- 远程熄屏功能需要 RustDesk 或开启 macOS 屏幕共享
- Automatically blacks out the local screen when someone connects to your Mac via RustDesk or macOS Screen Sharing (VNC)
- Auto display mirroring: merges multiple monitors into one when connected
- Saves the pre-connection display mirroring state and restores it on disconnect; includes a manual restore action for extended displays
- Auto resolution switching: switches to 1512×982 HiDPI on connect, restores on disconnect
- Dock repositioning: moves Dock to the left and disables auto-hide on connect, restores on disconnect
- Restores the screen, multi-monitor layout, resolution, and Dock when the remote connection ends, then locks the screen
- The remote viewer's display is unaffected
- Menu bar icon shows current status (monitoring / screen off / disabled)
- "远程连接自动熄屏" menu toggle enables/disables the whole monitor; if the screen is black when you disable it, everything restores immediately (no lock); choice persists
- FileVault AuthRestart support (password-free reboot)
- Mouse and trackpad scroll directions can be reversed independently
- Defaults: mouse reversed (traditional direction), trackpad untouched (natural direction)
- Toggle either from the menu bar — changes apply instantly and persist
- Requires Accessibility and Input Monitoring permissions
- Double-click a window titlebar: snaps the window into its layout cell (the cell with the largest overlap); double-click again to restore its previous position
- ⌘ + drag titlebar: shows a translucent grid overlay with the hovered cell highlighted; release to snap into it
- Multi-monitor: each display has its own layout based on
NSScreen.visibleFrame(menu bar and Dock excluded) - Layout = recursive binary-split tree; "编辑分屏布局…" opens a WYSIWYG full-screen editor overlay on every real display: click to select cells, drag dividers, right-click to split/merge, floating toolbar with reset/copy-to-all/save/cancel, Esc cancels anytime
- Config persists per display UUID in
~/Library/Application Support/Bento/config.json— survives reboots and display replugging - Requires Accessibility permission (the menu bar icon shows a warning badge while missing)
- When menu bar icons overflow (notch), choose which icons stay visible and which get hidden (hidden = tucked into the system "«" overflow section — click « to peek at and use them anytime)
- "管理菜单栏图标…" opens a checklist: checked = show, unchecked = hide — applies instantly and persists
- Drag rows to reorder icons in the menu bar (top = leftmost); order persists
- Movable system modules (Battery / Wi-Fi / User Switching) are listed and manageable too; Clock and Control Center are pinned by the system
- Bento's own icon appears as a row for ordering but cannot be hidden
- Works by rewriting the macOS 27 menu bar (MenuBarAgent) position-preference dict — no synthetic drags (the only synthetic event is a single click to collapse the expanded « strip); therefore requires macOS 27+
- Limitation: macOS 27 has no forced-hide primitive, so hidden icons can reappear when the bar has plenty of free space (stable on a crowded bar)
- Requires Accessibility permission
- 永久防睡 (keep awake indefinitely): check to hold the Mac awake, click again to stop
- 定时防睡 ▸ (timed): 30 min / 1 h / 2 h / 4 h presets; clicking the checked one stops it, and the menu row shows the time remaining
- "防睡设置…" sets a custom duration (1–1440 min), whether the display may still sleep (system-sleep only), and a low-battery auto-stop threshold
- The hard deadline is enforced by powerd, so even a killed Bento can't pin the machine awake forever
- State is not persisted across launches — a relaunch never silently restores keep-awake and drains the battery
- Cannot prevent clamshell sleep (no kext-free mechanism exists on Apple Silicon); the settings window says so
- Requires no extra permissions
./build_app.sh
open Bento.app- An eye icon appears in the menu bar
- On first launch you'll be prompted for permissions used by the scroll reverser. Confirm Bento is allowed under System Settings → Privacy & Security → Accessibility and Input Monitoring, then quit and relaunch the app
- Launch-at-login is configured automatically
- Click the menu bar icon to see status, toggle features, edit tiling layouts, manage menu bar icons, or quit
- macOS 14.0 (Sonoma) or later; the menu bar icon manager requires macOS 27+
- Remote screen-off feature requires RustDesk or macOS Screen Sharing