Yojam如何捕获macOS上8大链接入口:默认浏览器、Handoff、AirDrop全解析

原创2026-10-28 21:15:021,901 阅读

Yojam如何捕获macOS上8大链接入口:默认浏览器、Handoff、AirDrop全解析

Yojam 是一款 macOS 链接路由工具:把它设为默认浏览器后,它能在 8 种链接入口(默认浏览器点击、Finder 文件、Handoff、AirDrop、分享菜单、服务菜单、浏览器扩展、yojam:// 协议)截获链接,再按规则或快捷选择器把链接送进正确的浏览器、配置文件或 App。

macOS链接路由工具Yojam的标识,支持默认浏览器、Handoff、AirDrop等8大链接入口

为什么需要"链接路由器"?

你一定遇到过这种场景:在 Slack 里点了个链接,却弹到了 Safari——可你登录的工作账号在 Chrome 的第三个配置文件里;或者 Figma 链接根本不该开浏览器,而该打开桌面 App。

Yojam 的思路是:不做选择器,而是做"中间人"。它把自己注册为 macOS 的链接入口,所有链接先经过统一的规则引擎(改写 → 去追踪参数 → 规则匹配 → 打开或弹出选择器),没有"二等公民"式的入口处理。

macOS链接分发工具Yojam的Logo图片

小提示:Yojam 只在菜单栏显示,没有 Dock 图标,不抢 Cmd+Tab,存在感极低但无处不在。

准备工作:安装并设为默认浏览器

所有入口的根基都是"注册"。Yojam 通过 DefaultBrowserManager.swift 同时注册 URL 协议(http/https/mailto)和文件类型(.html/.webloc 等)。

安装方式(Homebrew):

brew install --cask yojam

首次启动时 Yojam 会请求成为默认浏览器——同意,这是它捕获一切链接的前提。

入口1:默认浏览器路径(所有 App 的链接点击)

🖱️ 覆盖范围:任意 App 中点击 http/https 链接。

Yojam 在 AppDelegate.swift 中很早就注册了 Apple Event 处理器:

  • 监听 kAEGetURL 事件(macOS 打开默认浏览器链接的标准方式)
  • 冷启动期间到达的 URL 会先进入队列,防止启动瞬间丢失链接

这是使用频率最高的入口:Slack、邮件、终端输出里的链接,全都走这里。

入口2:Finder 中的链接文件

📂 覆盖范围:.html、.xhtml、.webloc、.inetloc、.url 文件。

双击这些文件时,macOS 会把"打开文件"事件交给 Yojam。IncomingLinkExtractor.swift 负责"拆包":

  • .webloc / .inetloc:读取内部 plist,取出真正的 URL
  • .url:兼容 Windows 风格链接快捷方式
  • 任意超过 64KB 的"链接文件"会被直接拒绝,防止异常输入

入口3:Handoff(跨设备接力)

📱 覆盖范围:在 iPhone/iPad 上浏览的网页,继续到 Mac。

实现见 AppDelegate.swift:

  1. 只认领 NSUserActivityTypeBrowsingWeb 类型的接力活动
  2. 打上来源标记 com.yojam.source.handoff,交给规则引擎

实用玩法:写一条规则"来源 = com.yojam.source.handoff → 打开到工作配置文件",手机上浏览的网页接力到 Mac 时自动进入工作环境。这些来源标记定义在 SourceAppSentinel.swift。

入口4:AirDrop 的 .webloc 文件

✈️ 覆盖范围:别人 AirDrop 给你的链接。

AirDrop 传链接时实际传的是 .webloc 文件。Yojam 在 AppDelegate.swift 中做了精确判断:

  • 来源进程是 com.apple.sharingd(系统分享守护进程)→ 标记为 AirDrop
  • 其他情况的双击 .webloc → 按普通文件打开处理

两种情况都先"拆包"还原真实 URL 再路由,全程透明。

入口5:macOS 分享菜单

📤 覆盖范围:Safari、备忘录、邮件、访达、提醒事项、照片等支持分享面板的 App。

Yojam 自带 Share Extension(ShareViewController.swift),在分享菜单中显示"Open in Yojam",点一下即静默转发。

启用方法:系统设置 → 隐私与安全性 → 扩展 → 共享,打开 Yojam 开关。

入口6:服务菜单(Services)

🔗 覆盖范围:任意 Cocoa App 中选中的 URL 文本。

高亮 URL → 右键 → 服务 → "Open in Yojam"。入口实现位于 AppDelegate.swift 起的服务菜单部分。

进阶玩法:在"系统设置 → 键盘 → 键盘快捷键 → 服务"里为它绑定一个全局快捷键,选中 URL 后一按即路由,比鼠标快得多。

入口7:浏览器扩展(Safari / Chrome / Firefox)

🧩 覆盖范围:浏览器当前标签页、右键菜单。

Yojam 为三大浏览器提供扩展,统一能力:

能力 操作
工具栏按钮 点击把当前标签页送给 Yojam
右键菜单 "Open Link in Yojam" / "Open Page in Yojam"
快捷键 Alt+Shift+Y 发送当前标签页
  • Safari:Safari → 设置 → 扩展,直接启用
  • Chrome/Brave/Edge:加载 Extensions/dist/yojam-chrome.zip,Native Messaging Host 首次启动自动安装
  • Firefox:安装 Extensions/dist/ 下的 .xpi

扩展源码见 Extensions/shared/。

入口8:yojam:// URL 协议

⚙️ 覆盖范围:快捷指令、Raycast、Alfred、Shell 脚本等一切自动化场景。

yojam://route?url=<percent-encoded>&source=<bundle-id>&browser=<bundle-id>&pick=1&private=1

常用参数:

  • url(必填):目标 URL,必须是 http/https/mailto
  • browser:指定目标浏览器,跳过规则
  • pick=1:强制弹出选择器
  • private=1:用隐私窗口打开

协议解析逻辑见 YojamCommand.swift。比如写一条快捷指令:取"复制的文本" → 打开 yojam://route?url= 拼接后的 URL,剪贴板里的链接立刻可路由。

8 大入口殊途同归:同一套规则引擎

所有入口在 IngressOrigin.swift 中都有对应的来源枚举(defaultHandler、fileOpen、handoff、airdrop、shareExtension、servicesMenu、各浏览器扩展、urlScheme 等)。无论链接从哪里来,都走同一条流水线:

  1. 全局改写(正则查找替换)
  2. 追踪参数清洗(utm_source、fbclid、gclid 等 30+ 参数)
  3. 规则匹配(域名/前缀/正则/来源 App,首条命中生效)
  4. 按浏览器的改写
  5. 立即打开,或在你光标处弹出选择器

选择器支持 1-9 数字键直达、方向键选择、Cmd+C 复制 URL,键盘党福音。

常见问题快速排查

症状 解法
Handoff 链接不出现 确认 Yojam 是默认浏览器,且系统设置 → 通用 → AirDrop 与接力已开启
分享菜单里没有 Yojam 系统设置 → 隐私与安全性 → 扩展 → 共享 中启用
AirDropped 的链接落在访达 在 偏好设置 → Integrations 中设置 Yojam 为 .webloc 默认处理器
浏览器扩展按钮无反应 偏好设置 → Integrations → "Reinstall Browser Helpers" 一键修复

所有入口的健康状态都能在 偏好设置 → Integrations 面板里一屏查看,每项都有修复按钮。

小结

入口 触发方式 来源标记示例
默认浏览器 任意 App 点链接 真实来源 App
Finder 文件 双击 .html/.webloc 真实来源 App
Handoff iPhone/iPad 接力 com.yojam.source.handoff
AirDrop 接收 .webloc com.yojam.source.airdrop
分享菜单 Share Extension com.yojam.source.share-extension
服务菜单 选中 URL 右键 com.yojam.source.service
浏览器扩展 按钮/右键/Alt+Shift+Y com.yojam.source.*-extension
URL 协议 yojam://route com.yojam.source.url-scheme

Yojam 的价值就在于"捕获得全 + 处理得统一":入口越多,规则越值钱。配好规则后,它 90% 的时间是隐形的——链接自动落在它该去的地方;剩下的 10%,光标处的选择器随时待命。更多细节可参阅 README.md 与 IntegrationsTab.swift。

登录后查看全文
yojam