Skip to content

PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.

3.0 KB
Raw Blame

M-1 Spike:验证 macOS 剪贴板的两个致命假设

隔空贴的「纯懒模式」(复制时不传输,对端按下粘贴键才回源拉取)在技术上 只能通过剪贴板的延迟渲染(promise)机制实现——操作系统不提供「剪贴板被读取」 的通知,promise 回调是唯一能感知「对方按下了 Cmd+V」的时机。

这两个 spike 验证该路径是否真的走得通。若假设不成立,整个架构需要重新设计。

本机环境:macOS 15.7.3 (Sequoia) · Apple clang 17.0.0 · Xcode 26.x


Spike A — 剪贴板读取的隐私提示(privacy/)

要验证什么:macOS 15 Sequoia 起,App 以编程方式读取其他 App 放入剪贴板的内容时, 系统会弹出「"某某" 想要从其他 App 粘贴」的确认框。隔空贴的 daemon 需要持续监听剪贴板, 如果每次复制都弹窗,产品直接不可用。

分阶段探测,逐级判断哪一步触发提示:

阶段 操作 预期
1 读 changeCount 应不触发(只是个计数器)
2 读 pasteboard.types 应不触发(只是类型列表)
3 detectPatternsForPatterns: (macOS 14+) 官方宣称不触发,用于"窥探但不读取"
4 读 public.file-url 的实际内容 很可能触发 ← 这是我们真正需要的

成败判据:

  • 阶段 1/2 不触发 → 至少「感知到剪贴板变了」是免费的
  • 阶段 4 触发但选「每次都允许」后永久静默 → 可接受,首次引导用户授权一次
  • 阶段 4 每次都弹且无法永久授权 → 架构需调整(改为用户主动触发同步,而非自动监听)

Spike B — NSFilePromiseProvider 的实际可用性(promise/)

要验证什么:把 file promise 放进剪贴板后,目标 App 粘贴时能否正确触发回调、 回调里能否异步延迟数秒(模拟跨网络拉取)而不被系统超时杀掉。

程序把一个 promise 写进剪贴板,delegate 回调里先 sleep 5s 再写文件, 然后你去各个 App 里 Cmd+V,观察终端日志和 App 行为。

成败判据:

  • Finder 能粘出文件、显示进度条、不超时 → 核心路径成立
  • 5 秒延迟被杀 → 需要缩短首字节时间,或改为预落盘
  • 大量常用 App 不支持 promise → 需要对这些 App 降级为「先落盘再给路径」

兼容性矩阵(在 results.md 里填写实测结果): Finder / 微信 / 飞书 / Mail / VS Code / 钉钉 / Safari 上传框 / 终端拖拽区


运行

./build.sh

编译产物是两个 .app bundle(不是裸命令行工具)。这点很重要:macOS 的 TCC 隐私机制 以 bundle identifier 为授权主体,裸二进制的提示行为与真实 App 不一致,测出来的结论不可用。

./build/SpikeA.app/Contents/MacOS/SpikeA    # 前台运行看日志
./build/SpikeB.app/Contents/MacOS/SpikeB

两个程序都在前台打印日志,Ctrl+C 退出。