v1.6.6：原画布保留暂停画面，倒计时正常继续

v1.6.6：在原画布持续显示暂停帧

此前版本仍收到「数字显示，但游戏暂停期间黑屏」的报告。这次处理模拟器暂停时停止呈现的问题：游戏计算保持暂停，原来的 WebGL 画布独立重绘最近的有效帧，上面只显示 3、2、1。没有额外图片、画布、背景或遮罩。

画面在原生绘图时直接保留在 GPU 中，避免读取已经被丢弃的缓冲区。读档时短暂等待有效画面；恢复游戏前停止暂停呈现，并恢复原生图形状态。

验证覆盖 WebGL 1/2、故意清空缓冲区、像素读回全黑、原生帧数保持暂停、无额外图片或画布，以及恢复后的图形状态和游戏推进。真实 MAME《恐龙快打》和 FBNeo《拳皇97 最终决战》检查八种滤镜及跨页面读档；NAS 上线后，用户已在实际浏览器确认：倒计时画面可见，结束后正常继续。

更新部署

Git 安装执行 git pull --ff-only 后 docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.6.6.zip 后重建。账号入口由同一提交生成。保留 ROM、作者滤镜及完整账号数据目录。

缓存标识 arcade23、机台样式 cabinet19。关闭旧游戏页后重新进入，无需清理网站数据。更新指南。

v1.6.5：重写数字倒计时并移除暂停后的滤镜重设

v1.6.5：移除旧倒计时流程，暂停期间不重设滤镜

倒计时重写为每秒显示 3、2、1，结束后自动继续。删除原有反复准备画面和滤镜的流程；不添加截图、遮罩、标题或按钮。

暂停菜单原本会在暂停后重新启用滤镜，可能清掉停住的画面。现在保留已经呈现的原画，暂停期间的画面设置推迟到恢复运行后再应用；原画预览和存档缩略图仍可使用。

真实 MAME《恐龙快打》与 FBNeo《拳皇97 最终决战》检查八种滤镜和跨页面读档。新增检查禁止在暂停期间调用原生滤镜切换；MAME 同时使用有界面的 Edge 验证。此前版本仍有实际浏览器黑屏报告，本次验证范围不等于所有设备均已验收。

更新部署

Git 安装执行 git pull --ff-only 后 docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.6.5.zip 后重建。账号入口由同一提交生成。保留 ROM、作者滤镜及完整账号数据目录。

缓存标识 arcade22、机台样式 cabinet18。关闭旧游戏页后重新进入，无需清理网站数据。更新指南。

v1.6.4：游戏画面上的纯数字倒计时

v1.6.4：只在游戏画面上显示倒计时数字

继续游戏时只在实际游戏画面上显示白色 3、2、1。彻底移除倒计时截图、遮罩、卡片、标题和按钮，避免部分荧光滤镜读取缓冲区得到的黑色画面遮住游戏。倒计时期间暂停核心并屏蔽输入，结束后自动继续，Esc 可取消。

倒计时前完成滤镜初始化，期间停止后台画面重设；同时等待菜单预览操作完成，避免异步切换滤镜清黑暂停画面。

验证直接检查浏览器实际显示的画面，覆盖 MAME《恐龙快打》和 FBNeo《拳皇97 最终决战》、八种滤镜、菜单继续和重新打开后的读档。

更新部署

Git 安装执行 git pull --ff-only 后 docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.6.4.zip 后重建。账号入口由同一提交生成。保留 ROM、作者滤镜及完整账号数据目录。

缓存标识 arcade21、机台样式 cabinet17。关闭旧游戏页后重新进入，无需清理网站数据。更新指南。

v1.6.3：倒计时保留画面并自动继续

v1.6.3：倒计时保留游戏画面并自动继续

