2026-06-29 updated

source/_posts/firefox-global-menu.md

@@ -0,0 +1,84 @@
+---
+title: 为 Firefox 启用全局菜单集成到 KDE Plasma 任务栏
+date: 2026-06-29 11:32:26
+tags: [Firefox, 技术分享]
+---
+
+众所不周知， Chrome 菜单可以自动集成到 KDE Plasma 任务栏全局菜单组件，不管你喜不喜欢浏览器菜单至少看着很顺眼。然而，默认情况下，Firefox 并没有自动启用这个功能，需要进行一些配置。//本来我还以为是 Firefox 没有支持这个功能 TT
+
+本文将详细探讨 Linux 全局菜单的 D-Bus 工作原理，对比 Chrome 与 Firefox 的实现差异，并给出在 KDE Plasma 下完美启用 Firefox 全局菜单的配置方案（以下与 D-Bus 相关知识分享由 [Qwen 3.7](https://chat.qwen.ai)提供并由本人验证整理）。
+
+## 什么是全局菜单？其背后的 D-Bus 工作原理
+
+KDE Plasma 桌面的全局菜单（Global Menu）小组件可以把应用程序内部的菜单栏（如“文件”、“编辑”、“视图”等）提取出来，统一放置在桌面顶部的面板（Panel）中。这种机制实际上采用的是**“客户端-服务端”**的架构，其核心是基于 **D-Bus 消息总线系统** 与 **`dbusmenu` 协议**：
+
+1. **`dbusmenu` 协议**：最初由 Canonical 为 Ubuntu Unity 桌面环境设计，定义了一套标准的 D-Bus 接口，用来描述菜单的层次结构（菜单项、图标、快捷键、分隔符、启用状态等）以及用户交互事件。
+2. **应用端（D-Bus 导出者）**：支持全局菜单的应用启动时，会在 D-Bus 会话总线（Session Bus）上注册一个服务，把本应用的菜单树作为 D-Bus 对象暴露出来。此时，菜单的数据实质上依然保存在应用的内存中，只是通过 D-Bus 接口暴露给外部读取。
+3. **全局菜单小组件（D-Bus 消费者）**：
+   * **焦点追踪**：小组件通过窗口管理器（KWin）实时监听当前获得焦点的活动窗口。
+   * **数据拉取**：当用户切换窗口时，小组件定位到该窗口对应的 D-Bus 服务地址，通过 `dbusmenu` 协议拉取菜单树，并在顶栏上进行渲染。
+   * **事件回传**：用户在顶栏点击菜单项时，小组件通过 D-Bus 向目标应用发送“激活”（Activate）信号，应用接收后执行具体的操作。
+
+---
+
+## 为什么不同应用的支持情况不同？
+
+在 Linux 桌面中，不同工具包（Toolkit）的底层架构差异，导致了全局菜单集成度的不同：
+
+* **Qt 程序**：由于 KDE 深度基于 Qt 构建，Qt 5/6 已经原生内置了对 `dbusmenu` 的支持（通过 `libdbusmenu-qt` 等）。Qt 应用的 `QMenuBar` 会自动被全局菜单组件无缝接管，体验最完美。
+* **Electron / Chromium 应用**：Chromium 内核在 Linux 下原生集成了对 `libdbusmenu` 库的调用，只要没有使用 HTML 自绘标题栏，就会自动在 D-Bus 上注册原生菜单。
+
+### Chrome 与 Firefox 的差异对比
+
+* **Chrome/Chromium**：作为“优等生”，它直接在底层自带了 `dbusmenu` 支持，能自动检测 KDE 环境并向 D-Bus 注册菜单。
+  
+  ![Chrome 全局菜单](/images/chrome-global-menu.png)
+
+* **Firefox**：
+  1. Firefox 在 Linux 下主要基于 GTK3 构建，并不像 Chrome 那样天然“自带干粮”支持 D-Bus 菜单，需要依赖系统的 `appmenu-gtk-module` 翻译器。
+  2. 默认情况下，Firefox 倾向于“自己画界面”（使用 XUL/HTML 自绘机制）。当我们按下 `Alt` 键调出菜单栏时，它弹出的其实是**自绘的虚拟菜单**，而非标准的原生 `GtkMenuBar`。这就导致 `appmenu-gtk-module` 无法拦截到任何菜单数据。
+  3. 此外，如果启用了“自定义标题栏”（CSD，客户端装饰），Firefox 会完全接管窗口装饰，导致系统模块彻底与菜单脱钩。
+  
+---
+
+## 完美解决：Firefox 启用全局菜单的完整步骤
+
+要让 Firefox 的菜单能够正常进入全局菜单，我们需要：
+
+1. 让 Firefox 放弃自绘菜单，改用原生 GTK 菜单栏；
+2. 开启 Firefox 内部的强制 D-Bus 导出开关；
+3. 确保系统具备 GTK 菜单桥接模块。
+
+具体步骤如下：
+
+### 步骤 1：确保安装并加载了 `appmenu-gtk-module`
+
+确保系统里存在 GTK 桥接模块：
+
+1. 根据发行版安装对应的模块：
+   * **Arch Linux**：`sudo pacman -S appmenu-gtk-module`
+   * **Ubuntu / Debian / KDE Neon**：`sudo apt install appmenu-gtk3-module`
+   * **Fedora**：`sudo dnf install gtk3-appmenu-gtk-module`
+2. 重启你的桌面会话（或注销重新登录），以保证 `GTK_MODULES=appmenu-gtk-module` 环境变量在全局生效。
+
+### 步骤 2：在 `about:config` 中强制开启全局菜单输出
+
+由于 Firefox 默认隐藏菜单需要按 alt 键显示，我们需要手动强制其导出：
+
+1. 在 Firefox 地址栏输入 `about:config` 并回车，接受风险提示。
+2. 搜索并修改/新建以下两个键值：
+   * **`widget.gtk.global-menu.force`** 设置为 **`true`** （强制启用全局菜单）
+   * **`widget.gtk.global-menu.force-wayland`** 设置为 **`true`** （如果在 Wayland 会话下，强制通过 D-Bus 导出菜单，非常关键）
+3. 重启 Firefox。
+
+![Firefox 全局菜单配置](/images/firefox-global-menu-solve.png)
+
+---
+
+## 最终效果
+
+经过以上配置，Firefox 的菜单成功脱离了浏览器窗口，并无缝集成到了 KDE Plasma 的全局菜单面板中，整体桌面体验更加干净统一：
+
+![Firefox 默认菜单显示在标题栏下方](/images/firefox-global-menu.png)
+
+如此一来，无论是在 X11 还是 Wayland 会话下，我们都能在 Firefox 中享受到类似 macOS 的全局菜单体验了。

source/about/index.md

@@ -4,7 +4,7 @@ date: 2024-11-04 22:46:12
 layout: about
 ---
 
-白茅铺高地玄院第N任非菌群主🐳，Linux六年牢用户🐧
+白茅铺高地玄院第四任非菌群主🐳，Linux七年牢用户🐧，ASC三年牢选手🤡（无人在意）
 
 爱好编程，绘画，编曲，Vocaloid调教，Blender建模等😇
 
@@ -12,6 +12,6 @@ layout: about
 
 联系方式：
 
-- Email: <c_gh0s7@nudt.edu.cn>
+- Email: <cikki@hifuu.ink>
 
 - Github: <https://github.com/CGH0S7>