# 电视里插卡带：网站上的模拟器

> source: 想法/草稿/电视里插卡带-网站上的模拟器.md

## 问题

> 如果我要加上以前的那种模拟器，可以玩真正的游戏，比如合金弹头，还有自制小游戏运行，怎么做比较好？

## 想做什么

网站上的电视是 CRT，终端是键盘。插一盘卡带，电视就变成游戏机：`play @游戏/<名字>` 开机，按 `q`/`Esc` 退出。和唱片机 `vinyl` 是同一种东西。

## 做法

- **模拟核心**：浏览器里跑 RetroArch 的 WASM 核心。可以用 EmulatorJS（GPL-3，带触屏手柄），也可以用 Nostalgist.js（只要一个 canvas，好塞进 `#stage`）。合金弹头属于 Neo Geo / 街机，用 FBNeo 核心；红白机自制游戏用 FCEUmm 之类的核心。核心有几 MB，只在第一次 `play` 时加载，文件放在 Pi 上自己托管。
- **画面**：游戏 canvas 每秒刷 60 帧，SVG 的 `#crt` 桶形滤镜在上面会很贵。玩游戏时关掉 `#crt`，只留 CSS 的扫描线、暗角和眩光；或者改用核心自带的 CRT shader。
- **按键**：游戏获得焦点后吃掉所有按键，终端不响应。退出要留一个游戏用不到的键，比如长按 Esc。手柄用 Gamepad API；手机上用触屏手柄。
- **存档**：即时存档放在 IndexedDB，只存在玩家自己的浏览器里。
- **声音**：浏览器要求先有一次用户操作才能出声，敲 `play` 那一下就算。

## 版权的线（最关键）

- 合金弹头的 ROM 和 Neo Geo 的 BIOS 都是 SNK 的版权，**不能放在网站上给人下载或运行**。
- 可行的路是「自带卡带」：访客把自己合法拥有的 ROM 文件拖到电视上，只在本地浏览器里运行，不上传。BIOS 也要访客自己提供。
- 网站上真正公开的，只放自制游戏，以及许可证允许再分发的 homebrew。

## 自制小游戏两条路

1. **JS 小游戏**：写成一个模块，接口是「给一块 canvas 和按键，自己跑」，挂在电视里。最快，也最贴合现在的代码；以后还可以写成文章里的一个块。
2. **真卡带**：写成 NES/GB 的 homebrew ROM（用 NESmaker、GB Studio 或者汇编），用同一个模拟器跑。更有「卡带」的感觉，但难很多。TIC-80 这类幻想主机是中间的选择。

## 放在哪

- 根目录新开一个内容形态 `游戏/`：一个游戏一个 `.md`，写名字、核心、操作说明；自制游戏的源码也在这里。
- ROM 二进制和 `media/` 一样不进 git，由部署同步到 Pi。

## 走到哪了

- 2026-11-12：先做了 JS 小游戏。`play` 打开卡带列表 `/play`，`play snow` 插进第一盘「雪花」，q / Esc 拔出来；接口是 `src/games/` 里的 `GAMES` 表加 `mount(box, {best, save})`，游戏那一屏关掉 `#crt` 滤镜。下一步可以在同一个接口后面接模拟器核心。
- 2026-11-12：做成真卡带。雪花用 6502 汇编重写成 NROM-128 的 FC ROM（`site/src/games/fc/snow.s`，cc65 编译），电视里用 jsnes 当主机；最高分写在卡带的电池 RAM，主机存进浏览器。卡带用红白机自己的调色板，不跟网站配色走，这正是真卡带该有的样子。下一盘卡带照同一个路子写；合金弹头这种街机游戏要换 FBNeo 核心，接口要再长一层。

## 还没想通的

- 「自带卡带」值不值得做：访客里有多少人真的有 ROM？
- 电视在 `open` 推进后是全屏的，游戏要不要也走推进？
