跨平台协同
Seamless
让 Mac 和 Windows 像一台机器那样协作:把对端的运行中应用镜像到自己的 Dock 上,点一下就在对端按任务栏语义执行。局域网内双向实时同步。
- 平台
- macOS + Windows
- 形态
- monorepo(两端 + 契约 + 联调工具)
- 进度
- 两端 MVP 完成,待实机联调
- 仓库
- 私有
01要解决的问题
两台机器并排放在桌上时,人脑里其实只有「一个桌面」。但操作系统不这么认为:Mac 的 Dock 里没有 Windows 的窗口,Windows 的任务栏也不知道 Mac 上开着什么。来回找窗口、切输入设备,一天要打断几十次。
Seamless 先做其中最容易见效的一块:远程 Dock。把对端的「运行中应用 + 任务栏固定项」镜像成本端的代理图标;点代理图标,就在对端模拟一次任务栏点击——激活、最小化、多窗口切换,没运行就从固定项启动。
02先定契约,再写两端
跨端项目最容易死在「各写各的」上。所以第一件事不是写代码,是把窗口状态契约写成文档(docs/protocol/contract.md),并且明确它是两端唯一事实来源:改契约必须两端同步,不允许某一端偷偷加字段。
- Mac 端:Swift / SwiftUI,SPM 组织。协议编解码 → 状态仓库 → WS 客户端 → 会话管理 → 动态代理 Dock 图标 → 连接页,一条链打通。
- Windows 端:C#,由 Windows 侧开发者实现(PR 合入),64 个单测通过。
- 联调:
tools/mock_ws_server.py按契约起一个假服务端,握手 / 认证 / 快照 / 指令全链路可以先在单机上验完,不用等两台机器就位。
03取舍
更早的一版尝试过更激进的方向:窗口串流 + 键鼠共享,Windows 端用 NVENC 硬编 H.264。技术上能跑,但复杂度是远程 Dock 的好几倍,而且任何一端的窗口管理 API 一变就要重调。所以这一版主动收窄——先把「状态同步 + 点击语义」这件小事做到可靠,再谈画面。
这也是我目前最认同的工程习惯:把能独立验证的一小块做到闭环,比把五块都做到 70% 有用。
04现在
契约 v1 定稿,两端 MVP 与单机联调都跑通;剩下的是真实两台机器的实机联调——包括 command.activate / command.ack 的回流路径。这一段必须在真设备上过,mock 替代不了。