dsh-boot-suite 2.16.0 → 2.16.5

package/CHANGELOG.md

@@ -1,3 +1,39 @@
+## [2.16.5] — 2026-11-04
+
+- 下拉菜单加不透明底：皮肤把 `--dsw-alias-bg-layer-2` 定义成半透明，菜单会透出背后的说明文字。现在改用近不透明的 `--dsw-alias-bg-overlay` 双层叠加（≈99%，跟随浅/深主题）+ 轻微背景模糊，选项清晰可读。
+- 悬停底色、选中项颜色补了 fallback，皮肤未定义对应 token 时也能正常高亮。
+- 版本 2.16.5，构建号 cw-71。
+
+## [2.16.4] — 2026-11-04
+
+- 修复 v2.16.3 的自绘下拉：10 条新样式少了开头的 `.`，实际没有生效——触发按钮的框消失、菜单没有外框、每个选项露出浏览器默认白边。
+- 现在触发按钮恢复原生 select 的边框/底色/内边距，下拉菜单整块是一个带边框和阴影的框（随皮肤 3D 面板倾斜），选项是紧凑的纯文字行（无白框），排版与原生下拉列表一致。
+- 版本 2.16.4，构建号 cw-70。
+
+## [2.16.3] — 2026-11-04
+
+- 设置页所有下拉（启动动画、聊天背景、配音音色、转场等）改为自绘菜单，不再用系统原生 `<select>`：原生弹层无法被 CSS 3D 变换作用，所以之前不跟封锁橙皮肤的倾斜面板。
+- 自绘菜单渲染在设置面板内部，自动继承面板的 `perspective(1000px) rotateY(-6.5deg) rotateX(1.6deg)`，展开时与面板同一个 3D 平面；默认皮肤和其他皮肤没有这段变换，菜单自然保持水平（无需额外检测）。
+- 下拉空间不足时自动向上展开；支持 Esc 关闭、点击外部关闭、滚动关闭，键盘可 Tab/Enter 操作。
+- 聊天背景的「图片适配 / 背景类型 / 播放模式 / 色彩模式」四个下拉同样改为自绘。
+- 版本 2.16.3，构建号 cw-69。
+
+## [2.16.2] — 2026-11-03
+
+- **安装器代理加固**：开着代理安装时，pnpm 访问 npm registry 可能长时间卡在 [2/3]（用户实测等很久无响应，关代理马上恢复）。现在会先检测并提示（5 秒后自动继续），同时把 pnpm 的 fetch 超时收紧到 30 秒、失败后自动用国内镜像重试一次。
+- **桌面升级助手**增加提示：卡在第二步时关掉代理再双击一次。
+- **修复「鲸鱼娘扫描睁眼（4K H.264）」没有出现在第二幕下拉**：新增的 4K H.264 模板没加进「正式模板」白名单，会被当成测试类模板藏起来；现已补进白名单。
+- 版本号 2.16.2，构建号 cw-68。
+
+## [2.16.1] — 2026-11-03
+
+- **新增第二幕模板「鲸鱼娘扫描睁眼（4K H.264）」**：把原 4K 视频转码为 H.264 High 8bit（3840×2160 / 24fps / 约 9.6 Mbps，8.4MB），兼容性最好；部分机器没有 AV1 硬解、4K AV1 会走 CPU 软解导致掉帧，可改用本版。
+- **原 4K 模板改名**为「鲸鱼娘扫描睁眼（4K AV1）」，描述里注明 AV1 编码与掉帧时的替代方案。
+- **第二幕视频诊断**：诊断日志新增 `video meta`（分辨率/时长）与 `video stats`（实测帧率、丢帧数/总帧数、是否被暂停），4K 掉帧问题可以直接看日志定位。
+- **省电暂停自动恢复**：Chromium 会把不可见的静音视频暂停省电（video-only background media paused to save power），现在检测到暂停会自动恢复，不再表现为卡住/掉帧。
+- **消除 play() 噪音**：第二幕被跳过/收尾时 `play()` 的未捕获 promise 报错不再写进诊断日志。
+- 版本号 2.16.1，构建号 cw-67。
+
 ## [2.16.0] — 2026-11-02
 
 - **全景大肥鱼新增第二节登录 ID 动画**：第一节（登录 ID 段）延长到约 5.8s、只保留「检测到新的特工登录」；第二节 5s 登录动画，「WELCOME TO DEEPSEEK HARNESS」乱码→逐字、橙色扫描线从上往下、「正在登录：自定义用户名」按贝塞尔曲线平滑居中、用户名破解式逐字出现（最多 20 字符，过滤系统冲突符号）。

package/lib/client.js

@@ -60,7 +60,17 @@ window.__ModuleLoader__.load({
       '.__ss_err{font-size:12px;color:var(--dsw-alias-state-error-primary,#f85149)}',
       '.__ss_swatch{width:38px;height:26px;padding:0;border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:transparent;cursor:pointer}',
       '.__ss_preview{margin-top:2px;border:1px dashed var(--dsw-alias-border-l2);border-radius:10px;padding:10px 12px;display:flex;align-items:center;justify-content:space-between;gap:12px}',
-      '.__ss_previewText{font-size:12px;color:var(--dsw-alias-label-tertiary);line-height:1.5}'
+      '.__ss_previewText{font-size:12px;color:var(--dsw-alias-label-tertiary);line-height:1.5}',
+      '.__ss_selectWrap{position:relative;display:inline-block;min-width:180px;max-width:100%}',
+      '.__ss_select{display:flex;align-items:center;justify-content:space-between;gap:10px;width:100%;cursor:pointer;text-align:left}',
+      '.__ss_select.is-open{border-color:var(--dsw-alias-state-business-primary)}',
+      '.__ss_selectLabel{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '.__ss_selectCaret{flex:none;opacity:.7;font-size:11px}',
+      '.__ss_selectMenu{position:absolute;left:0;right:0;top:calc(100% + 4px);z-index:40;display:flex;flex-direction:column;gap:0;padding:4px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background-color:#1b1d22;background-image:linear-gradient(var(--dsw-alias-bg-overlay, rgba(22,23,27,.95)), var(--dsw-alias-bg-overlay, rgba(22,23,27,.95))),linear-gradient(var(--dsw-alias-bg-overlay, rgba(22,23,27,.95)), var(--dsw-alias-bg-overlay, rgba(22,23,27,.95)));backdrop-filter:blur(8px);box-shadow:0 10px 28px rgba(0,0,0,.45);max-height:280px;overflow:auto;box-sizing:border-box}',
+      '.__ss_selectMenu.is-up{top:auto;bottom:calc(100% + 4px)}',
+      '.__ss_selectItem{display:block;width:100%;text-align:left;border:none;background:transparent;color:var(--dsw-alias-label-primary);border-radius:6px;padding:6px 8px;font:inherit;font-size:13px;cursor:pointer}',
+      '.__ss_selectItem:hover{background:var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,.12))}',
+      '.__ss_selectItem.is-on{color:var(--dsw-alias-state-business-primary, var(--dsw-alias-brand-primary, #e6762b));font-weight:600}'
     ].join('')
     var tagId = 'dsh-startup-screen/main.css'
     if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css="' + tagId + '"]') === null) {
