# SwitchWakerHD：《风之杖 HD》重编译的 Nintendo Switch 移植

> 将 ZeldaWWHDRecomp 对《塞尔达传说 风之杖 HD》的静态重编译以自制软件形式移植到 Nintendo Switch，新增 libnx 平台层和以 deko3d 绘制游戏 GX2 图形的渲染器，转换后的着色器在主机上由 uam 编译。游戏代码由使用者自己的 Wii U 转储在本地重编译生成，因此不发布 Switch 版二进制。README 报告游戏在默认频率下于掌机和底座模式均可游玩，其自测帧率为 26–30 fps，并说明几乎全部 Switch 移植工作由 Claude Code 在人工指导和实机测试下编写。

- 类型：案例
- 目标：游戏
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-19
- 收录于：2026-11-09
- 原始资源：<https://github.com/centollOS/SwitchWakerHD>
- 一手来源：<https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/switchwakerhd-switch-port-case/>
- 记录 JSON：<https://awesomerea.org/resources/switchwakerhd-switch-port-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/switchwakerhd-switch-port-case/index.md)

## 使用条件与局限

- 需要使用者自己的 Wii U 美版或欧版游戏转储，版本 0、不含更新。光盘提取需要光盘密钥和 Wii U 通用密钥；运行时检查 code/cking.rpx。由转储构建的 NRO 文件和着色器缓存含游戏内容，不得分享。
- 构建需要 Python 3 与 pycryptodome，并在 Docker 或 Podman 中使用 devkitpro/devkita64，或在 Windows 上使用原生 devkitPro。游戏需在装有 Atmosphère 和 Homebrew Menu 的 Switch 上以标题模式启动，确保足够内存。生成的代码在逐文件编译时需要大量内存。
- 项目报告在默认频率下可于掌机和底座模式游玩，测得约 26–30 fps，支持声音、存档、即时存档和模组。测试主要覆盖开场岛屿、龙之岛及周边海域；已知问题见 docs/switch-port.md。CI 用占位客体代码测试桌面和 Android 运行时；Switch NRO 在实机上构建和测试。
- 这个分叉保留 ZeldaWWHDRecomp 的桌面和 Android 目标，同时加入 Switch 平台层和渲染器。作者报告 Claude Code 在人工指导和实机测试下完成了几乎全部 Switch 工作。
- 代码采用 MPL-2.0。随附的 Cemu、uam、{fmt}、Dear ImGui、xxHash 和 metal-cpp 保留各自许可证；游戏内容仍归其权利人。

## 一手来源

1. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/README.md>
2. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/INSTALL.md>
3. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/docs/switch-port.md>
4. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/THIRD_PARTY.md>
5. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/.gitmodules>
6. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/.github/workflows/release.yml>
7. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/.github/workflows/linux.yml>
8. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/LICENSE>
9. <https://github.com/centollOS/SwitchWakerHD/releases/tag/v0.4.7>

## 同分区更多条目：游戏

- [Swordigo Vita：Android 可执行文件的 PS Vita 移植](https://awesomerea.org/zh/resources/swordigo-vita-case/index.md) · 案例
- [swos-port：以录制行为校验的 DOS《Sensible World of Soccer》移植](https://awesomerea.org/zh/resources/swos-port-case/index.md) · 案例
- [Tactical-Retreat：用 QuakeC 重建《反恐精英 1.5》玩法](https://awesomerea.org/zh/resources/tactical-retreat-case/index.md) · 案例
- [Test Drive Enhanced：1987 年游戏的 SDL3 移植版](https://awesomerea.org/zh/resources/test-drive-enhanced-case/index.md) · 案例
- [Test Drive III Enhanced：重建赛车游戏的 SDL3 移植版](https://awesomerea.org/zh/resources/test-drive-iii-enhanced-case/index.md) · 案例
- [Test Drive III: The Passion：逆向重建的 SDL3 移植版](https://awesomerea.org/zh/resources/test-drive-iii-sdl3-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。
