Dusk Light
返回 Dusk Light 下载区
NEW

在 macOS 设置 Dusk Light

M 系列 Mac 使用 Apple silicon zip，Intel Mac 使用 x86_64 zip。下载后从解压出的 app 启动 Dusklight，再选择自己的受支持 GameCube 转储。下面的说明会覆盖 Gatekeeper、Metal、文件校验和 macOS 常见问题。

最后核对: 2026-06-16，对照 GitHub v1.3.1

选择正确的 macOS 构建

官方 v1.3.1 release 提供两个 macOS 归档：Apple silicon 使用 Dusklight-v1.3.1-macos-arm64.zip，Intel 使用 Dusklight-v1.3.1-macos-x86_64.zip。官方 README 说明 Dusklight 需要 D3D12、Vulkan 或 Metal 之一的图形后端；在 macOS 上实际就是 Metal 路线。README 同时明确不提供受版权保护的游戏资产，目前支持 GameCube USA 与 EUR 转储。

安装步骤

  1. 01下载与你 Mac 匹配的 macOS 构建：Apple silicon 用 ARM64，Intel Mac 用 x86_64。也可以用 Homebrew：brew install dusklight。
  2. 02如果下载的是 zip，双击解压得到 Dusklight.app。
  3. 03把 Dusklight.app 移到 Applications，或直接从解压目录启动；如果 macOS 阻止首次启动，用 Finder 右键 Open。
  4. 04打开 Dusklight，选择 Select Disc Image，选中你自己的 GameCube USA 或 EUR 转储。

开始前检查

Apple silicon 或 Intel

M1/M2/M3 及更新芯片使用 arm64 zip，Intel Mac 使用 x86_64 zip。不要因为一次启动失败就随意换架构。

Metal 支持

macOS 路线依赖 Metal。旧 Intel iGPU 或通过补丁运行新系统的 Mac，更应先看 issue 再安排长时间游玩。

自己的支持转储

Dusklight 不提供版权资产。支持输入仍是个人拥有的 GameCube USA 或 EUR 转储。

官方文件大小

v1.3.1 中 Apple silicon zip 为 27.6 MB，Intel zip 为 29.3 MB。文件名或大小明显不对时先回到 GitHub。

校验 macOS 归档

macOS 首次运行时容易被 Gatekeeper 提示打断。更稳妥的做法是先确认下载来源，再决定是否批准打开。

校验 Apple silicon zip

shasum -a 256 ./Dusklight-v1.3.1-macos-arm64.zip

在下载目录运行，可与 GitHub release asset metadata 中的 SHA-256 记录对比。

校验 Intel zip

shasum -a 256 ./Dusklight-v1.3.1-macos-x86_64.zip

Intel Mac 用户用这一条，避免后续更新时混淆 arm64 与 x86_64。

查看 Gatekeeper 状态

spctl --assess --verbose ./Dusklight.app

解压后可用于理解 macOS 为什么提示批准，但它不能替代来源校验。

macOS 注意事项

  • M 系列 Mac 使用 Apple silicon，Intel Mac 使用 x86_64。
  • Gatekeeper 批准前先确认文件来自官方 GitHub release。
  • Metal 支持是实际硬件要求的一部分。
  • 不要把游戏转储放进 app bundle，避免更新时混乱。
  • Dusk Light 不托管 ROM、ISO、光盘镜像或版权资产。

其他官方构建

继续查看同语言平台指南

在当前语言中切换到其他 Dusk Light 安装页面，比较文件大小、更新时间和平台限制。

Windowsv1.3.1 · 35.3 MBmacOSv1.3.1 · 27.6 MB当前页面Linuxv1.3.1 · 31.6 MBSteam Deckv1.3.1 · 31.6 MBAndroidv1.3.1 · 50.8 MBiOSv1.3.1 · 26.1 MB

v1.3.1 变化

Released May 27, 2026

本页核对时最新版本为 v1.3.1。旧教程仍可能提到 Dusk 或 v1.0 时代文件名。

配置保存与加载

v1.3.1 修复了 config saving and loading 相关问题，排查 macOS 设置异常前应先更新。

崩溃日志改进

发布说明提到 improved crash reporting in log files。报告 macOS 崩溃时，当前版本日志比截图更有价值。

macOS issue 追踪 notes

Issue #826: Metal 启动崩溃

Open

该报告描述了 RenderPipelineMTL / Metal pipeline 创建阶段的 macOS 启动崩溃，适合作为旧图形硬件兼容风险证据。

打开来源

Issue #1715: 键盘绑定

Open

该报告提到 Return、Shift 等键绑定到游戏按钮时不工作，长时间游玩前应先测试输入。

打开来源

Issue #1717: WUP-028 转接器

Open

报告称 Wii U GameCube adapter 在 Dolphin 可用但 macOS Dusklight 构建中不可用，应提前验证手柄路径。

打开来源

Issue #1832: Hidden Village 崩溃

Open

该 macOS 报告记录了离开 Hidden Village 时崩溃，并附带日志与视频，可作为稳定性排查案例。

打开来源

本 macOS 指南使用的来源

官方 GitHub 仓库用于核对支持版本、硬件要求和版权边界。官方 v1.3.1 release用于核对 macOS 文件名、大小、发布时间和修复说明。Issue #826 / #1715 / #1717 / #1832用于 macOS Metal、键盘、转接器与崩溃风险说明。

事实来源

这里列出的所有文件都指向官方 TwilitRealm/dusklight GitHub release 资产。Dusk Light 不镜像二进制文件，也不托管受版权保护的游戏数据。