SuperAPI AI 工具集

macpilot-window-manager

办公与效率

查看项目

更新于 10-15 11:17

技能介绍

MacPilot Window Manager 是一个用于控制 macOS 应用程序窗口的技能,基于 macpilot 命令行工具实现。它可以帮助用户列出、移动、缩放、吸附、最小化、全屏以及跨 Spaces 和显示器管理窗口。

用途

当需要整理或组织应用程序窗口、将窗口移动或缩放到指定位置、把窗口吸附到屏幕半屏或角落、查看当前打开的窗口列表、聚焦或前置某个窗口、跨多个 Spaces/桌面管理窗口,以及保存和恢复窗口布局时,可以使用该技能。

主要能力

窗口操作命令包括:

  • 列出窗口:macpilot window list --json(所有可见窗口)、macpilot window list --app "Safari" --json(指定应用窗口)、macpilot window list --all-spaces --json(包含所有 Spaces)。
  • 聚焦窗口:macpilot window focus "Safari" --json(聚焦应用主窗口)、macpilot window focus "Safari" --title "GitHub" --json(按标题子串聚焦)。
  • 新建窗口:macpilot window new "Safari" --json。
  • 移动窗口:macpilot window move "Safari" 100 50 --json(移动到 x=100, y=50)。
  • 缩放窗口:macpilot window resize "Safari" 1200 800 --json(设置宽 1200、高 800)。
  • 关闭窗口:macpilot window close --app "Safari" --json(关闭最前窗口)。
  • 最小化/全屏:macpilot window minimize "Safari" --json、macpilot window fullscreen "Safari" --json。
  • 吸附到位置:macpilot window snap "Safari" left --json(左半屏)、right(右半屏)、top-left(左上四分之一)、top-right(右上四分之一)、bottom-left(左下四分之一)、bottom-right(右下四分之一)、center(屏幕居中)、maximize(填满整个屏幕)。
  • 保存/恢复布局:macpilot window restore --save --json(保存所有窗口位置)、macpilot window restore --json(恢复已保存位置)、macpilot window restore --save --app "Safari"(仅保存指定应用)。
  • Spaces/桌面:macpilot space list --json(列出所有 Spaces)、macpilot space switch left --json、macpilot space switch right --json、macpilot space switch 2 --json、macpilot space bring --app "Slack" --json(将应用带到当前 Space)。

使用方式

该技能通过 macpilot 命令行工具调用,各命令均支持 --json 输出。常见工作流模式包括:

  • 并排布局:macpilot window snap "Safari" left 与 macpilot window snap "VS Code" right。
  • 四分屏布局(4 个应用):分别吸附到 top-left、top-right、bottom-left、bottom-right。
  • 演示设置:macpilot window snap "Keynote" maximize 或 macpilot window fullscreen "Keynote"。
  • 开发环境布局:编辑器左侧 60%、终端右侧 40%,通过 move 与 resize 组合实现。
  • 收集所有窗口:使用 macpilot space bring --app "..." 将分散窗口带回当前 Space。
  • 保存与恢复工作区:会议前 macpilot window restore --save,会议后 macpilot window restore。

适用场景

适用于需要快速整理窗口、搭建并排或四分屏布局、准备演示环境、恢复工作区、跨多显示器与 Spaces 管理窗口的 macOS 用户。

限制与提示

  • 建议在重新排列前使用 window list --json 查看当前窗口位置和尺寸。
  • snap 命令使用窗口当前所在的显示器。
  • 当存在多个窗口时,优先使用 window focus 而非应用聚焦。
  • 可使用 display-info --json 获取屏幕尺寸以进行精确定位。
  • 坐标以左上角为原点(0,0 为主显示器左上角)。
  • 在多显示器设置中,副显示器可能具有负 x 坐标(位于主显示器左侧)或 x 大于主显示器宽度(位于右侧)。

关于该技能的收费、价格、平台支持范围等更多信息,资料中暂未提供。