修正继续游戏倒计时背景变黑，以及可见窗口因焦点判断而一直暂停的问题。恢复后先更新视频帧，再从核心取得原生截图保留实际画面；轻半透明 3、2、1 结束后自动继续，无需额外按键。Esc 仍可主动取消，切换到隐藏的页面时暂停倒计时。

MAME 新游戏也自动跳过启动提示，避免停在提示页等待玩家按键。

本地验证包括真实 MAME《恐龙快打》与 FBNeo《拳皇97 最终决战》的新启动、菜单继续、三种滤镜下的暂停画面和重新打开页面读档；检查倒计时期间核心不推进，结束后自动推进，并覆盖可见但焦点报告为 false 的情况。其他游戏和核心仍可能有独立兼容性问题。

更新部署

Git 安装执行 git pull --ff-only 后 docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.6.3.zip 后重建。账号入口由同一提交生成。保留 ROM、作者滤镜及完整账号数据目录。

缓存标识 arcade20、机台样式 cabinet16。关闭旧游戏页后刷新，无需清理网站数据。更新指南。

v1.6.2 修正暂停倒计时透明背景

v1.6.2：修正暂停倒计时的半透明背景

移除倒计时中的额外截图画布，直接暂停已经显示的实际游戏画面，叠加 22% 黑色半透明遮罩。避免读取暂停后的 WebGL 缓冲区时得到黑色／不透明截图，将游戏画面盖住。3 秒倒计时、输入屏蔽、失焦暂停和 Esc 取消保持不变。

已检查真实 MAME 游戏倒计时画面，背景清晰可见且核心保持暂停；自动检查覆盖暂停期间不推进、输入屏蔽、半透明遮罩、取消和失焦重置。

更新部署

Git 安装执行 git pull --ff-only 后 docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.6.2.zip 后重建。账号入口从同一提交生成前端，无账号后端或数据变更。保留 ROM、作者滤镜及完整账号数据目录。

缓存标识 arcade19、机台样式 cabinet15。关闭旧游戏页后刷新，无需清理网站数据。更新指南。

v1.6.1 修复游戏启动准备阻塞

v1.6.1：修复所有游戏停留在准备中

修复 v1.6.0 引入的引擎初始化缺陷：版本检查在构造阶段读取尚未赋值的 this.config.dataPath，可能抛出异常并阻止启动界面出现。改为读取启动前已经设定的 EJS_pathtodata，兼容家庭版和 NAS 账号入口。

启动页面仅快速读取已有核心缓存，不再强制等待最长 3 分钟的预下载或网络 HEAD。首次所需核心由模拟器在点击开始后正常下载，并显示进度。账号同步的待上传队列改为后台处理，初始元数据请求限时 5 秒，本地记录与队列保留。

准备阶段列出正在等待的项目；10 秒慢响应提示，30 秒仍未完成时提供重载。下载／初始化 20 秒无进展时显示可重试提示；恢复进度后自动收起。无需清理网站数据。

部署

完整更新前端，并重建引擎：git pull --ff-only 后 docker compose up -d --build。ZIP 安装使用 pixel-arcade-family-v1.6.1.zip 合并程序并重建。只换前端不能修复旧的引擎脚本，必须同时更新 data/src/emulator.js。 NAS 账号入口从同一提交生成并核对源码与核心。

保留 ROM、作者滤镜与完整账号数据目录。缓存标识 arcade18、机台样式 cabinet14。关闭旧游戏页并按 Ctrl+F5 刷新；不需要删除收藏、存档或网站数据。更新指南。

新增真实引擎初始化 CI 检查，直接运行已安装的引擎并验证启动按钮可用；另外覆盖核心缓存直用、冷缓存不预下载、准备超时与迟到响应、下载停滞及进度恢复。原有游戏继续、存档与手柄检查保留。

v1.6.0 HACK 兼容、暂停倒计时与全屏启动

v1.6.0：HACK 父资源、暂停倒计时与全屏启动

