默认应用与 Web App：追踪真正的启动路径

选了 Firefox 作默认浏览器，Web App 却仍然打开 Chromium；PDF 在浏览器里显示，编辑器快捷键又继续启动旧编辑器。这可能是三条不同路径，而不是一个默认设置失败。

本文依据固定的 4.0.0.alpha 源码。后续启动器实现可能变化，应查询本机默认值、检查自己的快捷键。本快照 Web App 使用受支持的 Chromium 系默认浏览器，其他情况回退到 Chromium；没有提供一个通用、独立的 Web App 浏览器偏好设置。

1. 先找到入口，再决定改什么

普通网址 → XDG http/https 关联 → 浏览器 desktop 条目
Omarchy 浏览器快捷键 → omarchy-launch-browser → 默认浏览器解析
固定个人快捷键 → 明确指定的命令
文件管理器打开文件 → MIME 类型 → 默认 desktop 条目
Web App 条目 → Exec 行 → omarchy-launch-webapp → 支持的浏览器或回退

入口	通常跟随什么	有用的检查
使用 Omarchy 辅助函数的浏览器键	Omarchy/XDG 默认浏览器	绑定说明与动作
个人绑定直接写 firefox	该可执行程序	个人 bindings.lua
聊天应用内点击链接	XDG 关联，除非应用自己覆盖	应用偏好、HTTP/HTTPS 关联
Files 打开 PDF	application/pdf 默认项	MIME 查询
浏览器标签内的 PDF	浏览器内部查看器	浏览器设置
已安装的 Web App	desktop 条目的 Exec	查看实际用户条目

图标名字不能证明运行哪个程序。.desktop 可以调用辅助函数、固定浏览器或应用专属命令；同 ID 的用户条目也可能覆盖系统条目。MIME 默认应用规范

2. 先记录当前关联

修改前查询：

omarchy-default-browser
env -u BROWSER xdg-settings get default-web-browser
xdg-mime query default x-scheme-handler/http
xdg-mime query default x-scheme-handler/https
xdg-mime query default application/pdf
omarchy menu keybindings --print

把结果保存在本地。BROWSER 会影响部分工具；Omarchy 查询时移除它，避免绕回自己的辅助函数。本快照解析器先查配置中的 HTTP 关联，选择已安装条目，再回退到 XDG 查询。因此 HTTP/HTTPS 不一致时，应查关联，而不是重装无关组件。默认解析器

记录用户配置中已有的 mimeapps.list，包括桌面专属变体。计划编辑的文件用新名称备份，原先没有的文件也记下来。不要用猜测的完整清单覆盖现有全部关联。

3. 案例：普通链接用 Firefox，Web App 用 Chromium

需要时通过 Install → Browser 安装 Firefox，再去 Setup → Defaults → Browser 选择它。本快照直接命令是：

omarchy-default-browser firefox

可执行程序缺失时，设置命令可能提供安装流程。安装与设为默认是两件事，完成后再确认显示的默认值。

用无敏感信息的网址测试三个入口：

xdg-open 'https://example.com/'
omarchy-launch-browser 'https://example.com/'
omarchy-launch-webapp 'https://example.com/'

此配置预期前两项在关联一致时使用 Firefox，第三项以 Chromium 的应用模式打开。这是预期回退，不表示 Firefox 从未设置成功；单独运行第三条也不会创建持久的应用条目。浏览器设置器 · Web App 解析器

再从实际聊天应用点击一次链接。只有它打开别的浏览器时，查看它的专属偏好。辅助函数测试成功，不能证明每个应用都调用它。

普通默认值换成受支持的 Chromium 系浏览器时，Web App 也可能换过去。Cookie、配置档案和登录状态不会自动迁移。没有普通工具栏，也不等于 Web App 被隔离；这个启动器不会自动为每个应用创建独立档案。

4. 案例：快捷键忽略新默认值

检查个人文件和当前清单，比较两种动作：

-- 跟随 Omarchy 浏览器辅助函数。
o.rebind("SUPER + SHIFT + RETURN", "Browser", { omarchy = "browser" })

