# Caipirinha

开发中.

Caipirinha 是一款面向 Apple Silicon Mac 的应用，无需任何设置即可运行 Windows 游戏。它会创建 Wine 容器，安装 Windows 版 Steam，选择把 DirectX 转换为 Metal 的转换层（例如 DXVK 或 Apple 的 D3DMetal），并为每次运行保存日志。它需要 macOS 14 或更高版本以及 Rosetta 2，并且从不重新分发 Steam，官方安装程序直接来自 Valve。我在 2026 年 10 月开始用 Rust 开发 Caipirinha，代码还没有公开。

## 基本信息

- 系统: macOS
- 创建于: 2026-10-29
- 技术栈: Rust, Wine, DXVK, D3DMetal, AppKit, React
- 作者: Antonio Leandro (https://linkedin.com/in/tonho)

## Caipirinha 能做什么？

### 你的 Steam，开箱即用

一个按钮即可下载 Wine、创建容器、安装 Windows 版 Steam 并导入 Mac 上的 Steam 账号。游戏库直接列出你的游戏，并标明哪些能运行。

### 每款游戏一套设置

每款测试过的游戏都有一份配置，说明它在 Mac 上的运行情况和应使用的图形后端。点击开始游戏时，Caipirinha 会自动套用。

### 可一键修复的容器

每个容器都是 Mac 里一个独立的 Windows，图形转换层由你选择，例如 DXVK 或 D3DMetal。“保持现状”会保存快照，“修复 Steam”能回到最新快照，不影响游戏。

### 诊断与日志

检查 Mac、Rosetta、磁盘空间、运行时和容器。Wine 和 DXVK 只从带 sha256 校验的清单下载，每次运行都会留下日志。

### 无需再次登录即可开玩

只要 Mac 上的 Steam 已登录账号，无需登录 Windows 版 Steam 也能点“开始游戏”。游戏直接在 Wine 中打开，Mac 上的 Steam 会显示你正在游戏并累计时长。成就和云存档仍需通过容器里的 Steam。

### 使用你自己的 Game Porting Toolkit

Apple 的许可不允许 Caipirinha 分发 D3DMetal（它负责把 DirectX 12 转换为 Metal）。你可以在 Apple 网站免费下载 Game Porting Toolkit，然后在“设置”里选择 .dmg 文件。Caipirinha 只从中复制需要的文件。

### 手柄或键盘操作

手柄的方向键或键盘的方向键可把焦点移到屏幕上最近的项目。A 键确认，B 键返回，相当于 Enter 和 Esc。按钮、筛选和游戏列表都支持。

聊聊吧: tonhowtf@gmail.com