dsh-boot-suite 2.13.20 → 2.15.15

package/test/smoke-package.mjs

@@ -1,7 +1,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
-const root = process.cwd();
+const root = fileURLToPath(new URL('..', import.meta.url));
 const buf = fs.readFileSync(path.join(root, 'package.json'));
 if (buf.length >= 3 && buf[0] === 0xEF && buf[1] === 0xBB && buf[2] === 0xBF) {
   throw new Error('package.json 带 UTF-8 BOM，DSH 会拒绝加载');
@@ -27,4 +28,91 @@ for (const needle of ['TargetPkg', 'CheckOnly', 'DSH_BOOT_SUITE_ROLLBACK', '回
 for (const f of ['line-1.mp3', 'line-6.mp3', 'dry-line-1.mp3']) {
   if (fs.existsSync(path.join(root, 'lib/assets', f))) throw new Error('旧 TTS 配音素材未删除：' + f);
 }
+
+/* v2.15.5：全景大肥鱼-含彩蛋版（重命名 + 结尾波形 + 模板内配音效果） */
+const tplJson = JSON.parse(fs.readFileSync(path.join(root, 'templates/division-bigfish-codex/template.json'), 'utf8'))
+if (tplJson.name !== '全景大肥鱼-含彩蛋版') throw new Error('模板名称未更新：' + tplJson.name)
+const bigfishApp = fs.readFileSync(path.join(root, 'templates/division-bigfish-codex/app.js'), 'utf8')
+for (const needle of ['attachVoiceFx', 'window.__WAIT_START__', 'VOICE_FX_PRESETS']) {
+  if (!bigfishApp.includes(needle)) throw new Error('模板内配音效果/结尾波形缺少：' + needle)
+}
+const hostStartup = fs.readFileSync(path.join(root, 'lib/host-startup.js'), 'utf8')
+if (!hostStartup.includes("bigfishVoiceFx: 'none'")) throw new Error('host-startup 缺少 bigfishVoiceFx 默认值')
+if (!hostStartup.includes("window.CONFIG.voiceFx='")) throw new Error('host-startup 未注入模板 voiceFx')
+const clientJs = fs.readFileSync(path.join(root, 'lib/client.js'), 'utf8')
+for (const needle of ['bigfishVoiceFx', '全景大肥鱼-含彩蛋版']) {
+  if (!clientJs.includes(needle)) throw new Error('设置页缺少：' + needle)
+}
+/* v2.15.6：掉线彩蛋必须等用户点【重新连接】，不许自动 reconnect */
+if (bigfishApp.includes('setTimeout(reconnect')) throw new Error('彩蛋仍有自动 reconnect 定时器')
+if (!bigfishApp.includes('必须等用户点【重新连接】')) throw new Error('彩蛋等待逻辑缺少注释锚点')
+const bigfishCfg = fs.readFileSync(path.join(root, 'templates/division-bigfish-codex/config.js'), 'utf8')
+if (bigfishCfg.includes('eggReplayWait')) throw new Error('config.js 仍残留 eggReplayWait 自动重播字段')
+/* v2.15.7：结尾等待配音时必须继续渲染波形 */
+if (!bigfishApp.includes('if(!playing&&t>=cfg.duration-0.05)render();')) throw new Error('结尾等待期缺少渲染调用，波形会再次冻住')
+/* v2.15.8：模板配音音量 + iframe 模板 BGM */
+if (!hostStartup.includes('bigfishVoiceVolume: 50')) throw new Error('host-startup 缺少配音音量默认值')
+if (!hostStartup.includes('window.CONFIG.voiceVolume=')) throw new Error('host-startup 未注入模板配音音量')
+if (!bigfishApp.includes('a.volume=voiceVol')) throw new Error('模板配音未应用音量')
+if (!bigfishApp.includes('dsh-startup-voice')) throw new Error('模板未上报配音闪避事件')
+const splashJs = fs.readFileSync(path.join(root, 'lib/splash.js'), 'utf8')
+if (!splashJs.includes('dsh-startup-voice')) throw new Error('splash 未处理模板配音闪避')
+if (!/engine === 'iframe'[\s\S]{0,160}bgm\.start\(\)/.test(splashJs)) throw new Error('iframe 模板未启动 BGM')
+if (!clientJs.includes('配音音量')) throw new Error('设置页缺少配音音量')
+if (!clientJs.includes('bigfishVoiceVolume')) throw new Error('设置页缺少 bigfishVoiceVolume')
+if (!clientJs.includes('style: (isArchiveWarm || isBigfish)')) throw new Error('BGM 组未对全景大肥鱼显示')
+/* v2.15.9：无第二幕不切第二段音乐、BGM 循环开关、跳过按钮位置 */
+if (!hostStartup.includes('bgmLoop: true')) throw new Error('host-startup 缺少 bgmLoop 默认值')
+if (!hostStartup.includes("'bgmLoop'")) throw new Error('host-startup BOOL_KEYS 缺 bgmLoop')
+if (!splashJs.includes('C.bgmLoop !== false')) throw new Error('splash 未使用 bgmLoop')
+if (!/if \(!TEMPLATE2[\s\S]{0,420}bgm\.toSecond\(\)/.test(splashJs)) throw new Error('splash 在无第二幕时仍提前切第二段音乐')
+if (!clientJs.includes('hasSecondAct')) throw new Error('设置页缺少第二幕判断')
+if (!clientJs.includes('bgmLoop')) throw new Error('设置页缺少循环开关')
+const skipCss = fs.readFileSync(path.join(root, 'templates/division-bigfish-codex/style.css'), 'utf8')
+if (!skipCss.includes('top:64px;right:72px')) throw new Error('跳过按钮位置未调整')
+/* v2.15.10：掉线时机随机、彩蛋截断 BGM、重连不叠音 */
+if (!bigfishApp.includes('dsh-startup-bgm')) throw new Error('模板未上报 BGM 彩蛋信号')
+if (!bigfishApp.includes('resetPlayedAfter')) throw new Error('重连未按时间点重置语音')
+if (!bigfishApp.includes('eggTimeForPct(Math.random()*100)')) throw new Error('掉线时机未按进度百分比随机')
+if (!splashJs.includes('bgm cut')) throw new Error('splash 缺少 BGM 截断')
+if (!splashJs.includes('dsh-startup-bgm')) throw new Error('splash 未处理 BGM 彩蛋信号')
+if (!bigfishCfg.includes('egg:{}')) throw new Error('config.js 仍固定 egg.at')
+/* v2.15.11：模板不再自己做白闪，结尾转场由插件接管 */
+for (const f of ['index.html', 'render.html']) {
+  const html = fs.readFileSync(path.join(root, 'templates/division-bigfish-codex', f), 'utf8')
+  if (html.includes('id="flash"')) throw new Error(f + ' 仍有模板白闪节点 #flash')
+}
+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 模板收尾未交给插件退场转场')
+/* v2.15.12：结尾等配音时圆环继续转 */
+if (!bigfishApp.includes('const rt=t+waitSec')) throw new Error('结尾圆环未使用连续旋转时钟 rt')
+if (!bigfishApp.includes('rotate(${rt*5})')) throw new Error('外圈未使用 rt 旋转')
+if (!bigfishApp.includes('rotate(${-rt*12})')) throw new Error('内圈未使用 rt 旋转')
+if (!bigfishApp.includes('Math.sin(rt*6.54)')) throw new Error('外圈脉冲未使用 rt')
+if (!/function flashDone\(\)\{hideEgg\(\);doneEmit\(\);\}/.test(bigfishApp)) throw new Error('flashDone 不应再清零旋转时钟')
+/* v2.15.13：配音中文字幕 */
+if (!bigfishApp.includes('cfg.voice.subs')) throw new Error('模板未使用字幕映射 cfg.voice.subs')
+if (!bigfishApp.includes('subtitle')) throw new Error('模板未更新 #subtitle')
+const bigfishHtml = fs.readFileSync(path.join(root, 'templates/division-bigfish-codex', 'index.html'), 'utf8')
+if (!bigfishHtml.includes('id="subtitle"')) throw new Error('index.html 缺少 #subtitle 字幕节点')
+if (!bigfishCfg.includes('警告：检测到新特工登录')) throw new Error('config.js 缺少中文字幕映射')
+if (!bigfishCfg.includes("line2:'装备与技能配置已验证。倒计时十秒。'")) throw new Error('config.js line2 字幕未包含完整句')
+if (!bigfishCfg.includes("line3:'网络同步完成。正在移交权限。'")) throw new Error('config.js line3 字幕不正确')
+if (!bigfishCfg.includes("reconnect:'检测到特工重新连接。'")) throw new Error('config.js 缺少重连接字幕')
+if (!bigfishCfg.includes("line4:'警告：特工已离线。'")) throw new Error('config.js 缺少彩蛋 line4 字幕')
+if (!bigfishApp.includes('renderVoiceRow')) throw new Error('模板未使用整行字幕布局 renderVoiceRow')
+if (!fs.existsSync(path.join(root, 'templates/division-bigfish-codex/assets/whale-badge-line.png'))) throw new Error('缺少鲸鱼徽章图标 whale-badge-line.png')
+/* v2.15.14：重连提示音独占一整行，播完再继续，且不再续播断句 */
+if (!bigfishApp.includes('重连接提示音独占一整行')) throw new Error('app.js 缺少重连提示音独占一行的实现')
+if (!bigfishApp.includes('const cueOn=')) throw new Error('渲染未使用重连提示音分支 cueOn')
+if (!bigfishApp.includes('playing&&!cueGate')) throw new Error('重连期间未门控后续配音（cueGate）')
+if (!bigfishApp.includes('played.line2=false;played.line3=false;played.orig3=false')) throw new Error('重连后未重置后续配音的播放标记')
+if (/resetPlayedAfter\(cfg\.loadingStart\)/.test(bigfishApp)) throw new Error('重连仍会续播断句（resetPlayedAfter）')
+if (!bigfishApp.includes('cueFailTimer')) throw new Error('重连提示音缺少播放失败的兜底解除门控')
+/* v2.15.15：重连提示音也要走插件的配音效果；line3 顺延，避免和 line2 叠音 */
+if (!bigfishApp.includes("attachVoiceFx('reconnect')")) throw new Error('重连提示音未接入配音效果')
+if (!bigfishApp.includes("[20.0,'line3',3.300]")) throw new Error('app.js 默认时间线未把 line3 顺延到 20.0s')
+if (!bigfishCfg.includes("[20.0,'line3',3.300]")) throw new Error('config.js 时间线未把 line3 顺延到 20.0s')
 console.log('ok  package.json version=' + pkg.version + '，无 BOM，关键文件齐全（含更新前回滚 checkpoint）');

package/test/smoke-splash.mjs

@@ -336,6 +336,8 @@ console.log('\n[8] 终幕用真声欢迎语（来自 Video Project 3 的 line-6
   check('配音音色可切换：voicePack 为 f–k 时走 voice:<pack>:line-N 路由',
     /C\.voicePack/.test(src) && /'voice:' \+ pack \+ ':' \+ asset/.test(src)
     && /tplAssets && tplAssets\[asset\]/.test(src))
+  check('全局 line-N 无人声包时也改走 voice 路由（不再请求已删除的 lib/assets）',
+    src.includes("'/dsh-startup/voice/' + pack + '/' + name + '.mp3'") && src.includes("if (pack === 'builtin') pack = 'f'"))
   check('5 套声音效果预设都在，播放链路按 C.voiceFx 叠加',
     ['ai-mech', 'robot', 'radio', 'oldtv', 'dark'].every((k) => src.includes("'" + k + "':"))
     && /playAssetAndWait\(useAsset, 0\.85, isGlobalLine \? fx : 'none'\)/.test(src))

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-43', '__BUILD = cw-43（排查浏览器跑的是不是新包）', String(mod.__BUILD))
+ok(mod.__BUILD === 'cw-63', '__BUILD = cw-63（排查浏览器跑的是不是新包）', 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

@@ -50,7 +50,7 @@ const ctx = {
   on() { return () => {} },
   get(name) {
     if (name === 'webServer') return webServer
-    if (name === 'connection') return { requestRejection: () => undefined }
+    if (name === 'connection') return { requestRejection: (req) => (String((req && req.url) || '').includes('__deny=1') ? 401 : undefined) }
     return undefined
   },
   effect(fn) { effects++; const d = fn(); return () => { if (typeof d === 'function') d() } },
@@ -581,6 +581,12 @@ try {
   check('remove 后 /videos.roots 不再含该目录',
     !(rootsRes.json.roots || []).some((root) => root.path.toLowerCase().includes('custom-loops')), JSON.stringify(rootsRes.json.roots))
 
+  /* v2.14.0：壁纸路由接入信任栅栏（connection.requestRejection 返回状态码时直接拒绝） */
+  const deniedRes = await callJson('exact /chat-wallpaper/config', 'GET', undefined, '/chat-wallpaper/config?__deny=1')
+  check('★ 壁纸路由受信任栅栏保护：requestRejection 返回 401 时拒绝', deniedRes.res.statusCode === 401 && deniedRes.res.body === '', String(deniedRes.res.statusCode))
+  const allowedRes = await callJson('exact /chat-wallpaper/config', 'GET', undefined, '/chat-wallpaper/config')
+  check('栅栏放行普通请求', allowedRes.res.statusCode === 200, String(allowedRes.res.statusCode))
+
 } catch (e) {
   fail++
   console.log('  FAIL 测试本身抛异常：' + String((e && e.stack) || e))

package/tools/README.md

@@ -23,5 +23,5 @@
 
 ## 注意
 
-- 三个脚本都会**先要求桌面端完全退出**，否则直接退出不干活 —— 这是刻意的，避免在进程锁着 profile 时写半截。
+- 三个脚本默认会**先检查桌面端是否完全退出**，运行中会拒绝（避免在进程锁着 profile 时写半截）；确认要热装可加 `-Force`，装完重启 DSH。
 - 卸装 / 回滚都不会动 `~/.dsh/dsh-startup.json` 和 `~/.dsh/chat-wallpaper.json`（回滚会从备份里恢复它们）。

package/tools/build-release.mjs

@@ -7,7 +7,8 @@ const root = process.cwd();
 const stage = fs.mkdtempSync(path.join(os.tmpdir(), 'dsh-release-'));
 const out = path.join(root, '..', '03-发布包', 'dsh-boot-suite-win.zip');
 /* code-motion：另一条工作线（动效研究/验证）的文档与媒体，不属于插件本体，发布包不打包 */
-const skip = new Set(['.git', 'node_modules', '08-备份', 'code-motion']);
+/* docs：主线（编辑器重制/风格库/演示素材）文档与媒体，体积可能非常大（GB 级），不属于插件运行必需，发布包不打包 */
+const skip = new Set(['.git', 'node_modules', '08-备份', 'code-motion', 'docs']);
 function copy(src, dst) {
   fs.mkdirSync(dst, { recursive: true });
   for (const e of fs.readdirSync(src, { withFileTypes: true })) {

package/tools/install.ps1

@@ -16,7 +16,7 @@
     7. 自检并告诉你下一步
 #>
 [CmdletBinding()]
-param([switch]$CheckOnly, [string[]]$Profiles)
+param([switch]$CheckOnly, [switch]$Force, [string[]]$Profiles)
 
 $ErrorActionPreference = 'Stop'
 function Say($m) { Write-Host $m }
@@ -121,10 +121,13 @@ Say ('要装的 profile：' + ($targets -join '、'))
 # ── 3. 桌面端必须先完全退出 ─────────────────────────────────────────────────
 if ($targets -contains 'desktop') {
   $running = @(Get-Process -Name 'DeepSeek Harness' -ErrorAction SilentlyContinue)
-  if ($running.Count -gt 0 -and -not $CheckOnly) {
-    Die ('桌面端还在运行（' + $running.Count + ' 个进程）。请完全退出 DeepSeek Harness Desktop 后再双击安装。')
+  if ($running.Count -gt 0 -and -not $CheckOnly -and -not $Force) {
+    Die ('桌面端还在运行（' + $running.Count + ' 个进程）。请先完全退出 DeepSeek Harness Desktop 再双击安装；确实要热装可加 -Force（不推荐，装完手动重启）。')
   }
-  if ($running.Count -gt 0) { Say '（检查模式）桌面端正在运行 —— 真正安装前需要先完全退出' }
+  if ($running.Count -gt 0 -and $Force) {
+    Say ('[!] 桌面端还在运行（' + $running.Count + ' 个进程）：-Force 热装继续；装完请手动重启 DSH 让新代码生效。')
+  }
+  if ($running.Count -gt 0 -and $CheckOnly) { Say '（检查模式）桌面端正在运行 —— 真正安装前建议先完全退出' }
 }
 
 # ── 3.5 更新前的紧急回滚 checkpoint（v2.13.3）──────────────────────────────

package/tools/make-upgrade-helper.mjs

@@ -33,6 +33,26 @@ const pkgInstall = `%USERPROFILE%\\.dsh\\boot-suite-updates\\${version}\\pkg\\to
 const helperName = `升级到 ${version}（先完全退出 DSH 再双击）.cmd`
 const helperPath = path.join(desktop, helperName)
 
+/* 自检 0（2026-11-02 事故）：暂存包必须真的在 <updates>\<版本>\pkg\ 下，
+   否则生成的助手双击后必然报 “install.ps1 不存在”。生成前先确认，绝不给用户一个空指路牌。 */
+const stagedPkg = path.join(os.homedir(), '.dsh', 'boot-suite-updates', version, 'pkg')
+const stagedInstall = path.join(stagedPkg, 'tools', 'install.ps1')
+if (!fs.existsSync(stagedInstall)) {
+  console.error(`[x] 生成失败：暂存包不完整，缺少 ${stagedInstall}`)
+  console.error(`[x] 先把发布包解压到 ${stagedPkg}（注意是 pkg 子目录），再来生成桌面助手。`)
+  process.exit(1)
+}
+try {
+  const stagedVersion = JSON.parse(fs.readFileSync(path.join(stagedPkg, 'package.json'), 'utf8')).version
+  if (stagedVersion !== version) {
+    console.error(`[x] 生成失败：暂存包版本是 ${stagedVersion}，与要求的 ${version} 不一致`)
+    process.exit(1)
+  }
+} catch (err) {
+  console.error(`[x] 生成失败：读不到暂存包 package.json（${err.message}）`)
+  process.exit(1)
+}
+
 /* 整段模板：一行一个元素，绝不把版本号单独拼成数组元素 */
 const lines = [
   '@echo off',

package/tools/stage-local.mjs

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * 安全暂存本机升级包（2026-11-02 事故后的流程固化）。
+ *
+ * 事故复盘：
+ *   v2.15.13 曾把 zip 直接解压到 ~/.dsh/boot-suite-updates/2.15.13/，
+ *   文件铺在 2.15.13/ 下而不是 2.15.13/pkg/ 下；桌面助手固定调用
+ *   ...\2.15.13\pkg\tools\install.ps1，于是报「路径不存在」。
+ *   更糟的是当时在 DSH 运行时删掉了旧 pkg，profile 的 link: 指向了
+ *   不存在的目录，DSH 直接打不开，只能回滚。
+ *
+ * 本脚本的顺序（任何一步失败都保留旧版本，绝不让 profile 悬空）：
+ *   1. 确认目标 pkg 没有被任何 profile 以 link: 正在使用（在跑就拒绝）；
+ *   2. 解压到 updates 目录内的临时目录，校验 pkg/package.json 版本、
+ *      pkg/tools/install.ps1、文件数；
+ *   3. 旧 pkg 改名备份（不删除），新 pkg 原子 rename 到位；
+ *   4. 再校验一遍新 pkg；失败则把旧 pkg 改回来；
+ *   5. 复制 zip 到 <版本>/<版本>.zip，最后打印摘要。
+ *
+ * 用法：
+ *   node tools/stage-local.mjs 2.15.13
+ *   node tools/stage-local.mjs 2.15.13 --zip "F:/.../03-发布包/dsh-boot-suite-win.zip"
+ */
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+const repoRoot = path.dirname(here)
+
+const args = process.argv.slice(2)
+const version = args[0]
+const versionRe = /^\d+\.\d+\.\d+$/
+if (!version || !versionRe.test(version)) {
+  console.error('[x] 用法：node tools/stage-local.mjs <版本号> [--zip <发布包 zip 路径>]')
+  process.exit(1)
+}
+
+const zi = args.indexOf('--zip')
+let zipPath = zi >= 0 && args[zi + 1]
+  ? path.resolve(args[zi + 1])
+  : path.resolve(repoRoot, '..', '03-发布包', 'dsh-boot-suite-win.zip')
+
+if (!fs.existsSync(zipPath)) {
+  console.error(`[x] 找不到发布包 zip：${zipPath}`)
+  process.exit(1)
+}
+
+const updatesRoot = path.join(os.homedir(), '.dsh', 'boot-suite-updates')
+const versionDir = path.join(updatesRoot, version)
+const targetPkg = path.join(versionDir, 'pkg')
+const stamp = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14)
+const tmpRoot = path.join(updatesRoot, `.stage-${version}-${stamp}`)
+const tmpPkg = path.join(tmpRoot, 'pkg')
+
+const fail = (msg) => {
+  console.error(`[x] ${msg}`)
+  console.error(`[x] 旧的 ${targetPkg} 未被删除（如果已备份，会在下面提示），profile 未改动。`)
+  process.exit(1)
+}
+
+/* 1. 目标 pkg 正被 profile 以 link: 使用时拒绝替换 */
+const profilesRoot = path.join(os.homedir(), '.dsh', 'profiles')
+const live = []
+if (fs.existsSync(profilesRoot)) {
+  for (const name of fs.readdirSync(profilesRoot)) {
+    const pj = path.join(profilesRoot, name, 'package.json')
+    if (!fs.existsSync(pj)) continue
+    try {
+      const json = JSON.parse(fs.readFileSync(pj, 'utf8'))
+      for (const dep of Object.values(json.dependencies || {})) {
+        if (typeof dep !== 'string' || !dep.startsWith('link:')) continue
+        const resolved = path.resolve(dep.slice(5).replace(/\//g, path.sep)).toLowerCase()
+        if (resolved === targetPkg.toLowerCase() || resolved.startsWith(targetPkg.toLowerCase() + path.sep.toLowerCase())) {
+          live.push(`${name}: ${dep}`)
+        }
+      }
+    } catch { /* 单个 profile 读不动就跳过，不影响主流程 */ }
+  }
+}
+if (live.length) {
+  console.error(`[x] 目标 pkg 正被 profile 使用，拒绝替换：\n    ${live.join('\n    ')}`)
+  console.error('[x] 先让 DSH 用旧版本启动（或回滚）并完全退出，再暂存新版本。')
+  process.exit(1)
+}
+
+/* 2. 解压到临时目录并校验 */
+fs.rmSync(tmpRoot, { recursive: true, force: true })
+fs.mkdirSync(tmpPkg, { recursive: true })
+console.log(`[1/5] 解压 ${zipPath}`)
+const tar = spawnSync('tar', ['-xf', zipPath, '-C', tmpPkg], { stdio: 'inherit' })
+if (tar.status !== 0) fail(`解压失败（tar exit ${tar.status}）`)
+
+let srcPkg = tmpPkg
+if (!fs.existsSync(path.join(srcPkg, 'package.json')) && fs.existsSync(path.join(srcPkg, 'pkg', 'package.json'))) {
+  srcPkg = path.join(srcPkg, 'pkg') // 兼容 zip 内自带 pkg/ 层的情况
+}
+const countFiles = (dir) => {
+  let n = 0
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, e.name)
+    if (e.isDirectory()) n += countFiles(p)
+    else n++
+  }
+  return n
+}
+const pkgJsonPath = path.join(srcPkg, 'package.json')
+const installPath = path.join(srcPkg, 'tools', 'install.ps1')
+if (!fs.existsSync(pkgJsonPath)) fail('解压结果里没有 package.json')
+if (!fs.existsSync(installPath)) fail('解压结果里没有 tools/install.ps1（桌面助手会找不到安装器）')
+const pkgVersion = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8')).version
+if (pkgVersion !== version) fail(`包内版本 ${pkgVersion} 与要暂存的 ${version} 不一致`)
+const fileCount = countFiles(srcPkg)
+if (fileCount < 50) fail(`包内文件数异常（${fileCount}），拒绝暂存`)
+console.log(`[2/5] 校验通过：version=${pkgVersion}，files=${fileCount}`)
+
+/* 3. 旧 pkg 备份 → 新 pkg 原子替换 */
+fs.mkdirSync(versionDir, { recursive: true })
+let backupDir = ''
+if (fs.existsSync(targetPkg)) {
+  backupDir = path.join(versionDir, `pkg.prev-${stamp}`)
+  fs.renameSync(targetPkg, backupDir)
+  console.log(`[3/5] 旧 pkg 已备份到 ${backupDir}`)
+} else {
+  console.log('[3/5] 没有旧 pkg，直接放入新 pkg')
+}
+try {
+  fs.renameSync(srcPkg, targetPkg)
+} catch (err) {
+  if (backupDir) fs.renameSync(backupDir, targetPkg)
+  fail(`新 pkg 移入失败（${err.message}），已恢复旧 pkg`)
+}
+
+/* 4. 对最终位置再校验一遍，失败就回滚 */
+let ok = false
+try {
+  const v = JSON.parse(fs.readFileSync(path.join(targetPkg, 'package.json'), 'utf8')).version
+  ok = v === version && fs.existsSync(path.join(targetPkg, 'tools', 'install.ps1'))
+} catch { ok = false }
+if (!ok) {
+  fs.rmSync(targetPkg, { recursive: true, force: true })
+  if (backupDir) fs.renameSync(backupDir, targetPkg)
+  fail('新 pkg 落位后校验失败，已恢复旧 pkg')
+}
+const zipCopy = path.join(versionDir, `${version}.zip`)
+fs.copyFileSync(zipPath, zipCopy)
+console.log(`[4/5] 新 pkg 就位：${targetPkg}`)
+
+/* 5. 打印摘要 */
+const size = fs.statSync(zipPath).size
+console.log('[5/5] 完成')
+console.log(`  version      : ${version}`)
+console.log(`  pkg          : ${targetPkg}`)
+console.log(`  files        : ${fileCount}`)
+console.log(`  pkg.prev     : ${backupDir || '(无)'}`)
+console.log(`  zip copy     : ${zipCopy} (${size} bytes)`)