这是一个运行在浏览器里的 FC/NES 模拟器工程:前端使用 Vue 3 + Vite + TypeScript,核心实现包含 CPU(6502)、PPU(带简化渲染器)、APU(WebAudio 输出)、以及多个常见/国产卡带 Mapper。

本工程不附带任何 ROM。请仅使用你拥有合法授权的 ROM 进行测试。

• Web 端运行:WebGL2 视频输出,WebAudio(AudioWorklet)音频输出
• CPU:6502 指令执行 + IRQ/NMI(并提供调试计数)
• PPU:寄存器语义、vblank/NMI 时序、简化渲染器
  • 支持按扫描线捕获并回放部分 PPU/Mapper 状态,用于近似中断/中帧效果
• APU:基础声道与常见音效路径修正(持续完善中)

当前已实现/接入的 Mapper(以 iNES mapper number 表示):

• 0(NROM)
• 1(MMC1)
• 2(UxROM)
• 3(CNROM)
• 4(MMC3)
• 16(Bandai FCG)
• 19(Namco 163)
• 67(Sunsoft-3)
• 74(MMC3 兼容变种)
• 90(J.Y. ASIC / JyCompany)

说明:不同 ROM/盗版板会存在"同 mapper 号但行为不同"的情况;工程里会对部分变种做兼容性容错。

npm install

npm run dev

npm run build

• 页面中包含调试信息面板:
  • CART:mapper/mirroring/PRG/CHR 等信息
  • CPU:PC/寄存器/IRQ-NMI 服务计数/IRQline
  • PPU:PPUCTRL/PPUMASK/PPUSTATUS、滚动信息、OAM DMA 统计等
  • 部分 mapper 会额外输出 mapper 内部寄存器/IRQ 状态,便于定位兼容性问题

• src/emulator:模拟器核心(CPU/PPU/APU/Bus/Cartridge/Mapper)
• src/emulator/cart/mappers:各类 Mapper 实现
• src:前端 UI(Vue)

• 该 PPU 渲染器为"简化实现",用于兼容大量游戏的常见路径,但并非 cycle-accurate。
• 部分依赖精确 PPU 取数/中帧滚动/特殊板逻辑的 ROM 可能仍存在图形或 HUD 异常,需要逐 ROM 调试完善。

• 继续提升兼容性(尤其是滚屏/HUD/特殊板)
• 规划并实现一套更正式的 UI(ROM 管理、快捷键/手柄、保存状态、调试视图等)