DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-nes-emulator

S

dsh-nes-emulator

Manifest valid

NES / FC emulator plugin for DeepSeek Harness with managed ROM library, cover screenshots, unlimited saves, gamepad and fast-forward.

UI (client)hasBundlePatch

NES 模拟器(dsh-nes-emulator)

在 DeepSeek Harness 左侧栏加一个 NES 模拟器入口,点开就是一台 FC / 红白机: 管理自己的 ROM 库(按文件夹导入、可移除、自动生成封面),选中即玩,支持声音、 键盘/手柄、即时存档、电池存档和全屏。

dsh-nes-emulator

安装

插件通过 GitHub 仓库发布,运行前需要已安装 DeepSeek Harness。

  1. 克隆仓库到本机任意目录:

    git clone https://github.com/Siwei-666/dsh-nes-emulator.git
    
  2. 在 DSH 中安装这个本地 bundle:

    • 插件管理页选择「安装本地插件 / 从文件夹安装」,指向克隆下来的目录;或
    • 让 Agent 调用 plugin_manager 的 install_bundle,target 填该目录的绝对路径。
  3. 确认插件 NES emulator 已启用,刷新 Harness 页面,左侧栏出现手柄图标。

仓库已经包含构建好的 client.js 与 cover-worker.mjs,安装时不需要额外执行 npm install;只有修改源码重新构建时才需要开发依赖。

使用

  1. 重新打开 Harness 的插件列表,确认 NES 模拟器已启用(安装后默认生效)。 如果左侧栏还没出现手柄图标,刷新一次页面。
  2. 点击左侧栏的面板图标(手柄形状)打开模拟器。
  3. 「游戏库」打开游戏抽屉:输入关键字过滤,点一个开玩;也可以把 .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」从磁盘选择,「设置」打开按键、手柄与语言设置;
  • 选中游戏后游戏库自动收起,画面获得最大空间。

操作

功能默认键盘屏幕 / 手柄
方向方向键十字键 / 左摇杆
AXA(Xbox 的 B 键位置)
BZB(Xbox 的 A 键位置)
StartEnter开始 / Menu
SelectShift选择 / 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/core 2.7.0 — MIT,NES 模拟核心, 已打包进 client.js。
  • 插件自身代码 — MIT。

Comments

Loading…

Similar plugins

dsh-plugin-fc-emulator

by sknagato

dsh fc/nes模拟器

Just for FunDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Oct 8, 2026

dsh plugin --profile web add dsh-plugin-fc-emulator

by 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.

Manifest valid

★ 0

MIT

JavaScript

Nov 10, 2026

dsh plugin --profile web add dsh-fc-games

by wangyong1972

Native macOS computer-use plugin for DeepSeek Harness with trusted mouse/keyboard control, screenshots, and multi-display selection.

Manifest valid

★ 0

MIT

TypeScript

Aug 23, 2026

dsh plugin --profile web add @wangyong1972/dsh-computer-use-macos

by 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

Development & InfrastructureManifest valid

★ 2

MIT

JavaScript

Nov 6, 2026

dsh plugin --profile web add dsh-docdesk

by Entaum

Adds a Spawnd.gg games cabinet to the DeepSeek Harness Web sidebar with search, sorting, hover previews, embedded play, and a minimized player.

Just for FunDevelopment & InfrastructureTerminal & ClientsManifest valid

★ 1

↓ 44/wk

MIT

JavaScript

Aug 31, 2026

dsh plugin --profile web add dsh-free-games

by 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.

Development & InfrastructureTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Sep 18, 2026

dsh plugin --profile web add dsh-run-environment