Yojam如何捕获macOS上8大链接入口:默认浏览器、Handoff、AirDrop全解析
Yojam如何捕获macOS上8大链接入口:默认浏览器、Handoff、AirDrop全解析
Yojam 是一款 macOS 链接路由工具:把它设为默认浏览器后,它能在 8 种链接入口(默认浏览器点击、Finder 文件、Handoff、AirDrop、分享菜单、服务菜单、浏览器扩展、yojam:// 协议)截获链接,再按规则或快捷选择器把链接送进正确的浏览器、配置文件或 App。
为什么需要"链接路由器"?
你一定遇到过这种场景:在 Slack 里点了个链接,却弹到了 Safari——可你登录的工作账号在 Chrome 的第三个配置文件里;或者 Figma 链接根本不该开浏览器,而该打开桌面 App。
Yojam 的思路是:不做选择器,而是做"中间人"。它把自己注册为 macOS 的链接入口,所有链接先经过统一的规则引擎(改写 → 去追踪参数 → 规则匹配 → 打开或弹出选择器),没有"二等公民"式的入口处理。
小提示: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:
- 只认领
NSUserActivityTypeBrowsingWeb类型的接力活动 - 打上来源标记
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/mailtobrowser:指定目标浏览器,跳过规则pick=1:强制弹出选择器private=1:用隐私窗口打开
协议解析逻辑见 YojamCommand.swift。比如写一条快捷指令:取"复制的文本" → 打开 yojam://route?url= 拼接后的 URL,剪贴板里的链接立刻可路由。
8 大入口殊途同归:同一套规则引擎
所有入口在 IngressOrigin.swift 中都有对应的来源枚举(defaultHandler、fileOpen、handoff、airdrop、shareExtension、servicesMenu、各浏览器扩展、urlScheme 等)。无论链接从哪里来,都走同一条流水线:
- 全局改写(正则查找替换)
- 追踪参数清洗(
utm_source、fbclid、gclid等 30+ 参数) - 规则匹配(域名/前缀/正则/来源 App,首条命中生效)
- 按浏览器的改写
- 立即打开,或在你光标处弹出选择器
选择器支持 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。
