桌面应用【免费下载链接】yasbA highly configurable Windows status bar written in Python.项目地址https://gitcode.com/gh_mirrors/yas/yasb点击查看免费下载YASBYet Another Status Bar是一个用 Python 编写的高可配置 Windows 状态栏而 Window Switcher 是其中内置的一个轻量级弹出式窗口切换组件它把当前所有打开的应用程序以图标形式集中展示在一个悬浮面板中让你可以像使用增强版 Alt-Tab 一样用鼠标或键盘快速在应用间切换焦点、甚至直接关闭某个窗口。本文将以官方 Widget 文档docs/widgets/(Widget)-Window-Switcher.md-Window-Switcher.md)为主体逐项讲解它的全部配置项、回调、弹出层样式、键盘导航与 CSS 定制方法并结合仓库源码剖析它背后的窗口枚举、图标提取、屏幕定位与焦点切换实现原理让你既能开箱即用也能按需深度定制。什么是 Window SwitcherWindow Switcher 是一个快速、轻量的弹出式 Widget设计目标非常简单让用户轻松地在当前打开的应用之间循环浏览并聚焦目标窗口。它是 Windows 内置 Alt-Tab 菜单的高可定制、鼠标与键盘双友好的替代方案相比系统自带的切换界面它的图标大小、可见数量、标题显示、配色与圆角等全部可以通过配置文件控制。从源码结构看该组件定义在 src/core/widgets/yasb/window_switcher.py 中核心类是WindowSwitcherWidget它继承自BaseWidgetsrc/core/widgets/base.py复用 YASB 统一的 Widget 生命周期、回调注册与热键事件机制。其数据来源则与任务栏组件共享TaskbarWindowManager单例src/core/widgets/services/taskbar/window_manager.py通过 Windows SHELLHOOK 原生消息跟踪顶层窗口的创建、销毁与激活变化——这也是它能做到所见即所有打开应用的根本原因。全部配置项一览Window Switcher 的全部配置都定义在widgets.window_switcher.options下下表来自官方文档并与 src/core/validation/widgets/yasb/window_switcher.py 中的WindowSwitcherConfig模型逐项对应该模型基于 pydanticextraforbid多余字段会被拒绝因此请严格按表配置名称类型默认值说明labelstring\uf2d2状态栏上显示的图标或文字Nerd Font 图标。注官方文档表格中写作\uf2d0而当前仓库验证模型与使用示例中的默认值均为\uf2d2实际生效值以模型为准。label_altstring备用标签文本可用于鼠标悬停切换显示。icon_sizeint48弹出层中每个应用程序图标的大小像素。max_visible_appsint5在启用滚动之前最多同时显示的应用数量。show_titlebooleantrue是否在图标下方显示当前聚焦应用的标题。callbacksobject见下方 Callbacks定义 Widget 的鼠标交互动作。popupobject见下方 Popup定义弹出层的样式与定位。keybindingslist[]触发弹出层的全局热键。Callbacks鼠标回调回调把鼠标点击动作映射到具体的功能上。该配置继承自通用的CallbacksConfigsrc/core/validation/widgets/base_model.pyWindow Switcher 只覆盖了on_left的默认值选项类型默认值动作on_leftstringtoggle_window_switcher切换窗口切换器的开关。on_middlestringdo_nothing可选动作默认不执行任何操作。on_rightstringdo_nothing可选动作默认不执行任何操作。在源码中toggle_window_switcher回调在__init__中通过self.register_callback(toggle_window_switcher, self._toggle_window_switcher)注册见 window_switcher.py其实现是若弹出层已可见则调用hide_animated()关闭否则调用_show_popup()打开天然支持再按一次即关闭的切换语义。Popup弹出层样式弹出层是渲染窗口图标列表的无边框悬浮窗口以下参数控制它的视觉外观名称类型默认值说明blurbooleantrue是否对弹出层背景应用模糊效果。round_cornersbooleantrue是否应用圆角。round_corners_typestringnormal圆角类型可选normal或small。border_colorstringSystem边框颜色。dark_modebooleantrue是否为弹出层应用深色模式。这些参数直接透传给通用组件PopupWidgetsrc/core/utils/utilities.py的构造函数。从源码可见弹出层使用Qt.WindowType.Popup | FramelessWindowHint | WindowStaysOnTopHint等窗口标志组合并设置WA_TranslucentBackground透明背景关闭时通过 80ms 的windowOpacity淡出动画hide_animated平滑消失配合blur背景虚化视觉上非常轻盈。键盘导航当弹出层打开时焦点会自动落在第一个应用图标上源码中set_focused_button(0)完成初始聚焦之后你可以完全用键盘操作Left←切换到上一个窗口。Right→切换到下一个窗口。Enter / Space选择并切换至当前聚焦的窗口。Delete关闭当前选中窗口对应的应用。Escape关闭窗口切换器不改变当前焦点。这些按键逻辑全部集中在eventFilter中window_switcher.py分别对应Key_Left、Key_Right、Key_Return/Key_Enter/Key_Space、Key_Delete与Key_Escape。特别值得注意的是自动滚动跟随当选中项超出当前可视区域时set_focused_button会计算水平滚动条位置把聚焦项平滑地带入视野键盘导航时自动滚动鼠标悬停时不触发滚动以免打扰。标题实时更新每次切换焦点都会把对应窗口的窗口标题更新到底部的标题栏并调用elidedText做省略号截断保证长标题不会撑破布局。除了键盘源码还额外支持以下鼠标交互这是对文档的有力补充鼠标悬停移动鼠标到某个图标上即切换焦点Enter事件触发set_focused_button(..., by_mouseTrue)。左键点击立即切换并聚焦该窗口。右键点击关闭该窗口对应的应用。滚轮滚动当应用数量超过可视范围时滚动滚轮可水平平滑浏览其余图标QWheelEvent被拦截并转换为水平滚动条的位移。使用配置你的 config.yaml在config.yaml的widgets段中加入以下配置即可启用该组件widgets: window_switcher: type: yasb.window_switcher.WindowSwitcherWidget options: label: span\uf2d2/span icon_size: 48 max_visible_apps: 5 show_title: true keybindings: - keys: altw action: toggle_window_switcher screen: cursortype字段必须是yasb.window_switcher.WindowSwitcherWidget它通过BaseWidget.__init_subclass__机制自动注册进 Widget 注册表src/core/widgets/registry.py构建器按此类型名实例化。Keybindings 选项选项类型说明keysstring键盘快捷键序列例如altw。actionstring要触发的 Widget 动作此处固定为toggle_window_switcher。screenstring弹出层出现的屏幕模式active当前活动窗口所在屏、cursor鼠标所在屏、primary主屏幕。默认active。screen字段的类型在 base_model.py 中被约束为Literal[active, cursor, primary]只接受这三个值。对应源码实现_get_target_screenwindow_switcher.pycursor调用find_focused_screen(follow_mouseTrue, follow_windowFalse)跟随鼠标所在屏active调用find_focused_screen(follow_mouseFalse, follow_windowTrue)跟随当前活动窗口所在屏primary直接返回QApplication.primaryScreen()。需要注意文档中只配置了toggle_window_switcher这一个动作但配置项的 action 字段是通用的——若你日后在该 Widget 上自定义了其他回调名例如在callbacks.on_left中指定同样可以在此绑定到对应按键。实用要点图标清晰度与动态宽度官方文档特别给出了两条实战注意点值得展开图标模糊问题如果把icon_size设置得过大例如80或128部分应用图标可能会显得模糊或像素化。原因是很多应用并没有在.exe文件中嵌入高分辨率图标通常最多只有64x64。Widget 会尽力提取应用原生提供的最高质量图标但如果应用本身没有提供大图标图像就只能被拉伸。这与源码中的图标提取逻辑完全吻合_get_app_iconwindow_switcher.py采用三级回退策略按优先级取图AUMID 图标通过get_aumid_for_window拿到窗口的 App User Model ID再调用get_icon_for_aumid获取对 UWP/打包应用尤其有效进程图标取不到时回退到get_process_icon(pid)从进程的可执行文件中提取窗口图标最后回退到get_window_icon(hwnd)其内部依次尝试WM_GETICONICON_BIG/ICON_SMALL/ICON_SMALL2、类图标GCLP_HICONSM/GCLP_HICON直至系统默认应用图标IDI_APPLICATION实现见 src/core/utils/win32/app_icons.py。同时源码对取到的图标会按icon_size × 屏幕 DPR计算物理像素使用LANCZOS重采样算法缩放到目标尺寸并将(hwnd, icon_size, dpr)作为缓存键复用图标缓存上限为 40 个防止图标过大导致内存无谓增长。这也解释了为什么绝对最高质量的前提是应用本身提供了大图否则 80/128 的大图标必然被拉伸。动态屏幕宽度Widget 具备完整的屏幕感知能力。为了防止使用超大图标或很高的max_visible_apps时弹出层溢出显示器边缘弹出层的最大宽度会被动态限制在屏幕宽度的 90%以内超出部分可以通过滚动平滑浏览其余图标。源码_update_popup_geometrywindow_switcher.py的算法是取目标屏幕几何信息max_allowed_width screen_width * 0.9再扣除标题栏等附加宽度后算出当前可视区域最多能放几个应用max_screen_apps最终实际可见数量 min(应用总数, max_visible_apps, max_screen_apps)并把弹出层居中定位到该屏幕的中央。也就是说max_visible_apps是一个上限值真正的可见数量还会被屏幕宽度动态收敛。CSS 样式定制这是一个结构非常简单的组件因此它的全部样式类都列在下面的示例中。你可以直接把它作为起点在styles.css中定制窗口切换器的外观官方文档完整示例.window-switcher-widget {} .window-switcher-widget .label {} .window-switcher-widget .icon { font-family: JetBrainsMono NFP } /* Styling for the popup container */ .window-switcher-popup { background-color: rgba(18, 19, 20, 0.4); padding: 10px; } /* Styling for each window item */ .window-switcher-popup .item { background-color: rgba(255, 255, 255, 0); border-radius: 8px; margin: 5px; padding: 10px; cursor: pointer; border: 1px solid transparent } /* Hover or keyboard-focus effect */ .window-switcher-popup .item:hover, .window-switcher-popup .item.active { background-color: rgba(255, 255, 255, 0.07); border: 1px solid rgba(255, 255, 255, 0.07); } /* Window title text styling */ .window-switcher-popup .title { padding: 10px 10px 5px 10px; color: #ffffff; font-size: 12px; font-weight: 600; margin-top: 10px; border-top: 1px solid rgba(255, 255, 255, 0.158); }从源码结构可以对应出每个类的用途.window-switcher-widgetWidget 在状态栏上的外壳由BaseWidget统一挂上widget window-switcher-widget两个 class其.label是状态栏上的触发图标.icon类用于 Nerd Font 图标的字体族设置.window-switcher-popup弹出层最外层包装容器wrapper的 class 属性见_build_overlay_popup.window-switcher-popup .item每个窗口图标项_SwitcherItem被设置为item属性当键盘/鼠标聚焦时会被追加active类set_focused_button中btn.setProperty(class, item active)这正是.item.active选择器生效的来源.window-switcher-popup .title底部当前窗口标题标签仅当show_title: true时创建。滚动区域内部#ws_scroll、#ws_viewport、#ws_container由源码强制设置为透明无边框内联样式因此你在外部看到的背景色完全由.window-switcher-popup的background-color决定配合blur背景模糊即可实现毛玻璃质感。源码实现细节弹出层的构建与窗口切换除了文档中已有的内容从源码还能提炼出几个值得开发者注意的实现事实见 window_switcher.py窗口来源与排序_get_sorted_windows从TaskbarWindowManager.get_windows()取出所有被跟踪的顶层窗口用is_taskbar_window()过滤出任务栏可见窗口随后调用win32gui.EnumWindows枚举当前 Z 序按最近活跃优先排序展示——这与 Windows 原生 Alt-Tab 的排列直觉一致。延迟聚焦技巧_switch_to_window通过resolve_base_and_focus解析窗口所属的主窗口 实际聚焦目标必要时先restore_window/show_window还原再用set_foreground置前最后QTimer.singleShot(0, lambda: force_foreground_focus(target))延迟一拍强制聚焦。延迟一帧是因为 Windows 前台锁foreground lock限制直接同步调用可能被系统拒绝整个流程还有多层 try/except 兜底逐级降级到ShowWindowSetActiveWindow。关闭窗口后的自愈_close_window调用close_application关闭应用后会立即从buttons_list中移除对应项并重建弹出层几何然后自动把焦点移动到原位置的下一个应用min(index, len(buttons_list) - 1)如果所有窗口都被关闭弹出层会自动淡出。一次打开的切换语义由于PopupWidget维护了一个每父组件已打开弹出层的注册表PopupWidget._open_popups重复触发toggle_window_switcher不会叠加出多个弹出层而是先关闭旧的再打开新的保证了单实例行为。总结YASB 的 Window Switcher Widget 把查看所有窗口、快速切换、随手关闭压缩到了一个由配置驱动的轻量弹出层里label/icon_size/max_visible_apps/show_title控制展示形态popup控制视觉质感keybindingsscreen决定你用哪个快捷键、在哪个屏幕上唤醒它而键盘导航与鼠标操作让切换效率直逼甚至超过系统原生 Alt-Tab。如果你想进一步研究它的实现可以从 window_switcher.py 入手配合 window_manager.py窗口跟踪与 app_icons.py图标提取两条链路深入阅读。赞分享桌面应用【免费下载链接】yasbA highly configurable Windows status bar written in Python.项目地址https://gitcode.com/gh_mirrors/yas/yasb点击查看免费下载相关推荐yasb 电池 WidgetBattery Widget完整配置与实现原理指南yasb 电池 WidgetBattery Widget完整配置与实现原理指南 本文导读 本文围绕 yasbYet Another Status Bar桌面应用推荐文章窗口切换利器——Window Switcher让效率飞起来推荐文章窗口切换利器——Window Switcher让效率飞起来 在日常的办公和编程生活中高效地管理窗口是提升工作流的关键。今天我们来一起探索一个简桌面应用GUI 自动化yasb Active Window Widget 完全指南在状态栏显示当前窗口标题与图标yasb Active Window Widget 完全指南在状态栏显示当前窗口标题与图标 本篇指南基于 yasb一款用 Python 编写的高度可配置 W桌面应用上一篇深入 Chia CLVM 智能合约测试体系Program 封装、Puzzle 压缩与 SpendSim 模拟器实战下一篇UI-TARS 坐标定位五步点得准创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考