dsh-crossterm 0.8.10 → 0.8.12

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # dsh-crossterm 变更记录
 
+## 0.8.12 — 2026-10-20
+
+### 修复：更新链路在 pnpm 11 上必定失败；latest 被镜像滞后带偏
+
+来源：跨设备邮件（YOCE_C 经「同端多会话2」转发，2026-10-20T06:20:28Z）—— 0.8.11 复测报告。
+
+- **`--prefer-online` 是 pnpm 11 的非法选项**：0.8.11 把它拼进了 dsh / cli / pnpm 三级兜底，
+  B 机实测 `[ERROR] Unknown option: 'prefer-online'`，exit 1 ⇒ 三条路一起挂。
+  现在只给 pnpm 那步加它认识的 `--config.prefer-offline=false`；dsh / cli 两条路不加附加项。
+- **24h 发布年龄策略**：新版本发布不到 24 小时会被 `minimumReleaseAge` 拒装
+  （`ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`）。失败输出命中该关键字时，用
+  `--config.minimumReleaseAge=0` 重试一次，并把「已临时放宽」记进 `logs/update.log`。
+- **`latestVersion()` 取最大版本**：原来「第一个能返回的 registry 就用」，而顺序是 npmmirror 优先，
+  镜像滞后时会把 0.8.11 读成 0.8.10（钉版本也会钉到旧号）。现在两源都问、取最大版本，
+  请求带 `cache-control: no-cache`。
+- 探针 `probe-0811.mjs` 扩到 **25 项全 PASS**（新增「pnpm 合法选项」「不再出现 --prefer-online 参数」
+  「minimumReleaseAge 重试」「两源取最大」四项，替换掉原来断言 --prefer-online 的两项）。
+
+## 0.8.11 — 2026-10-20
+
+### 更新不再把版本装低（YOCE_C 实测事故）
+
+来源：跨设备邮件（YOCE_C，2026-10-20T06:04:39Z）报告 —— 0.8.2 那台点「更新」被装成 **0.6.1**，还回 `ok:true updated:true`。
+
+- **根因**：`updatePlugin()` 用 `pnpm add dsh-crossterm@latest`，pnpm 命中了缓存里的旧 packument
+  （`reused 2, downloaded 0, added 1`），装成 0.6.1；成功判定又是「装完版本 != 装前版本」，
+  于是降级也算成功。同类事故 10-19 09:51Z 也发生过（0.7.2 → 0.3.38）。
+- **修法**：已知 `latest` 就钉版本号 `dsh-crossterm@<latest>`（拿不到才回退 `@latest`），
+  三级兜底（dsh → cli → pnpm）每步都加 `--prefer-online`；新增 `settle()`：
+  装完重读版本，`installed < before` 判为降级 → 按 `before` 精确回滚并记 `rollback`；
+  **成功条件是 `installed === latest`**，降级一律报错、日志写 `downgraded/rollback`。
+- 路由返回体加 `downgraded`、`rollback`；文案分「已恢复到 X，请重试」「恢复失败请手动重装 X」。
+
+### 同 id 邮件副本不再各自重投（F7 收尾）
+
+- 以前只有「已投递成功」才按信封 id 归档重复副本；第一份投递失败时，同 id 的其他副本会各自重试，
+  最后可能投两次（YOCE_C 用 dedupe-a/dedupe-b 实测到）。
+- 现在 `state.failedIds[信封id] = 首份文件名`：失败也记 id，同 id 的其他副本直接归档进 `done/`；
+  首份重投成功后清 `failedIds`。`state` 形状兼容旧文件（缺字段按空对象）。
+
 ## 0.8.10 — 2026-10-19
 
 - **云端设备的显示规则调整**（User said (m11109)：名称（权限）＋在线状态不变，版本只在有差异时显示）：

package/README.md

