重塑macOS窗口工作流滑动式平铺窗口管理器Paneru完全入门指南【免费下载链接】paneruA sliding, tiling window manager for MacOS.项目地址: https://gitcode.com/gh_mirrors/pan/paneru还在被 macOS 上杂乱堆叠的窗口困扰吗Paneru是一款面向 macOS 的滑动式平铺窗口管理器它把所有窗口排列在一条无限向右延伸的窗口带上新窗口打开时永远不会挤压或重排已有窗口让布局始终保持稳定。本文将从安装、配置到进阶玩法带你用最短时间上手这款由 Rust 编写的开源窗口管理器。 核心亮点为什么选择 Paneru特性说明 滑动窗口带窗口排在横向无限轨道上触控板滑动即可浏览 布局零扰动打开新窗口不会导致其他窗口缩放重排️ 多屏独立每块显示器拥有独立的窗口带窗口不会溢出到隔壁屏幕 虚拟工作区在单个 macOS 桌面内纵向堆叠多条窗口行按任务分组️ 焦点跟随鼠标省去多余点击键盘/触控板双通道操作 会话恢复重启后自动恢复窗口布局、虚拟工作区与显示器分配 菜单栏指示器在菜单栏实时显示当前虚拟工作区️ 一键复制窗口规则免去手动猜测应用的 bundle idPaneru 的设计灵感来自 Niri 与 PaperWM 的可滚动平铺体验窗口管理底层技术则参考了同为 macOS 窗口管理器的 Yabai。⚡ 快速安装 Paneru4 种方式任选方式一Homebrew 一键安装推荐brew install paneru方式二Cargo 从 crates.io 安装cargo install paneru方式三从源码构建安装git clone https://gitcode.com/gh_mirrors/pan/paneru cd paneru cargo build --release cargo install --path .默认构建会内嵌从源码编译的 LuaJIT无需系统预装 Lua。方式四Nix Flake如果你使用 nix-darwin 或 Home Manager可声明式地管理 Paneru 及其 launchd 服务详见 nix/README.md。✅ 首次运行前的 3 项系统设置必看授权辅助功能权限 首次运行时 macOS 会弹出授权对话框若被拒绝请到系统设置 → 隐私与安全性 → 辅助功能中手动勾选 Paneru。没有此权限窗口无法被移动。开启显示器具有独立空间在系统设置的显示器选项中启用 Displays have separate spaces这样 Paneru 才能独立管理每个桌面的窗口带。多显示器请上下摆放️ Paneru 通过将窗口移出屏幕来隐藏它们。若外接屏在笔记本左侧或右侧macOS 可能把移出屏幕的窗口自动抢到另一块屏幕导致行为混乱。建议把附加显示器摆放在主屏上方或下方可用horizontal_mouse_warp选项让光标体验依旧像左右排列。小知识屏幕边缘那一条 5 像素宽的窗口窄条sliver不是设计失误而是为了规避 macOS 会把完全移出屏幕的窗口强制搬回屏幕的限制可通过sliver_width/sliver_height调整。⌨️ 快速上手核心快捷键清单安装后用paneru install paneru start注册并启动服务或用 Spotlight 启动 app launcher。以下是最小可用快捷键配置[options] focus_follows_mouse true # 焦点跟随鼠标 mouse_follows_focus true # 光标跟随焦点 [bindings] window_focus_west cmd - h # 焦点左移 window_focus_east cmd - l # 焦点右移 window_resize alt - r # 循环切换预设宽度 window_center alt - c # 当前窗口居中 quit ctrl alt - q # 退出日常操作速查操作说明cmd h/cmd l左右切换窗口焦点alt r循环切换预设列宽可放大到超过一屏横向滚动查看alt c把当前窗口滑回视野中央触控板滑动 /alt 滚轮像翻页一样横向滑动整条窗口带垂直三指手势在虚拟工作区行间切换全部命令与选项的权威参考见 CONFIGURATION.md快捷键解析实现位于 src/config.rs。 配置入门TOML 与 Lua 二选一Paneru 支持两种配置方式二者互斥有 Lua 脚本时 TOML 完全不再生效TOML查找顺序为~/.paneru→~/.paneru.toml→$XDG_CONFIG_HOME/paneru/paneru.tomlLua 脚本init.lua通过paneru.setup{...}声明全部配置还能用paneru.on挂接事件、用paneru.bind绑定自定义回调详见 SCRIPTING.md两个重要体验热重载保存配置文件即自动生效改快捷键无需重启️Copy Window Rule菜单栏一键把当前焦点窗口的[windows]规则模板含 bundle_id 与标题正则复制到剪贴板粘贴即用再也不用翻查应用的 bundle id。 进阶玩法命令行控制与状态订阅除了快捷键Paneru 暴露了完整的命令行接口任何可绑定热键的命令都能通过send-cmd远程发送# 把焦点右移一格 paneru send-cmd window focus east # 一键把整条窗口带的所有列对齐为当前窗口宽度 paneru send-cmd window balance # 查看结构化状态供状态栏、脚本集成 paneru query state --json paneru subscribe --json # 持续输出焦点/工作区/窗口变化事件典型场景启动即摆位工作流——open -a Safari paneru send-cmd window resize打开应用后立即调整它的宽度。完整的 JSON 字段契约见 QUERY_AND_SUBSCRIBE_FORMAT.md。另外两个值得了解的功能虚拟工作区实验性在单个桌面内纵向堆叠多条窗口行配合菜单栏指示器样式可自定义见 src/menubar.rs 与 src/overlay.rs管理工作 / 学习 / 个人上下文会话恢复窗口布局、虚拟工作区行、显示器分配都持久化到~/.local/state/paneru/state.json重启 Paneru 后自动还原相关逻辑在 src/ecs/restore.rs 与 src/ecs/state.rs。 延伸阅读了解 Paneru 的内部架构Paneru 基于Bevy ECS构建把世界建模为显示器、工作区、应用、窗口等实体 组件核心平铺算法列管理、坐标计算是纯函数位于 src/ecs/layout.rs焦点管理焦点跟随鼠标等在 src/ecs/focus.rs触控板滑动的惯性处理在 src/ecs/scroll.rs。三层架构总览Platform → Manager → ECS的完整图解见 ARCHITECTURE.md平台层src/platform/通过objc2与 Core Graphics 对接 macOS 事件循环管理层src/manager/定义 OS 无关的WindowApi等 trait桥接辅助功能与 SkyLight APIECS 层src/ecs/处理输入触发、布局计算与动画的大脑。 小结Paneru 用一条横向滑动的窗口带重新定义了 macOS 的窗口工作流打开新窗口不再打乱布局大屏幕上不必在巨大窗口与一堆碎窗口之间二选一小屏幕上也不必反复手动最大化。安装只要一行brew install paneru配合热重载的 TOML 配置和send-cmd命令行接口它足以成为你桌面效率工作流的稳定基座。现在就去试试滑动你的第一个窗口带吧【免费下载链接】paneruA sliding, tiling window manager for MacOS.项目地址: https://gitcode.com/gh_mirrors/pan/paneru创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考