dsh-boot-suite 2.13.11 → 2.13.19

package/lib/client.js

@@ -249,10 +249,11 @@ window.__ModuleLoader__.load({
        面板也要能正常显示这些控件，而不是一片 undefined。 */
     var FALLBACK = {
       voice: true, voiceLang: 'en', voiceName: '', voiceRate: 0.88, voicePitch: 0.85,
-      voiceVolume: 0.9, voiceCue: true, voiceLead: 240, voiceSource: 'asset',
+      voiceVolume: 0.9, voiceCue: true, voiceLead: 240, welcomeDelay: 550, voiceSource: 'asset', voicePack: 'f', voiceFx: 'robot',
       sound: true, soundVolume: 0.5, bedNoise: false,
       transitionIn: 'dissolve', transitionJoin: 'dissolve', transitionOut: 'dissolve',
-      transitionMs: 600, transitionDir: 'left'
+      transitionMs: 600, transitionDir: 'left',
+      colorMode: 'color'
     }
     function num(v, d) {
       var n = Number(v)
@@ -265,7 +266,9 @@ window.__ModuleLoader__.load({
           —— 桌面端走浏览器半侧自举时没有 1，就靠这一条
        3) 下面这个常量：两份都没拿到时的兜底，别让面板显示 undefined
        版本号本身只在 lib/index.js 里读一次，这里不重复维护。 */
-    var FALLBACK_VERSION = '2.13.11'
+    var FALLBACK_VERSION = '2.13.19'
+    /* 手动选包成功后置 true：让还在后台跑的“浏览器下载监听”不要再弹第二次更新器 */
+    var __manualUpdateApplied = false
     function readInjectedVersion() {
       try {
         var v = window.__DSH_STARTUP_VERSION__
@@ -283,10 +286,13 @@ window.__ModuleLoader__.load({
       var [busy, setBusy] = react.useState(false)
       var [templates, setTemplates] = react.useState([])
       var [hiddenTemplates, setHiddenTemplates] = react.useState([])
+      var [voicePacks, setVoicePacks] = react.useState([])
       var [update, setUpdate] = react.useState(null)
       var [checking, setChecking] = react.useState(false)
       var [updating, setUpdating] = react.useState(false)
       var [updateMsg, setUpdateMsg] = react.useState('')
+      var [waitingDownload, setWaitingDownload] = react.useState(false)
+      var [diagnosing, setDiagnosing] = react.useState(false)
 
       function load() {
         setError(null)
@@ -317,6 +323,25 @@ window.__ModuleLoader__.load({
       }
       react.useEffect(() => { refreshTemplates() }, [])
 
+      /* 音色包列表：来自 lib/assets/voices/manifest.json，由宿主只读下发 */
+      function refreshVoices() {
+        return fetch('/dsh-startup/voices', { headers: { Accept: 'application/json' }, cache: 'no-store' })
+          .then((r) => r.json())
+          .then((j) => { if (j && j.ok === true && Array.isArray(j.packs)) setVoicePacks(j.packs) })
+          .catch(() => { /* 拉不到就只显示内置音色 */ })
+      }
+      react.useEffect(() => { refreshVoices() }, [])
+
+      function voiceOptions() {
+        var opts = []
+        for (var i = 0; i < voicePacks.length; i++) {
+          var v = voicePacks[i]
+          if (!v || !v.id) continue
+          opts.push([v.id, String(v.name || v.id)])
+        }
+        return opts
+      }
+
       function set(key, value) {
         setNotice(null)
         setDraft((d) => Object.assign({}, d, { [key]: value }))
@@ -357,18 +382,23 @@ window.__ModuleLoader__.load({
           .then(() => setBusy(false))
       }
 
-      /** 一键诊断：让宿主写一份报告到桌面，用户直接发给作者。 */
+      /** 一键诊断：让宿主写一份报告到桌面，用户直接发给作者。生成中按钮禁用，防止连点刷屏。 */
       function runDiagnose() {
-        setNotice(null)
+        if (diagnosing) return
+        setDiagnosing(true)
+        setNotice('正在生成诊断报告，请稍等…')
+        setError(null)
         fetch(STARTUP_ROUTE + '/diagnose', { method: 'POST' })
           .then(function (r) { return r.json() })
           .then(function (j) {
             if (!j || j.ok !== true) throw new Error((j && j.error) || '生成失败')
-            setNotice('诊断报告已生成到桌面：' + j.file)
+            setNotice('诊断报告已生成到桌面：' + j.file + '（报告里不含任何密钥/密码）')
           })
           .catch(function (e) {
-            setNotice('生成诊断报告失败：' + String((e && e.message) || e))
+            setNotice(null)
+            setError('生成诊断报告失败：' + String((e && e.message) || e))
           })
+          .then(function () { setDiagnosing(false) })
       }
 
       /** 检查更新：问宿主（宿主去读 GitHub latest release，避开浏览器 CORS）。 */
@@ -409,27 +439,44 @@ window.__ModuleLoader__.load({
 
       /** 立即更新：让系统浏览器下载（走浏览器自己的代理），插件监听 Downloads 自动接住 */
       function runUpdate() {
-        if (!update || !update.latest) return
+        if (!update || !update.latest || updating) return
+        __manualUpdateApplied = false
         setUpdating(true)
+        setWaitingDownload(true)
         setUpdateMsg('正在让浏览器下载 v' + update.latest + '（使用浏览器自己的代理）…')
         fetch(STARTUP_ROUTE + '/update-browser-download', { method: 'POST' })
           .then(function (r) { return r.json() })
           .then(function (j) {
             if (!j || j.ok !== true) throw new Error((j && j.error) || '无法启动浏览器下载')
-            setUpdateMsg('已用 ' + (j.browser === 'chrome' ? 'Chrome' : '默认浏览器') + ' 打开下载，完成后会自动继续（最多等 10 分钟）…')
+            setUpdateMsg('已用 ' + (j.browser === 'chrome' ? 'Chrome' : '默认浏览器') + ' 打开下载，完成后会自动继续（最多等 30 分钟）。等太久可以点「打开下载文件夹」或「选择安装包」。')
             return fetch(STARTUP_ROUTE + '/update-watch-download?version=' + encodeURIComponent(update.latest))
           })
           .then(function (r) { return r.json() })
           .then(function (j) {
+            setWaitingDownload(false)
+            if (__manualUpdateApplied) return
             if (!j || j.ok !== true) throw new Error((j && j.error) || '没有等到下载文件')
             setUpdating(false)
             setUpdateMsg('已获取 v' + j.version + '（' + Math.round(j.size / 1048576) + ' MB）')
             confirmAndApply(j.version)
           })
           .catch(function (e) {
+            setWaitingDownload(false)
+            if (__manualUpdateApplied) return
             setUpdating(false)
-            setUpdateMsg('浏览器下载没接住：' + String((e && e.message) || e) + '。可再点「立即更新」，或点「选择安装包」手动指定。')
+            setUpdateMsg('浏览器下载没接住：' + String((e && e.message) || e) + '。可以点「打开下载文件夹」找到 zip 后点「选择安装包」。')
+          })
+      }
+
+      /** 打开系统下载文件夹（等下载时的手动出口） */
+      function openDownloads() {
+        fetch(STARTUP_ROUTE + '/open-downloads', { method: 'POST' })
+          .then(function (r) { return r.json() })
+          .then(function (j) {
+            if (!j || j.ok !== true) throw new Error((j && j.error) || '打不开文件夹')
+            setUpdateMsg('已打开下载文件夹：' + j.dir + '。找到 dsh-boot-suite 的 zip 后，点「选择安装包」选它。')
           })
+          .catch(function (e) { setUpdateMsg('打开下载文件夹失败：' + String((e && e.message) || e)) })
       }
 
       /** 浏览器下载好 zip 后，从本地选择文件（完全不依赖宿主联网） */
@@ -454,6 +501,8 @@ window.__ModuleLoader__.load({
             .then(function (r) { return r.json() })
             .then(function (j) {
               if (!j || j.ok !== true) throw new Error((j && j.error) || '本地安装包无效')
+              __manualUpdateApplied = true
+              setWaitingDownload(false)
               setUpdating(false)
               setUpdateMsg('已载入本地安装包 v' + j.version + '（' + Math.round(j.size / 1048576) + ' MB）')
               confirmAndApply(j.version)
@@ -616,7 +665,10 @@ window.__ModuleLoader__.load({
           .then((r) => r.json())
           .then((j) => {
             if (!j || j.ok !== true) return
-            if (j.config) window.__DSH_STARTUP__ = Object.assign({}, FALLBACK, j.config)
+            /* v2.13.15：预览必须带上「当前还没保存的修改」。
+               原来只灌宿主已保存的配置：用户选完音色/效果直接点「立即预览」，
+               运行时拿到的还是旧配置 —— 表现就是「选了日文音色，预览仍播英文」。 */
+            if (j.config) window.__DSH_STARTUP__ = Object.assign({}, FALLBACK, j.config, draft || {})
             try {
               if (j.template) window.__DSH_STARTUP_TEMPLATE__ = j.template
               else delete window.__DSH_STARTUP_TEMPLATE__
@@ -876,56 +928,38 @@ window.__ModuleLoader__.load({
           h('div', { className: '__ss_groupTitle' }, '语音与音效'),
           h(Check, {
             label: '女声播报（念每一行的英文）',
-            hint: '照参考片里那位女声的节奏：文字出现的同一时刻念出来。'
-              + '动画会等这句话念完再走下一步，不会把语音掐断；浏览器要求先有一次点击才准出声，'
-              + '所以第一次点按钮/按 Enter 时会把当前这行补念一次。',
+            hint: '每一行的英文都在文字出现的同一时刻念出来，动画等这句话念完再走下一步。',
             checked: draft.voice,
             onChange: (v) => set('voice', v)
           }),
-          h(Field, {
-            label: '语音来源',
-            hint: '素材 = 插件内置的真声（来自你给的音频，5 句）；TTS = 用系统语音合成。'
-              + '素材缺失时无论选哪个都会自动回落到 TTS；终幕那句嵌了可配置的身份名称，始终走 TTS。'
+          draft.voice ? h(Field, {
+            label: '配音音色',
+            hint: '6 套完整干音：英文 1 套（音色F·默认）+ 日文 5 套（日文音色1–5）；可再叠声音效果。'
+              + '选完音色后，下面的「声音效果」可以再叠一层处理，或选「无」保留原声。'
           },
             h(Select, {
-              value: draft.voiceSource || 'asset',
-              options: [['asset', '真声素材（推荐）'], ['tts', '系统 TTS 合成']],
-              onChange: (v) => set('voiceSource', v)
+              value: draft.voicePack || 'builtin',
+              options: voiceOptions(),
+              onChange: (v) => set('voicePack', v)
             })
-          ),
-          h(Field, { label: '播报语言' },
+          ) : null,
+          draft.voice ? h(Field, {
+            label: '声音效果',
+            hint: '5 个音效都来自模板编辑器里的同一套参数，实时叠加在所选音色上；选「无（原声）」就是干净人声。'
+              + '只影响全局配音素材，模板自带的配音不受影响。'
+          },
             h(Select, {
-              value: draft.voiceLang,
-              options: [['en', '英语（照参考片）'], ['zh', '中文'], ['both', '中英各念一遍']],
-              onChange: (v) => set('voiceLang', v)
+              value: draft.voiceFx || 'none',
+              options: [
+                ['none', '无（原声，默认）'],
+                ['ai-mech', 'AI 机械音'],
+                ['robot', '机器人'],
+                ['radio', '无线电'],
+                ['oldtv', '老电视'],
+                ['dark', '低沉']
+              ],
+              onChange: (v) => set('voiceFx', v)
             })
-          ),
-          draft.voice ? h(VoicePicker, {
-            value: draft.voiceName,
-            onChange: (v) => set('voiceName', v),
-            onPreview: () => speakSample(null, draft)
-          }) : null,
-          draft.voice ? h('div', { className: '__ss_row' },
-            h('button', {
-              className: '__ss_btn',
-              type: 'button',
-              onClick: () => {
-                set('voiceRate', 0.88)
-                set('voicePitch', 0.85)
-                set('voiceName', '')
-                set('voiceCue', true)
-                set('voiceLead', 240)
-              }
-            }, '↺ 套用「电影旁白」档'),
-            h('span', { className: '__ss_hint' }, '语速 0.88 · 音调 0.85（压抑、深沉）· 自动挑神经网络女声 · 提示音 + 开口留白')
-          ) : null,
-          draft.voice ? h('div', { className: '__ss_two' },
-            h(Field, { label: '语速' },
-              h(Range, { value: num(draft.voiceRate, 1), min: 0.5, max: 2, display: num(draft.voiceRate, 1).toFixed(2) + '×', onChange: (v) => set('voiceRate', v) })
-            ),
-            h(Field, { label: '音调' },
-              h(Range, { value: num(draft.voicePitch, 1), min: 0, max: 2, display: num(draft.voicePitch, 1).toFixed(2), onChange: (v) => set('voicePitch', v) })
-            )
           ) : null,
           draft.voice ? h(Field, { label: '开口前留白', hint: '提示音响过之后停多久再开口。电影旁白/机场广播都有这一拍，240ms 起最像"系统在播报"。' },
             h(Range, {
@@ -934,6 +968,13 @@ window.__ModuleLoader__.load({
               onChange: (v) => set('voiceLead', v)
             })
           ) : null,
+          draft.voice ? h(Field, { label: '终幕语音延迟', hint: '05→06 的过场和声钟约 1.5 秒；默认等它收尾再进最后一句。觉得欢迎语进得太早/太晚，就调这里。' },
+            h(Range, {
+              value: num(draft.welcomeDelay, 550), min: 0, max: 3000, step: 50,
+              display: Math.round(num(draft.welcomeDelay, 550)) + ' ms',
+              onChange: (v) => set('welcomeDelay', v)
+            })
+          ) : null,
           draft.voice ? h(Field, { label: '音量' },
             h(Range, { value: num(draft.voiceVolume, 0.9), min: 0, max: 1, display: Math.round(num(draft.voiceVolume, 0.9) * 100) + '%', onChange: (v) => set('voiceVolume', v) })
           ) : null,
@@ -1017,7 +1058,7 @@ window.__ModuleLoader__.load({
         /* 版本与更新 */
         h('div', { className: '__ss_row', style: { marginTop: '10px' } },
           h('button', { className: '__ss_btn', disabled: checking, onClick: checkUpdate }, checking ? '检查中…' : '检查更新'),
-          h('button', { className: '__ss_btn', onClick: runDiagnose }, '生成诊断报告'),
+          h('button', { className: '__ss_btn', disabled: diagnosing, onClick: runDiagnose }, diagnosing ? '生成中…' : '生成诊断报告'),
           h('span', {
             className: (update && update.ok && update.hasUpdate) ? '__ss_ok' : '__ss_hint'
           }, (function () {
@@ -1034,12 +1075,19 @@ window.__ModuleLoader__.load({
             ? h('button', { className: '__ss_btn __ss_btnPrimary', disabled: updating, onClick: runUpdate }, updating ? '更新中…' : '立即更新')
             : null,
           (update && update.ok && update.hasUpdate)
-            ? h('button', { className: '__ss_btn', disabled: updating, onClick: pickLocalPackage }, '选择安装包')
+            ? h('button', { className: '__ss_btn', disabled: updating && !waitingDownload, onClick: pickLocalPackage }, '选择安装包')
+            : null,
+          (update && update.ok && update.hasUpdate && waitingDownload)
+            ? h('button', { className: '__ss_btn', onClick: openDownloads }, '打开下载文件夹')
             : null
         ),
         (update && update.ok && update.hasUpdate)
           ? h('div', { className: '__ss_hint', style: { marginTop: '6px', lineHeight: '1.8' } },
-              '下载会优先用 Chrome（Edge + IDM 可能拦下载）。如果没自动继续，点「选择安装包」选 Downloads 里的 zip。')
+              '下载会优先用 Chrome（Edge + IDM 可能拦下载）。如果没自动继续，点「打开下载文件夹」找到 zip，再点「选择安装包」。')
+          : null,
+        waitingDownload
+          ? h('div', { className: '__ss_hint', style: { marginTop: '6px', lineHeight: '1.8', color: '#c98a2b' } },
+              '正在等浏览器下载（最多 30 分钟）。下载完成后会自动继续；如果已经下好，点「打开下载文件夹」看看，或直接点「选择安装包」选那个 zip。')
           : null,
         h('div', { className: '__ss_hint', style: { marginTop: '6px', lineHeight: '1.8' } },
           '回滚保护：安装新版本前，桌面会自动多一个「紧急回滚-V当前版本」按钮。新版装不上、或装完 DSH 打不开时，完全退出 DSH（窗口+托盘）后双击它，就能回到更新前的版本；它只换插件版本，不动你的设置。更新成功后旧按钮会被自动替换，不会越积越多——确认新版正常后也不用手动删。'),
@@ -1552,7 +1600,7 @@ window.__ModuleLoader__.load({
     /* 每次改客户端就把这个号 +1。
        有了它在控制台一眼就能判断"浏览器里跑的是不是最新那份" ——
        排查问题时，分不清是代码问题还是旧包，会白猜一轮。 */
-    var BUILD = 'cw-34'
+    var BUILD = 'cw-42'
 
     function log() {
       try {
@@ -2058,6 +2106,8 @@ window.__ModuleLoader__.load({
         L.push(B + ' > ' + V + ' { position: absolute; inset: 0; }')
         L.push('html.dsh-cw-light ' + B + ' > ' + V + ' { background: linear-gradient(' + cfg.veilLightA + ', ' + cfg.veilLightB + '); }')
         L.push('html.dsh-cw-dark ' + B + ' > ' + V + ' { background: linear-gradient(' + cfg.veilDarkA + ', ' + cfg.veilDarkB + '); }')
+      /* v2.13.17：黑白原版素材模式 —— 不染色，直接关掉主题色纱（模糊仍可单独调） */
+      L.push('html.dsh-cw-mono ' + B + ' > ' + V + ' { background: transparent !important; }')
         /* v2.13.11 镜头模糊：只模糊纱后面的壁纸/视频，纱上的聊天文字不受影响。
            0 = 不生成规则（完全不动）；100 = 约 24px。 */
         if (Number(cfg.veilBlur) > 0) {
@@ -2353,6 +2403,8 @@ window.__ModuleLoader__.load({
       current = cfg
       var dark = looksDark()
       setThemeClass(dark)
+      /* v2.13.17：黑白（原版素材）模式 → 关掉主题色纱，保留原画面 */
+      try { document.documentElement.classList.toggle('dsh-cw-mono', cfg.colorMode === 'mono') } catch (e) { /* 忽略 */ }
       log('套用壁纸', { image: cfg.__image, theme: dark ? 'dark' : 'light' })
       injectCss(cfg)
       mountBg(cfg)            /* 最底：聊天底图（用户自己定的那张，可选）*/
@@ -2386,7 +2438,7 @@ window.__ModuleLoader__.load({
       removeBg()
       removeBanner()
       try {
-        document.documentElement.classList.remove('dsh-cw-dark', 'dsh-cw-light')
+        document.documentElement.classList.remove('dsh-cw-dark', 'dsh-cw-light', 'dsh-cw-mono')
         themeClass = null
       } catch (e) { /* 忽略 */ }
     }
@@ -2520,9 +2572,11 @@ window.__ModuleLoader__.load({
       var [busy, setBusy] = cwReact.useState(false)
       var [error, setError] = cwReact.useState(null)
       var [notice, setNotice] = cwReact.useState(null)
+      var [refreshing, setRefreshing] = cwReact.useState(false)
 
-      function load() {
+      function load(manual) {
         setError(null)
+        if (manual) { setNotice(null); setRefreshing(true) }
         return Promise.all([api('/images'), api('/config', { cache: 'no-store' }), api('/videos')])
           .then(function (arr) {
             var images = arr[0] || {}
@@ -2543,6 +2597,7 @@ window.__ModuleLoader__.load({
               veilBlur: cfg.veilBlur == null ? 0 : Math.max(0, Math.min(100, Number(cfg.veilBlur) || 0)),
               image: conf.image || null,
               imageFit: cfg.imageFit === 'contain' ? 'contain' : 'cover',
+              colorMode: cfg.colorMode === 'mono' ? 'mono' : 'color',
               video: {
                 bgMode: vids.bgMode || 'image',
                 videoMode: vids.videoMode || 'single',
@@ -2555,8 +2610,13 @@ window.__ModuleLoader__.load({
             }
             setData(next)
             setDraft({ banner: next.banner, bannerOpacity: next.bannerOpacity, dark: looksDark(), newRoot: '', shuffleMin: next.video.shuffleMinutes })
+            if (manual) {
+              setNotice('已重新读取：图片 ' + next.images.length + ' 张 / 视频 ' + next.video.items.length + ' 个'
+                + (next.dropDirExists ? '' : '（丢图目录还不存在，点「打开图片文件夹」会创建）'))
+            }
           })
           .catch(function (e) { setError('读取失败：' + String((e && e.message) || e)) })
+          .then(function () { if (manual) setRefreshing(false) })
       }
       cwReact.useEffect(function () { load() }, [])
 
@@ -2659,11 +2719,20 @@ window.__ModuleLoader__.load({
             cwH('br'),
             '循环视频：' + (data.video && data.video.items.length ? ('已扫描 ' + data.video.items.length + ' 段' + (data.video.bgMode === 'video' && data.video.currentId ? '，正在播放' : '，未启用')) : '（视频目录里还没有视频）'),
             cwH('br'),
-            '丢图目录：' + (data.dropDir || '?')
+            '丢图目录：' + (data.dropDir || '（尚未创建，点「打开图片文件夹」会自动创建）')
           ),
           cwH('div', { className: '__ss_row' },
-            cwH('button', { className: '__ss_btn', type: 'button', onClick: function () { api('/open-dir', { method: 'POST' }) } }, '打开图片文件夹'),
-            cwH('button', { className: '__ss_btn', type: 'button', disabled: busy, onClick: function () { load() } }, '刷新')
+            cwH('button', {
+              className: '__ss_btn', type: 'button', disabled: busy,
+              onClick: function () {
+                setNotice(null); setError(null)
+                api('/open-dir', { method: 'POST' }).then(function (j) {
+                  if (j && j.ok) setNotice('已打开图片文件夹：' + (j.opened || data.dropDir))
+                  else setError('打开图片文件夹失败：' + ((j && j.error) || '宿主没有返回'))
+                })
+              }
+            }, '打开图片文件夹'),
+            cwH('button', { className: '__ss_btn', type: 'button', disabled: busy || refreshing, onClick: function () { load(true) } }, refreshing ? '刷新中…' : '刷新')
           )
         ),
 
@@ -2672,7 +2741,7 @@ window.__ModuleLoader__.load({
           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 丢进去，再点刷新。'),
+            : 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', {
@@ -2714,6 +2783,18 @@ window.__ModuleLoader__.load({
               cwH('option', { value: 'shuffle' }, '随机轮换')
             )
           ),
+          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('div', { className: '__ss_hint' }, '黑白模式会关掉主题色纱、保留原画面颜色，适合本身就是黑白的动态壁纸；彩色模式不做任何调色。'),
           data.video.videoMode === 'shuffle'
             ? cwH('div', { className: '__ss_row' },
                 cwH('span', { className: '__ss_status' }, '轮换间隔（分钟，0 = 每次启动随机）'),
@@ -2764,7 +2845,7 @@ window.__ModuleLoader__.load({
             : cwH('div', { className: '__ss_hint' }, '还没有视频。把 mp4/webm 或壁纸引擎的项目文件夹放进上面的目录，再点下方「刷新」。'),
           cwH('div', { className: '__ss_row', style: { marginTop: 8 } },
             cwH('button', { className: '__ss_btn', type: 'button', disabled: busy || !(data.video.roots && data.video.roots.length), onClick: function () { if (data.video.roots && data.video.roots.length) rootAction('open', data.video.roots[0]) } }, '打开视频文件夹'),
-            cwH('button', { className: '__ss_btn', type: 'button', disabled: busy, onClick: function () { load() } }, '刷新')
+            cwH('button', { className: '__ss_btn', type: 'button', disabled: busy || refreshing, onClick: function () { load(true) } }, refreshing ? '刷新中…' : '刷新')
           )
         ),
 

package/lib/host-startup.js

@@ -19,6 +19,18 @@ import { spawn } from 'node:child_process'
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
 const DSH_HOME = process.env.DSH_HOME || path.join(os.homedir(), '.dsh')
 const CONFIG_FILE = path.join(DSH_HOME, 'dsh-startup.json')
+const VOICE_ROOT = path.join(PACKAGE_ROOT, 'lib', 'assets', 'voices')
+/* 音色包清单由 lib/assets/voices/manifest.json 描述（随安装包发布）。
+   读不到就当作没有扩展音色，内置音色不受影响。 */
+const VOICE_PACKS = (() => {
+  try {
+    const list = JSON.parse(fs.readFileSync(path.join(VOICE_ROOT, 'manifest.json'), 'utf8'))
+    if (!Array.isArray(list)) return []
+    return list.filter((v) => v && /^[a-z]$/.test(String(v.id)) && (v.lang === 'en' || v.lang === 'ja'))
+      .map((v) => ({ id: String(v.id), name: String(v.name || '').slice(0, 12) || ('音色 ' + String(v.id).toUpperCase()), lang: v.lang }))
+  } catch (err) { return [] }
+})()
+const VOICE_PACK_IDS = [...VOICE_PACKS.map((v) => v.id)]
 
 const NS = 'dsh-startup-screen'
 const ROUTE_BASE = '/dsh-startup'
@@ -75,7 +87,10 @@ const DEFAULTS = {
   voiceCue: true,             // 念台词前的一声轻提示
   sfx: 'audio',               // 音效来源：audio=lib/assets 里的真素材 / synth=现场合成
   voiceSource: 'asset',       // 语音来源：asset=优先用真声素材（拿不到自动回落 TTS）/ tts=全 TTS
+  voicePack: 'f',       // 配音音色：f..k=音色包（默认 F 英文）；用户在设置里可换
+  voiceFx: 'robot',           // 声音效果：none | ai-mech | robot | radio | oldtv | dark（默认机器人，贴近旧版听感）
   voiceLead: 240,             // 提示音之后留一小段空白再开口
+  welcomeDelay: 550,          // 05→06 过场和声钟之后等多久再进终幕欢迎语（0–3000ms；实测 550 最顺）
   identity: 'JOYCE MOORE',    // ← 设置页里可改的「身份名称」
   identityId: '0087',
   accessLevel: '3',
@@ -117,6 +132,8 @@ const ENUMS = {
   voiceLang: ['en', 'zh', 'both'],
   sfx: ['audio', 'synth'],
   voiceSource: ['asset', 'tts'],
+  voicePack: VOICE_PACK_IDS,
+  voiceFx: ['none', 'ai-mech', 'robot', 'radio', 'oldtv', 'dark'],
   transitionIn: TRANSITION_TYPES,
   transitionJoin: TRANSITION_TYPES,
   transitionOut: TRANSITION_TYPES,
@@ -125,6 +142,7 @@ const ENUMS = {
 const BOOL_KEYS = ['enabled', 'requireInteraction', 'allowSkip', 'sound', 'bedNoise', 'voice', 'voiceCue']
 /** 数值字段的合法区间（越界即夹取）。 */
 const RANGES = {
+  welcomeDelay: [0, 3000],
   speed: [0.35, 3],
   transitionMs: [200, 2000],
   soundVolume: [0, 1],
@@ -397,6 +415,36 @@ function apply(ctx) {
     }
   }))
 
+  /* 音色包：6 套扩展配音（英文 F + 日文 G–K）。设置页只拿 id/名称/语言，音频走只读白名单路由；
+     id 与文件名都白名单，且不接受子路径 —— 和 /asset 同样防目录穿越。 */
+  disposers.push(registerRoute({
+    kind: 'exact',
+    path: ROUTE_BASE + '/voices',
+    handler: (req, res) => sendJson(res, 200, { ok: true, packs: VOICE_PACKS, default: 'f' })
+  }))
+  disposers.push(registerRoute({
+    kind: 'prefix',
+    path: ROUTE_BASE + '/voice',
+    handler: (req, res) => {
+      const rest = decodeURIComponent(String(req.url || '').split('?')[0])
+        .slice((ROUTE_BASE + '/voice').length).replace(/^\/+/, '')
+      const parts = rest.split('/')
+      const id = String(parts[0] || '')
+      const name = String(parts[1] || '')
+      if (!/^[a-z]$/.test(id) || !/^line-[1-6]\.mp3$/.test(name) || !VOICE_PACK_IDS.includes(id)) {
+        res.writeHead(404); res.end(); return
+      }
+      let bytes
+      try { bytes = fs.readFileSync(path.join(VOICE_ROOT, id, name)) } catch (err) { res.writeHead(404); res.end(); return }
+      res.writeHead(200, {
+        'Content-Type': 'audio/mpeg',
+        'Cache-Control': 'no-store',
+        'Content-Length': String(bytes.length)
+      })
+      res.end(bytes)
+    }
+  }))
+
   /* 模板自带声音：/dsh-startup/template-asset/<模板id>/<文件名>
      先找用户目录 ~/.dsh/startup-templates/<id>/assets/，再找插件自带 templates/<id>/assets/。
      id 与文件名都过白名单，且不接受子路径 —— 模板作者塞不进来任意文件读取。 */
@@ -601,11 +649,16 @@ function apply(ctx) {
       '<script src="' + ROUTE_BASE + '/splash.js"></script></body></html>'
   }
 
-  /* 一键诊断：把环境信息写到桌面，让不会用 AI 的用户也能一键求助 */
+  /* 一键诊断：把环境信息写到桌面，让不会用 AI 的用户也能一键求助。
+     同一时间只允许生成一份：按钮连点时后面的请求直接返回“正在生成中”，
+     避免桌面被一堆同名报告刷屏。 */
+  let diagnoseBusy = false
   disposers.push(registerRoute({
     kind: 'exact',
     path: ROUTE_BASE + '/diagnose',
     handler: async (req, res) => {
+      if (diagnoseBusy) { sendJson(res, 429, { ok: false, error: '诊断报告正在生成中，请等几秒，不用重复点击。' }); return }
+      diagnoseBusy = true
       try {
         const lines = []
         const add = (s2) => lines.push(s2 == null ? '' : String(s2))
@@ -688,6 +741,8 @@ function apply(ctx) {
         sendJson(res, 200, { ok: true, file, desktop })
       } catch (err) {
         sendJson(res, 500, { ok: false, error: String((err && err.message) || err) })
+      } finally {
+        diagnoseBusy = false
       }
     }
   }))
@@ -1327,6 +1382,26 @@ function apply(ctx) {
     return out
   }
 
+  /* 打开浏览器默认下载目录：等下载超时/找不到文件时，给用户一个直接可见的出口 */
+  disposers.push(registerRoute({
+    kind: 'exact',
+    path: ROUTE_BASE + '/open-downloads',
+    handler: async (req, res) => {
+      if ((req.method || 'GET').toUpperCase() !== 'POST') { sendJson(res, 405, { ok: false, error: 'method not allowed' }); return }
+      try {
+        const dir = browserDownloadDirs()[0]
+        try { fs.mkdirSync(dir, { recursive: true }) } catch (e) { /* 忽略 */ }
+        if (process.platform === 'win32') spawn('explorer.exe', [dir], { detached: true, stdio: 'ignore' }).unref()
+        else if (process.platform === 'darwin') spawn('open', [dir], { detached: true, stdio: 'ignore' }).unref()
+        else spawn('xdg-open', [dir], { detached: true, stdio: 'ignore' }).unref()
+        diag('open-downloads ' + dir)
+        sendJson(res, 200, { ok: true, dir })
+      } catch (err) {
+        sendJson(res, 200, { ok: false, error: String((err && err.message) || err) })
+      }
+    }
+  }))
+
 
   /* 自动更新（浏览器代理路线）：让系统默认浏览器去下载，插件只负责“接住”文件 */
   disposers.push(registerRoute({
@@ -1366,7 +1441,8 @@ function apply(ctx) {
         if (!/^[0-9][0-9A-Za-z.+-]{0,39}$/.test(version)) throw new Error('版本号不合法')
         const dirs = browserDownloadDirs()
         const since = (browserDownloadAt || Date.now()) - 120000
-        const deadline = Date.now() + 600000
+        /* 30 分钟：国内网络下 24MB 的包偶尔要十几分钟，10 分钟太容易误判超时 */
+        const deadline = Date.now() + 1800000
         diag('update-watch-download start dirs=' + dirs.join('|') + ' since=' + since)
         let found = null
         let bad = null
@@ -1375,7 +1451,8 @@ function apply(ctx) {
             try {
               if (!fs.existsSync(dir)) continue
               for (const f of fs.readdirSync(dir)) {
-                if (!/^dsh-boot-suite-win.*\.zip$/i.test(f)) continue
+                /* 文件名放宽：Chrome 可能存成 “dsh-boot-suite-win-V2.13.12 (1).zip” 甚至带空格的名字 */
+                if (!/dsh[-_ ]?boot[-_ ]?suite.*\.zip$/i.test(f)) continue
                 const fp = path.join(dir, f)
                 const st = fs.statSync(fp)
                 if (!st.isFile() || st.size < 1024 * 1024) continue
@@ -1397,7 +1474,7 @@ function apply(ctx) {
           }
           if (!found) await new Promise((r) => setTimeout(r, 1500))
         }
-        if (!found) { diag('update-watch-download timeout'); sendJson(res, 200, { ok: false, error: '等待浏览器下载超时（10 分钟）。建议用 Chrome 重新点「立即更新」，或点「选择安装包」手动指定。' }); return }
+        if (!found) { diag('update-watch-download timeout'); sendJson(res, 200, { ok: false, error: '等待浏览器下载超时（30 分钟）。可以点「打开下载文件夹」看看安装包是不是已经下好，再点「选择安装包」手动指定。' }); return }
         const raw = fs.readFileSync(found.file)
         if (!zipComplete(raw)) throw new Error('浏览器下载的安装包不完整（zip 校验失败），请重新下载')
         const outDir = path.join(DSH_HOME, 'boot-suite-updates')

package/lib/host-wallpaper.js

@@ -63,7 +63,8 @@ const DEFAULTS = {
   videoMode: 'single',                 // single 手动选 / shuffle 随机轮换
   videoId: '',                         // 选中的视频 id（视频文件的绝对路径规范化）
   videoRoots: [],                      // 额外的视频存放目录（默认 loops 始终包含）
-  videoShuffleMinutes: 0               // 0 = 每次启动随机；>0 = 每 N 分钟换一段
+  videoShuffleMinutes: 0,              // 0 = 每次启动随机；>0 = 每 N 分钟换一段
+  colorMode: 'color'                   // color 彩色 | mono 黑白（原版素材，不染色）
 }
 
 function readConfig() {
@@ -407,6 +408,8 @@ export default {
         const cfg = readConfig()
         const cur = resolveImage(cfg)
         const dir = wallpaperImageDir()
+        /* v2.13.17：目录不存在时直接建出来，面板不再显示「?」，打开按钮也才有东西可开 */
+        try { mkdirSync(dir, { recursive: true }) } catch { /* 权限不足就保持原样 */ }
         json(res, 200, {
           ok: true,
           dropDir: dir.replace(/\\/g, '/'),
@@ -464,7 +467,7 @@ export default {
      * 只接受白名单键，值做长度/类型校验，避免面板把配置写成垃圾。
      */
     const ALLOWED_SET = new Set(['image', 'imageFit', 'veilLightA', 'veilLightB', 'veilDarkA', 'veilDarkB', 'veilBlur', 'banner', 'bannerOpacity',
-      'bgMode', 'videoMode', 'videoId', 'videoShuffleMinutes'])
+      'bgMode', 'videoMode', 'videoId', 'videoShuffleMinutes', 'colorMode'])
     const setHandler = (req, res) => {
       let body = ''
       req.on('data', (c) => { body += c; if (body.length > 16384) req.destroy() })
@@ -483,6 +486,7 @@ export default {
               continue
             }
             if (k === 'bgMode') { if (v === 'image' || v === 'video') { cfg.bgMode = v; applied.bgMode = v } continue }
+            if (k === 'colorMode') { if (v === 'color' || v === 'mono') { cfg.colorMode = v; applied.colorMode = v } continue }
             if (k === 'videoMode') { if (v === 'single' || v === 'shuffle') { cfg.videoMode = v; applied.videoMode = v } continue }
             if (k === 'videoShuffleMinutes') {
               const n = Number(v)
@@ -691,6 +695,8 @@ export default {
       }
     }
 
+    /* v2.13.17：开机就把丢图目录建好；老用户/新装用户都不会再看到「?」 */
+    try { mkdirSync(wallpaperImageDir(), { recursive: true }) } catch { /* 忽略 */ }
     ctx.effect(() => ctx.webServer.register({ kind: 'exact', path: '/chat-wallpaper/config', handler: configHandler }))
     ctx.effect(() => ctx.webServer.register({ kind: 'exact', path: '/chat-wallpaper/image', handler: imageHandler }))
     ctx.effect(() => ctx.webServer.register({ kind: 'exact', path: '/chat-wallpaper/images', handler: imagesHandler }))