-- 明确固定应用，与默认浏览器独立。
-- o.rebind("SUPER + SHIFT + RETURN", "Firefox", { launch = "firefox" })

备份 bindings.lua 后只保留符合意图的定义。第一种是替换原绑定，不是添加竞争动作。通过 Setup → Keybindings 保存，查看清单并实际按键。

编辑器辅助函数与固定编辑器命令也有同样区别。Omarchy 命令使用的“默认编辑器”，并不保证控制所有文本文件 MIME 关联或应用内部编辑器。匹配、冲突与撤销见快捷键设计。

5. 案例：PDF 应该用文档查看器打开

选择本地、不敏感的测试 PDF，先确认实际类型，不只看扩展名：

xdg-mime query filetype "$HOME/Documents/test.pdf"
xdg-mime query default application/pdf

路径换成实际存在的测试文件；不存在的文件不能测试关联。在 Files 的 Open With 选择已安装查看器，界面支持时设为默认。也可以用 xdg-mime default，但必须先确认查看器的 desktop ID。

例如，仅当本机条目确实是 org.gnome.Evince.desktop：

xdg-mime default org.gnome.Evince.desktop application/pdf
xdg-open "$HOME/Documents/test.pdf"

先到 /usr/share/applications/ 或 ~/.local/share/applications/ 确认。可执行程序 evince 与 desktop ID 不是同一个名字，不同包也可能提供不同 ID。

同时验证查询结果与 Files 实际打开。浏览器下载/PDF 偏好仍可能在标签页显示文档。修改文件关联不会取代这种内部行为，选浏览器也不会自动修改全部 PDF 关联。

6. 检查并创建一个 Web App 条目

通过 Install → Web App 填名称、HTTP(S) URL 与图标。使用唯一名称，避免覆盖已有条目。教学例子是 Example Site 与 https://example.com/，只测试启动，不测试真实服务的登录流程。

生成条目在 ~/.local/share/applications/。只读取它的关键字段：

grep -E '^(Name|Exec|Icon|StartupWMClass)=' \
  "$HOME/.local/share/applications/Example Site.desktop"

正常 Exec 调用 omarchy-launch-webapp。旧条目若固定 chromium --app=...，或使用自定义命令，可能绕过当前解析器。先看实际文件，再判断辅助函数是否有问题。安装器源码

从菜单启动，需要工作区规则时查看 hyprctl clients。Web App 的窗口 class 可能与普通浏览器不同，先发现真实身份再写规则。已打开实例也单独测试：应用可能聚焦旧窗口，而不新建一个。

不要把 Shell 引号规则直接搬到 Exec。desktop 条目有自己的转义与字段代码：%U 表示启动器传入的网址，字面百分号需要转义。包含查询参数的网址应保持为一个参数。优先用 Omarchy 安装器处理这些转义。Desktop Entry Exec 规范

7. 只排查和恢复受影响的路径

现象	下一步证据
普通链接 Firefox，Web App Chromium	本快照不支持默认值时的预期回退
只有一个 Web App 忽略默认	它的 Exec、自定义条目与旧实例
只有一个按键启动旧浏览器	固定或重复绑定
HTTP 与 HTTPS 不一致	两种关联、相关清单优先级
默认指向已卸载应用	desktop 条目和可执行程序是否仍在
PDF 查询正确，浏览器仍显示 PDF	浏览器内部查看器偏好
换浏览器后网站退出登录	浏览器/档案存储不同，不是 XDG 路由失败

通过默认菜单恢复之前记录的浏览器。旧 PDF 关联非空、对应条目仍存在时才恢复它。原先没有显式关联时，比较后恢复关联文件备份；凭空指定一个应用不等于恢复继承。

通过 Remove → Web App 用唯一名称删除测试条目。删除入口不会删除网站账号、浏览器 Cookie 或正在运行的窗口。只恢复改过的绑定，或比较备份。然后重复网址、按键、PDF 和 Web App 测试，每项验证不同路径。

继续阅读窗口规则、应用外观与应用管理。本文核对了资料，流程未在真实 Omarchy 安装执行。