dsh-ppt-studio 1.1.0

package/scripts/install-desktop.mjs

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+/**
+ * dsh-ppt-studio 桌面端安装器（DSH Electron 应用）
+ *
+ * ── 为什么需要单独一个安装器（2026-09-26 实测，两条都是硬事实）──────────────────────
+ * ① **独立 CLI 拒绝桌面 profile**：`@deepseek-ai/dsh` 的 `lib/bin.js` 写死了
+ *      if (profile.toLowerCase() === "desktop") program.error('profile "desktop" is managed exclusively by the Electron application')
+ *    启动与 `plugin` 两条路都过这道守卫，且**没有环境变量旁路**
+ *    ⇒ README 那条 `dsh plugin --profile desktop add <URL>` 在桌面端一定失败。
+ * ② **桌面端自带的 pnpm 装不了 tarball URL**：应用内置 pnpm 11.7.0 + Electron 的 Node 24.18.1，
+ *    而它的 profile 用 `nodeLinker: hoisted`。hoisted 下 `pnpm add <https…tgz>` 会失败：
+ *      [ERR_PNPM_MISSING_TARBALL_INTEGRITY] … its lockfile entry has no "integrity" field
+ *    隔离复现：同一份 pnpm/工作区，**去掉 nodeLinker** 就成功；**换 pnpm 11.21** 也成功。
+ *    ⇒ 这是 pnpm 11.7 在 hoisted + tarball-URL 组合上的缺陷，不是本插件的代码问题；
+ *      但它让"用发布资产 URL 装"这条**我们唯一公开的安装通道**在桌面端直接不可用。
+ *
+ * ── 本脚本怎么做 ────────────────────────────────────────────────────────────────
+ *   1) 只用**应用自带的 pnpm/Node**（`resources/runtime/…`）——和应用的插件管理器同一套工具链，
+ *      避免用系统 Node 重编 profile 里的原生模块（cpu-features / ssh2 等）；
+ *   2) **默认把本包打成一个 tgz 放进 profile 内的 `.dsh-plugins/`，再以相对 `file:` 规格安装**。
+ *      理由：`file:` 由 pnpm 本地算 integrity ⇒ 在 hoisted 下实测可用，且 tarball 落在 **profile 内部**，
+ *      不会因为外部目录（解压目录 / `_artifacts`）被删而让桌面端下次 `pnpm install` 失败——
+ *      那种悬空依赖会让**应用起不来**，是最糟的失败形状；
+ *   3) 显式 `--spec <https…tgz>` 时先按原样试；撞上上面那个 integrity 错误就回退：
+ *      有可用系统 pnpm 就用它再试一次（实测它写的锁文件带 `resolution.integrity`，
+ *      之后桌面端自带 pnpm 跑 `install` 会 "Already up to date"）；否则下载进 `.dsh-plugins/` 转 `file:`；
+ *   4) 全程**先备份** `package.json` / `pnpm-lock.yaml` / `pnpm-workspace.yaml`，失败即还原
+ *      （应用自己的插件管理器也是这个纪律：失败恢复这几个文件）；
+ *   5) 收尾把包名补进 `dsh.profile.bundles`——桌面端启动只认这个列表，装完不补 = 装了不加载。
+ *
+ * 用法：
+ *   node scripts/install-desktop.mjs                       # 默认 DSH_HOME/~/.dsh + profile desktop，规格=本包
+ *   node scripts/install-desktop.mjs --spec <URL|tgz|目录>   # 指定安装规格
+ *   node scripts/install-desktop.mjs --prefix <DSH_HOME>    # 指定 DSH_HOME（测试/多实例）
+ *   node scripts/install-desktop.mjs --app-dir <目录>        # 指定桌面端安装目录（探测失败时）
+ *   node scripts/install-desktop.mjs --dry-run              # 只探测并打印计划，不写任何东西
+ *   node scripts/install-desktop.mjs --uninstall            # 卸载（摘依赖 + 摘 bundles 条目）
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, rmSync, statSync, readdirSync } from 'node:fs'
+import { spawnSync } from 'node:child_process'
+import { homedir, platform } from 'node:os'
+import { join, dirname, resolve, basename } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+
+const args = process.argv.slice(2)
+const opt = (k, d) => { const i = args.indexOf(k); return i >= 0 && args[i + 1] ? args[i + 1] : d }
+const PROFILE = opt('--profile', 'desktop')
+const prefix = resolve(opt('--prefix', process.env.DSH_HOME || join(homedir(), '.dsh')))
+const profileDir = join(prefix, 'profiles', PROFILE)
+const dryRun = args.includes('--dry-run')
+const uninstall = args.includes('--uninstall')
+const spec = opt('--spec', root)
+
+const say = (s) => console.log(s)
+const tail = (out, n = 6) => out.trim().split('\n').slice(-n).join('\n')
+const die = (s) => { console.error(`✗ ${s}`); process.exit(1) }
+/**
+ * 安装期的失败出口：只要已经备份过，就先**还原 profile** 再退出
+ * （应用自己的插件管理器也是这个纪律：pnpm 一失败就把 package.json / pnpm-lock.yaml 恢复原状）。
+ */
+let BACKUP_BOX = null
+const dieInstall = (s) => {
+  if (BACKUP_BOX !== null && existsSync(BACKUP_BOX)) {
+    restoreProfile(profileDir, BACKUP_BOX)
+    say('  （已还原 profile 文件）')
+  }
+  console.error(`✗ ${s}`)
+  process.exit(1)
+}
+
+// ── 应用目录与内置工具链 ──────────────────────────────────────────────────────
+/** 桌面端默认安装位置（探测失败时用 --app-dir 指定）。 */
+function defaultAppDirs() {
+  const out = []
+  if (process.env.DSH_DESKTOP_APP_DIR) out.push(process.env.DSH_DESKTOP_APP_DIR)
+  if (platform() === 'win32') {
+    const local = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local')
+    out.push(join(local, 'Programs', 'DeepSeek Harness'), join(local, 'DeepSeek Harness'))
+  } else if (platform() === 'darwin') {
+    out.push('/Applications/DeepSeek Harness.app/Contents/Resources')
+  } else {
+    out.push('/opt/DeepSeek Harness/resources', join(homedir(), '.local/share/DeepSeek Harness/resources'))
+  }
+  return out
+}
+
+/** 定位 resources 目录（含 runtime/pnpm/bin/pnpm.mjs 才算）。 */
+function findAppDir() {
+  const explicit = opt('--app-dir', null)
+  const candidates = explicit ? [resolve(explicit)] : defaultAppDirs()
+  for (const c of candidates) for (const r of [join(c, 'resources'), c]) {
+    if (existsSync(join(r, 'runtime', 'pnpm', 'bin', 'pnpm.mjs'))) return r
+  }
+  return null
+}
+
+/** 内置工具链：Node 垫片、pnpm 入口、Electron 可执行文件（垫片靠它当 Node 用）。 */
+function appToolchain(resourcesDir) {
+  const isWin = platform() === 'win32'
+  const nodeShim = join(resourcesDir, 'runtime', 'bin', isWin ? 'node.cmd' : 'node')
+  const pnpmEntry = join(resourcesDir, 'runtime', 'pnpm', 'bin', 'pnpm.mjs')
+  const appRoot = dirname(resourcesDir)
+  const exeCandidates = isWin
+    ? [join(appRoot, 'DeepSeek Harness.exe')]
+    : [join(dirname(appRoot), 'MacOS', 'DeepSeek Harness'), join(appRoot, 'DeepSeek Harness')]
+  return { nodeShim, pnpmEntry, exe: exeCandidates.find((p) => existsSync(p)) ?? null }
+}
+
+// ── profile 读写 ─────────────────────────────────────────────────────────────
+const readJson = (file) => JSON.parse(readFileSync(file, 'utf8').replace(/^\uFEFF/, ''))
+const writeJson = (file, obj) => writeFileSync(file, `${JSON.stringify(obj, null, 2)}\n`, 'utf8')
+
+/** workspace 设置里的 nodeLinker（缺省 = pnpm 的 isolated）。 */
+function nodeLinkerOf(dir) {
+  const f = join(dir, 'pnpm-workspace.yaml')
+  if (!existsSync(f)) return 'isolated'
+  const m = /^nodeLinker:\s*(\S+)\s*$/m.exec(readFileSync(f, 'utf8'))
+  return m ? m[1] : 'isolated'
+}
+
+const BACKUP_FILES = ['package.json', 'pnpm-lock.yaml', 'pnpm-workspace.yaml']
+function backupProfile(dir) {
+  const box = join(dir, `.dsh-install-backup-${new Date().toISOString().replace(/[:.]/g, '-')}`)
+  mkdirSync(box, { recursive: true })
+  for (const f of BACKUP_FILES) if (existsSync(join(dir, f))) copyFileSync(join(dir, f), join(box, f))
+  return box
+}
+function restoreProfile(dir, box) {
+  for (const f of BACKUP_FILES) if (existsSync(join(box, f))) copyFileSync(join(box, f), join(dir, f))
+}
+
+// ── 两套 pnpm ───────────────────────────────────────────────────────────────
+// 必须自己引号化：Node 的 `shell: true` **不引号化命令本身**，而桌面端的路径含空格
+// （`…\Programs\DeepSeek Harness\resources\runtime\bin\node.cmd`）——实测会退化成
+// `'C:\Users\11867\AppData\Local\Programs\DeepSeek' is not recognized`。
+const SHQ = (s) => {
+  const str = String(s)
+  if (!/[\s"']/.test(str)) return str
+  return platform() === 'win32' ? `"${str.replace(/"/g, '""')}"` : `'${str.replace(/'/g, `'\\''`)}'`
+}
+const run = (cmd, cmdArgs, opts = {}) => spawnSync([cmd, ...cmdArgs].map(SHQ).join(' '), { encoding: 'utf8', shell: true, ...opts })
+
+function runAppPnpm(tc, dir, pnpmArgs) {
+  const env = { ...process.env }
+  if (tc.exe !== null) env.DSH_DESKTOP_NODE_EXECUTABLE = tc.exe
+  const r = run(tc.nodeShim, [tc.pnpmEntry, ...pnpmArgs], { cwd: dir, env })
+  return { code: r.status, out: `${r.stdout ?? ''}\n${r.stderr ?? ''}` }
+}
+
+/** 系统 pnpm（桌面端单机用户不一定有）。 */
+function systemPnpm() {
+  const v = run('pnpm', ['--version'])
+  if (v.status !== 0) return null
+  return {
+    version: String(v.stdout ?? '').trim(),
+    run: (dir, pnpmArgs) => {
+      const r = run('pnpm', pnpmArgs, { cwd: dir })
+      return { code: r.status, out: `${r.stdout ?? ''}\n${r.stderr ?? ''}` }
+    },
+  }
+}
+
+const INTEGRITY_BUG = /ERR_PNPM_MISSING_TARBALL_INTEGRITY/
+
+/** 在 profile 内的 `.dsh-plugins/` 放一份 tgz，返回相对规格（相对 profile，不依赖任何外部路径）。 */
+function stageTarball(tc, dir, fromDir) {
+  const box = join(dir, '.dsh-plugins')
+  mkdirSync(box, { recursive: true })
+  const before = new Set(readdirSync(box))
+  // 注意 cwd：`pnpm pack` 打的是**当前目录**这个包，所以要 cd 到源目录，而不是 profile
+  const r = runAppPnpm(tc, fromDir, ['pack', '--pack-destination', box])
+  if (r.code !== 0) { say(tail(r.out)); dieInstall(`打包失败：${fromDir}`) }
+  const fresh = readdirSync(box).filter((f) => f.endsWith('.tgz') && !before.has(f))
+  const tgz = fresh.sort().pop() ?? readdirSync(box).filter((f) => f.endsWith('.tgz')).sort().pop()
+  if (!tgz) dieInstall('打包后没找到 tgz')
+  // 只留当前这一个：历史 tgz 会让 profile 里堆垃圾，也会让"装的是哪一版"说不清
+  for (const f of readdirSync(box)) if (f.endsWith('.tgz') && f !== tgz) rmSync(join(box, f), { force: true })
+  return { spec: `file:./.dsh-plugins/${tgz}`, tgz }
+}
+
+/**
+ * 把规格装进 profile。
+ * @returns {string} 实际用到的策略（供输出与测试）
+ */
+function installSpec(tc, dir, theSpec) {
+  const isUrl = /^https?:\/\//i.test(theSpec)
+  const isDir = existsSync(theSpec) && statSync(theSpec).isDirectory()
+
+  if (isUrl) {
+    const first = runAppPnpm(tc, dir, ['add', theSpec])
+    if (first.code === 0) return `应用自带 pnpm（URL 规格）`
+    if (!INTEGRITY_BUG.test(first.out)) { say(tail(first.out)); dieInstall(`应用自带 pnpm 安装失败（规格 ${theSpec}）`) }
+    say('  ⚠ 撞上桌面端自带 pnpm 的已知缺陷（hoisted + tarball URL 缺 integrity），回退…')
+    const sys = systemPnpm()
+    if (sys !== null) {
+      const second = sys.run(dir, ['add', theSpec])
+      if (second.code === 0) return `系统 pnpm ${sys.version}（绕开自带 pnpm 的 hoisted+URL 缺陷）`
+      say(tail(second.out))
+    }
+    const cache = join(dir, '.dsh-plugins')
+    mkdirSync(cache, { recursive: true })
+    const local = join(cache, basename(new URL(theSpec).pathname) || 'plugin.tgz')
+    const dl = run(process.execPath, ['--input-type=module', '-e',
+      `const {writeFileSync}=await import('node:fs');const r=await fetch(${JSON.stringify(theSpec)});if(!r.ok)throw new Error(String(r.status));writeFileSync(${JSON.stringify(local)},Buffer.from(await r.arrayBuffer()))`])
+    if (dl.status !== 0 || !existsSync(local)) { say(tail(String(dl.stderr ?? ''))); dieInstall('下载 tgz 失败（无法走 file: 兜底）') }
+    const third = runAppPnpm(tc, dir, ['add', `file:./.dsh-plugins/${basename(local)}`])
+    if (third.code !== 0) { say(tail(third.out)); dieInstall('file: 规格兜底也失败') }
+    return '应用自带 pnpm + profile 内 file: 兜底'
+  }
+
+  // 目录 → 用应用自带 pnpm 打成 tgz 放进 profile；已是 tgz → 直接放进 profile
+  let staged
+  if (isDir) staged = stageTarball(tc, dir, theSpec)
+  else if (/\.tgz$/i.test(theSpec) && existsSync(theSpec)) {
+    const box = join(dir, '.dsh-plugins')
+    mkdirSync(box, { recursive: true })
+    const target = join(box, basename(theSpec))
+    copyFileSync(theSpec, target)
+    staged = { spec: `file:./.dsh-plugins/${basename(theSpec)}`, tgz: basename(theSpec) }
+  } else {
+    // 其它形态（git/registry 等）交给 pnpm 自己判断
+    const r = runAppPnpm(tc, dir, ['add', theSpec])
+    if (r.code !== 0) { say(tail(r.out)); dieInstall(`应用自带 pnpm 安装失败（规格 ${theSpec}）`) }
+    return '应用自带 pnpm（原样规格）'
+  }
+  const r = runAppPnpm(tc, dir, ['add', staged.spec])
+  if (r.code !== 0) { say(tail(r.out)); dieInstall(`安装失败（规格 ${staged.spec}）`) }
+  return `应用自带 pnpm + profile 内 ${staged.spec}`
+}
+
+/** 把包名补进（或从）dsh.profile.bundles——桌面端启动只认这个列表。 */
+function reconcileBundles(dir, name, remove = false) {
+  const file = join(dir, 'package.json')
+  const manifest = readJson(file)
+  const list = manifest.dsh?.profile?.bundles ?? []
+  const next = remove ? list.filter((n) => n !== name) : (list.includes(name) ? list : [...list, name])
+  if (JSON.stringify(next) === JSON.stringify(list)) return false
+  manifest.dsh = manifest.dsh ?? {}
+  manifest.dsh.profile = manifest.dsh.profile ?? {}
+  manifest.dsh.profile.bundles = next
+  writeJson(file, manifest)
+  return true
+}
+
+// ── 主流程 ──────────────────────────────────────────────────────────────────
+if (!existsSync(profileDir)) {
+  die(`桌面 profile 不存在：${profileDir}\n  桌面端至少要启动过一次；或用 --prefix 指定 DSH_HOME`)
+}
+const appResources = findAppDir()
+if (appResources === null) die(`没找到桌面端安装目录（找过：${defaultAppDirs().join(' / ')}）\n  用 --app-dir <应用目录> 指定`)
+const tc = appToolchain(appResources)
+if (!existsSync(tc.nodeShim) || !existsSync(tc.pnpmEntry)) die(`内置工具链不完整：${appResources}`)
+
+const profilePkgFile = join(profileDir, 'package.json')
+const profileName = readJson(profilePkgFile).name ?? '(未知)'
+say(`桌面端：${appResources}`)
+say(`profile：${profileDir}（${profileName}）`)
+say(`内置工具链：${tc.nodeShim}${tc.exe === null ? '（未定位到可执行文件，沿用环境变量）' : ''}`)
+say(`nodeLinker：${nodeLinkerOf(profileDir)}`)
+if (profileName !== `dsh-profile-${PROFILE}`) say(`  ⚠ profile 名不是 dsh-profile-${PROFILE}——确认这是桌面端的 profile`)
+
+if (uninstall) {
+  if (dryRun) { say(`\n（dry-run）将执行：应用自带 pnpm remove ${pkg.name}；并从 dsh.profile.bundles 摘掉它`); process.exit(0) }
+  BACKUP_BOX = backupProfile(profileDir)
+  const r = runAppPnpm(tc, profileDir, ['remove', pkg.name])
+  if (r.code !== 0) { say(tail(r.out)); dieInstall('卸载失败，已还原 profile 文件') }
+  reconcileBundles(profileDir, pkg.name, true)
+  rmSync(join(profileDir, '.dsh-plugins'), { recursive: true, force: true })
+  rmSync(BACKUP_BOX, { recursive: true, force: true })
+  say(`\n✅ 已卸载 ${pkg.name}。重启桌面端后生效。`)
+  process.exit(0)
+}
+
+const isUrl = /^https?:\/\//i.test(spec)
+const isDir = existsSync(spec) && statSync(spec).isDirectory()
+say(`安装规格：${spec}${spec === resolve(root) ? '（本包目录 → 会先打成 tgz 放进 profile）' : ''}`)
+if (dryRun) {
+  const plan = isUrl
+    ? `应用自带 pnpm 直接装 URL；仅在撞上 hoisted+URL 缺陷时回退${systemPnpm() === null ? '（本机没有系统 pnpm ⇒ 会走 profile 内 file: 兜底）' : ''}`
+    : isDir ? '应用自带 pnpm 打包本目录 → 装 profile 内 file: 规格'
+      : `应用自带 pnpm 装 ${spec}`
+  say(`\n（dry-run）计划：${plan}`)
+  say(`（dry-run）随后把 ${pkg.name} 补进 dsh.profile.bundles，并核验 dsh.bundle.patch 在位`)
+  process.exit(0)
+}
+
+BACKUP_BOX = backupProfile(profileDir)
+say(`已备份 profile 文件 → ${BACKUP_BOX}`)
+const strategy = installSpec(tc, profileDir, spec)
+say(`  ✓ 安装完成（${strategy}）`)
+
+// 校验装到的包 + 补 bundles
+const name = pkg.name
+const installedDir = join(profileDir, 'node_modules', ...name.split('/'))
+if (!existsSync(join(installedDir, 'package.json'))) dieInstall(`装完仍找不到 ${installedDir}——已还原 profile 文件`)
+const installed = readJson(join(installedDir, 'package.json'))
+const patchRel = installed.dsh?.bundle?.patch
+if (typeof patchRel !== 'string' || !existsSync(join(installedDir, patchRel.replace(/^\.\//, '')))) {
+  dieInstall('装到的包没有可用的 dsh.bundle.patch——不是 bundle，装了也不会加载（已还原 profile 文件）')
+}
+const added = reconcileBundles(profileDir, name)
+say(`  ✓ ${name}@${installed.version} 已就位；dsh.bundle.patch=${patchRel}${added ? '；已补进 dsh.profile.bundles' : '（bundles 里已有）'}`)
+if (installed.dsh?.engines?.dsh) say(`  · 声明 dsh.engines.dsh = ${installed.dsh.engines.dsh}（桌面端 0.1.7-rc.2 满足）`)
+rmSync(BACKUP_BOX, { recursive: true, force: true })
+
+say(`
+✅ 装好了。**必须重启桌面端**（bundle 层在启动时组合，不热更）。
+重启后：新建会话的预设选择器里能看到「PPT 工作室」；
+        在会话里调一次 ppt_state，presetDelivery 字段会写明预设声明状态。`)

package/scripts/install.mjs

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+/**
+ * dsh-ppt-studio 一键安装器（随发布包提供——新用户"下载→可用"的最后一步）：
+ *   1) 确认本包是 **profile bundle**；不是就**替你装**（`dsh plugin --profile <p> add <规格>`）
+ *   2) 校验包在 profile 里可解析（包本体归 pnpm 管，本安装器**不建 junction**）
+ *   3) 校验"预设**声明**"所需的包内资产在位，并清理历史遗留产物
+ * 装完：重启 dsh web → 新建会话时选「PPT 工作室」→ 直接提需求。
+ *
+ * ── 2026-09-24 适配 DSH 0.1.7-rc.1：**安装器不再写预设目录** ──────────────────────
+ * 0.1.6 及以前，预设靠"往 `<dshHome>/.agent-presets/ppt/` 写文件"交付（宿主启动时扫描该目录）。
+ * 0.1.7 把那条发现路径**整个删掉了**，预设改为向 `agentPresets` 注册表**声明**——本插件的
+ * `lib/preset-delivery.js` 在激活时自己声明。所以安装器现在的职责变成：
+ *   · 保证**装配**（profile bundle）——这条没变；
+ *   · 校验**声明所需的包内资产**（`agent-presets/ppt/*` + `lib/preset-delivery.js`）真的装到了；
+ *   · **清理**旧版本留下的 `.agent-presets/ppt/`（在 0.1.7 上它是惰性垃圾，留着只会让人以为
+ *     "预设是靠这个目录生效的"）。
+ *
+ * ── `--isolate` 在 0.1.7 上**被拒绝**（不是被遗忘）────────────────────────────────
+ * 隔离模式原本靠"预设目录里的 junction + **相对路径**插件行"实现：相对行按**组合文件所在目录**解析
+ * （本机 liangshen/j-space 等预设正是用 `name: ./xxx.mjs` 引用自己的文件）。
+ * 这条路在 0.1.7 上断了两处：
+ *   ① 预设目录**不再被扫描**（同上）——没有"组合文件所在目录"这回事了；
+ *   ② 预设的行现在由注册表在**注册表自己 ctx 的 baseUrl** 下 mount（源码：
+ *      `mountPreset(scope.ctx.extend({ baseUrl: record.context.baseUrl }), …)`，而 `register()` 里
+ *      `context = this.ctx` = 注册表所在层 ⇒ 那是 **dsh-web-app 的包目录**，不是 profile、更不是预设目录）
+ *      ⇒ 裸包名 `dsh-ppt-studio` 在那里解析不到 ⇒ 预设被判 `broken` ⇒ 选择器过滤掉它。
+ * 所以 `--isolate` 现在会**明确失败并说明原因**，而不是写出一个永远不会被读到的预设（那正是
+ * 1.0.6 及以前在 0.1.7 上的静默故障形状）。要做隔离需要把插件行放进"预设声明"里、并给插件行一个
+ * **绝对 file:// 名字**（install 期算出来）——那是一块独立工作，不与默认路径共享代码，见 README §10。
+ *
+ * 用法：
+ *   node scripts/install.mjs                    # 默认 DSH_HOME/~/.dsh + profile web
+ *   node scripts/install.mjs --spec <URL|路径>   # 用指定安装规格装成 bundle（发布流程会传）
+ *   node scripts/install.mjs --prefix <dir>     # 指定 DSH_HOME（测试/多实例）
+ *   node scripts/install.mjs --profile <name>   # 指定 profile
+ *   node scripts/install.mjs --no-preset        # 只保证 bundle，不校验预设资产
+ */
+import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync, readdirSync } from 'node:fs'
+import { spawnSync } from 'node:child_process'
+import { homedir } from 'node:os'
+import { join, dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+
+// ── 参数 ────────────────────────────────────────────────────────────
+const args = process.argv.slice(2)
+const opt = (k, d) => {
+  const i = args.indexOf(k)
+  return i >= 0 && args[i + 1] ? args[i + 1] : d
+}
+const prefix = resolve(opt('--prefix', process.env.DSH_HOME || join(homedir(), '.dsh')))
+const profile = opt('--profile', 'web')
+const noPreset = args.includes('--no-preset')
+// 技能镜像默认**关闭**（跨预设泄漏，见第 3 步注释）；要给非 PPT 会话留兜底才显式开启。
+const mirrorSkills = args.includes('--mirror-skills')
+
+const profileDir = join(prefix, 'profiles', profile)
+// 包在 profile 里的落点：**按 pkg.name 拼**（2026-09-18 改无 scope 名 `dsh-ppt-studio` 后，
+// 硬编码 '@dsh-external/dsh-ppt-studio' 会指向一个不存在的目录）。split('/') 同时兼容 scoped 名。
+const pkgDir = join(profileDir, 'node_modules', ...pkg.name.split('/'))
+// 旧名（scoped）时代的 junction 落点——只在提示/兼容检查里用到，装新名后它是历史遗留物
+const legacyPkgDir = join(profileDir, 'node_modules', '@dsh-external', 'dsh-ppt-studio')
+// 0.1.6 的预设交付目录：0.1.7 上惰性，安装器负责清理
+const legacyPresetDir = join(prefix, '.agent-presets', 'ppt')
+
+if (args.includes('--isolate')) {
+  console.error(`✗ --isolate 在 DSH 0.1.7 上不再可用（本安装器拒绝写出一个永远不会被读到的预设）
+
+  原因（两处，都有源码依据）：
+    · 宿主不再扫描 \`<dshHome>/.agent-presets/\`——上游原文 "the harness discovers no preset on disk"，
+      预设改为向 agentPresets 注册表声明；旧写法写完等于没写，且**静默**。
+    · 预设的行现在由注册表在它自己 ctx 的 baseUrl 下 mount（= dsh-web-app 包目录，不是 profile、
+      不是预设目录）⇒ 预设里的裸包名 \`dsh-ppt-studio\` 解析不到 ⇒ 预设被判 broken ⇒ 选择器看不到它。
+
+  可选做法：
+    · 默认（全局）安装：直接跑本脚本不带 --isolate —— 「PPT 工作室」预设会由插件自己声明，
+      该 profile 的**所有会话**都能用 ppt_* 工具（这也是当前发布的装配形状）。
+    · 真要"只在「PPT 工作室」里生效"：需要把插件行放进**预设声明**里、并用安装期算出的绝对
+      \`file://\` 名字（见 README §10「隔离安装」）。这条路尚未实现——宁可明确拒绝，也不静默失败。`)
+  process.exit(1)
+}
+
+if (!existsSync(profileDir)) {
+  console.error(`✗ profile 不存在：${profileDir}\n  请确认已安装 dsh web（或 --prefix/--profile 正确）`)
+  process.exit(1)
+}
+if (!existsSync(join(root, 'lib', 'index.js'))) {
+  console.error(`✗ 当前目录缺少 lib/（发布包应自带；源码模式请先 node scripts/build.mjs）`)
+  process.exit(1)
+}
+
+const steps = []
+steps.push(`装配模式：**全局**（profile bundle：该 profile 的所有会话都能用）`)
+
+// ── 1) 包本体可达性 + bundle 装配 ─────────────────────────────────────────────
+const profilePkgFile = join(profileDir, 'package.json')
+let profilePkg = {}
+// 去 BOM 再解析：Windows 上被 PowerShell/记事本编辑过的 JSON 可能带 UTF-8 BOM，JSON.parse 会直接抛
+try { profilePkg = JSON.parse(readFileSync(profilePkgFile, 'utf8').replace(/^\uFEFF/, '')) } catch { /* 无/坏 → 视为非 bundle */ }
+let bundleInstalled = Boolean(profilePkg.dependencies?.[pkg.name]) || (profilePkg.dsh?.profile?.bundles ?? []).includes(pkg.name)
+
+if (!bundleInstalled) {
+  // 确认/建立 profile bundle（包本体交给 pnpm；规格优先级 --spec > 包本目录）
+  const spec = opt('--spec', root)
+  steps.push(`未检测到 profile bundle → 先装成 bundle：dsh plugin --profile ${profile} add ${spec}`)
+  // **必须把 DSH_HOME 传给子进程**：`--prefix` 指的就是 DSH home，不传会让 dsh 去动真实 ~/.dsh
+  const r = spawnSync('dsh', ['plugin', '--profile', profile, 'add', spec], {
+    stdio: 'inherit', shell: process.platform === 'win32', env: { ...process.env, DSH_HOME: prefix },
+  })
+  if (r.status !== 0) {
+    console.error(`✗ 安装 profile bundle 失败（dsh 退出码 ${r.status}）。请手动执行：\n    dsh plugin --profile ${profile} add ${spec}`)
+    process.exit(1)
+  }
+  try { profilePkg = JSON.parse(readFileSync(profilePkgFile, 'utf8').replace(/^\uFEFF/, '')) } catch { profilePkg = {} }
+  bundleInstalled = Boolean(profilePkg.dependencies?.[pkg.name]) || (profilePkg.dsh?.profile?.bundles ?? []).includes(pkg.name)
+  if (!bundleInstalled) { console.error(`✗ dsh 报告成功，但 profile 里仍没有本包（${profilePkgFile}）`); process.exit(1) }
+  steps.push(`已装成 profile bundle（${profilePkg.dependencies?.[pkg.name] ?? 'dsh.profile.bundles'}）`)
+} else {
+  steps.push(`已确认 profile bundle（${profilePkg.dependencies?.[pkg.name] ?? 'dsh.profile.bundles'}）——包本体归 pnpm 管`)
+}
+if (!existsSync(join(pkgDir, 'package.json'))) {
+  console.error(`✗ profile 里找不到本包：${join(pkgDir, 'package.json')}\n  请重跑：dsh plugin --profile ${profile} add ${opt('--spec', root)}`)
+  process.exit(1)
+}
+// 改名（@dsh-external/dsh-ppt-studio → dsh-ppt-studio）之后的双重挂载风险：旧包若仍在 profile 里，
+// 两行 patch 会各挂一次。插件有装配防重（不会崩），但纪律是二选一 ⇒ 主动提示清掉。
+if (existsSync(join(legacyPkgDir, 'package.json'))) {
+  steps.push(`⚠ 检测到旧包名残留：${legacyPkgDir}\n    建议执行：dsh plugin --profile ${profile} remove @dsh-external/dsh-ppt-studio（避免新旧双挂载）`)
+}
+
+// ── 2) 清理历史遗留：0.1.6 的预设目录 ────────────────────────────────────────
+// 在 0.1.7 上它是惰性垃圾（没有任何发现路径扫它）。留着会让"改了预设为什么没生效"变成
+// 一个假线索，也会与注册表里的那条声明**看起来像两处真相**。里面的文件全是安装器从包里拷的
+// （agent.cordis.yml / preset.yml）与安装器自己建的 junction（plugin）⇒ 清理是安全的；已存在的
+// `plugin` junction 也一并删掉（升级到 0.1.7 时它可能还指着旧路径）。
+if (existsSync(legacyPresetDir)) {
+  const entries = readdirSync(legacyPresetDir)
+  rmSync(legacyPresetDir, { recursive: true, force: true })
+  steps.push(`已清理 0.1.6 遗留的预设目录（0.1.7 不再扫描它）：${legacyPresetDir}（原含 ${entries.join('、') || '空'}）`)
+}
+
+// ── 3) 预设**声明**资产校验（2026-09-24）──────────────────────────────────────
+// 预设不再由安装器"写"出来，而是插件激活时向 agentPresets 注册表声明。安装器能验的是：
+// **声明要用的包内资产确实装到了 profile 里**（否则插件会告警"预设组合不可用"而静默没有预设）。
+if (!noPreset) {
+  const installedPreset = join(pkgDir, 'agent-presets', 'ppt', 'agent.cordis.yml')
+  const installedMeta = join(pkgDir, 'agent-presets', 'ppt', 'preset.yml')
+  const installedDelivery = join(pkgDir, 'lib', 'preset-delivery.js')
+  if (!existsSync(installedPreset) || !existsSync(installedMeta)) {
+    console.error(`✗ 装到 profile 的包缺少预设组合（发布包应自带 \`agent-presets/ppt/\`）：\n    ${installedPreset}`)
+    process.exit(1)
+  }
+  if (!existsSync(installedDelivery)) {
+    console.error(`✗ 装到 profile 的包缺少 lib/preset-delivery.js——那是"声明预设"的实现，缺了就没有预设：\n    ${installedDelivery}`)
+    process.exit(1)
+  }
+  // 组合里**不得**含本包插件行：插件已由 profile bundle 挂载，预设里再来一行 = 同进程双挂载。
+  const presetText = readFileSync(installedPreset, 'utf8')
+  if (/^-\s*id:\s*ppt-studio\s*$/m.test(presetText)) {
+    console.error('✗ 随包预设含本包插件行——同进程会被挂两次（profile bundle + 预设）。发布包不该带这一行。')
+    process.exit(1)
+  }
+  steps.push('预设资产已就位：agent-presets/ppt/{agent.cordis.yml,preset.yml} + lib/preset-delivery.js ✓（预设由插件声明，不由安装器写）')
+  steps.push('重启 dsh web 后：「PPT 工作室」由插件向 agentPresets 注册表声明，选择器里可选；状态可用 `ppt_state` 查 presetDelivery')
+}
+
+// ── 4) 内置 skill 文件镜像（**默认关闭**，见下）──────────────────────────────────
+// 技能包的**主通道**是插件内嵌注册（lib/skill.js → ctx.skills.register，落装它的那一层，随插件同生共死）。
+// 把 skills/*/SKILL.md 镜像到 <dshHome>/skills/ **会让该 profile 的所有会话（含官方标准预设）在技能目录里
+// 看到它们**——那是"跨预设泄漏"，与"只有选「PPT 工作室」时才有这些技能"直接冲突（2026-09-18 用户报告）。
+// 因此改为 **opt-in**：要给非 PPT 会话留"提问即用"的兜底，显式加 `--mirror-skills`。
+// 未开启时会**清理历史镜像**——否则早期安装留下的副本会继续泄漏，且此后每次 release-sync 都把它装回来，
+// 表现为"改了没生效"的静默问题。
+const skillsRoot = join(root, 'skills')
+if (!noPreset) {
+  if (!existsSync(skillsRoot)) {
+    console.warn('⚠ 包内缺少 skills/（此包打包不完整）——内置技能不可用')
+  } else {
+    const dirs = readdirSync(skillsRoot, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name)
+    if (mirrorSkills) {
+      const names = []
+      for (const name of dirs) {
+        const src = join(skillsRoot, name, 'SKILL.md')
+        if (!existsSync(src)) continue
+        const dstDir = join(prefix, 'skills', name)
+        mkdirSync(dstDir, { recursive: true })
+        writeFileSync(join(dstDir, 'SKILL.md'), readFileSync(src, 'utf8'), 'utf8')
+        names.push(name)
+      }
+      steps.push(names.length
+        ? `内置技能镜像已同步（--mirror-skills 显式开启，共 ${names.length} 本）：${names.join('、')}`
+        : '⚠ 包内 skills/ 下没有可用技能')
+    } else {
+      // 清理历史镜像（fs.rmSync 不跟随重解析点；这些本来就是普通目录）
+      let removed = 0
+      for (const name of dirs) {
+        const dstDir = join(prefix, 'skills', name)
+        if (existsSync(dstDir)) { rmSync(dstDir, { recursive: true, force: true }); removed++ }
+      }
+      steps.push(removed
+        ? `内置技能：**已移除 ${removed} 本历史镜像**——技能只在装插件的层可见（插件内嵌注册）；要给别的会话留兜底请加 --mirror-skills`
+        : '内置技能：未镜像（默认）——技能随插件注册，随插件同生共死')
+    }
+  }
+}
+
+console.log(`dsh-ppt-studio v${pkg.version} 安装/校验完成（${prefix} / profile=${profile}）\n- ` + steps.join('\n- ') + '\n\n下一步：重启 dsh web → 新建会话选「PPT 工作室」→ 直接提需求。')

package/scripts/migrate-templates-dualtrack.mjs

@@ -0,0 +1,71 @@
+/**
+ * v0.9.0 双轨迁移（幂等）：为外部模板补齐真相层——
+ * ① 原始 pptx → templates/<id>/template.pptx（用户桌面模板库）
+ * ② 已渲染 COM 整页 PNG（~/.dsh/ppt-studio/fidelity/orig/<模板名>/NN.png）→ templates/<id>/previews/
+ * ③ template.yaml 补 sourcePptx/previews 元数据
+ * 用法：node scripts/migrate-templates-dualtrack.mjs
+ *
+ * 【2026-09-18 状态（1.0.4）】它服务的那 4 套导入模板已移出随包发行物、桌面源目录也已不存在 ⇒
+ * 默认调用会找不到源。保留为**双轨真相层的迁移参考实现**（收纳自己的模板时仍可照此补齐
+ * template.pptx + previews/；生成侧现在有 `ppt_template_add` 覆盖）。
+ */
+import { readFile, writeFile, copyFile, mkdir, readdir } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { join, dirname, basename } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { homedir } from 'node:os'
+import YAML from 'yaml'
+
+const TPL_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'templates')
+const DESK = 'C:\\Users\\11867\\Desktop\\ppt模板库'
+const ORIG = join(homedir(), '.dsh', 'ppt-studio', 'fidelity', 'orig')
+
+// 源文件名（桌面/orig 目录名，中文+大小写差异）→ 模板 id
+const MAP = {
+  '实用毕业设计论文答辩PPT模板': '实用毕业设计论文答辩ppt模板',
+  '极简实用部门工作总结PPT模板': '极简实用部门工作总结ppt模板',
+  '深蓝质感论文答辩PPT模板': '深蓝质感论文答辩ppt模板',
+  '简约商务': '简约商务',
+}
+
+let done = 0
+for (const [srcName, tplId] of Object.entries(MAP)) {
+  const tplDir = join(TPL_DIR, tplId)
+  if (!existsSync(tplDir)) { console.log(`SKIP（模板目录不存在）：${tplId}`); continue }
+  // ① 原始 pptx
+  const pptxSrc = join(DESK, srcName + '.pptx')
+  const pptxDst = join(tplDir, 'template.pptx')
+  if (existsSync(pptxSrc) && !existsSync(pptxDst)) {
+    await copyFile(pptxSrc, pptxDst)
+    console.log(`+ template.pptx ← ${basename(pptxSrc)}`)
+  } else if (!existsSync(pptxSrc)) {
+    console.log(`! 源 pptx 缺失（跳过真相层）：${pptxSrc}`)
+  } else {
+    console.log(`= template.pptx 已存在（保持）`)
+  }
+  // ② 整页 PNG
+  const pvSrc = join(ORIG, srcName)
+  const pvDst = join(tplDir, 'previews')
+  if (existsSync(pvSrc) && !existsSync(pvDst)) {
+    await mkdir(pvDst, { recursive: true })
+    const files = (await readdir(pvSrc)).filter((f) => /\.png$/i.test(f)).sort()
+    for (const f of files) await copyFile(join(pvSrc, f), join(pvDst, f))
+    console.log(`+ previews/ ← ${files.length} 页（${srcName}）`)
+  } else if (!existsSync(pvSrc)) {
+    console.log(`! 已渲染 PNG 缺失：${pvSrc}`)
+  } else {
+    console.log(`= previews/ 已存在（保持）`)
+  }
+  // ③ 元数据
+  const metaFile = join(tplDir, 'template.yaml')
+  if (existsSync(metaFile)) {
+    const doc = YAML.parseDocument(await readFile(metaFile, 'utf8'))
+    let changed = false
+    if (existsSync(pptxDst) && !doc.get('sourcePptx')) { doc.set('sourcePptx', 'template.pptx'); changed = true }
+    if (existsSync(pvDst) && !doc.get('previews')) { doc.set('previews', 'previews'); changed = true }
+    if (changed) { await writeFile(metaFile, String(doc)); console.log(`~ template.yaml 元数据补充`) }
+    else console.log(`= template.yaml 已含双轨字段`)
+  }
+  done++
+}
+console.log(`\n完成：处理 ${done} 个模板`)