dsh-boot-suite 2.16.5 → 2.16.8

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [2.16.8] — 2026-11-04
+
+- 聊天背景新增第二张内置背景「黑发雪夜战术少女」（`lib/assets/builtin-background-snowgirl.png`）：设置 → 聊天背景 → 背景图里会多一张可点选，默认仍用原默认背景，不覆盖用户已选。
+- 聊天背景设置面板：内置背景条目支持多张（`id` / `builtinId`），当前选中项按 id 精确高亮；「当前状态」显示对应内置名称。
+- 掉线彩蛋底图沿用上一版替换后的图片。
+- 版本 2.16.8，构建号 cw-74。
+
+## [2.16.7] — 2026-11-04
+
+- 新增「视频原声」开关：第一幕、第二幕各一个，可分别决定是否播放视频自带的配音/音乐（默认静音，保持原有行为）。适合把配好音的导入动画当第二幕使用；打开后视频原声与背景音乐同时响，建议只开一个。
+- 未静音视频若被浏览器自动播放策略拦下，会自动退回静音再播，保证画面不会卡住。
+- 掉线彩蛋底图换成「黑发雪夜战术少女」。
+- 版本 2.16.7，构建号 cw-73。
+
+## [2.16.6] — 2026-11-04
+
+- 修复「第一幕是 iframe 模板（全景大肥鱼-含彩蛋版）时，第二幕永远不播」：`lib/splash.js` 的 iframe 分支此前在模板结束后直接收尾，绕过了 `playSecondTemplate()`；现在 iframe 收尾前先接管第二幕，再走退场转场。
+- 无第二幕时行为不变（直接退场）；第二幕的衔接/退场转场仍按设置生效。
+- 版本 2.16.6，构建号 cw-72。
+
 ## [2.16.5] — 2026-11-04
 
 - 下拉菜单加不透明底：皮肤把 `--dsw-alias-bg-layer-2` 定义成半透明，菜单会透出背后的说明文字。现在改用近不透明的 `--dsw-alias-bg-overlay` 双层叠加（≈99%，跟随浅/深主题）+ 轻微背景模糊，选项清晰可读。

package/lib/client.js