@@ -93,13 +103,109 @@ window.__ModuleLoader__.load({
     }
 
     function Select(props) {
-      return h('select', {
-        className: '__ss_select',
-        value: props.value,
-        onChange: (e) => props.onChange(e.target.value)
-      }, props.options.map((o) => h('option', { key: o[0], value: o[0] }, o[1])))
+      var openState = react.useState(false)
+      var open = openState[0]
+      var setOpen = openState[1]
+      var upState = react.useState(false)
+      var openUp = upState[0]
+      var setOpenUp = upState[1]
+      var wrapRef = react.useRef(null)
+      var btnRef = react.useRef(null)
+      var opts = props.options || []
+      var cur = opts.find(function (o) { return String(o[0]) === String(props.value) }) || opts[0] || ['', '']
+      var label = cur[1]
+
+      function measure() {
+        var el = btnRef.current
+        if (!el) return
+        var r = el.getBoundingClientRect()
+        var topLimit = 8
+        var bottomLimit = (window.innerHeight || 800) - 8
+        var node = el.parentNode
+        while (node && node.nodeType === 1 && node !== document.body) {
+          var st = window.getComputedStyle(node)
+          if (/(auto|scroll)/.test(st.overflowY) && node.clientHeight > 0) {
+            var nr = node.getBoundingClientRect()
+            topLimit = Math.max(topLimit, nr.top + 2)
+            bottomLimit = Math.min(bottomLimit, nr.bottom - 2)
+            break
+          }
+          node = node.parentNode
+        }
+        var below = bottomLimit - r.bottom
+        var above = r.top - topLimit
+        var useUp = below < 280 && above > below
+        setOpenUp(useUp)
+        var maxH = Math.max(120, Math.min(280, (useUp ? above : below) - 8))
+        if (wrapRef.current) {
+          wrapRef.current.style.setProperty('--ss-menu-max', maxH + 'px')
+          var menu = wrapRef.current.querySelector('.__ss_selectMenu')
+          if (menu) menu.style.maxHeight = maxH + 'px'
+        }
+      }
+
+      react.useEffect(function () {
+        if (!open) return
+        measure()
+        function onDocDown(e) {
+          if (!wrapRef.current) return
+          if (!wrapRef.current.contains(e.target)) setOpen(false)
+        }
+        function onKey(e) {
+          if (e.key === 'Escape') {
+            setOpen(false)
+            try { btnRef.current.focus() } catch (err) {}
+          }
+        }
+        function onScroll(e) {
+          if (!wrapRef.current) return
+          if (!wrapRef.current.contains(e.target)) setOpen(false)
+        }
+        document.addEventListener('mousedown', onDocDown, true)
+        document.addEventListener('keydown', onKey, true)
+        window.addEventListener('scroll', onScroll, true)
+        return function () {
+          document.removeEventListener('mousedown', onDocDown, true)
+          document.removeEventListener('keydown', onKey, true)
+          window.removeEventListener('scroll', onScroll, true)
+        }
+      }, [open])
+
+      return h('div', { className: '__ss_selectWrap' + (open ? ' is-open' : ''), ref: wrapRef },
+        h('button', {
+          className: '__ss_select' + (open ? ' is-open' : ''),
+          type: 'button',
+          ref: btnRef,
+          'aria-haspopup': 'listbox',
+          'aria-expanded': open ? 'true' : 'false',
+          onClick: function () { setOpen(!open) }
+        },
+          h('span', { className: '__ss_selectLabel' }, label),
+          h('span', { className: '__ss_selectCaret', 'aria-hidden': 'true' }, 'v')
+        ),
+        open ? h('div', {
+          className: '__ss_selectMenu' + (openUp ? ' is-up' : ''),
+          role: 'listbox',
+          style: { maxHeight: 'var(--ss-menu-max, 280px)' }
+        }, opts.map(function (o) {
+          var on = String(o[0]) === String(props.value)
+          return h('button', {
+            key: o[0],
+            type: 'button',
+            role: 'option',
+            'aria-selected': on ? 'true' : 'false',
+            className: '__ss_selectItem' + (on ? ' is-on' : ''),
+            onClick: function () {
+              setOpen(false)
+              if (on) return
+              props.onChange(o[0])
+            }
+          }, o[1])
+        })) : null
+      )
     }
 
+
     function Check(props) {
       return h('label', { className: '__ss_check' },
         h('input', {
@@ -269,7 +375,7 @@ window.__ModuleLoader__.load({
           —— 桌面端走浏览器半侧自举时没有 1，就靠这一条
        3) 下面这个常量：两份都没拿到时的兜底，别让面板显示 undefined
        版本号本身只在 lib/index.js 里读一次，这里不重复维护。 */
-    var FALLBACK_VERSION = '2.16.0'
+    var FALLBACK_VERSION = '2.16.5'
     /* 手动选包成功后置 true：让还在后台跑的“浏览器下载监听”不要再弹第二次更新器 */
     var __manualUpdateApplied = false
     function readInjectedVersion() {
@@ -903,7 +1009,7 @@ window.__ModuleLoader__.load({
       /* v2.14.0：模板分类。正式下拉只放「正式模板」；其余归到「测试类模板」。
          默认：内置模板里只有 archive-warm（第一幕）与 whale-girl-scan / -4k（第二幕）算正式；
          用户本地导入的算正式；被手动「归类」或「移出」的以配置为准。 */
-      var PROD_TEMPLATES = { template: { 'archive-warm': 1 }, act2: { 'whale-girl-scan': 1, 'whale-girl-scan-4k': 1 } }
+      var PROD_TEMPLATES = { template: { 'archive-warm': 1 }, act2: { 'whale-girl-scan': 1, 'whale-girl-scan-4k': 1, 'whale-girl-scan-4k-h264': 1 } }
       function findTemplate(id) {
         for (var fi = 0; fi < (templates || []).length; fi++) if (templates[fi] && templates[fi].id === id) return templates[fi]
         return null
@@ -2022,7 +2128,7 @@ window.__ModuleLoader__.load({
     /* 每次改客户端就把这个号 +1。
        有了它在控制台一眼就能判断"浏览器里跑的是不是最新那份" ——
        排查问题时，分不清是代码问题还是旧包，会白猜一轮。 */
-    var BUILD = 'cw-66'
+    var BUILD = 'cw-71'
 
     function log() {
       try {
@@ -2979,6 +3085,107 @@ window.__ModuleLoader__.load({
        与「启动动画」并列（order 26 → 27）。数据走宿主自带的 HTTP 接口（/chat-wallpaper/*）。 */
     var cwReact = require('react')
     var cwH = cwReact.createElement
+    /* v2.16.3：自绘下拉（跟随设置面板的 3D 平面；原生 <select> 的系统弹层无法被 CSS 变换） */
+    function CwSelect(props) {
+      var openState = cwReact.useState(false)
+      var open = openState[0]
+      var setOpen = openState[1]
+      var upState = cwReact.useState(false)
+      var openUp = upState[0]
+      var setOpenUp = upState[1]
+      var wrapRef = cwReact.useRef(null)
+      var btnRef = cwReact.useRef(null)
+      var opts = props.options || []
+      var cur = opts.find(function (o) { return String(o[0]) === String(props.value) }) || opts[0] || ['', '']
+
+      function measure() {
+        var el = btnRef.current
+        if (!el) return
+        var r = el.getBoundingClientRect()
+        var topLimit = 8
+        var bottomLimit = (window.innerHeight || 800) - 8
+        var node = el.parentNode
+        while (node && node.nodeType === 1 && node !== document.body) {
+          var st = window.getComputedStyle(node)
+          if (/(auto|scroll)/.test(st.overflowY) && node.clientHeight > 0) {
+            var nr = node.getBoundingClientRect()
+            topLimit = Math.max(topLimit, nr.top + 2)
+            bottomLimit = Math.min(bottomLimit, nr.bottom - 2)
+            break
+          }
+          node = node.parentNode
+        }
+        var below = bottomLimit - r.bottom
+        var above = r.top - topLimit
+        var useUp = below < 280 && above > below
+        setOpenUp(useUp)
+        var maxH = Math.max(120, Math.min(280, (useUp ? above : below) - 8))
+        if (wrapRef.current) {
+          var menu = wrapRef.current.querySelector('.__ss_selectMenu')
+          if (menu) menu.style.maxHeight = maxH + 'px'
+        }
+      }
+
+      cwReact.useEffect(function () {
+        if (!open) return
+        measure()
+        function onDocDown(e) {
+          if (!wrapRef.current) return
+          if (!wrapRef.current.contains(e.target)) setOpen(false)
+        }
+        function onKey(e) {
+          if (e.key === 'Escape') {
+            setOpen(false)
+            try { btnRef.current.focus() } catch (err) {}
+          }
+        }
+        function onScroll(e) {
+          if (!wrapRef.current) return
+          if (!wrapRef.current.contains(e.target)) setOpen(false)
+        }
+        document.addEventListener('mousedown', onDocDown, true)
+        document.addEventListener('keydown', onKey, true)
+        window.addEventListener('scroll', onScroll, true)
+        return function () {
+          document.removeEventListener('mousedown', onDocDown, true)
+          document.removeEventListener('keydown', onKey, true)
+          window.removeEventListener('scroll', onScroll, true)
+        }
+      }, [open])
+
+      return cwH('div', { className: '__ss_selectWrap' + (open ? ' is-open' : ''), ref: wrapRef },
+        cwH('button', {
+          className: '__ss_select' + (open ? ' is-open' : ''),
+          type: 'button',
+          ref: btnRef,
+          disabled: !!props.disabled,
+          'aria-haspopup': 'listbox',
+          'aria-expanded': open ? 'true' : 'false',
+          onClick: function () { if (!props.disabled) setOpen(!open) }
+        },
+          cwH('span', { className: '__ss_selectLabel' }, cur[1]),
+          cwH('span', { className: '__ss_selectCaret', 'aria-hidden': 'true' }, 'v')
+        ),
+        open ? cwH('div', { className: '__ss_selectMenu' + (openUp ? ' is-up' : ''), role: 'listbox' },
+          opts.map(function (o) {
+            var on = String(o[0]) === String(props.value)
+            return cwH('button', {
+              key: o[0],
+              type: 'button',
+              role: 'option',
+              'aria-selected': on ? 'true' : 'false',
+              className: '__ss_selectItem' + (on ? ' is-on' : ''),
+              onClick: function () {
+                setOpen(false)
+                if (on) return
+                props.onChange(o[0])
+              }
+            }, o[1])
+          })
+        ) : null
+      )
+    }
+
 
     /** 把 rgba(...) 里的 alpha 换掉，保留 RGB。 */
     function withAlpha(color, a) {
@@ -3166,14 +3373,7 @@ window.__ModuleLoader__.load({
             : cwH('div', { className: '__ss_hint' }, '目录里还没有图。点「打开图片文件夹」，把 jpg / png / webp 丢进去，再点刷新。只扫描这一层，子文件夹里的不算（支持 jpg/png/webp/gif/avif/bmp）。'),
           cwH('div', { className: '__ss_row', style: { marginTop: 8 } },
             cwH('span', { className: '__ss_status' }, '图片适配'),
-            cwH('select', {
-              className: '__ss_select', disabled: busy,
-              value: data.imageFit,
-              onChange: function (ev) { apply({ imageFit: ev.target.value }, true) }
-            },
-              cwH('option', { value: 'cover' }, '铺满窗口（裁切多余部分）'),
-              cwH('option', { value: 'contain' }, '完整显示（不裁切，留底色边）')
-            )
+            cwH(CwSelect, { value: data.imageFit, disabled: busy, options: [['cover', '铺满窗口（裁切多余部分）'], ['contain', '完整显示（不裁切，留底色边）']], onChange: function (v) { apply({ imageFit: v }, true) } })
           ),
           cwH('div', { className: '__ss_row' },
             cwH('button', { className: '__ss_btn', type: 'button', disabled: busy, onClick: function () { apply({ image: NO_IMAGE_ID }, true) } }, '不用背景图')
@@ -3187,34 +3387,13 @@ window.__ModuleLoader__.load({
           ),
           cwH('div', { className: '__ss_row', style: { marginTop: 8 } },
             cwH('span', { className: '__ss_status' }, '背景类型'),
-            cwH('select', {
-              className: '__ss_select', disabled: busy,
-              value: data.video.bgMode,
-              onChange: function (ev) { apply({ bgMode: ev.target.value }, true) }
-            },
-              cwH('option', { value: 'image' }, '静态底图'),
-              cwH('option', { value: 'video' }, '循环视频')
-            ),
+            cwH(CwSelect, { value: data.video.bgMode, disabled: busy, options: [['image', '静态底图'], ['video', '循环视频']], onChange: function (v) { apply({ bgMode: v }, true) } }),
             cwH('span', { className: '__ss_status', style: { marginLeft: 16 } }, '播放模式'),
-            cwH('select', {
-              className: '__ss_select', disabled: busy,
-              value: data.video.videoMode,
-              onChange: function (ev) { apply({ videoMode: ev.target.value }, true) }
-            },
-              cwH('option', { value: 'single' }, '手动选择'),
-              cwH('option', { value: 'shuffle' }, '随机轮换')
-            )
+            cwH(CwSelect, { value: data.video.videoMode, disabled: busy, options: [['single', '手动选择'], ['shuffle', '随机轮换']], onChange: function (v) { apply({ videoMode: v }, true) } })
           ),
           cwH('div', { className: '__ss_row', style: { marginTop: 8 } },
             cwH('span', { className: '__ss_status' }, '色彩模式'),
-            cwH('select', {
-              className: '__ss_select', disabled: busy,
-              value: data.colorMode,
-              onChange: function (ev) { apply({ colorMode: ev.target.value }, true) }
-            },
-              cwH('option', { value: 'color' }, '彩色（默认）'),
-              cwH('option', { value: 'mono' }, '黑白（原版素材，不染色）')
-            )
+            cwH(CwSelect, { value: data.colorMode, disabled: busy, options: [['color', '彩色（默认）'], ['mono', '黑白（原版素材，不染色）']], onChange: function (v) { apply({ colorMode: v }, true) } })
           ),
           cwH('div', { className: '__ss_hint' }, '黑白模式会关掉主题色纱、保留原画面颜色，适合本身就是黑白的动态壁纸；彩色模式不做任何调色。'),
           data.video.videoMode === 'shuffle'

package/lib/splash.js

@@ -2476,10 +2476,54 @@
         vnode.addEventListener('play', function () { diagRun('video play ' + vfile + ' vids=' + videoCount()) })
         vnode.addEventListener('ended', function () { diagRun('video ended ' + vfile) })
         vnode.addEventListener('error', function () { diagRun('video error ' + vfile) })
+        /* v2.16.1：第二幕视频诊断（分辨率/时长/实测帧率/丢帧）+ 省电暂停自动恢复 + play() 失败静默 */
+        vnode.addEventListener('loadedmetadata', function () {
+          diagRun('video meta ' + vfile + ' ' + vnode.videoWidth + 'x' + vnode.videoHeight + ' dur=' + (isFinite(vnode.duration) ? vnode.duration.toFixed(2) : '?'))
+        })
+        var vResumeTimer = null
+        vnode.addEventListener('pause', function () {
+          /* Chromium 会把不可见的静音视频暂停省电；只要还在第二幕里就拉回来，避免“卡住/掉帧” */
+          if (vnode.ended || !vnode.isConnected || vResumeTimer) return
+          vResumeTimer = setTimeout(function () {
+            vResumeTimer = null
+            if (!vnode.isConnected || vnode.ended || !vnode.paused) return
+            try { var vpR = vnode.play(); if (vpR && vpR.catch) vpR.catch(function () {}) } catch (eR) { /* noop */ }
+          }, 260)
+        })
         placeLayer(vnode, tlNumber(L.pos && L.pos[0], 640), tlNumber(L.pos && L.pos[1], 360), vw, vh)
         stage.appendChild(vnode)
         diagRun('video append ' + vfile + ' vids=' + videoCount())
-        try { vnode.play() } catch (ePlay) { /* autoplay blocked */ }
+        try {
+          var vp0 = vnode.play()
+          if (vp0 && vp0.catch) vp0.catch(function () {})
+        } catch (ePlay) { /* autoplay blocked */ }
+        if (vnode.requestVideoFrameCallback) {
+          var vFrames = 0, vT0 = 0
+          var onVFrame = function (now) {
+            if (!vnode.isConnected) return
+            if (!vT0) { vT0 = now; vFrames = 0 }
+            vFrames += 1
+            if (now - vT0 < 1200) {
+              try { vnode.requestVideoFrameCallback(onVFrame) } catch (eF) { /* noop */ }
+              return
+            }
+            var vq = null
+            try { vq = vnode.getVideoPlaybackQuality() } catch (eQ) { /* noop */ }
+            var vFps = vT0 ? Math.round(vFrames * 1000 / (now - vT0)) : 0
+            diagRun('video stats ' + vfile + ' ' + vnode.videoWidth + 'x' + vnode.videoHeight + ' fps=' + vFps +
+              ' dropped=' + (vq ? vq.droppedVideoFrames : '?') + '/' + (vq ? vq.totalVideoFrames : '?') +
+              ' paused=' + vnode.paused)
+          }
+          try { vnode.requestVideoFrameCallback(onVFrame) } catch (eF0) { /* noop */ }
+        } else {
+          setTimeout(function () {
+            if (!vnode.isConnected) return
+            var vq2 = null
+            try { if (vnode.getVideoPlaybackQuality) vq2 = vnode.getVideoPlaybackQuality() } catch (eQ2) { /* noop */ }
+            diagRun('video stats ' + vfile + ' ' + vnode.videoWidth + 'x' + vnode.videoHeight +
+              ' dropped=' + (vq2 ? vq2.droppedVideoFrames : '?') + '/' + (vq2 ? vq2.totalVideoFrames : '?'))
+          }, 1500)
+        }
         nodes.push({ def: L, node: vnode, video: vnode })
         continue
       }

package/package.json

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

package/templates/whale-girl-scan-4k/template.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
   "id": "whale-girl-scan-4k",
-  "name": "鲸鱼娘扫描睁眼（4K）",
+  "name": "鲸鱼娘扫描睁眼（4K AV1）",
   "author": "素材：NativeDog1/dsh-boot-animation（BSD-3-Clause）；8K 超分：1catmint1/dsh-boot-animation-8k；模板维护：LeeRolling",
   "homepage": "https://github.com/LeeRolling/dsh-boot-suite",
   "license": "BSD-3-Clause",
   "version": "1.0.0",
-  "description": "鲸鱼娘「DeepSeek娘扫描睁眼」4K 版（3840×2160，7 秒），全屏播放 + 淡入淡出。由社区作者 1catmint1 的 8K 超分版下采样而来（8K 源：https://github.com/1catmint1/dsh-boot-animation-8k ，BSD-3-Clause）；原片：NativeDog1/dsh-boot-animation（BSD-3-Clause）。桌面版建议用本 4K 版或 2K 版，8K 版在桌面端有内存崩溃风险，仅建议网页端/收藏使用。",
+  "description": "鲸鱼娘「DeepSeek娘扫描睁眼」4K 版（3840×2160，7 秒，AV1 编码），全屏播放 + 淡入淡出。AV1 在部分机器上没有硬解、会走 CPU 软解导致掉帧；遇到掉帧请改用「鲸鱼娘扫描睁眼（4K H.264）」或 2K 版。由社区作者 1catmint1 的 8K 超分版下采样而来（8K 源：https://github.com/1catmint1/dsh-boot-animation-8k ，BSD-3-Clause）；原片：NativeDog1/dsh-boot-animation（BSD-3-Clause）。桌面版建议用本 4K 版或 2K 版，8K 版在桌面端有内存崩溃风险，仅建议网页端/收藏使用。",
   "tags": [
     "anime",
     "whale",

package/templates/whale-girl-scan-4k-h264/template.json

@@ -0,0 +1,104 @@
+{
+  "schemaVersion": 1,
+  "id": "whale-girl-scan-4k-h264",
+  "name": "鲸鱼娘扫描睁眼（4K H.264）",
+  "author": "素材：NativeDog1/dsh-boot-animation（BSD-3-Clause）；8K 超分：1catmint1/dsh-boot-animation-8k；模板维护：LeeRolling",
+  "homepage": "https://github.com/LeeRolling/dsh-boot-suite",
+  "license": "BSD-3-Clause",
+  "version": "1.0.0",
+  "description": "鲸鱼娘「DeepSeek娘扫描睁眼」4K H.264 版（3840×2160，24fps，7 秒，H.264 High 8bit 约 9.6Mbps），全屏播放 + 淡入淡出。由社区作者 1catmint1 的 8K 超分版下采样后转码为 H.264，兼容性最好：AV1 无硬解的机器（如部分 4K 掉帧环境）可改用本版。8K 源：https://github.com/1catmint1/dsh-boot-animation-8k （BSD-3-Clause）；原片：NativeDog1/dsh-boot-animation（BSD-3-Clause）。",
+  "tags": [
+    "anime",
+    "whale",
+    "video",
+    "cinematic"
+  ],
+  "duration": 7200,
+  "theme": {
+    "accent": "#4d6bfe",
+    "glitchA": "#ff3b30",
+    "glitchB": "#2971b8"
+  },
+  "segments": [
+    {
+      "name": "扫描 · 睁眼",
+      "from": 0,
+      "to": 7200
+    }
+  ],
+  "layers": [
+    {
+      "id": "bg",
+      "type": "panel",
+      "pos": [
+        640,
+        360
+      ],
+      "panelW": 1280,
+      "panelH": 720,
+      "fill": "#000000",
+      "radius": 0,
+      "keyframes": [
+        {
+          "t": 0,
+          "opacity": 1
+        }
+      ]
+    },
+    {
+      "id": "whale",
+      "type": "video",
+      "pos": [
+        640,
+        360
+      ],
+      "videoW": 1280,
+      "videoH": 720,
+      "src": "whale-girl-scan-4k-h264.mp4",
+      "keyframes": [
+        {
+          "t": 0,
+          "opacity": 1
+        },
+        {
+          "t": 7200,
+          "opacity": 1
+        }
+      ]
+    },
+    {
+      "id": "credit",
+      "type": "text",
+      "text": "WHALE GIRL · NATIVEDOG1/DSH-BOOT-ANIMATION · 8K SOURCE: 1CATMINT1 · BSD-3-CLAUSE",
+      "pos": [
+        640,
+        360
+      ],
+      "align": "center",
+      "font": {
+        "size": 9,
+        "weight": 400,
+        "tracking": 0.18
+      },
+      "color": "rgba(139,232,255,.55)",
+      "keyframes": [
+        {
+          "t": 0,
+          "opacity": 0,
+          "offsetY": 318
+        },
+        {
+          "t": 600,
+          "opacity": 1,
+          "offsetY": 318
+        },
+        {
+          "t": 7200,
+          "opacity": 1,
+          "offsetY": 318
+        }
+      ]
+    }
+  ],
+  "effects": []
+}

package/test/smoke-client.mjs

@@ -34,6 +34,13 @@ const React = {
     const i = hookIndex++
     if (!ranEffects.has(i)) { ranEffects.add(i); fn() }
   },
+  useRef(init) {
+    const i = hookIndex++
+    if (hooks[i] === undefined) hooks[i] = { current: init === undefined ? null : init }
+    return hooks[i]
+  },
+  useMemo(fn) { return fn() },
+  useCallback(fn) { return fn },
   useStateReset() {},
 }
 function resetHooks() { hookIndex = 0 }
@@ -180,6 +187,8 @@ function walk(node, out = []) {
   if (typeof node !== 'object') return out          /* 文本节点本身不收集 */
   if (Array.isArray(node)) { node.forEach((n) => walk(n, out)); return out }
   if (node.type) {
+    /* 自绘下拉 Select 有 hooks，不能直接调用；把它当成一个「下拉节点」收集 */
+    if (typeof node.type === 'function' && node.type.name === 'Select') { out.push(node); return out }
     /* 函数组件要展开（Field / Check / TextInput… 都不用 hooks，直接调用即可） */
     if (typeof node.type === 'function') return walk(node.type(node.props || {}), out)
     out.push(node)
@@ -255,8 +264,8 @@ for (const label of ['第一幕入场', '第一幕 → 第二幕', '第二幕
 
 /* 三段转场的下拉：8 种类型 × 3 个；方向下拉：4 个 */
 const selectOf = (values) => walk(tree).filter((n) =>
-  n.type === 'select' && Array.isArray(n.props.children) &&
-  values.every((v) => n.props.children.some((o) => o && o.type === 'option' && o.props.value === v)))
+  typeof n.type === 'function' && Array.isArray(n.props.options) &&
+  values.every((v) => n.props.options.some((o) => o && o[0] === v)))
 const TRANSITION_TYPES = ['dissolve', 'flash', 'glitch', 'scanline', 'slide', 'iris', 'black', 'none']
 const TRANSITION_DIRS = ['left', 'right', 'up', 'down']
 const typeSelects = selectOf(TRANSITION_TYPES)
@@ -283,10 +292,10 @@ check('文件选择器 accept 白名单含 mp4/webm/gif/png/jpg/jpeg/webp',
   fileInput && fileInput.accept)
 
 /* 选择转场 → 保存 patch 里必须带上（沿用现有的 vm 渲染 + 保存路径） */
-typeSelects[0].props.onChange({ target: { value: 'glitch' } })
-typeSelects[1].props.onChange({ target: { value: 'flash' } })
-typeSelects[2].props.onChange({ target: { value: 'scanline' } })
-dirSelects[0].props.onChange({ target: { value: 'up' } })
+typeSelects[0].props.onChange('glitch')
+typeSelects[1].props.onChange('flash')
+typeSelects[2].props.onChange('scanline')
+dirSelects[0].props.onChange('up')
 msRange.props.onChange({ target: { value: '900' } })
 tree = renderPanel()
 const typeSelects2 = selectOf(TRANSITION_TYPES)
@@ -322,17 +331,17 @@ console.log('\n[5c] 删除该动画：本地删文件 / 内置隐藏可恢复（
   const groupTitles = () => walk(tree).filter((n) => n.type === 'div' && n.props && n.props.className === '__ss_groupTitle').map((n) => n.props.children)
   const postList = (prefix) => requests.filter((r) => r.init && r.init.method === 'POST' && String(r.url).includes(prefix))
   const restoreBtn = () => find(tree, (n) => n.type === 'button' && /^恢复已隐藏的内置模板（\d+）$/.test(String(n.props.children || '')))
-  const hasOption = (sel, id) => !!sel && Array.isArray(sel.props.children) &&
-    sel.props.children.some((o) => o && o.type === 'option' && o.props.value === id)
+  const hasOption = (sel, id) => !!sel && Array.isArray(sel.props.options) &&
+    sel.props.options.some((o) => o && o[0] === id)
   /* 第一幕/第二幕两个模板下拉：都含内置 archive-warm，且都有一项「内置/不播放」说明 */
   const templateSelects = () => walk(tree).filter((n) =>
-    n.type === 'select' && Array.isArray(n.props.children) &&
-    n.props.children.some((o) => o && o.type === 'option' && (o.props.value === 'archive-warm' || o.props.value === 'whale-girl-scan')) &&
-    n.props.children.some((o) => o && o.type === 'option' && /内置|不播放/.test(String(o.props.children))))
+    typeof n.type === 'function' && Array.isArray(n.props.options) &&
+    n.props.options.some((o) => o && (o[0] === 'archive-warm' || o[0] === 'whale-girl-scan')) &&
+    n.props.options.some((o) => o && /内置|不播放/.test(String(o[1]))))
   /* archive-warm 被隐藏后上面的定位会失效：改用「有内置/不播放说明」来找两个下拉 */
   const templateSelectsAny = () => walk(tree).filter((n) =>
-    n.type === 'select' && Array.isArray(n.props.children) &&
-    n.props.children.some((o) => o && o.type === 'option' && /内置|不播放/.test(String(o.props.children))))
+    typeof n.type === 'function' && Array.isArray(n.props.options) &&
+    n.props.options.some((o) => o && /内置|不播放/.test(String(o[1]))))
 
   /* ── 组顺序：自定义动画 → 模板 → 转场（保留） ── */
   const titles = groupTitles()
@@ -380,7 +389,7 @@ console.log('\n[5c] 删除该动画：本地删文件 / 内置隐藏可恢复（
   /* ── 选内置模板 → 按钮也启用（v2.12.4 不再只对本地生效） ── */
   let tplSel = templateSelects()
   check('找到第一幕 / 第二幕两个模板下拉', tplSel.length === 2, '实际 ' + tplSel.length)
-  tplSel[0].props.onChange({ target: { value: 'archive-warm' } })
+  tplSel[0].props.onChange('archive-warm')
   tree = renderPanel()
   rows = tplRows()
   check('★ 第一幕选内置 archive-warm → 第一幕按钮 enabled（title=隐藏内置模板（可恢复）），第二幕未选仍置灰',
@@ -389,7 +398,7 @@ console.log('\n[5c] 删除该动画：本地删文件 / 内置隐藏可恢复（
     rowValue(rows[1]) === '' && rowBtn(rows[1]).props.disabled === true,
     JSON.stringify(rows.map((r) => ({ v: rowValue(r), disabled: rowBtn(r).props.disabled, title: rowBtn(r).props.title }))))
   tplSel = templateSelects()
-  tplSel[1].props.onChange({ target: { value: 'whale-girl-scan' } })
+  tplSel[1].props.onChange('whale-girl-scan')
   tree = renderPanel()
   rows = tplRows()
   check('★ 第二幕也选内置 whale-girl-scan → 两个按钮都 enabled',
@@ -450,7 +459,7 @@ console.log('\n[5c] 删除该动画：本地删文件 / 内置隐藏可恢复（
 
   /* ── 本地模板删除路径保持不变（删文件、不可恢复、不进 hidden） ── */
   tplSel = templateSelects()
-  tplSel[0].props.onChange({ target: { value: 'custom-local-a' } })
+  tplSel[0].props.onChange('custom-local-a')
   tree = renderPanel()
   rows = tplRows()
   check('第一幕选本地模板 → 按钮 enabled（title=删除这个本地动画）',
@@ -502,10 +511,10 @@ check('立即预览先重新拉配置', requests.length > beforePreview && reque
 check('立即预览调用 __DSH_STARTUP_API__.replay()', windowStub.__replayed === true)
 /* v2.13.15 回归：选完「配音音色」直接点预览（还没点保存）也必须按当前选择播 */
 tree = renderPanel()
-const voiceSel = walk(tree).filter((n) => n.type === 'select' && Array.isArray(n.props.children) && n.props.children.some((o) => o && o.props.value === 'g'))[0]
-check('配音音色下拉能从 /voices 拿到音色G', !!voiceSel, JSON.stringify(walk(tree).filter((n) => n.type === 'select').map((n) => (n.props.children || []).map((o) => o && o.props.value))))
+const voiceSel = walk(tree).filter((n) => typeof n.type === 'function' && Array.isArray(n.props.options) && n.props.options.some((o) => o && o[0] === 'g'))[0]
+check('配音音色下拉能从 /voices 拿到音色G', !!voiceSel, JSON.stringify(walk(tree).filter((n) => typeof n.type === 'function' && Array.isArray(n.props.options)).map((n) => n.props.options.map((o) => o && o[0]))))
 if (voiceSel) {
-  voiceSel.props.onChange({ target: { value: 'g' } })
+  voiceSel.props.onChange('g')
   await flush()
   tree = renderPanel()
   const previewBtn2 = find(tree, (n) => n.type === 'button' && n.props.children === '立即预览')

package/test/smoke-package.mjs

@@ -149,4 +149,31 @@ if (!bigfishApp.includes("track.style.transform='translateX('")) throw new Error
 if (!bigfishApp.includes("renderVoiceRow($('login-voice')")) throw new Error('app.js 登录段未使用配音行 renderVoiceRow')
 if (!skipCss.includes('width:min(500px,92vw)')) throw new Error('style.css 登录框未缩到 1/3 尺寸')
 
+/* v2.16.1：4K AV1 改名 + 新增 4K H.264 模板 + 第二幕视频诊断/暂停恢复 */
+const tpl4k = JSON.parse(fs.readFileSync(path.join(root, 'templates/whale-girl-scan-4k/template.json'), 'utf8'))
+if (tpl4k.name !== '鲸鱼娘扫描睁眼（4K AV1）') throw new Error('4K AV1 模板名称未更新')
+const tpl4kh = JSON.parse(fs.readFileSync(path.join(root, 'templates/whale-girl-scan-4k-h264/template.json'), 'utf8'))
+if (tpl4kh.name !== '鲸鱼娘扫描睁眼（4K H.264）') throw new Error('缺少 4K H.264 模板名称')
+if (!fs.existsSync(path.join(root, 'templates/whale-girl-scan-4k-h264/assets/whale-girl-scan-4k-h264.mp4'))) throw new Error('缺少 4K H.264 视频文件')
+const splashSrc = fs.readFileSync(path.join(root, 'lib/splash.js'), 'utf8')
+if (!splashSrc.includes('video stats ')) throw new Error('splash.js 缺少第二幕视频丢帧统计')
+if (!splashSrc.includes('video meta ')) throw new Error('splash.js 缺少第二幕视频分辨率日志')
+if (!splashSrc.includes('vResumeTimer')) throw new Error('splash.js 缺少省电暂停自动恢复')
+if (!splashSrc.includes('vp0.catch')) throw new Error('splash.js 未静默 play() 失败')
+/* v2.16.2：新增 4K H.264 必须算「正式模板」，否则第二幕下拉里看不到 */
+const clientSrc = fs.readFileSync(path.join(root, 'lib/client.js'), 'utf8')
+if (!clientSrc.includes("'whale-girl-scan-4k-h264': 1")) throw new Error('client.js 的正式模板白名单缺少 4K H.264')
+/* v2.16.2：安装器代理加固 */
+const installPs1V2162 = fs.readFileSync(path.join(root, 'tools/install.ps1'), 'utf8')
+if (!installPs1V2162.includes('Get-ProxyInfo')) throw new Error('install.ps1 缺少代理探测')
+if (!installPs1V2162.includes('npm_config_fetch_timeout')) throw new Error('install.ps1 缺少 pnpm 网络超时设置')
+if (!installPs1V2162.includes('registry.npmmirror.com')) throw new Error('install.ps1 缺少国内镜像重试')
+const helperGen = fs.readFileSync(path.join(root, 'tools/make-upgrade-helper.mjs'), 'utf8')
+if (!helperGen.includes('turn off any proxy')) throw new Error('升级助手缺少代理提示')
+/* v2.16.3：设置页下拉改自绘，跟随皮肤 3D 面板平面 */
+if (!clientSrc.includes('__ss_selectMenu')) throw new Error('client.js 缺少自绘下拉菜单')
+if (!clientSrc.includes('aria-haspopup')) throw new Error('client.js 自绘下拉缺少 aria 属性')
+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（聊天背景）')
 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-66', '__BUILD = cw-66（排查浏览器跑的是不是新包）', String(mod.__BUILD))
+ok(mod.__BUILD === 'cw-71', '__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-panel.mjs

@@ -365,10 +365,10 @@ ok(MODEL.lastRootsBody && MODEL.lastRootsBody.action === 'remove' && String(MODE
 const beforeMode = requests.length
 tree = renderPanel()
 const modeSel = findNode(tree, (n) =>
-  n.type === 'select' && Array.isArray(n.props.children) &&
-  n.props.children.some((o) => o && o.type === 'option' && o.props.value === 'video'))
+  typeof n.type === 'function' && Array.isArray(n.props.options) &&
+  n.props.options.some((o) => o && o[0] === 'video'))
 ok(!!modeSel, '「背景类型」下拉含「循环视频」选项')
-modeSel.props.onChange({ target: { value: 'video' } })
+modeSel.props.onChange('video')
 await flushP(); await flushP(); await flushP(); await flushP()
 const modeReq = requests.slice(beforeMode).find((r) => r.url.includes('/chat-wallpaper/set'))
 const modeBody = modeReq && JSON.parse(modeReq.init.body)

package/tools/install.ps1

@@ -22,6 +22,20 @@ $ErrorActionPreference = 'Stop'
 function Say($m) { Write-Host $m }
 function Die($m) { Write-Host ('[x] ' + $m) -ForegroundColor Red; exit 1 }
 
+# v2.16.2：代理探测。开着代理时 pnpm 访问 npm registry 可能长时间卡住（用户实测第二步无响应）。
+function Get-ProxyInfo {
+  $marks = @()
+  foreach ($n in @('HTTP_PROXY','HTTPS_PROXY','ALL_PROXY','http_proxy','https_proxy','all_proxy')) {
+    $v = [Environment]::GetEnvironmentVariable($n)
+    if ($v) { $marks += ($n + '=' + $v) }
+  }
+  try {
+    $reg = Get-ItemProperty 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' -ErrorAction Stop
+    if ($reg.ProxyEnable -eq 1 -and $reg.ProxyServer) { $marks += ('系统代理=' + $reg.ProxyServer) }
+  } catch {}
+  return ($marks -join '；')
+}
+
 $RepoRoot = Split-Path -Parent $PSScriptRoot
 if (-not (Test-Path (Join-Path $RepoRoot 'package.json'))) { Die ('这不像插件目录：' + $RepoRoot) }
 if (-not (Test-Path (Join-Path $RepoRoot 'lib\index.js'))) { Die '源码不完整（缺 lib\index.js），你下载的可能是残缺的压缩包' }
@@ -319,6 +333,22 @@ foreach ($profile in $targets) {
   }
 
   Say '  [2/3] 安装本插件（link 方式，改代码即生效）…'
+  $proxyInfo = Get-ProxyInfo
+  if ($proxyInfo -and -not $ManualMode) {
+    Say ''
+    Say '  [提示] 检测到代理：' + $proxyInfo
+    Say '         已知问题：开着代理时，安装这一步（pnpm 访问 npm registry）可能长时间卡住。'
+    Say '         如果卡住超过 2 分钟：按 Ctrl+C 关窗口 → 暂时关闭代理 → 重新双击本助手。'
+    Say '         也可以把 registry.npmjs.org 设为直连/绕过代理。'
+    Say ''
+    for ($pi = 5; $pi -ge 1; $pi--) { Write-Host ('         5 秒后继续…（' + $pi + '）'); Start-Sleep -Seconds 1 }
+  }
+  $prevFetchTimeout = [Environment]::GetEnvironmentVariable('npm_config_fetch_timeout')
+  $prevFetchRetries = [Environment]::GetEnvironmentVariable('npm_config_fetch_retries')
+  if (-not $ManualMode) {
+    $env:npm_config_fetch_timeout = '30000'
+    $env:npm_config_fetch_retries = '2'
+  }
   if ($ManualMode) {
     Install-Manual $profileDir
   } else {
@@ -328,6 +358,15 @@ foreach ($profile in $targets) {
     try { $outAdd = (& $dsh plugin --profile $profile add $spec 2>&1 | Out-String) } catch { $outAdd = $_.Exception.Message }
     if ($outAdd.Trim()) { $outAdd.Trim().Split([char]10) | ForEach-Object { '        ' + $_ } }
     $addExit = $LASTEXITCODE
+    if ($addExit -ne 0) {
+      Say '        第一次安装没成功，改用 npm 国内镜像重试一次…'
+      $prevRegistry = [Environment]::GetEnvironmentVariable('npm_config_registry')
+      $env:npm_config_registry = 'https://registry.npmmirror.com'
+      try { $outAdd = (& $dsh plugin --profile $profile add $spec 2>&1 | Out-String) } catch { $outAdd = $_.Exception.Message }
+      $addExit = $LASTEXITCODE
+      if ($outAdd.Trim()) { $outAdd.Trim().Split([char]10) | ForEach-Object { '        ' + $_ } }
+      if ($prevRegistry) { $env:npm_config_registry = $prevRegistry } else { Remove-Item Env:npm_config_registry -ErrorAction SilentlyContinue }
+    }
     $ErrorActionPreference = $eapAdd
     $installedOk = Test-InstalledOk $profileDir
     if ($addExit -ne 0 -or $outAdd -match 'managed exclusively' -or -not $installedOk) {
@@ -342,6 +381,8 @@ foreach ($profile in $targets) {
       if (Test-InstalledOk $profileDir) { $addExit = 0 } else { $addExit = 1 }
     }
   }
+  if ($prevFetchTimeout) { $env:npm_config_fetch_timeout = $prevFetchTimeout } else { Remove-Item Env:npm_config_fetch_timeout -ErrorAction SilentlyContinue }
+  if ($prevFetchRetries) { $env:npm_config_fetch_retries = $prevFetchRetries } else { Remove-Item Env:npm_config_fetch_retries -ErrorAction SilentlyContinue }
   if (-not (Test-InstalledOk $profileDir)) {
     Say '  [x] 安装后校验失败：profile 里没有可用的 dsh-boot-suite'
     Say '      （bundles 里不会添加它，避免 DSH 启动时加载一个不存在的插件）'

package/tools/make-upgrade-helper.mjs

@@ -61,6 +61,7 @@ const lines = [
   'echo ============================================================',
   `echo  Install dsh-boot-suite v${version} from this staged package.`,
   'echo  IMPORTANT: fully quit DeepSeek Harness first (window + tray).',
+  'echo  If it hangs at step 2: close this window, turn off any proxy, then double-click again.',
   'echo ============================================================',
   'echo.',
   `powershell -NoProfile -ExecutionPolicy Bypass -File "${pkgInstall}"`,