桌面应用操作系统【免费下载链接】qtile:cookie: A full-featured, hackable tiling window manager written and configured in Python (X11 Wayland)项目地址https://gitcode.com/gh_mirrors/qt/qtile点击查看免费下载Groups 是 Qtile 中的工作区workspace概念每个被窗口管理器托管的客户端窗口都恰好属于某一个 group。与多数窗口管理器不同Qtile 中的 group 本身不负责窗口的定位与排布——那是布局layout的职责因此 group 对外暴露的命令范围相对有限但它在命令图command graph中同时持有对布局、窗口和屏幕的引用是打通三者关系的关键枢纽。本文以 Qtile 官方文档 docs/manual/commands/api/groups.rst 为骨架结合 libqtile/group.py 源码逐条剖析 group 对象对外暴露的全部命令并给出在键绑定lazy、命令行qtile cmd-obj与 Python 脚本InteractiveCommandClient三种接口下的具体调用方式帮助你彻底掌握 Qtile 工作区的控制能力。Group 在 Qtile 中的角色定位在 Qtile 的架构里group 是一堆窗口的容器类比其他窗口管理器中的 workspaces。理解 group 需要先厘清它与三个相邻概念的分工与布局的关系group不负责窗口的定位和排布那是布局layout对象的职责例如 libqtile/layout/tile.py、libqtile/layout/max.py 等。这也是为什么 group 暴露的命令范围较为有限——它不需要关心窗口怎么被平铺。与窗口的关系group 持有其内部的所有窗口源码中的self.windows列表并维护一个focus_history焦点历史用于记录窗口获得焦点的顺序。与屏幕的关系group 可以被显示在某块屏幕上self.screen通过set_screen在屏幕间迁移。官方文档用一句话概括了 group 的能力边界Groups have access to the layouts in that group, the windows in the group and the screen displaying the group.即 group 能访问三样东西组内的布局、组内的窗口、以及正在显示该组的屏幕。这三者的引用关系在命令图command graph中体现得十分直接。命令图中的 Group 节点Qtile 的整套远程控制机制建立在命令图command graph之上图中有八种节点——layouts、windows、groups、bars、widgets、screens、core和特殊的root节点。每条有向边都可以读作持有对……的引用。在 libqtile/command/graph.py 中group 节点被定义为class _GroupGraphNode(CommandGraphObject): object_type group children [layout, window, screen]这正对应了文档中group 能访问组内布局、组内窗口、显示该组的屏幕的表述。而其他节点也反向持有对 group 的引用例如_ScreenGraphNode.children中包含group因此命令图存在环graph is not a tree。借助这种连通性可以从 group 出发触达与其相关的任何对象。docs/manual/commands/api/groups.rst文档正是通过.. qtile_graph::与.. qtile_commands::两个 Sphinx 指令自动生成命令图与命令列表的前者以:root: group渲染该节点及其直接关联节点后者以:baseclass: libqtile.group._Group扫描类中所有被expose_command()装饰的方法。也就是说本文下面列出的每一条命令都是_Group类中带有expose_command装饰器的真实 API它们全部可以通过任意接口调用。通过三种接口访问 Group 命令所有命令均注册在命令图中因此可被 Qtile 提供的任意接口调用。以文档中自动生成的接口语法模板见 docs/qtile_docs/commands.py 与 docs/qtile_docs/templates/command.py为基础访问 group 命令有三种典型方式1. 配置中的 lazy 接口键绑定在config.py中通过lazy.group[...]定位特定组然后调用命令from libqtile.lazy import lazy keys [ # 切换布局 Key([mod], Tab, lazy.group[a].setlayout(max)), # 把当前组拉到指定屏幕 Key([mod, shift], k, lazy.group[a].toscreen(0)), # 切换窗口焦点 Key([mod], j, lazy.group.next_window()), Key([mod], k, lazy.group.prev_window()), ]不带选择器的lazy.group表示当前组命令图根节点省略 key 时即默认当前对象带[a]选择器则精确锁定名为a的组。2. 命令行接口qtile cmd-objqtile cmd-obj -o group -f info qtile cmd-obj -o group -f toscreen -a 0 qtile cmd-obj -o group a -f setlayout -a max-o group指定对象不写名称表示当前组-o group a指定具体组-f指定要执行的命令-a传递参数。交互式地浏览命令图还可以使用qtile shell用ls查看节点、用help查看命令说明参见 docs/manual/commands/index.rst 与 docs/manual/commands/shell/qtile-shell.rst。3. Python 脚本接口InteractiveCommandClientfrom libqtile.command.client import InteractiveCommandClient c InteractiveCommandClient() print(c.group.info()) # 当前组的信息 c.group[b].toscreen(1) # 将组 b 拉到屏幕 1 c.group.next_window() # 聚焦组内下一个窗口InteractiveCommandClient会自动连接正在运行的 Qtile 实例详见 libqtile/command/client.py。访问当前组时可省略选择器c.group.info()访问指定组则用映射语法c.group[b]继续下钻可访问 group 的子节点例如c.group[b].screen.info()获取显示组 b 的屏幕信息——但注意若组 b 当前未显示在任何屏幕上该路径会解析失败并抛出CommandError。Group 的完整命令清单以下命令全部定义在 libqtile/group.py 的_Group类中并带有expose_command()装饰器即它们是命令图中对外公开的 API。信息查询类info()— 获取组的状态信息返回该组的完整状态字典是排查与脚本自动化中最常用的命令。源码实现libqtile/group.py返回的字段包括字段含义name组的名称配置时设定的标识符label组的显示名GroupBox 组件用它来显示focus当前聚焦窗口的名称无则返回Nonewindows组内全部窗口名称列表focus_history按获得焦点先后排序的窗口名称列表tiled_windows被平铺的窗口集合layout当前使用的布局名称layouts该组可用的全部布局名称列表floating_info浮动层布局的信息screen显示该组的屏幕索引未显示则为Noneqtile cmd-obj -o group -f infoc InteractiveCommandClient() info c.group.info() print(info[name], info[layout], info[windows])info_by_name(name)— 按名称查询窗口信息而不改变焦点与focus_by_name不同该命令只获取信息、不会把焦点切过去libqtile/group.py。找到第一个名称匹配的窗口并返回其info()未找到则无操作。c.group.info_by_name(firefox)布局控制类setlayout(layout)— 设置组的当前布局通过布局名称切换布局。实现上会遍历该组的layouts列表找到名称匹配的布局后调用use_layoutlibqtile/group.py。布局名称通常是配置文件中布局类名的小写形式如max、tile若找不到会记录一条错误日志No such layout: name。lazy.group[a].setlayout(max) lazy.group.setlayout(tile)qtile cmd-obj -o group -f setlayout -a max组级布局的配置补充尽管setlayout是运行时切换组还可以在配置阶段就指定专属的默认布局与布局列表见 docs/manual/config/groups.rst 与 libqtile/config.pyfrom libqtile.config import Group groups [ Group(dev, layoutmax), # 该组默认使用 max 布局 Group(web, layouts[tile, max]), # 用独立的布局列表覆盖全局布局 Group(chat, layout_opts{margin: 8}), # 为默认布局传入选项 ]其中layout是默认布局的名称layouts可以为此组定义一套独立于全局的布局列表layout_opts则向布局传递参数。运行时调用setlayout只能切换到组内已有布局因此layouts参数是扩展组内可用布局的主要途径。屏幕迁移类toscreen(screenNone, toggleFalse)— 把组拉到指定屏幕核心的跨屏操作命令。源码逻辑libqtile/group.pyscreen参数为屏幕偏移量索引省略时默认使用当前屏幕若该组已经在目标屏幕上当toggleTrue时会与上次使用的组进行切换调用screen.toggle_group实现来回复切效果toggleFalse时不做任何事若不在目标屏幕上则调用screen.set_group(self)完成迁移。lazy.group[b].toscreen() # 拉到当前屏幕 lazy.group[b].toscreen(0) # 拉到屏幕 0 lazy.group[b].toscreen(0, True) # 已在屏幕 0 则与上一个组来回切换qtile cmd-obj -o group -f toscreen -a 0命令图文档中给出的经典示例正是c.group[b].toscreen(1)——把组 b 发送到屏幕 1docs/manual/commands/command_graph.rst。switch_groups(name)— 交换两个组的位置把当前组与指定名称的组在屏幕上互换位置libqtile/group.py底层调用qtile.switch_groups。适用于交换左右屏幕内容这类操作。lazy.group.switch_groups(b) # 当前组与组 b 互换屏幕位置窗口焦点控制类这一类命令处理的是组内窗口间的焦点切换是日常高频操作。next_window()/prev_window()— 循环聚焦下一个/上一个窗口按当前布局定义的顺序循环切换焦点libqtile/group.py。需要注意源码中的两个细节会循环组内所有窗口无论其是被平铺还是浮动但平铺窗口与浮动窗口的循环不会混合——即焦点在平铺窗口中时按平铺顺序走在浮动窗口中时按浮动顺序走两种循环相互独立。lazy.group.next_window() lazy.group.prev_window()focus_back()— 回到上一个焦点窗口聚焦在当前窗口之前获得过焦点的窗口libqtile/group.py。反复调用会在最近两个窗口之间来回切换。若组内从未有两个窗口获得过焦点则无操作。lazy.group.focus_back()focus_by_name(name)/focus_by_index(index)— 按名称或索引聚焦focus_by_name(name)聚焦第一个名称匹配的窗口未找到则无操作libqtile/group.pyfocus_by_index(index)按窗口在组内windows列表中的索引聚焦索引越界则无操作libqtile/group.py。lazy.group.focus_by_name(emacs) lazy.group.focus_by_index(0)swap_window_order(new_location)— 重排组内窗口顺序将当前聚焦窗口移动到组内windows列表的指定新位置libqtile/group.py从而改变窗口的排列次序。参数越界则无操作。lazy.group.swap_window_order(0) # 把当前窗口移到列表首位unminimize_all()— 取消组内全部窗口的最小化遍历组内所有窗口并清除其minimized标记然后重新布局libqtile/group.py。lazy.group.unminimize_all()显示与标签控制类set_label(label)— 设置组的显示名称设置 GroupBox 组件中显示的名称libqtile/group.py。特别之处在于传入None时恢复为使用组名name显示传入空字符串时该组会在 GroupBox 中隐藏不可见。lazy.group[a].set_label(工作台)这正好对应配置阶段Group(label...)参数的语义组以name标识、以label显示二者可以不同libqtile/group.py。命令图中 Group 的子节点导航除了自身命令group 还是命令图中的中间节点可以通过它继续下钻到layout、window、screen三种子对象libqtile/command/graph.py。这意味着一旦拿到 group 节点就能触达与之关联的整条对象链c InteractiveCommandClient() c.group.info() # 当前组自身的命令 c.group.layout.info() # 下钻到当前布局 c.group.layout[max].info() # 下钻到指定布局 c.group.window.info() # 下钻到当前窗口 c.group[b].screen.info() # 下钻到显示组 b 的屏幕若未显示则抛 CommandError而_Group._items与_selectlibqtile/group.py正是实现这些下钻路径的底层逻辑layout子项对应组内布局索引screen子项在组未显示时不可用window子项以窗口的wid作为选择器。理解这层结构即可在qtile shell中自由地沿图导航ls查看可用子节点再逐层深入。底层实现要点焦点历史与窗口管理最后补充几个理解上述命令行为的关键实现细节均可在 libqtile/group.py 中印证焦点历史focus_historycurrent_window属性就是focus_history的最后一个元素。focus_back、next_window、prev_window、focus_by_index等命令全部建立在这条历史与windows列表之上。窗口被移除组时remove会同步从焦点历史中摘除。浮动的特殊处理focus时若目标窗口浮动会先模糊blur所有平铺布局、只向浮动布局登记焦点反之亦然。这与next_window平铺/浮动不混合循环的行为一致。拖拽保护focus在 Qtile 处于拖拽窗口状态self.qtile._drag时默认拒绝改焦点除非forceTrue。钩子hook联动窗口加入/移除组会触发group_window_add/group_window_remove钩子布局切换触发layout_change焦点变化触发focus_changeset_label触发changegroup——因此在脚本中监听这些钩子即可感知组状态的每一次变化参见 docs/manual/config/hooks.rst。总结Qtile 的 Group 命令 API 虽然范围有限却覆盖了工作区管理的全部核心动作查询info、布局切换setlayout、跨屏迁移toscreen、switch_groups、焦点控制next_window、prev_window、focus_back、focus_by_name、focus_by_index、swap_window_order、unminimize_all与显示控制set_label。由于它们全部注册在命令图中同一套命令可以无差别地用于lazy键绑定、qtile cmd-obj命令行和InteractiveCommandClientPython 脚本三种场景又因为 group 节点连通了layout、window、screen三个子节点掌握了 group 就等于掌握了在 Qtile 对象图中自由导航的入口。结合本文给出的源码位置与配置参数你可以直接在自己的配置中落地这些命令构建出完整、可脚本化的工作区管理方案。赞分享桌面应用操作系统【免费下载链接】qtile:cookie: A full-featured, hackable tiling window manager written and configured in Python (X11 Wayland)项目地址https://gitcode.com/gh_mirrors/qt/qtile点击查看免费下载相关推荐Qtile Shell 实战指南用命令行交互式驾驭 Qtile 命令图Qtile Shell 实战指南用命令行交互式驾驭 Qtile 命令图 Qtile shell qtile shell 是 Qtile 提供的一个命令行式桌面应用操作系统wezterm cli rename-workspace 命令详解WezTerm 工作区Workspace重命名实战指南wezterm cli rename workspace 命令详解WezTerm 工作区Workspace重命名实战指南 wezterm cli rena桌面应用开发工具跨平台pixi workspace 命令详解用命令行管理 pixi 工作区配置pixi workspace 命令详解用命令行管理 pixi 工作区配置 pixi workspace 是 pixi用 Rust 编写的跨平台包管理器构建开发工具CLI包管理器任务调度上一篇微服务契约测试终极指南保障API兼容性的完整解决方案下一篇typescript-eslint安全审计代码漏洞检测能力分析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考