@@ -362,7 +362,8 @@ window.__ModuleLoader__.load({
       colorMode: 'color',
       bgmEnabled: false, bgmFile: '', bgmFile2: '', bgmVolume: 0.5, bgmBpm: 100, bgmBeats1: 16, bgmBeats2: 32,
       bgm1Start: 0, bgm2Start: 0, bgm1FadeIn: 1, bgm1FadeOut: 1, bgm2FadeIn: 1, bgm2FadeOut: 2,
-      bgmCrossfade: 1200, bgmLoop: true, bgm2Loop: false, bgmDuck: true
+      bgmCrossfade: 1200, bgmLoop: true, bgm2Loop: false, bgmDuck: true,
+      act1VideoSound: false, act2VideoSound: false
     }
     function num(v, d) {
       var n = Number(v)
@@ -375,7 +376,7 @@ window.__ModuleLoader__.load({
           —— 桌面端走浏览器半侧自举时没有 1，就靠这一条
        3) 下面这个常量：两份都没拿到时的兜底，别让面板显示 undefined
        版本号本身只在 lib/index.js 里读一次，这里不重复维护。 */
-    var FALLBACK_VERSION = '2.16.5'
+    var FALLBACK_VERSION = '2.16.8'
     /* 手动选包成功后置 true：让还在后台跑的“浏览器下载监听”不要再弹第二次更新器 */
     var __manualUpdateApplied = false
     function readInjectedVersion() {
@@ -1266,6 +1267,12 @@ window.__ModuleLoader__.load({
               }, '删除该动画')
             )
           ),
+          h(Field, {
+            label: '第一幕视频原声',
+            hint: '第一幕使用视频/导入动画时，是否播放视频自带的声音；默认静音。'
+          },
+            h(Check, { checked: draft.act1VideoSound === true, onChange: (v) => set('act1VideoSound', v), label: '播放第一幕视频原声' })
+          ),
           h(Field, {
             label: '启动动画第二幕',
             hint: '第一幕播完接着播这一段；选「不播放」就第一幕结束直接进聊天。'
@@ -1294,6 +1301,12 @@ window.__ModuleLoader__.load({
               }, '删除该动画')
             )
           ),
+          h(Field, {
+            label: '第二幕视频原声',
+            hint: '第二幕视频里自带配音/音乐时打开；默认静音。打开后会和背景音乐同时响。'
+          },
+            h(Check, { checked: draft.act2VideoSound === true, onChange: (v) => set('act2VideoSound', v), label: '播放第二幕视频原声' })
+          ),
           h('div', { className: '__ss_row' },
             h('button', {
               className: '__ss_btn',
@@ -2128,7 +2141,7 @@ window.__ModuleLoader__.load({
     /* 每次改客户端就把这个号 +1。
        有了它在控制台一眼就能判断"浏览器里跑的是不是最新那份" ——
        排查问题时，分不清是代码问题还是旧包，会白猜一轮。 */
-    var BUILD = 'cw-71'
+    var BUILD = 'cw-74'
 
     function log() {
       try {
@@ -3216,6 +3229,8 @@ window.__ModuleLoader__.load({
               images: images.images || [],
               current: images.current || null,
               imageSource: images.imageSource || '',
+              builtinId: images.builtinId || '',
+              builtinName: images.builtinName || '',
               dropDir: images.dropDir || '',
               dropDirExists: !!images.dropDirExists,
               veil: images.veil || { light: 0.8, dark: 0.5 },
@@ -3318,14 +3333,14 @@ window.__ModuleLoader__.load({
 
       var thumb = function (im) {
         var selected = im.builtin
-          ? data.imageSource === 'builtin'
+          ? (im.builtinId ? data.builtinId === im.builtinId : (im.selected != null ? im.selected : data.imageSource === 'builtin'))
           : (data.current && data.current.split(/[\\/]/).pop() === im.name)
         return cwH('button', {
           key: im.name,
           type: 'button',
-          title: im.builtin ? '默认背景（内置，随插件安装；删不掉）' : (im.name + ' · ' + im.sizeKB + ' KB · ' + im.mtime),
+          title: im.builtin ? ('内置背景：' + im.name + '（随插件安装；删不掉）') : (im.name + ' · ' + im.sizeKB + ' KB · ' + im.mtime),
           disabled: busy,
-          onClick: function () { apply({ image: im.builtin ? BUILTIN_IMAGE_ID : im.name }, true) },
+          onClick: function () { apply({ image: im.builtin ? (im.builtinId || BUILTIN_IMAGE_ID) : im.name }, true) },
           style: {
             position: 'relative', padding: 0, border: '2px solid ' + (selected ? 'var(--dsw-alias-state-business-primary,#3964fe)' : 'var(--dsw-alias-border-l2)'),
             borderRadius: 8, background: 'var(--dsw-alias-bg-layer-3)', cursor: 'pointer', overflow: 'hidden', width: 132, height: 76
@@ -3343,7 +3358,7 @@ window.__ModuleLoader__.load({
           cwH('div', { className: '__ss_groupTitle' }, '当前状态'),
           cwH('div', { className: '__ss_hint' },
             '背景图：' + (data.imageSource === 'builtin'
-              ? '默认背景（内置）'
+              ? (data.builtinName || '默认背景（内置）')
               : (data.image ? data.image.split(/[\\/]/).pop() : '（没有背景图，使用 DSH 默认底色）')),
             cwH('br'),
             '循环视频：' + (data.video && data.video.items.length ? ('已扫描 ' + data.video.items.length + ' 段' + (data.video.bgMode === 'video' && data.video.currentId ? '，正在播放' : '，未启用')) : '（视频目录里还没有视频）'),
@@ -3367,7 +3382,7 @@ window.__ModuleLoader__.load({
 
         cwH('div', { className: '__ss_group' },
           cwH('div', { className: '__ss_groupTitle' }, '背景图'),
-          cwH('div', { className: '__ss_hint' }, '点一下立刻换。第一张「默认背景（内置）」是插件自带、开箱就有的；把图丢进上面的目录也会出现在这里，按修改时间取最新那张。'),
+          cwH('div', { className: '__ss_hint' }, '点一下立刻换。前两张是插件自带的内置背景（默认 / 黑发雪夜战术少女），开箱就有；把图丢进上面的目录也会出现在这里，按修改时间取最新那张。'),
           data.images.length
             ? cwH('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 8 } }, data.images.map(thumb))
             : cwH('div', { className: '__ss_hint' }, '目录里还没有图。点「打开图片文件夹」，把 jpg / png / webp 丢进去，再点刷新。只扫描这一层，子文件夹里的不算（支持 jpg/png/webp/gif/avif/bmp）。'),

package/lib/host-startup.js

@@ -115,6 +115,9 @@ const DEFAULTS = {
   glitchB: '#2971b8',
   template: 'archive-warm',   // 第一幕默认：档案暖白
   act2: 'whale-girl-scan',    // 第二幕默认：鲸鱼娘扫描睁眼（2K）；另有 whale-girl-scan-4k；'' = 不播
+  /* v2.16.7：视频原声（第一幕 / 第二幕分开控制；默认静音） */
+  act1VideoSound: false,
+  act2VideoSound: false,
   /* v2.12.0 三段转场：第一幕入场 / 两幕衔接 / 第二幕退场。默认全部交叉叠化。 */
   transitionIn: 'dissolve',
   transitionJoin: 'dissolve',
@@ -166,7 +169,7 @@ const ENUMS = {
   transitionOut: TRANSITION_TYPES,
   transitionDir: TRANSITION_DIRS
 }
-const BOOL_KEYS = ['enabled', 'requireInteraction', 'allowSkip', 'sound', 'bedNoise', 'voice', 'voiceCue', 'bgmEnabled', 'bgmLoop', 'bgm2Loop', 'bgmDuck']
+const BOOL_KEYS = ['enabled', 'requireInteraction', 'allowSkip', 'sound', 'bedNoise', 'voice', 'voiceCue', 'bgmEnabled', 'bgmLoop', 'bgm2Loop', 'bgmDuck', 'act1VideoSound', 'act2VideoSound']
 /** 数值字段的合法区间（越界即夹取）。 */
 const RANGES = {
   welcomeDelay: [0, 3000],

package/lib/host-wallpaper.js

@@ -21,13 +21,26 @@ const HOME = process.env.DSH_HOME ?? join(homedir(), '.dsh')
 const CONFIG_FILE = join(HOME, 'chat-wallpaper.json')
 
 /* v2.13.1：插件自带一张默认背景图（随安装包上传，新装用户开箱就有底图）。
-   两个哨兵值写进 config.image：
-     __default__ = 明确选内置默认图（用户自己的图不参与自动挑选）
-     __none__    = 明确不要背景图（否则空字符串在"丢图目录里有图"时会自动挑最新那张） */
-const BUILTIN_IMAGE = join(dirname(fileURLToPath(import.meta.url)), 'assets', 'default-background.jpg')
-const BUILTIN_IMAGE_ID = '__default__'
+   v2.16.8：新增第二张内置背景（可选，默认仍是第一张）；两张都随包分发、删不掉。
+   哨兵值写进 config.image：
+     __default__  = 明确选内置默认图（用户自己的图不参与自动挑选）
+     __snowgirl__ = 明确选内置第二张「黑发雪夜战术少女」
+     __none__     = 明确不要背景图（否则空字符串在"丢图目录里有图"时会自动挑最新那张） */
+const ASSETS_DIR = join(dirname(fileURLToPath(import.meta.url)), 'assets')
+const BUILTIN_IMAGES = [
+  { id: '__default__', name: '默认背景（内置）', file: join(ASSETS_DIR, 'default-background.jpg') },
+  { id: '__snowgirl__', name: '黑发雪夜战术少女（内置）', file: join(ASSETS_DIR, 'builtin-background-snowgirl.png') },
+]
+const BUILTIN_IMAGE = BUILTIN_IMAGES[0].file
+const BUILTIN_IMAGE_ID = BUILTIN_IMAGES[0].id
 const NO_IMAGE_ID = '__none__'
 
+/** 按哨兵 id 找内置图 */
+function builtinById(id) {
+  if (!id) return null
+  return BUILTIN_IMAGES.find((b) => b.id === id) || null
+}
+
 /** 默认配置。字段与客户端半边一一对应。 */
 const DEFAULTS = {
   /* 聊天底图：往 ~/.dsh/chat-wallpaper/ 里丢张图就自动换背景。
@@ -158,13 +171,17 @@ function isImageFile(p) {
 }
 function resolveImage(cfg) {
   if (cfg.image === NO_IMAGE_ID) return { file: null, source: 'none' }
-  if (cfg.image === BUILTIN_IMAGE_ID) {
-    return isImageFile(BUILTIN_IMAGE) ? { file: BUILTIN_IMAGE, source: 'builtin' } : { file: null, source: 'none' }
+  const picked = builtinById(cfg.image)
+  if (picked) {
+    return isImageFile(picked.file)
+      ? { file: picked.file, source: 'builtin', builtinId: picked.id, builtinName: picked.name }
+      : { file: null, source: 'none' }
   }
   if (cfg.image && isImageFile(cfg.image)) return { file: cfg.image, source: 'config' }
   const list = listImages()
   if (list.length) return { file: list[0].file, source: 'your-library' }
-  if (isImageFile(BUILTIN_IMAGE)) return { file: BUILTIN_IMAGE, source: 'builtin' }
+  const fallback = BUILTIN_IMAGES[0]
+  if (isImageFile(fallback.file)) return { file: fallback.file, source: 'builtin', builtinId: fallback.id, builtinName: fallback.name }
   return { file: null, source: 'none' }
 }
 
@@ -374,12 +391,13 @@ export default {
         let file = null
         if (want) {
           const wanted = String(want)
-          if (wanted === BUILTIN_IMAGE_ID) {
-            if (isImageFile(BUILTIN_IMAGE)) file = BUILTIN_IMAGE
+          const picked = builtinById(wanted)
+          if (picked) {
+            if (isImageFile(picked.file)) file = picked.file
           } else {
             const cand = join(wallpaperImageDir(), basename(wanted))
             if (isImageFile(cand)) file = cand
-            /* 兼容旧 URL：只有用户目录没有同名文件时才回落到内置图 */
+            /* 兼容旧 URL：只有用户目录没有同名文件时才回落到内置默认图 */
             else if (wanted === 'default-background.jpg' && isImageFile(BUILTIN_IMAGE)) file = BUILTIN_IMAGE
           }
         } else {
@@ -416,18 +434,22 @@ export default {
           dropDirExists: existsSync(dir),
           current: cur.file ? cur.file.replace(/\\/g, '/') : null,
           imageSource: cur.source,
+          builtinId: cur.builtinId || '',
+          builtinName: cur.builtinName || '',
           imageConfig: cfg.image || '',
           banner: cfg.banner || '',
           bannerOpacity: cfg.bannerOpacity == null ? 0.12 : cfg.bannerOpacity,
           images: [
-            ...(existsSync(BUILTIN_IMAGE) ? [{
-              name: '默认背景（内置）',
-              url: '/chat-wallpaper/image?name=' + encodeURIComponent(BUILTIN_IMAGE_ID),
-              sizeKB: Math.round(statSync(BUILTIN_IMAGE).size / 1024),
+            ...BUILTIN_IMAGES.filter((b) => existsSync(b.file)).map((b) => ({
+              id: b.id,
+              builtinId: b.id,
+              name: b.name,
+              url: '/chat-wallpaper/image?name=' + encodeURIComponent(b.id),
+              sizeKB: Math.round(statSync(b.file).size / 1024),
               mtime: '',
               builtin: true,
-              selected: cur.source === 'builtin',
-            }] : []),
+              selected: cur.source === 'builtin' && cur.builtinId === b.id,
+            })),
             ...listImages().map((c) => {
               const name = c.file.split(/[\\/]/).pop()
               return {
@@ -503,7 +525,7 @@ export default {
             if (k === 'image') {
               /* 只允许：空字符串（自动/内置默认）、两个哨兵、丢图目录里的文件名。
                  不接受任意绝对路径（避免成为本地任意文件读取原语）。 */
-              if (v === '' || v === NO_IMAGE_ID || v === BUILTIN_IMAGE_ID) {
+              if (v === '' || v === NO_IMAGE_ID || builtinById(String(v))) {
                 cfg.image = String(v || '')
                 applied.image = cfg.image
                 continue

package/lib/splash.js

@@ -489,6 +489,8 @@
   }
 
   var C = cfg()
+  /* v2.16.7：当前正在构建哪一幕的时间线（1=第一幕，2=第二幕），用于视频原声开关 */
+  var TIMELINE_ACT = 1
 
   /* 模板的配色。两条规矩：
      1) 用户手动挑过的颜色优先 —— 只有配置还是默认值时才让模板改；
@@ -1982,7 +1984,7 @@
      - 同源时顺手把作者编辑器侧栏藏掉，只留动画舞台。 */
   var iframeCleanup = null
 
-  function runIframeTemplate(tpl) {
+  function runIframeTemplate(tpl, afterIframe) {
     diagRun('iframe template ' + tpl.id)
     var entry = String(tpl.entry || 'index.html').replace(/^\/+/, '')
     var wrap = document.createElement('div')
@@ -2052,6 +2054,9 @@
       finishOnce()
     }
     return done.then(function () {
+      /* v2.16.6：第一幕是 iframe 模板时，收尾前先把控制权交给调用方（接第二幕）；
+         没有 afterIframe 时保持原行为——直接走退场转场。 */
+      if (typeof afterIframe === 'function') return afterIframe()
       /* v2.15.11：模板不再自己做白闪；结尾由插件退场转场接管。
          这里不提前卸 iframe / 停 BGM，交给被转场盖住的 finish() 统一清理。 */
       return transOut(transType('Out'), finish)
@@ -2064,7 +2069,15 @@
     if (TEMPLATE && TEMPLATE.engine === 'iframe' && TEMPLATE.id) {
       /* v2.15.8：iframe 模板也支持用户自备 BGM（父页面播，模板自己演） */
       try { bgm.start() } catch (eBgmIframe) { /* 静默失败，绝不阻塞启动 */ }
-      return runIframeTemplate(TEMPLATE)
+      /* v2.16.6：iframe 第一幕结束后接第二幕（此前直接 finish，配了第二幕也永远不播） */
+      return runIframeTemplate(TEMPLATE, function () {
+        if (iframeCleanup) { try { iframeCleanup() } catch (eCleanIframe) { /* noop */ } iframeCleanup = null }
+        return playSecondTemplate()
+          .then(function () { return secondTransitionDone ? finish() : transOut(transType('Out'), finish) })
+      }).catch(function (errIframe) {
+        try { console.warn('[dsh-startup-screen] iframe+第二幕异常，直接收尾：', errIframe) } catch (e2) {}
+        return finish()
+      })
     }
     diagRun('run enter timeline=' + (TIMELINE ? 'v2' : 'v1') + ' tpl=' + ((TEMPLATE && TEMPLATE.id) || '?') + ' tpl2=' + ((TEMPLATE2 && TEMPLATE2.id) || 'none'))
     audio.bedStart()   /* 本地补丁：开机即"开通道"，底噪一路铺到揭幕 */
@@ -2453,8 +2466,10 @@
         var vnode = document.createElement('video')
         vnode.className = 'dsu-tl-layer dsu-tl-video'
         vnode.setAttribute('data-layer', String(L.id || ('video-' + i)))
-        vnode.muted = true
-        vnode.defaultMuted = true
+        /* v2.16.7：视频原声开关——第一幕用 act1VideoSound，第二幕用 act2VideoSound；默认静音 */
+        var vSoundOn = TIMELINE_ACT === 2 ? (C.act2VideoSound === true) : (C.act1VideoSound === true)
+        vnode.muted = !vSoundOn
+        vnode.defaultMuted = !vSoundOn
         vnode.autoplay = true
         vnode.playsInline = true
         vnode.preload = 'auto'
@@ -2495,7 +2510,13 @@
         diagRun('video append ' + vfile + ' vids=' + videoCount())
         try {
           var vp0 = vnode.play()
-          if (vp0 && vp0.catch) vp0.catch(function () {})
+          if (vp0 && vp0.catch) vp0.catch(function (eAudio) {
+            if (!vSoundOn) return
+            /* v2.16.7：未静音自动播放可能被浏览器策略拦下——退回静音再播，保证画面不卡 */
+            try { vnode.muted = true; vnode.defaultMuted = true } catch (eMute) {}
+            try { var vpM = vnode.play(); if (vpM && vpM.catch) vpM.catch(function () {}) } catch (eMute2) {}
+            diagRun('video audio blocked, fallback muted ' + vfile)
+          })
         } catch (ePlay) { /* autoplay blocked */ }
         if (vnode.requestVideoFrameCallback) {
           var vFrames = 0, vT0 = 0
@@ -3184,6 +3205,7 @@
   /* 第二幕分支是否已经自己处理过「第二幕→桌面」退场（v2 主链路据此决定要不要再包 transOut） */
   var secondTransitionDone = false
   function playSecondTemplate() {
+    TIMELINE_ACT = 2
     if (secondStarted) { diagRun('second skipped (duplicate)'); return Promise.resolve() }
     secondStarted = true
     diagRun('second enter tlSwap=' + !!tlSwap)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-boot-suite",
-  "version": "2.16.5",
+  "version": "2.16.8",
   "description": "两幕启动动画（默认档案暖白 + 鲸鱼娘扫描睁眼，2K/4K 可切），支持导入视频/图片、三段转场、11→6 套配音音色与 5 种声音效果、聊天背景/循环视频、内置 iframe 启动模板（全景大肥鱼-含彩蛋版）与更新前自动回滚。",
   "keywords": [
     "dsh",

package/test/smoke-package.mjs

@@ -85,7 +85,8 @@ for (const f of ['index.html', 'render.html']) {
 if (bigfishApp.includes('flashEl')) throw new Error('app.js 仍引用模板白闪 flashEl')
 if (bigfishApp.includes('flashEl')) throw new Error('app.js 仍残留白闪动画')
 if (skipCss.includes('#flash')) throw new Error('style.css 仍残留 #flash 样式')
-if (!/return done\.then\(function \(\) \{[\s\S]{0,260}transOut\(transType\('Out'\), finish\)/.test(splashJs)) throw new Error('iframe 模板收尾未交给插件退场转场')
+if (!/if \(typeof afterIframe === 'function'\) return afterIframe\(\)/.test(splashJs)) throw new Error('iframe 模板收尾未支持第二幕回调')
+if (!/return done\.then\(function \(\) \{[\s\S]{0,420}transOut\(transType\('Out'\), finish\)/.test(splashJs)) throw new Error('iframe 模板收尾未交给插件退场转场')
 /* v2.15.12：结尾等配音时圆环继续转 */
 if (!bigfishApp.includes('const rt=t+waitSec')) throw new Error('结尾圆环未使用连续旋转时钟 rt')
 if (!bigfishApp.includes('rotate(${rt*5})')) throw new Error('外圈未使用 rt 旋转')
@@ -176,4 +177,28 @@ if (!clientSrc.includes('aria-haspopup')) throw new Error('client.js 自绘下
 if (!clientSrc.includes('function CwSelect(')) throw new Error('client.js 聊天背景缺少 CwSelect')
 if (clientSrc.includes("h('select',")) throw new Error('client.js 仍残留原生 select（设置页）')
 if (clientSrc.includes("cwH('select',")) throw new Error('client.js 仍残留原生 select（聊天背景）')
+/* v2.16.6：第一幕是 iframe 模板时也要接第二幕 */
+if (!splashSrc.includes('function runIframeTemplate(tpl, afterIframe)')) throw new Error('splash.js 未给 iframe 模板留第二幕回调')
+if (!splashSrc.includes('runIframeTemplate(TEMPLATE, function () {')) throw new Error('splash.js iframe 首幕未接第二幕')
+if (!splashSrc.includes('afterIframe')) throw new Error('splash.js 缺少 afterIframe 处理')
+/* v2.16.7：视频原声开关 + 掉线彩蛋底图 */
+const hostSrcV2167 = fs.readFileSync(path.join(root, 'lib/host-startup.js'), 'utf8')
+if (!hostSrcV2167.includes('act1VideoSound: false')) throw new Error('host-startup 缺少第一幕视频原声默认值')
+if (!hostSrcV2167.includes('act2VideoSound: false')) throw new Error('host-startup 缺少第二幕视频原声默认值')
+if (!hostSrcV2167.includes("'act1VideoSound'") || !hostSrcV2167.includes("'act2VideoSound'")) throw new Error('host-startup 的 BOOL_KEYS 缺少视频原声开关')
+if (!splashSrc.includes('act2VideoSound === true')) throw new Error('splash.js 缺少第二幕视频原声分支')
+if (!splashSrc.includes('fallback muted')) throw new Error('splash.js 缺少未静音自动播放失败回退')
+if (!clientSrc.includes('第一幕视频原声') || !clientSrc.includes('第二幕视频原声')) throw new Error('client.js 缺少视频原声设置项')
+const eggBg = path.join(root, 'templates/division-bigfish-codex/assets/egg-bg.png')
+if (!fs.existsSync(eggBg)) throw new Error('缺少掉线彩蛋底图 egg-bg.png')
+if (fs.statSync(eggBg).size < 1000000) throw new Error('掉线彩蛋底图疑似未替换（文件过小）')
+/* v2.16.8：聊天背景第二张内置背景（可选，不改变默认） */
+const wallSrcV2168 = fs.readFileSync(path.join(root, 'lib/host-wallpaper.js'), 'utf8')
+if (!wallSrcV2168.includes('BUILTIN_IMAGES')) throw new Error('host-wallpaper 缺少多张内置背景表')
+if (!wallSrcV2168.includes("'__snowgirl__'")) throw new Error('host-wallpaper 缺少第二张内置背景哨兵')
+if (!wallSrcV2168.includes('builtinName')) throw new Error('host-wallpaper 缺少内置背景名称回传')
+if (!clientSrc.includes('builtinName')) throw new Error('client.js 缺少内置背景名称显示')
+const snowBg = path.join(root, 'lib/assets/builtin-background-snowgirl.png')
+if (!fs.existsSync(snowBg)) throw new Error('缺少第二张内置背景图 builtin-background-snowgirl.png')
+if (fs.statSync(snowBg).size < 1000000) throw new Error('第二张内置背景图疑似不完整')
 console.log('ok  package.json version=' + pkg.version + '，无 BOM，关键文件齐全（含更新前回滚 checkpoint）');

package/test/smoke-wallpaper-client.mjs

@@ -463,7 +463,7 @@ ok(intervals.every((t) => t.cleared) || intervals.length === 0, '旧的 interval
   intervals.map((t) => (t.cleared ? 'cleared' : 'live')).join(','))
 
 console.log('\n=== ⑦ v2.13.0 测试钩子 / BUILD ===')
-ok(mod.__BUILD === 'cw-71', '__BUILD = cw-68（排查浏览器跑的是不是新包）', String(mod.__BUILD))
+ok(mod.__BUILD === 'cw-74', '__BUILD = cw-68（排查浏览器跑的是不是新包）', String(mod.__BUILD))
 ok(mod.__VIDEO_ID === 'dsh-cw-video', '__VIDEO_ID = dsh-cw-video', String(mod.__VIDEO_ID))
 ok(typeof mod.__startShuffle === 'function', '__startShuffle 导出')
 ok(typeof mod.__stopShuffle === 'function', '__stopShuffle 导出')

package/test/smoke-wallpaper-host.mjs

@@ -196,10 +196,12 @@ try {
     sortKeys(r.json))
   check('/images 的 dropDir 指向临时 DSH_HOME',
     r.json && r.json.dropDir.includes(HOME.replace(/\\/g, '/')), r.json && r.json.dropDir)
-  check('★ /images 默认列出「默认背景（内置）」，且 marked builtin/selected',
-    r.json && Array.isArray(r.json.images) && r.json.images.length === 1 &&
+  check('★ /images 默认列出两张内置背景（默认图 selected，第二张可选）',
+    r.json && Array.isArray(r.json.images) && r.json.images.length === 2 &&
     r.json.images[0].builtin === true && r.json.images[0].selected === true &&
-    r.json.images[0].url.includes('__default__'),
+    r.json.images[0].url.includes('__default__') &&
+    r.json.images[1].builtin === true && r.json.images[1].selected === false &&
+    r.json.images[1].url.includes('__snowgirl__'),
     JSON.stringify(r.json && r.json.images))
   check('/images.imageSource = builtin、imageConfig 为空',
     r.json && r.json.imageSource === 'builtin' && r.json.imageConfig === '',
@@ -323,9 +325,10 @@ try {
     r.json && r.json.imageSource === 'your-library', r.json && r.json.imageSource)
 
   r = await callJson('exact /chat-wallpaper/images')
-  check('★ 丢图后 /images 列出 2 张：内置默认图在前、用户的在后',
-    r.json && Array.isArray(r.json.images) && r.json.images.length === 2 &&
-    r.json.images[0].builtin === true && r.json.images[1].name === 'smoke-bg.png',
+  check('★ 丢图后 /images 列出 3 张：两张内置在前、用户的在后',
+    r.json && Array.isArray(r.json.images) && r.json.images.length === 3 &&
+    r.json.images[0].builtin === true && r.json.images[1].builtin === true &&
+    r.json.images[2].name === 'smoke-bg.png' && r.json.images[2].selected === true,
     JSON.stringify(r.json && r.json.images))
   check('丢图后 /images.current 指向它、imageSource = your-library',
     r.json && typeof r.json.current === 'string' && r.json.current.endsWith('smoke-bg.png') &&