puNES：NES 模拟器与 NSF 音乐播放器

项目简介

puNES 是一个基于 Qt 的 Nintendo Entertainment System（NES）模拟器，同时也是一个 NSF/NSF2/NSFe 音乐播放器。项目以 C 与 C++ 编写，可运行在 Linux、FreeBSD、OpenBSD 和 Windows 上，采用 GPL-2.0 许可证。

主要功能

• NES 模拟：支持 Famicom Disk System（FDS）、Quick Disk 格式，README 中列出了数百个受支持的 mapper 编号（覆盖 0–564 区间内的大量编号）以及一长串 UNIF boards。
• 音乐播放：可作为 NSF/NSF2/NSFe 播放器使用，v0.111 重写了 NSF 播放器并新增 NSF2 格式支持。
• 图形后端：Windows 上可选 OpenGL 或 Direct3D 9。
• 视频滤镜设置、作弊编辑器（Cheat Editor）、存档状态、快进（带屏幕图标提示）、PPU 超频（可按游戏设置，也可为所有 ROM 设置默认值）。
• 手柄与快捷键：支持 Xbox360、PS4 等标准手柄配置，并可在命令行中配置快捷键与 NES 手柄。
• 虚拟键盘：Family BASIC 与 Subor 虚拟键盘。
• RAM 初始化可选 0x00、0xFF（默认）或随机。
• 多语言界面：阿拉伯语、中文、英语、法语、德语、匈牙利语、意大利语、波兰语、葡萄牙语、俄语、西班牙语、土耳其语。

安装与使用

Linux 用户可通过 Flathub 获取：https://flathub.org/apps/details/io.github.punesemu.puNES

README 还提供了始终跟随最新提交的 WIP 构建下载（nightly.link 链接）：Linux x86_64 AppImage、Windows 32 位（OpenGL / D3D9）、Windows 64 位（OpenGL / D3D9）。

便携模式有三种启用方式：

1. 可执行文件所在目录中存在 puNES.cfg 文件。
2. 给可执行文件名加上 _p 后缀，例如 punes.exe → punes_p.exe、punes64.exe → punes64_p.exe。
3. 以 --portable 选项启动模拟器。

查看可用命令行选项：以 -h 参数启动 puNES。

从源码编译使用 CMake，README 给出了 Linux、FreeBSD、OpenBSD、Windows 的编译说明，并提供 ENABLE_OPENGL、ENABLE_FFMPEG、ENABLE_QT5_LIBS、DISABLE_PORTABLE_MODE 等构建选项。

注意事项

• v0.111 重写了存档状态格式，0.110 及更早版本的存档状态不再兼容。
• WIP 构建对模拟器内核做了大量改动，可能引入新问题；如果发现 ROM 相比 0.110 运行异常，可以向项目反馈。
• Windows 32 位版本兼容 Windows XP。

本作品整理自 GitHub 开源项目 punesemu/puNES，原作者 @punesemu，许可证 GPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。