• 拳皇97 最终决战等分包会自动查找并加载已有父 ROM，优先选择普通版，保留修改版文件；Neo Geo BIOS ZIP 可直接供 FBNeo 读取。原资源和记录标识不变。不支持的专用修改版仍需匹配核心。
• 从启动页恢复、历史进度恢复、快捷读档及菜单继续时，显示游戏画面并暂停，覆上半透明 3、2、1 倒计时后继续。期间屏蔽游戏输入；Esc／手柄返回可暂停，切走窗口会保持暂停并重新准备。
• 跨页面记住最近使用的键鼠、手柄型号及已确认控制器，避免每页重置提示和重复接管。真实输入仍可切换设备，断开设备会回退。
• 收起原生工具栏、通知文字和 RetroArch 菜单快捷键，保留统一游戏菜单。
• 已安装应用请求全屏启动，大厅提供一次点击全屏；Windows 可用 scripts/create_fullscreen_shortcut.ps1 创建无地址栏的 Edge 全屏桌面入口。普通标签页无法绕过浏览器要求自动全屏。

更新与一致性

家庭版与 NAS 使用同一提交、同一 engine-lock.json 和同一前端源码。NAS 账号入口由构建脚本生成必要的登录和路径适配，并逐文件核对部署结果；作者私有滤镜和 ROM 不进入公开发布包。

Git 安装：git pull --ff-only 后 docker compose up -d --build。ZIP 安装：合并 pixel-arcade-family-v1.6.0.zip 后重建原 Compose 项目。保留资源、作者滤镜和完整账号数据目录，本版无账号数据库变更。账号入口重新生成前端，并更新引擎更新检查的本地路径适配。

新增 rom-parents.json、resume-countdown.js、fullscreen-launch.js 必须一并部署；缓存标识 arcade17、机台样式 cabinet13。关闭旧游戏页并刷新大厅，不要清除网站数据。详见 更新指南 和 父 ROM 说明。校验文件 SHA256SUMS-v1.6.0.txt。

《超时空要塞2》部分跨次读档的声音兼容问题仍未彻底解决，沿用已知问题记录，不宣称修复。

v1.5.1 7z 街机启动兼容与菜单隐藏

v1.5.1：7z 街机资源兼容与画面菜单隐藏

修复浏览器版 FBNeo 禁用原生 7z 支持导致资源存在却无法启动的问题。启动时使用已安装的模拟器解压组件，将 7z 内容临时封装为 ZIP，再交给核心读取。原始资源、游戏路径、收藏、历史和继续点标识不变；无需逐款手动换文件或重建游戏库。普通 ZIP 直接沿用。

隐藏游戏画面右上角的模拟器三条杠菜单。自定义「游戏菜单」、Esc 和手柄菜单快捷键仍可使用。另修正桌面玩竖屏游戏时机台灯箱标题换行、裁切的问题。

启动海报显示解压进度；解压失败会提示重新载入，工作线程和临时资源会清理。7z 转换只解决容器兼容性，游戏仍需与核心、BIOS 和父 ROM 匹配。大资源需要较多浏览器内存，临时 ZIP 随页面关闭释放，不写入账号存档或原 ROM 目录。

更新部署

Git 安装执行 git pull --ff-only、docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.5.1.zip 后重新构建原 Compose 项目。账号入口重新生成并部署前端即可，本版不修改账号后端和数据格式。

保留原资源、作者滤镜 JSON、配置与完整账号数据目录。关闭旧游戏页后刷新大厅，无需清除网站数据。缓存标识 arcade16，机台样式 cabinet12，新增 library/rom-archive.js 必须一同部署。详见 更新部署指南。校验文件 SHA256SUMS-v1.5.1.txt。

验证

真实核心使用原 mushisam.7z 通过 4 个 ROM CRC 校验、开机自检、投币和游戏选择；punisher.7z 同样通过启动检查。用自制微型 7z 实测原解压组件，生成 ZIP 经 Python 独立验证 CRC、二进制内容、中文文件名和空文件，另检查 ZIP 直通、重复安装保护、损坏包提示与线程回收。覆盖桌面／手机机台、隐藏原生菜单，以及真实核心历史继续和手柄导航回归。

