Finicky项目中处理Brave浏览器PWA链接的技术方案

背景介绍

Finicky是一款macOS上的智能浏览器选择工具，可以根据预设规则自动将不同类型的网页链接分配到不同的浏览器打开。但在实际使用中，用户发现通过Brave浏览器创建的PWA(渐进式Web应用)中的链接无法被Finicky正确捕获和处理。

问题现象

当用户通过Brave浏览器安装PWA应用(如Proton Mail邮件客户端)后，点击PWA中的任何链接时，Finicky无法检测到这些URL请求。相比之下，通过Safari浏览器安装的相同PWA应用中的链接则能被Finicky正常处理。

技术分析

Brave PWA的特殊性

Brave浏览器基于Chromium内核，其PWA实现有以下特点：

1. 独立的Bundle ID：每个PWA应用都有独特的Bundle ID，格式为com.brave.Browser.app.随机字符串
2. 内部链接处理机制：Chromium内核浏览器会优先在应用内部处理HTTP/HTTPS协议链接
3. 应用隔离：PWA应用与主浏览器进程隔离，导致系统级URL处理机制无法捕获其链接

传统解决方案的局限性

常见的Finicky配置方法如匹配opener.bundleId在这种情况下无效，因为：

1. 系统根本不会将链接事件传递给Finicky
2. PWA应用内部实现了自己的链接处理逻辑
3. Chromium内核的沙盒机制阻止了外部干预

可行的技术方案

方案一：使用特定启动参数

对于已知目标URL的应用(如Google Meet)，可以通过Finicky直接启动PWA并传递URL参数：

{
  match: finicky.matchHostnames(["meet.google.com"]),
  browser: ({ urlString }) => ({
    name: "com.brave.Browser",
    profile: "Default",
    args: [
      '--app-id=kjgfgldnnfoeklkmfkjfagphfepbbdan',
      `--app-launch-url-for-shortcuts-menu-item=${urlString}`
    ],
  }),
}

其中app-id是PWA应用在Brave中的内部标识符，可通过Bundle ID最后部分获取。

方案二：使用JavaScript重定向

对于需要处理任意链接的场景，可以考虑：

1. 书签脚本：创建包含JavaScript代码的书签，点击后重写当前URL
2. 浏览器扩展：安装能够修改链接行为的扩展程序
3. 用户脚本：使用TamperMonkey等工具注入脚本修改页面所有链接

示例书签脚本代码：

javascript:var url=window.location.href;var op='?%27;if(window.location.search){op='%27&%27;}url=url+op+%27finicky=brave%27;url=url.replace(window.location.protocol,%27finicky:%27);window.location.href=url;

方案三：使用中间件工具

可以考虑使用Browserosaurus等中间件工具作为替代方案，这类工具通常有更完善的PWA支持。

最佳实践建议

1. 对于特定服务(如Google Meet)，优先使用方案一的直接启动方式
2. 对于邮件客户端等需要处理多种链接的场景，考虑方案二中的浏览器扩展方案
3. 如果以上方案均不适用，暂时使用Safari生成的PWA可能是最稳定的选择
4. 关注Finicky v2版本的更新，预计会改进对PWA的支持

技术展望

随着PWA应用的普及，浏览器厂商和工具开发者需要更好地协作解决这类系统集成问题。未来可能的改进方向包括：

1. 标准化的PWA链接处理API
2. 浏览器提供更细粒度的链接处理控制
3. 操作系统层面对PWA的更好支持

目前，开发者需要根据具体使用场景选择最适合的变通方案。