Cocoa-Way 最新版

Cocoa-Way 是一款创新的 macOS 原生 Wayland 合成器，打破操作系统的边界，让你在 Mac 上无缝、低延迟、高 DPI地运行 Linux 应用程序。

不同于传统的虚拟机（VM）或远程桌面方案，Cocoa-Way 不模拟整个操作系统，而是通过 Unix 套接字直接利用 Wayland 协议，将 Linux 应用的图形界面“流式传输”到 macOS 的原生窗口中。这意味着你可以像在本地一样使用 Firefox、VS Code 或任何 Linux GUI 应用，享受 Retina 屏幕的清晰度和原生窗口的流畅体验。

核心优势：为什么选择 Cocoa-Way？

1. 真正的低延迟与零虚拟化

• 协议级直连：通过 waypipe-darwin 和 Unix 套接字，直接传输 Wayland 协议指令，而非像素帧。这消除了传统 VNC 或 X11 转发的高延迟和带宽消耗。
• 无 VM 开销：不需要启动沉重的 Linux 虚拟机图形界面。只要你能通过 SSH 连接到 Linux 主机（如 OrbStack、WSL2、远程服务器），就能运行应用。

2. 原生 macOS 体验

• HiDPI / Retina 完美支持：专为 Mac 的 Retina 显示屏优化，文字和图标清晰锐利，告别传统远程方案的模糊感。
• 原生窗口装饰：Linux 应用会以独立的 macOS 窗口形式呈现，拥有精致的阴影、焦点指示器和标准的红绿灯控制，完美融入 Mac 桌面环境。
• OpenGL 硬件加速：利用 Mac 的 GPU 进行高效渲染，确保动画流畅。

3. 极简架构

• 轻量级：只是一个合成器客户端，不包含复杂的虚拟化层。
• 灵活部署：既可以在本地 OrbStack 容器中运行，也可以连接远程 Linux 服务器。

方案对比

注意：目前版本主要针对 HiDPI 优化，但在极高分辨率下的远程连接延迟仍有提升空间。未来计划提供多种显示模式以适应不同场景。

安装指南

方法一：Homebrew (推荐)

最快捷的安装方式，自动处理依赖。

# 添加仓库
brew tap J-x-Z/tap

# 安装 Cocoa-Way 和必要的 Waypipe 组件
brew install cocoa-way waypipe-darwin

方法二：下载二进制文件

访问项目的 GitHub Releases 页面，下载最新的 .dmg 或 .zip 安装包。

方法三：从源码构建

适合开发者或需要最新特性的用户。
需安装 Rust (Cargo) 和基础依赖。

# 安装依赖
brew install libxkbcommon pixman pkg-config

# 克隆并编译
git clone https://github.com/J-x-Z/cocoa-way.git
cd cocoa-way
cargo build --release

# 二进制文件位于 target/release/cocoa-way

⚡ 快速开始

前置要求

必须安装 waypipe-darwin 才能建立连接：

brew install waypipe-darwin

步骤 1：启动合成器

在终端运行：

cocoa-way

此时会启动一个空的合成器环境，等待连接。

步骤 2：连接并运行 Linux 应用

使用提供的脚本或手动命令，通过 SSH 将 Linux 应用“投射”过来。

示例：运行 Firefox

# 假设你已配置好 SSH 免密登录到 Linux 主机 (或 OrbStack)
./run_waypipe.sh ssh user@linux-host firefox

原理：
该命令会在远程主机上启动 waypipe 服务端，并将 Wayland 显示流量通过 SSH 隧道转发到本地的 cocoa-way 合成器。几秒钟后，Firefox 窗口就会像原生应用一样出现在你的 Mac 桌面上。

典型应用场景

1. OrbStack 用户：
   OrbStack 是 macOS 上轻量级的 Linux 容器/虚拟机方案。配合 Cocoa-Way，你可以直接在 Mac 桌面上运行 Linux 版的 Docker 管理工具、IDE 或测试应用，无需切换上下文。
2. 远程开发：
   连接公司的 Linux 开发服务器，运行重型 GUI 工具（如 Matplotlib 绘图、Qt 调试器），享受本地般的流畅度，且不受网络带宽限制（因为传输的是协议指令而非视频流）。
3. 跨平台测试：
   在不安装完整虚拟机的情况下，快速启动 Linux 应用进行兼容性测试或截图。

未来展望

Cocoa-Way 目前处于早期阶段，但潜力巨大：

• 多显示模式：计划引入两种显示模式，以平衡极致清晰度与远程连接的低延迟需求。
• 更完善的输入支持：进一步优化键盘映射、剪贴板共享和拖拽功能。
• 生态整合：探索与更多 macOS 原生特性（如通知中心、快捷键）的深度集成。