@@ -28,17 +28,22 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.8.10）**
-
-- **云端设备显示规则调整**：每台设备显示 `名称（权限） · 在线状态`，例如 `YOCE_C（成员） · 3 小时前`；
-  版本号**只在它与本机版本不一致时**才显示（如 ` · v0.8.2`），与本机一致的设备不再挂版本号。
-- 只改客户端渲染，接口与数据不变；升级后刷新卡片即生效。
-
-**上一版（0.8.9）**
-
-- **第一个组件从「总开关」改成「自更新开关」**：关掉它只失去卡片与自动更新，跨会话 / 跨终端 / 跨设备 / 跨账号 各自独立。
-- **自动更新默认关**：卡片「自动更新」一行 + 开关，默认每 6 小时检查一次并自动安装，装完提示重启、不自动重启。
-- **服务注入拆掉**：五行都只 `inject(['agents'])`，不再 provide/inject 连锁。
+**本版更新（0.8.12）**
+
+- **修「点更新必定失败」**：0.8.11 给三级兜底都加了 `--prefer-online`，而这是 pnpm 11 的**非法选项**
+  （`[ERROR] Unknown option`），三条路会一起挂。现在只给 pnpm 那步加它认识的
+  `--config.prefer-offline=false`。
+- **新版本发布不到 24h 也能装**：撞 `minimumReleaseAge` 策略（`ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`）时，
+  自动用 `--config.minimumReleaseAge=0` 重试一次，并在 `logs/update.log` 记一笔「临时放宽」。
+- **npm 最新版读得准了**：原来「第一个能返回的镜像就用」（npmmirror 优先），镜像滞后时会把 0.8.12 读成旧号，
+  钉版本也钉错。现在两个源都问、取最大版本。
+- 本机是 `link:` 源码版，点更新仍提示「改源码后重启」；以上对用 npm 安装的其他设备生效。
+
+**上一版（0.8.11）**
+
+- **更新不再把版本装低**：钉死 `dsh-crossterm@<npm 最新版>`（原来是 `@latest`，会命中 pnpm 缓存的旧 packument，
+  实测把 0.8.2 装成 0.6.1 还判成功）；装完必须**等于**最新版才算成功，装低了自动回滚并报错。
+- **同 id 邮件副本不再各自重投**：一份投递失败时，同 id 的其他副本直接归档。
 
 **更早（0.8.8 / 0.8.7 / 0.8.6 / 0.8.5 / 0.8.2 / 0.8.0）**
 

package/lib/bus.js

@@ -23,7 +23,7 @@ import path from 'node:path'
 import crypto from 'node:crypto'
 import { rotateIfNeeded } from './logs.js'
 
-export const VERSION = '0.8.10'
+export const VERSION = '0.8.12'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/lib/cloud/relay.js

@@ -13,9 +13,16 @@ const nowIso = () => new Date().toISOString()
 function loadState(file) {
   try {
     const j = JSON.parse(fs.readFileSync(file, 'utf8'))
-    return { at: j.at || 0, processed: j.processed || {}, seen: j.seen || {}, failed: j.failed || {}, sent: j.sent || [] }
+    return {
+      at: j.at || 0,
+      processed: j.processed || {},
+      seen: j.seen || {},
+      failed: j.failed || {},
+      failedIds: j.failedIds || {},
+      sent: j.sent || [],
+    }
   } catch {
-    return { at: 0, processed: {}, seen: {}, failed: {}, sent: [] }
+    return { at: 0, processed: {}, seen: {}, failed: {}, failedIds: {}, sent: [] }
   }
 }
 