v1.5.0 大存档同步与轻度做旧机台

v1.5.0：大存档同步与轻度做旧机台

账号同步移除单份 16 MB、每账号 512 MB 的应用容量限制，改为 1 MB 校验分块、断点续传和磁盘存储。旧数据库存档与本机待上传队列可直接沿用；NAS 空间不足时保留本机副本并提示重试。每游戏手动、自动各 3 份的保留规则不变。

机台外壳与操作台加入自制 SVG 磨损纹理、轻微泛黄、细划痕和旧金属螺丝；设置预览同步更新，纹理不覆盖游戏画面。保留正面屏幕和立体操作台结构。

继续游戏会等待核心首帧就绪；MAME 继续入口跳过独立于存档的开机声明提示，并在恢复结束后移除海报等待层。《超时空要塞 2》在 MAME 2003 Plus 下部分跨次读档仍可能无声，本版尚未彻底修复此核心兼容问题。 保留旧进度，未强制切换核心或重开游戏。同一局内暂停／恢复与跨次读档分别验证，不将音量恢复视为游戏声音已恢复。

更新部署

Git 安装执行 git pull --ff-only、docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.5.0.zip 后重新构建原 Compose 项目。保留 .env、ROM、cheats、作者滤镜 JSON 和账号数据。

账号入口必须同时更新 account_sync.py、重新生成前端并重启账号服务，保留原 /data 挂载。旧数据库自动增加新列。新版已完成存档位于 /data/sync-files/，待续传分块位于 /data/sync-uploads/。备份与恢复须先停止账号服务，再复制整个持久目录；以后只备份 SQLite 不能恢复完整存档。 升级前先备份。详见 账号同步说明 与 更新部署指南。

页面缓存标识 arcade15，机台样式 cabinet11。关闭旧游戏页后刷新大厅，无需清除网站数据。校验文件为 SHA256SUMS-v1.5.0.txt。

验证

覆盖超过 16 MB 的浏览器间存档字节校验、超过旧 512 MB 总配额的账号、分块中断／刷新续传、重复块、损坏块、账号隔离、旧存档兼容、物理文件保留清理，以及登录服务回归。另检查桌面／手机机台结构、设置预览、控制器导航、真实核心继续、海报入场与音量／静音恢复。

可用 MACROSS_URL=本地游戏地址 node scripts/probe_macross_resume.cjs 复现上述声音问题；此诊断需要本地合法 ROM 与核心，不属于无需 ROM 的通过性测试。

v1.4.3 大厅控制器导航与接管修补

v1.4.3：大厅控制器选择与接管修补

修复选中大厅控制器后导航无法继续的问题。控制器选项改为直接左右／确认切换，上下离开，避免原生弹出菜单困住焦点。

选择另一台设备时，原手柄会继续工作；新手柄松开按键和摇杆后按确认才正式接管，并消耗这次确认，避免误启动。目标离线会回退自动选择；大厅在此选项按返回可恢复自动并回到游戏列表。游戏玩家分配保持独立。

更新部署

Git 安装执行 git pull --ff-only、docker compose up -d --build；ZIP 安装合并 pixel-arcade-family-v1.4.3.zip 后重新构建原 Compose 项目。保留 .env、ROM、cheats、作者滤镜 JSON 和账号服务的数据目录。

账号入口重新生成并部署前端；本版无账号后端或数据库变更。缓存标识为 arcade14，控制器样式标识为 gamepad114。关闭旧游戏页并刷新大厅，无需清除网站数据。校验文件为 SHA256SUMS-v1.4.3.txt。详见 更新部署指南。

已覆盖桌面和手机下左右切换、上下离开、返回恢复自动、设置窗口导航、带漂移的设备和两手柄确认接管。