dsh-nes-emulator
Manifest validNES / FC emulator plugin for DeepSeek Harness with managed ROM library, cover screenshots, unlimited saves, gamepad and fast-forward.
NES 模拟器(dsh-nes-emulator)
在 DeepSeek Harness 左侧栏加一个 NES 模拟器入口,点开就是一台 FC / 红白机: 管理自己的 ROM 库(按文件夹导入、可移除、自动生成封面),选中即玩,支持声音、 键盘/手柄、即时存档、电池存档和全屏。
安装
插件通过 GitHub 仓库发布,运行前需要已安装 DeepSeek Harness。
-
克隆仓库到本机任意目录:
git clone https://github.com/Siwei-666/dsh-nes-emulator.git -
在 DSH 中安装这个本地 bundle:
- 插件管理页选择「安装本地插件 / 从文件夹安装」,指向克隆下来的目录;或
- 让 Agent 调用
plugin_manager的install_bundle,target 填该目录的绝对路径。
-
确认插件 NES emulator 已启用,刷新 Harness 页面,左侧栏出现手柄图标。
仓库已经包含构建好的
client.js与cover-worker.mjs,安装时不需要额外执行npm install;只有修改源码重新构建时才需要开发依赖。
使用
- 重新打开 Harness 的插件列表,确认 NES 模拟器已启用(安装后默认生效)。 如果左侧栏还没出现手柄图标,刷新一次页面。
- 点击左侧栏的面板图标(手柄形状)打开模拟器。
- 「游戏库」打开游戏抽屉:输入关键字过滤,点一个开玩;也可以把
.nes文件拖到画面, 或点「打开 ROM」从磁盘选择。
添加 / 移除 ROM
- 按文件夹添加:游戏库右下角「添加文件夹」→ 选择电脑上的文件夹(或粘贴路径)→
「添加」。文件夹里的
.nes会就地加入库,不复制文件,递归最多 6 层, 跳过node_modules、.git和隐藏目录。 - 首次使用会自动把本插件目录的上一级(当前工作区)加为默认文件夹, 所以现有的 nes rom 会直接出现。
- 移除:列表每一行右侧的
×会把这个 ROM 从库中移除,不删除磁盘上的文件; 想重新显示可删除.nes-library/library.json里的hidden记录。 - 库清单与封面缓存在工作区的
.nes-library/:library.json:文件夹、隐藏记录、封面状态;covers/<id>.png:256×240 封面。
要换默认文件夹或库位置,在 bundle 配置里写 romRoot / libraryDir:
- insert:
- id: dsh-nes-emulator
name: 'dsh-nes-emulator'
config:
romRoot: 'D:\games\nes'
libraryDir: 'D:\games\.nes-library'
封面
- 封面不是从 ROM 文件里读出来的(NES 卡带没有统一的封面数据),而是把 ROM 放进模拟核心启动几秒并截帧:在 90–360 帧之间采样,挑颜色/画面信息最多的一帧, 输出 256×240 PNG。
- 生成在 Node worker 线程 + 队列里做,添加文件夹后界面立即可用,封面会一张张补齐; 游戏库标题会显示「正在生成封面 12/446」这样的进度,列表里暂未生成的格子显示手柄占位图。
- 同一张卡带只生成一次;已生成/失败的记录存在
library.json,重启后不会重跑。 不支持的 mapper 会标记为失败并保留占位图。
布局
中间是游戏画面,两侧是可点击的虚拟手柄与常用操作:
- 左栏:十字键、存档/存档列表、音量与静音;
- 右栏:B/A 面键、开始/选择、播放/暂停、重置、全屏,以及手柄连接状态;
- 顶部:「游戏库」打开/收起游戏列表抽屉,「打开 ROM」从磁盘选择,「设置」打开按键、手柄与语言设置;
- 选中游戏后游戏库自动收起,画面获得最大空间。
操作
| 功能 | 默认键盘 | 屏幕 / 手柄 |
|---|---|---|
| 方向 | 方向键 | 十字键 / 左摇杆 |
| A | X | A(Xbox 的 B 键位置) |
| B | Z | B(Xbox 的 A 键位置) |
| Start | Enter | 开始 / Menu |
| Select | Shift | 选择 / View |
- 自定义按键:顶部「设置 → 按键设置」,点一项后按下新键即可;Esc 取消,
「恢复默认」还原。设置保存在浏览器
localStorage。 - 游戏手柄:支持标准映射的 Xbox、DualSense、Switch Pro 等手柄,插上即用,
无需额外配置;右栏会显示实际使用的手柄名称,设置页里也会显示连接状态。
多个设备同时存在时(例如远程桌面留下的虚拟 HID
OrayVHID),会优先选择标准映射、 按键数更多、名称匹配 Xbox/DualSense 的手柄,而不是虚拟设备;也可以在设置里手动指定。 设置页可切换「交换手柄 A/B」:关闭时按物理位置(Xbox B = NES A),开启时按按键名称 (Xbox A = NES A);选择会保存在浏览器localStorage。 - 语言:设置里可切「自动 / 中文 / English」。自动跟随 Harness 的界面语言,
也可以固定为中文或英文;选择保存在
localStorage,只影响本插件面板。 - 快捷键(可设置):
F5快捷存档、F8快捷读档、R循环加速 (1× → 2× → 4× → 8× → 16× → 1×)。在设置 →「快捷键」里可以改成任意按键。 快捷存档会覆盖同一游戏的上一份快速存档(在存档列表里带「快速」标记)。 - 加速:右栏下拉框也可直接选 1×/2×/4×/8×/16×。高倍速受 CPU 限制, 实际帧率以状态栏 FPS 为准;加速期间音频静音,回到 1× 自动恢复。
- 播放 / 暂停:右栏按钮;暂停时点画面也会继续。
- 切走再回来:离开面板会保存一个隐藏的续玩点;回来后点「继续 · 游戏名」即可 从离开时的画面恢复(手动存档另存于「存档列表」)。
- 重置:重新启动当前卡带。
- 存档 / 读档:左栏「存档」立即新建一份存档;「存档列表」打开全部存档。
数量不限,每份都带画面截图、存档时间与当时的游戏时长,可单独读取或删除;
F5生成的快速存档会覆盖上一份并置顶显示。 存档存在当前页面会话里(切换面板再回来仍在,刷新页面会清空)。 - 电池存档:支持 SRAM 的游戏(
hasSRAM)会自动存到浏览器localStorage, 下次打开同一个 ROM 继续。 - 音量 / 静音:左栏;全屏:右栏。
- 帧率与 Mapper:画面下方显示,便于判断卡带是否被支持。
兼容性
模拟核心是 @nesjs/core(MIT,纯 JavaScript),
内置 mapper 包括 0/1/2/3/4/5/7/9/10/15/18/19/… 以及大量中文合卡 mapper:
163、164、176、240、241、245、249、112、15、74、162、242 等。
当前工作区实测(446 个 .nes):
- 342 个可以直接载入(约 77%),其中绝大多数在约 2–3 秒内出现标题画面;
- 104 个因 mapper 未实现而拒绝载入,主要是 150、199、141、191、178、146、165、198 等, 界面会提示「不支持的 Mapper N」,换一个游戏即可;
- 有 2 个文件其实是 UNIF 格式却用了
.nes后缀,会被明确拒绝。
ROM 版权归各自权利人所有。本插件只读取你本地已有的文件,不附带任何游戏。
实现
dsh-nes-emulator/
├─ package.json # bundle 清单 + dsh.client(浏览器半侧)
├─ cordis.patch.yml # 一条 Host 插件行
├─ index.js # Host:注册 /nes-emulator 路由
├─ library.js # Host:文件夹/隐藏记录、封面队列与缓存
├─ cover-worker.mjs # 后台封面生成 worker(构建产物)
├─ client.js # 浏览器:构建产物(React + @nesjs/core)
├─ src/
│ ├─ client.js # 模块入口:window.__ModuleLoader__.load(...)
│ ├─ app.js # 面板 UI:三栏布局、游戏库抽屉、按键设置、手柄轮询、多语言
│ └─ engine.js # 模拟器运行时:帧循环、音频环形缓冲、存档、SRAM、手柄按键
├─ scripts/
│ ├─ build.mjs # esbuild 构建脚本
│ └─ cover-worker-src.mjs
├─ locale/{en,zh}.json
└─ icon.svg
- 左侧栏入口:
ctx.slots.inject('sidebar.panellist', …)注册图标,id 与main面板的 key 相同(nes-emulator),点击图标即切到本面板。 - 画面:
<canvas>256×240,整数倍率由容器尺寸算出,image-rendering: pixelated。 - 声音:
AudioContext+ScriptProcessorNode(2048 帧),250ms 环形缓冲吸收 RAF 抖动;音量走GainNode。 - ROM 传输:浏览器只访问同源
/nes-emulator/rom?id=…,Host 从库索引解析绝对路径, 再做realpath+ 前缀校验和大小上限,不把文件系统 API 暴露给页面。 - 封面:
cover-worker.mjs(esbuild 打包的 ESM worker)启动 ROM、采样帧、用 内置 zlib 编码 PNG;Host 以 2 个 worker 的队列处理,结果写入.nes-library/covers。 - 手柄:
navigator.getGamepads()逐帧轮询标准映射(十字键 12–15、左摇杆、 面键、Start/Back),与键盘输入共用引擎的按键状态机。 - 主题:只使用
--dsw-alias-*主题变量,跟随明暗主题。
修改源码后重新构建
npm install
npm run build
构建脚本用 esbuild 把 src/client.js 打成 client.js,把 scripts/cover-worker-src.mjs
打成 cover-worker.mjs;React 不打进产物,运行时由 Harness 的模块表提供。
@nesjs/core 与 esbuild 只是构建期依赖,运行时不需要 node_modules。
第三方声明
@nesjs/core2.7.0 — MIT,NES 模拟核心, 已打包进client.js。- 插件自身代码 — MIT。
Comments
Loading…
Similar plugins
by sknagato
dsh fc/nes模拟器
★ 1
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add dsh-plugin-fc-emulatorby flyingfishzxf
FC/NES game library and emulator for the DSH Web right sidebar — multi-source search, ZIP support, custom sources, URL cards, gamepad input, saves and a Famicom-inspired UI.
★ 0
MIT
JavaScript
Nov 10, 2026
dsh plugin --profile web add dsh-fc-gamesby wangyong1972
Native macOS computer-use plugin for DeepSeek Harness with trusted mouse/keyboard control, screenshots, and multi-display selection.
★ 0
MIT
TypeScript
Aug 23, 2026
dsh plugin --profile web add @wangyong1972/dsh-computer-use-macosby wei238982377
An add-only Markdown library for DeepSeek Harness with a workspace file picker, fixed non-overlapping icon grid, marquee selection, virtual folders, full-screen tabs, GFM tables, and local Mermaid/cha
★ 2
MIT
JavaScript
Nov 6, 2026
dsh plugin --profile web add dsh-docdeskby Entaum
Adds a Spawnd.gg games cabinet to the DeepSeek Harness Web sidebar with search, sorting, hover previews, embedded play, and a minimized player.
★ 1
↓ 44/wk
MIT
JavaScript
Aug 31, 2026
dsh plugin --profile web add dsh-free-gamesby albertgranados
DeepSeek Harness plugin: run the project you have open, from the harness you are already in. Detects how a workspace is meant to be run (Node.js today, adapters for more) and runs it from the Session header.
★ 0
MIT
JavaScript
Sep 18, 2026
dsh plugin --profile web add dsh-run-environment