@@ -159,6 +166,21 @@ export function createRelay({ pan, getLayout, localDir, stateFile, deliver, getS
       stats.pending = 0
       const incomingDir = path.join(localDir, 'incoming')
       fs.mkdirSync(incomingDir, { recursive: true })
+      // 0.8.11 F7 补完：同一个信封 id 出现多份文件时（哪怕第一份投递失败），
+      // 其余副本一律归档进 done/，不让它们各自重试、最后变成重复投递。
+      const archiveDuplicate = async (dupName, dupLocal, dupId, why) => {
+        try {
+          await pan.mkdir(layout.paths.doneDir)
+          await pan.put(dupLocal, `${layout.paths.doneDir}/${dupName}`)
+          await pan.rm(`${layout.paths.inboxDir}/${dupName}`)
+          state.seen[dupName] = dupId
+          delete state.failed[dupName]
+          saveState(stateFile, { ...state, at: Date.now() })
+          log(`中转站：${dupName} ${why}，已归档不重投`)
+        } catch (e) {
+          log(`中转站：${dupName} 重复信封归档失败：${(e && e.message) || String(e)}`)
+        }
+      }
 
       for (const f of files) {
         const name = f.server_filename
@@ -191,17 +213,15 @@ export function createRelay({ pan, getLayout, localDir, stateFile, deliver, getS
         const mailId = envelope.id || path.basename(name, '.json')
         if (state.processed[mailId]) {
           // 0.8.2 F7：同一个信封换了文件名又出现 —— 已经投过，把这个副本归档掉，不再投第二次
-          try {
-            await pan.mkdir(layout.paths.doneDir)
-            await pan.put(localJson, `${layout.paths.doneDir}/${name}`)
-            await pan.rm(`${layout.paths.inboxDir}/${name}`)
-            state.seen[name] = mailId
-            delete state.failed[name]
-            saveState(stateFile, { ...state, at: Date.now() })
-            log(`中转站：${name} 与已投递的 ${mailId} 同一个信封，已归档不重投`)
-          } catch (e) {
-            log(`中转站：${name} 重复信封归档失败：${(e && e.message) || String(e)}`)
-          }
+          await archiveDuplicate(name, localJson, mailId, `与已投递的 ${mailId} 同一个信封`)
+          continue
+        }
+        // 0.8.11 F7 补完：这份信封的「第一份」如果已经投递失败在退避里，
+        // 同 id 的其他副本也不该各自重试 —— 归档掉，等第一份成功或进 dead/。
+        const failedFirst = state.failedIds && state.failedIds[mailId]
+        if (failedFirst && failedFirst !== name) {
+          stats.pending += 1
+          await archiveDuplicate(name, localJson, mailId, `与待重投的 ${failedFirst} 同一个信封`)
           continue
         }
         // 0.8.0 F3：有账号密钥就要求签名对得上，否则拒收（防伪造发件人 / 提示注入）
@@ -214,6 +234,7 @@ export function createRelay({ pan, getLayout, localDir, stateFile, deliver, getS
             const prevSig = state.failed[name] || {}
             const sigTries = Number(prevSig.tries || 0) + 1
             state.failed[name] = { at: nowIso(), mailId, reason: '签名无效', tries: sigTries, nextAt: Date.now() + 3600000 }
+            state.failedIds[mailId] = name
             saveState(stateFile, { ...state, at: Date.now() })
             continue
           }
@@ -249,6 +270,7 @@ export function createRelay({ pan, getLayout, localDir, stateFile, deliver, getS
           state.processed[mailId] = { at: nowIso(), name, mailId, archived, sessionId: result.sessionId || '', to: String(envelope.to) }
           state.seen[name] = mailId
           delete state.failed[name]
+          delete state.failedIds[mailId]
           log(`中转站投递 ${mailId} → ${result.sessionId || String(envelope.to)}`)
         } else {
           stats.pending += 1
@@ -263,6 +285,7 @@ export function createRelay({ pan, getLayout, localDir, stateFile, deliver, getS
             tries,
             nextAt: Date.now() + delays[Math.min(tries - 1, delays.length - 1)],
           }
+          state.failedIds[mailId] = name
           log(`中转站留件 ${name}（第 ${tries} 次）：${(result && result.reason) || '投递失败'}`)
           if (tries >= 8) {
             try {

package/lib/web.js

@@ -205,6 +205,10 @@ function compareVersion(a, b) {
 }
 
 async function latestVersion() {
+  // 0.8.12：原来「第一个能返回的 registry 就用」+ 顺序是 npmmirror 优先 → 镜像滞后时
+  // 会把 0.8.11 读成 0.8.10，钉版本也钉到旧号（YOCE_C 2026-10-20 实测）。
+  // 现在两源都问，取最大的那个版本；单源失败不影响。
+  const found = []
   let last = ''
   for (const registry of NPM_REGISTRIES) {
     const ctrl = new AbortController()
@@ -212,14 +216,17 @@ async function latestVersion() {
     try {
       const res = await fetch(`${registry}/${PKG}/latest`, {
         signal: ctrl.signal,
-        headers: { accept: 'application/json' },
+        headers: { accept: 'application/json', 'cache-control': 'no-cache' },
       })
       if (!res.ok) {
         last = `HTTP ${res.status}`
         continue
       }
       const doc = await res.json()
-      if (doc && typeof doc.version === 'string') return doc.version
+      if (doc && typeof doc.version === 'string') {
+        found.push(doc.version)
+        continue
+      }
       last = 'no version field'
     } catch (error) {
       last = String((error && error.message) || error)
@@ -227,6 +234,7 @@ async function latestVersion() {
       clearTimeout(timer)
     }
   }
+  if (found.length > 0) return found.sort(compareVersion).pop()
   throw new Error(last || 'unknown')
 }
 
@@ -368,10 +376,15 @@ function appendUpdateLog(cfg, record) {
  * 每条都记进 steps（命令、退出码、耗时、输出尾部），最后核对 node_modules 里的真实版本。
  */
 async function updatePlugin(term, info, latest) {
-  const target = `${PKG}@latest`
+  // 0.8.11：不再用 @latest —— pnpm 可能拿缓存里的旧 packument，把机器「更新」成老版本
+  // （YOCE_C 实测 0.8.2 → 0.6.1，还判成功）。已知确切版本就钉版本号。
+  // 0.8.12：--prefer-online 是 pnpm 11 的非法选项（[ERROR] Unknown option），
+  // 三级兜底会一起挂；pnpm 只认 --config.prefer-offline=false，所以改成只给 pnpm 步加这条。
+  const pin = latest ? `${PKG}@${latest}` : ''
+  const target = pin || `${PKG}@latest`
   const before = installedVersion(info)
   const steps = []
-  const attempt = async (label, cmd, args, opts) => {
+  const record = async (label, cmd, args, opts) => {
     const started = Date.now()
     const res = await run(cmd, args, (opts && opts.cwd) || info.dir, opts)
     steps.push({
@@ -383,17 +396,33 @@ async function updatePlugin(term, info, latest) {
     })
     return res
   }
-  const finish = (via) => {
-    const installed = installedVersion(info)
-    const updated = Boolean(installed) && installed !== before
-    const upToDate = Boolean(installed) && Boolean(latest) && compareVersion(installed, latest) >= 0
-    const ok = updated || upToDate
-    appendUpdateLog(term.cfg, { profile: info.name, ok, updated, via, before, installed, latest: latest || '', steps })
-    return { ok, updated, via, before, installed, latest: latest || '', steps }
+  // 装完必须等于 latest 才算成功；装低了就按 before 精确回滚（同样钉版本号）
+  const settle = async (via, step) => {
+    let installed = installedVersion(info)
+    const downgraded = Boolean(before) && Boolean(installed) && compareVersion(installed, before) < 0
+    let rollback = null
+    if (downgraded && step) {
+      const args = step.args.map((a) => (a === target && pin ? `${PKG}@${before}` : a))
+      const res = await record(`rollback:${step.label}`, step.cmd, args, step.opts)
+      const restored = installedVersion(info)
+      rollback = { ok: res.code === 0 && restored === before, restored, code: res.code }
+      installed = restored
+    }
+    const exact = Boolean(installed) && Boolean(latest) && compareVersion(installed, latest) === 0
+    const ok = exact && !downgraded
+    const updated = ok && Boolean(before) && installed !== before
+    const out = { profile: info.name, ok, updated, via, before, installed, latest: latest || '', downgraded, rollback, steps }
+    appendUpdateLog(term.cfg, out)
+    return out
   }
 
   const { cmd: node, env } = nodeTool(term.cfg)
   const cli = cliScript()
+  // pnpm 11：--prefer-online 不是合法选项；prefer-offline 只能通过 --config. 前缀关掉。
+  // 新版本发布不到 24h 还会撞 minimumReleaseAge 策略，失败时用 policyArgs 重试一次并记日志。
+  const pnpmFlags = ['--config.prefer-offline=false']
+  const policyArgs = ['--config.minimumReleaseAge=0']
+  const policyRe = /minimum[-_]?release[-_]?age/i
   const plan = [{ label: 'dsh', cmd: 'dsh', args: ['plugin', '--profile', info.name, 'add', target], opts: {} }]
   if (fs.existsSync(cli)) {
     plan.push({
@@ -404,27 +433,28 @@ async function updatePlugin(term, info, latest) {
     })
   }
   for (const pnpm of pnpmCandidates(term.cfg)) {
-    plan.push({ label: 'pnpm', cmd: node, args: [pnpm, 'add', target], opts: { shell: false, env } })
+    plan.push({ label: 'pnpm', cmd: node, args: [pnpm, 'add', target, ...pnpmFlags], opts: { shell: false, env } })
   }
 
   let last = null
-  for (const step of plan) {
-    const res = await attempt(step.label, step.cmd, step.args, step.opts)
-    last = res
-    if (res.code === 0) {
-      const result = finish(step.label)
-      if (result.ok) return result
+  for (const base of plan) {
+    let step = base
+    let res = await record(step.label, step.cmd, step.args, step.opts)
+    if (res.code !== 0 && policyRe.test(res.out || '')) {
+      const args = [...step.args, ...policyArgs]
+      res = await record(`${step.label}+release-age`, step.cmd, args, step.opts)
+      step = { ...step, args }
     }
+    last = res
+    if (res.code !== 0) continue
+    const result = await settle(step.label, step)
+    if (result.ok) return result
   }
-  appendUpdateLog(term.cfg, { profile: info.name, ok: false, updated: false, before, latest: latest || '', steps })
+  const settled = await settle('none', null)
   return {
+    ...settled,
     ok: false,
     updated: false,
-    via: 'none',
-    before,
-    installed: installedVersion(info),
-    latest: latest || '',
-    steps,
     out: steps.map((s) => `[${s.label}] 退出码 ${s.code}\n${s.out}`).join('\n\n') || updateErrorText(last),
   }
 }
@@ -951,6 +981,11 @@ export function registerWeb(ctx, term, log) {
               let message
               if (result.ok && result.updated) message = `已更新到 ${installed}，重启 DSH 后生效`
               else if (result.ok) message = `已经是最新（${installed || latest}），不用更新`
+              else if (result.downgraded) {
+                message = result.rollback && result.rollback.ok
+                  ? `更新把版本装低了（原 ${result.before}，装成更旧版本），已恢复到 ${installed}；请重试`
+                  : `更新把版本装低了（原 ${result.before}，现在 ${installed}），恢复失败，请手动重装 ${result.before}`
+              } else if (installed && latest) message = `更新没成功（当前装着 ${installed}，npm 最新 ${latest}）：${result.out || '命令都返回失败'}`
               else if (installed) message = `更新没成功（当前装着 ${installed}）：${result.out || '命令都返回失败'}`
               else message = `更新失败：${result.out || '未知原因'}`
               json(res, 200, {
@@ -960,6 +995,8 @@ export function registerWeb(ctx, term, log) {
                 before: result.before || '',
                 installed,
                 latest,
+                downgraded: Boolean(result.downgraded),
+                rollback: result.rollback || null,
                 needRestart: Boolean(result.ok && result.updated),
                 steps,
                 message,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-crossterm",
-  "version": "0.8.10",
+  "version": "0.8.12",
   "description": "跨端互通：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份",
   "type": "module",
   "main": "./lib/index.js",