dsh-foxy-jumpscare

把《玩具熊的五夜后宫 2》(Five Nights at Freddy's 2)的 Foxy(霍斯 / Withered Foxy) 请进 DeepSeek Harness(dsh)Web 界面:每秒钟有 1/1000 的几率,屏幕突然被全屏 jumpscare 占据, 伴随那声标志性的尖叫,吓你一跳后自动消失。

> 素材与音效均来自 Five Nights at Freddy's Wiki, > 版权归 Scott Cawthon / Steel Wool Studios 所有。本项目是非官方同人玩具插件,详见 > [NOTICE.md](./NOTICE.md)。

特性

• 每秒 1/1000 几率:每 intervalMs(默认 1000ms)掷一次骰子,命中概率 probability(默认 0.001);
• 全屏 jumpscare:全屏黑底 + Foxy 大头,附带一个「前扑」缩放动画,durationMs(默认 1800ms)后自动消失;
• 尖叫音效:随 jumpscare 同步播放,音量可调;首次点击/按键会自动「解锁」音频以绕过浏览器自动播放限制;画面收起时音效立即停止;
• 零延迟:图片与音效启动时预加载,命中瞬间即出,不联网、不转圈;
• 开箱即用:node half 自动注册 HTTP 路由 serve 素材与 config.json,无需手动部署;
• 可配置:概率、间隔、时长、音量、开关、素材地址都能改;localStorage 覆盖实时生效(每秒检测,无需刷新),也能一键关闭;
• 点击关闭:jumpscare 期间点一下屏幕即可提前关掉。

安装

方式 A:dsh plugin 自动安装(推荐)

本包声明了 dsh.bundle.patch,dsh plugin add 会自动把它的 patch 层并入 dsh.profile.bundles:

dsh plugin --profile web add github:01Virex/dsh-foxy-jumpscare

重启 dsh web,浏览器 Ctrl+F5 硬刷新 即可生效。

方式 B:手动安装

1. 把本项目放到 web profile 的 node_modules 下(默认 C:\Users\<你>\.dsh\profiles\web\node_modules\dsh-foxy-jumpscare\); 2. 在 web profile 的 cordis.patch.yml 里插入:

``yaml - insert: - id: foxy-jumpscare name: dsh-foxy-jumpscare ``

3. (可选)node gen-config.cjs 生成本地 config.json; 4. 重启 dsh web,浏览器 Ctrl+F5 硬刷新。

配置

配置优先级从高到低:

1. localStorage 完整配置:dsh-foxy-jumpscare.config(粘贴 JSON,实时生效,无需刷新); 2. config.json(项目根,本地个性化,被 .gitignore 忽略;缺省时 node half 自动回退到 config.example.json;修改后需刷新页面重新加载); 3. 内置默认值(见 lib/client.js 顶部 DEFAULT_CONFIG)。

配置文件格式(config.example.json):

{
  "enabled": true,
  "probability": 0.001,
  "intervalMs": 1000,
  "durationMs": 1800,
  "volume": 1.0,
  "debug": false,
  "imageUrl": "/plugins/dsh-foxy-jumpscare/assets/foxy-jumpscare.webp",
  "soundUrl": "/plugins/dsh-foxy-jumpscare/assets/foxy-scream.ogg"
}

应急关闭:不想再被吓时,在浏览器控制台执行(1 秒内立即生效,无需刷新):

localStorage.setItem("dsh-foxy-jumpscare.config", JSON.stringify({ enabled: false }));
// 恢复默认:localStorage.removeItem("dsh-foxy-jumpscare.config")

快速触发 / 测试

不想等 1/1000 的概率,想立刻看效果?浏览器控制台(F12)执行:

window.dshFoxyJumpscare.trigger()  // 立刻跳杀一次
window.dshFoxyJumpscare.hide()     // 立刻收起
window.dshFoxyJumpscare.config     // 查看当前生效配置(只读)

也可以把概率临时拉到 1(每 tick 必中)——控制台执行 localStorage.setItem("dsh-foxy-jumpscare.config", JSON.stringify({ probability: 1 })), 1 秒内就会连跳;改回/删除该键即可恢复默认(都实时生效,无需刷新)。

> 数学上,默认参数(每秒掷一次、命中率 1/1000)服从几何分布,期望首次触发时间 ≈ 1000 秒 ≈ 16 分 40 秒; > 其中位数约 11 分 30 秒(50% 概率在此之前触发)。详见「原理」。

项目结构

dsh-foxy-jumpscare/
├── lib/
│   ├── index.js            # node half:serve 素材与 config.json
│   └── client.js           # browser half:jumpscare 定时器 + 全屏 overlay
├── assets/
│   ├── foxy-jumpscare.webp # Withered Foxy jumpscare 画面(893×609,透明背景)
│   └── foxy-scream.ogg     # Foxy jumpscare 尖叫
├── config.example.json     # 完整配置模板(入库)
├── config.json             # 本地个性化配置(被 .gitignore 忽略)
├── gen-config.cjs          # 初始化 config.json 的脚本
├── cordis.patch.yml        # bundle patch(由 dsh.bundle.patch 自动应用)
├── package.json
├── NOTICE.md               # 素材版权归属说明
├── LICENSE                 # MIT
└── README.md

卸载

• 方式 A 安装:dsh plugin --profile web remove dsh-foxy-jumpscare;
• 方式 B 安装:从 cordis.patch.yml 删掉 foxy-jumpscare 那一行,并删除 node_modules 下的包目录。

之后重启 dsh web 即可。

原理

这是 dsh 的「双面(bundle + client)」插件:同一包名既是一个 bundle(通过 dsh.bundle.patch 在配置树里插入一行),又是一个 dsh.client 浏览器插件(web 运行时扫描 dsh.client 元数据、serve /plugins/dsh-foxy-jumpscare/client.js 并注入 window.__DSH_BOOT__)。 node 半部只负责把素材/配置送出本地 HTTP,惊吓逻辑全在浏览器半部。

触发时机(数学期望)

每 intervalMs(默认 1000ms)独立掷一次骰子,命中率 probability(默认 0.001)。这是几何分布:

• 期望首次触发时间 = intervalMs / probability = 1000 / 0.001 · 1000ms = 1000 秒 ≈ 16 分 40 秒;
• 中位数 ≈ 693 秒 ≈ 11 分 30 秒(即 50% 的概率在此前已触发);
• 1000 秒内至少触发一次的概率 ≈ 63.2%,1 小时内 ≈ 97.3%,1 分钟内 ≈ 5.8%;
• 无记忆性:无论已经安静了多久,接下来每一秒的触发概率仍是 1/1000,剩余期望等待时间仍是 1000 秒——"期望"是长期平均,不保证任何具体时刻。

贡献

欢迎提 Issue / PR,或直接在 config.example.json 里调整默认参数。改动后记得跑一次 node scripts/package-release.cjs 检查发布文件是否齐全。

License

代码:[MIT](./LICENSE)。素材版权归原权利方所有,见 [NOTICE.md](./NOTICE.md)。