@noob-stupid/dsh-plugin-console 0.5.101 → 0.5.103

package/lib/server/domain/selfupdate.js

@@ -10,100 +10,30 @@
 // 现在的顺序：① spec 是版本范围 → `pnpm update <pkg>`（spec 不变、lock 提到范围内最新）
 //            ② 仍不是 latest（超出范围 / spec 是 git·file 来源）→ `pnpm add <pkg>@<latest>`（spec 与 lock 同步改写）
 //            ③ 回读核实 readInstalledVersion / lockVersion；都不匹配才回落手铺文件，且**必须**带 lockNote 警告。
-import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { readFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { linkSpecFor, linkSpecIsIntact, materializePackageForLink, probeRegistryPackage, sameSourceSpec, suggestedPinAction } from './dep-source.js'
 import { canWriteImporterEntry, lockEntryKeyMatches, verifyLockReadOnly, writeLockImporterEntry } from './lock-importer.js'
 import { readManifestDeps } from './lockfile-health.js'
 import { pnpmInstall } from './install.js'
+// 同一个 profile + 包名 的安装互斥（2026-11-04 加法，见 domain/install-lock.js 顶部现场）：
+// 「插件卡片的更新」与「市场页那颗自更新 pill」动的是**同一个** node_modules/<控制台> 目录 —— 必须串行。
+import { withInstallLockOr } from './install-lock.js'
 // 自更新兜底（2026-11-03 加法，见 self-update-guard.js 顶部事故记录）：
 // begin/note/settle 是同一套判据与同一份 manualCommand；finishSelfUpdate 是本文件收尾段**原样搬出**的（腾行数用）。
 import { beginSelfUpdateGuard, finishSelfUpdate, noteGuardStep, settleSelfUpdateGuard } from './self-update-guard.js'
+// 只读读数（spec 判定 / 已装版本 / lock 里钉住的版本）2026-11-04 搬进 selfupdate-read.js：
+// 本文件贴着 600 行架构棘轮，而本轮要给"pnpm 卡住/失败后立刻手铺 + 补 lock"腾出空间。
+// 名字与语义一个字未改；下面的 export 语句照旧把它们**原样 re-export**（外部调用方与测试不用改）。
+import { isRegistryRange, lockVersion, profileSpec, readInstalledVersion } from './selfupdate-read.js'
+// 手铺兜底（2026-11-04 加法，见 selfupdate-copy.js 顶部现场）：pnpm 之前先把 tarball 备好 →
+// pnpm 超时/失败就**只覆盖文件、不清空目录**地铺进去 → 再把 lock 的版本/完整性补上。
+import { disposeSelfUpdateTarball, overlaySelfUpdateTarball, patchSelfUpdateLock, prepareSelfUpdateTarball } from './selfupdate-copy.js'
 import { fetchJsonUrl } from '../infra/http.js'
 import { runPnpmWithFallback } from '../infra/exec.js'
 
 const CONSOLE_PACKAGE = '@noob-stupid/dsh-plugin-console'
 
-/** spec 是否是 registry 版本范围（`^1.2.3` / `~1.2.3` / `1.2.3` / `>=1` / `=1`）。
- * 只有这种才能用 `pnpm update` 在**不改写 spec**的前提下把 lock 提到范围内最新；
- * git / file / link / workspace 来源没有"范围"可言，只能走 `pnpm add <pkg>@<版本>`。 */
-function isRegistryRange(spec) {
-  if (typeof spec !== 'string') return false
-  const s = spec.trim()
-  if (/^[\^~]?\d/u.test(s)) return true
-  return /^(>=|>|=)\s*\d/u.test(s)
-}
-
-/** profile 里该包的依赖声明（spec）。读不到返回 null。 */
-function profileSpec(profileDir, name) {
-  try {
-    const pkg = JSON.parse(readFileSync(join(profileDir, 'package.json'), 'utf8'))
-    const spec = pkg?.dependencies?.[name]
-    return typeof spec === 'string' ? spec : null
-  } catch {
-    return null
-  }
-}
-
-/** 已安装版本（直接读 node_modules 里那份 package.json）。 */
-function readInstalledVersion(profileDir, name) {
-  try {
-    const pkg = JSON.parse(readFileSync(join(profileDir, 'node_modules', ...name.split('/'), 'package.json'), 'utf8'))
-    return typeof pkg?.version === 'string' ? pkg.version : null
-  } catch {
-    return null
-  }
-}
-
-/**
- * 从 pnpm-lock.yaml 读出该包被**钉住**的版本。解析策略（lock 格式五花八门，只认两种确定性位置，避免子串误命中）：
- *   ① importers 段：行内容恰为 `'<name>':`（可带缩进），随后几行内的 `version: X`；
- *   ② packages 段：行首（可带缩进/引号）`<name>@<版本或 git+...>:` 的键名。
- * 读不到返回 null（调用方据此判定"没能核实"，不谎报成功）。
- *
- * ★ 2026-09-22 修复（缺陷②连带）：旧版 ① 在遇到 `specifier: …` 行时**直接 break**，而 importers 段
- *   恒为 `specifier:` 在前、`version:` 在后 → ① 从来没生效过，全靠 ② 兜底；而 ② 的正则用 `[^':\s]+`
- *   取值，遇到 `name@https://…tgz` / `link:…` 会在第一个冒号处截断（读出 `http`）或读不到（link 依赖
- *   在 lock 里没有 packages 条目 → 返回 null）。后果：来源钉住的包永远被判为「漂移」→ 每次安装都白跑
- *   一次 pnpm add，并给用户一条假的「没写进 lock」警告。现在 ① 跳过 specifier 行、② 取到行尾。
- */
-function lockVersion(profileDir, name) {
-  const file = join(profileDir, 'pnpm-lock.yaml')
-  if (!existsSync(file)) return null
-  let lines = []
-  try {
-    lines = readFileSync(file, 'utf8').split(/\r?\n/u)
-  } catch {
-    return null
-  }
-  for (let i = 0; i < lines.length; i += 1) {
-    // 键形态三种都认（0.5.38 改错）：`name`、`'name':`（pnpm 对**含 `/`/`@`** 的包名加引号）、
-    // `name:`（pnpm 对**未加 scope** 的包名不加引号）。旧判据漏了第三种 ⇒ 未加 scope 的 `link:`
-    // 依赖在 importers 里明明有条目却读不出来（真机 desktop profile 的 `dshmarket` 就是：
-    // lock 的 35-37 行写着 `dshmarket: / specifier: link:… / version: link:../../plugin-src/dshmarket`，
-    // 而 `lockVersion()` 返回 null）——后果是面板永远报"没写进 pnpm-lock.yaml"、pin 永远 partial、
-    // 每次对账都白跑一次 `pnpm add`。真值一律从下面这一处读，别在调用方再补一套。
-    // 0.5.39：键判据搬进 lock-importer.js#lockEntryKeyMatches —— 定点**写**入也要认同一批键形态，
-    // 两处各写一份必然再次分叉（写进去的键、读的时候认不出，就是 0.5.38 那个现场）。
-    if (lockEntryKeyMatches(lines[i], name)) {
-      for (let k = i + 1; k < Math.min(i + 8, lines.length); k += 1) {
-        const m = /^\s*version:\s*(\S+)\s*$/u.exec(lines[k])
-        if (m) return m[1]
-        // 只在新包的键行（`'<name>':` 形态）处停止；`specifier: X` 有值，不是键行，必须继续往下看
-        if (/^\s*'?[^\s:]+'?:\s*$/u.test(lines[k])) break
-      }
-    }
-  }
-  const escaped = name.replace(/[/\\^$*+?.()|[\]{}]/gu, '\\$&')
-  // 取到行尾再剥尾部的引号/冒号：`'name@https://…tgz':` / `name@git+https://…#sha:` / `name@1.2.3:`
-  const keyRe = new RegExp(`^\\s*'?${escaped}@(.+?)'?:\\s*$`, 'u')
-  for (const line of lines) {
-    const m = keyRe.exec(line)
-    if (m) return m[1]
-  }
-  return null
-}
-
 /** 给用户的兜底建议命令（照用户报告里那条：让 lock 也变成新版本，而不是只改文件）。 */
 function selfUpdateCommand(latest, profileName = '<你的profile>') {
   return `dsh plugin --profile ${profileName} add ${CONSOLE_PACKAGE}@${latest}`
@@ -113,8 +43,37 @@ function selfUpdateCommand(latest, profileName = '<你的profile>') {
  * 把控制台升到 `latest` 并**确保写进 lock**。
  * 依赖以参数注入（便于单测替换）：`runPnpm`（默认 runPnpmWithFallback）、`pnpmAdd`（默认 pnpmInstall）、
  * `curlManualInstall`（手铺文件兜底，由路由传入）。
+ *
+ * ★ 2026-11-04 加法（唯一的改动，见 domain/install-lock.js 顶部现场）：整段操作过**同一个包互斥闸** ——
+ *   这条路和插件卡片的「更新」（`/install` → domain/install-channels.js）动的是**同一个**
+ *   `node_modules/@noob-stupid/dsh-plugin-console`，真机事故就是两边同时装这个包。
+ *   拿不到锁 ⇒ 如实返回"正在安装中"（ok=false + reason），**不装、不碰目录**（结构同 finishSelfUpdate）。
+ */
+async function selfUpdateToLatest(args = {}) {
+  return await withInstallLockOr(
+    { profileDir: args?.profileDir, packageName: CONSOLE_PACKAGE },
+    async () => await selfUpdateToLatestLocked(args),
+    (error) => ({
+      method: null, spec: profileSpec(args?.profileDir ?? '', CONSOLE_PACKAGE), installedVersion: readInstalledVersion(args?.profileDir ?? '', CONSOLE_PACKAGE),
+      lockVersion: lockVersion(args?.profileDir ?? '', CONSOLE_PACKAGE), lockUpdated: false, lockNote: null,
+      command: selfUpdateCommand(args?.latest, args?.profileName ?? '<你的profile>'), note: error.message, errors: [error.message],
+      ok: false, reason: error.message, selfUpdate: null,
+    }),
+  )
+}
+
+/**
+ * 上面那个互斥外壳里的正文。
+ *
+ * ★ 2026-11-04 加法（**三步的触发条件与顺序一个字未改**，只多了"预先备 tarball"和"手铺后补 lock"）：
+ *   现场：pnpm 一启动就清空目标目录，在 profile 里重算整棵依赖树要几分钟 → 撞 90s/180s 超时被杀 →
+ *   目录停在"空了"的状态，手铺那一步（第③步）压根还没轮到；即使轮到，既有 curl 通道也是"先删再铺"。
+ *   现在：⓪ 先用既有 curl/元数据链路把目标版本 tarball 备到手（失败不影响后续）→ ① ② 照旧 →
+ *   ③ 需要手铺时**先用备好的 tarball 只覆盖文件（绝不清空目录）**，不行才回落到既有 curl 通道 →
+ *   ③c 手铺成功但 lock 没跟上 ⇒ 立刻补 lock（版本 + 完整性）并复核；补不上就如实记 lockNote。
+ *   `copyDeps` 只是单测注入口（默认全是既有实现），路由侧一个字都不用改。
  */
-async function selfUpdateToLatest({ profileDir, latest, registries, curlManualInstall, runPnpm = runPnpmWithFallback, pnpmAdd = pnpmInstall, profileName = null, execOpts = {}, selfUpdateDeps = {} }) {
+async function selfUpdateToLatestLocked({ profileDir, latest, registries, curlManualInstall, runPnpm = runPnpmWithFallback, pnpmAdd = pnpmInstall, profileName = null, execOpts = {}, selfUpdateDeps = {}, copyDeps = {} }) {
   const command = selfUpdateCommand(latest, profileName ?? '<你的profile>')
   const spec = profileSpec(profileDir, CONSOLE_PACKAGE)
   const errors = []
@@ -123,6 +82,9 @@ async function selfUpdateToLatest({ profileDir, latest, registries, curlManualIn
   // 自更新兜底（规矩：只对本插件生效 / 更新前就有完整副本 / 真的装在 node_modules 里，三条闸都在 begin 里）
   const guard = beginSelfUpdateGuard({ packageName: CONSOLE_PACKAGE, profileDir, targetVersion: latest, deps: selfUpdateDeps })
 
+  // ⓪ 走 pnpm **之前**先把目标版本的 tarball 备到手（失败只记原因，绝不阻断后续：三步顺序不变）
+  const prepared = await prepareSelfUpdateTarball({ packageName: CONSOLE_PACKAGE, version: latest, registries, deps: copyDeps })
+
   // ① spec 是版本范围 → pnpm update（spec 不变，lock 提到范围内最新）
   if (isRegistryRange(spec)) {
     try {
@@ -148,27 +110,65 @@ async function selfUpdateToLatest({ profileDir, latest, registries, curlManualIn
   let lock = lockVersion(profileDir, CONSOLE_PACKAGE)
   let lockUpdated = installed === latest && lock === latest
   let lockNote = null
+  let copy = null
+  let lockPatch = null
 
-  // ③ 包管理器都没成 → 手铺文件兜底（**不写 lock**），并且必须明确警告，不能让人以为升级成功
+  // ③ 包管理器都没成 → 手铺文件兜底（触发条件与 0.5.102 一致：`!lockUpdated`）
   if (!lockUpdated) {
-    try {
-      const info = await curlManualInstall(profileDir, CONSOLE_PACKAGE, registries, null, latest)
-      method = method === null ? 'manual-copy' : `${method}+manual-copy`
-      installed = info?.version ?? readInstalledVersion(profileDir, CONSOLE_PACKAGE)
+    // ③a 先用**已备好的 tarball 只覆盖文件、不清空目录**（pnpm 卡住/失败时那条"立刻手铺"的腿）
+    const overlay = await overlaySelfUpdateTarball({ prepared, profileDir, packageName: CONSOLE_PACKAGE, expectedVersion: latest, deps: copyDeps })
+    if (overlay.ok === true) {
+      method = method === null ? 'manual-overlay' : `${method}+manual-overlay`
+      installed = overlay.version ?? readInstalledVersion(profileDir, CONSOLE_PACKAGE)
+      copy = { channel: 'overlay', files: overlay.files, preserved: overlay.preserved, version: overlay.version ?? null, boxNote: overlay.boxNote ?? null, noClear: true, reason: null }
+    } else {
+      // ③b 没 tarball / 覆盖失败 → **既有** curl 通道（先删再铺），行为与 0.5.102 逐字一致
+      try {
+        const info = await curlManualInstall(profileDir, CONSOLE_PACKAGE, registries, null, latest)
+        method = method === null ? 'manual-copy' : `${method}+manual-copy`
+        installed = info?.version ?? readInstalledVersion(profileDir, CONSOLE_PACKAGE)
+        copy = { channel: 'curl', files: null, preserved: null, version: info?.version ?? null, boxNote: info?.boxNote ?? null, noClear: false, reason: overlay.reason ?? null }
+      } catch (error) {
+        errors.push(`手动铺文件失败：${label(error)}`)
+        copy = { channel: null, files: null, preserved: null, version: null, boxNote: null, noClear: false, reason: overlay.reason ?? null }
+      }
+    }
+    lock = lockVersion(profileDir, CONSOLE_PACKAGE)
+    lockUpdated = installed === latest && lock === latest
+    // ③c 手铺成功（版本对了）但 lock 还钉在旧版本 ⇒ **必须补 lock**，否则下一次 pnpm 操作就把它还原
+    if (installed === latest && !lockUpdated) {
+      lockPatch = await patchSelfUpdateLock({
+        profileDir, packageName: CONSOLE_PACKAGE, targetVersion: latest, spec,
+        integrity: prepared.ok === true ? prepared.integrity : null,
+        section: manifestSectionOf(profileDir, CONSOLE_PACKAGE), deps: copyDeps,
+      })
       lock = lockVersion(profileDir, CONSOLE_PACKAGE)
       lockUpdated = installed === latest && lock === latest
-    } catch (error) {
-      errors.push(`手动铺文件失败：${label(error)}`)
+      if (lockPatch.reason !== null) errors.push(`补 pnpm-lock.yaml 未成功：${lockPatch.reason}`)
     }
     noteGuardStep(guard, 'manual-copy')
     if (!lockUpdated) {
       lockNote = `此更新未写入 pnpm-lock.yaml（lock 里仍是 ${lock ?? '未知'}）：之后任何 pnpm 操作（开关插件、dsh plugin add/remove）都会把它还原成 lock 里的版本。要真正落地请执行：${command}`
+      if (lockPatch !== null && lockPatch.reason !== null) lockNote = `${lockNote}（补 lock 未成功：${lockPatch.reason}）`
     }
   }
 
+  // 临时工作目录（预下载的 tarball / 解包目录）收尾即删；删不掉要如实记下来（本机 %TEMP% 下 rmSync 会静默落空）
+  const cleanup = disposeSelfUpdateTarball(prepared)
+
   // 收尾：三步都走完才统一校验（全部走完仍不过才自愈），然后交给**原样搬出**的收尾段组装返回结构
   const selfUpdate = settleSelfUpdateGuard(guard, { targetVersion: latest })
-  return finishSelfUpdate({ profileDir, packageName: CONSOLE_PACKAGE, latest, spec, installed, method, command, errors, lockVersion: lock, lockUpdated, lockNote, registryRange: isRegistryRange, selfUpdate })
+  const tarball = {
+    ok: prepared.ok === true,
+    version: prepared.version ?? latest,
+    integrity: prepared.integrity ?? null,
+    tarball: prepared.tarball ?? null,
+    registry: prepared.registry ?? null,
+    reason: prepared.reason ?? null,
+    ms: prepared.ms ?? 0,
+    cleanup: { removed: cleanup.removed === true, note: cleanup.note ?? null },
+  }
+  return finishSelfUpdate({ profileDir, packageName: CONSOLE_PACKAGE, latest, spec, installed, method, command, errors, lockVersion: lock, lockUpdated, lockNote, registryRange: isRegistryRange, selfUpdate, copy, tarball, lockPatch })
 }
 
 /**

package/lib/server/domain/subdir-install.js

@@ -32,6 +32,7 @@ import { PLUGIN_SRC_DIR, linkSpecFor, sameSourceSpec } from './dep-source.js'
 import { noteChannel } from './git-channel.js'
 import { addBundleToManifest, detectBundleOnly } from './install.js'
 import { finalizeInstallPersistence } from './install-finalize.js'
+import { INSTALL_LOCK_TIMEOUT, withInstallLock } from './install-lock.js'
 import { alreadyInstalledTarget, verifyInstalledEntry } from './install-verify.js'
 import { ensureLinkSelfSufficiency } from './link-self-sufficiency.js'
 import { setProfileDependency } from './manifest.js'
@@ -313,9 +314,15 @@ async function runSubdirInstallJobInner(job, ports, deps = {}) {
     job.subdirSource = { dir, from: acquired.dir, reused: acquired.reused === true, placed: placed.dir, version: recheck.version }
     // ⑥ 本地目录来源 = 既有安装通道：`pnpm add link:<目录>` 建起 node_modules 里的那条链接
     //    （link: 是本地目录的正常形态，见 source-spec.js 判据 C；依赖由下一步的自足性补齐）
+    //    ★ 2026-11-04：过**同一个包互斥闸**（domain/install-lock.js）—— 它动的也是 node_modules/<包名>
     try {
-      await channels.pnpmInstall(profileDir, spec, undefined)
+      await withInstallLock({ profileDir, packageName, job }, async () => await channels.pnpmInstall(profileDir, spec, undefined))
     } catch (error) {
+      // 排队等不到（INSTALL_LOCK_TIMEOUT）与 pnpm 真失败都是"没装上"，但文案必须分开（不把排队说成安装失败）
+      if (error?.code === INSTALL_LOCK_TIMEOUT) {
+        job.installLock = { ...(job.installLock ?? {}), timeout: true, reason: error.message }
+        return failSubdirInstall(job, error.message)
+      }
       return failSubdirInstall(job, `从子目录 ${dir}/ 安装失败（本地目录来源 ${spec}）：${error instanceof Error ? error.message : String(error)}。`
         + `源码已取到本地（${placed.dir}），可重试；重试会复用已取到的源码。`)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.5.101",
+  "version": "0.5.103",
   "description": "DSH 框架升级安全与插件升级门控：一键升级、失败自动回滚、升级后回滚上版、旧插件不适配自动禁用；内置多源插件市场为发现层，插件源全部可自定义，可指向公司内网私有源 / 私有索引 / 本地 Git 仓库，纯内网离线可用 | Framework upgrade safety & plugin version gating for DSH, with a customizable multi-source plugin market: point every source at internal mirrors or a local file:// repo for intranet-only, offline installs.",
   "repository": {
     "type": "git",