dsh-crossterm 0.8.11 → 0.8.13

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # dsh-crossterm 变更记录
 
+## 0.8.13 — 2026-10-20
+
+### 优化：已经是最新就不再重装；没写收件人的信优先投给维护者
+
+来源：跨设备邮件（YOCE_C 的 0.8.12 验收报告，经 QQ 会话转交，2026-10-20T07:55:35Z）的两条观察。
+
+- **已是最新就短路**：`updatePlugin()` 在 `latest && before && compareVersion(latest, before) <= 0` 时直接返回
+  `{ok:true, updated:false, skipped:'latest'}`，不再跑安装 —— 实测等于最新时仍会花 15.7s 重写 node_modules。
+- **无收件人的信优先给维护者**：`relayDeliver()` 的兜底顺序改为「MAINTAINERS.md 主维护会话 → 最近活跃会话 → 第一个会话」，
+  回执文案区分「按维护者 MAINTAINERS.md」与「按最近活跃会话」。修 YOCE_C 的验收报告被投进 `im:qq_39` 的问题。
+- **不用跟着动手**：直接升级即可，配置与云端数据格式都没变。
+
+## 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 实测事故）

package/README.md

@@ -28,39 +28,28 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.8.11）**
-
-- **更新不再把版本装低**：点「更新」时钉死 `dsh-crossterm@<npm 最新版>` 并加 `--prefer-online`
-  （以前 `@latest` 会命中 pnpm 缓存里的旧 packument，实测把 0.8.2 装成 0.6.1 还判成功）；
-  装完必须**等于**最新版才算成功，装低了会自动回滚到原版本并报错。
-- **同 id 邮件副本不再各自重投**：一份邮件投递失败时，同 id 的其他副本直接归档，不会最后重复投递。
-- 本机是 `link:` 源码版，点更新仍会提示「改源码后重启」；以上对用 npm 安装的其他设备生效。
-
-**上一版（0.8.10）**
-
-- **云端设备显示规则调整**：每台设备显示 `名称（权限） · 在线状态`，例如 `YOCE_C（成员） · 3 小时前`；
-  版本号**只在它与本机版本不一致时**才显示（如 ` · v0.8.2`），与本机一致的设备不再挂版本号。
-- 只改客户端渲染，接口与数据不变；升级后刷新卡片即生效。
-
-- **第一个组件从「总开关」改成「自更新开关」**：关掉它只失去卡片与自动更新，跨会话 / 跨终端 / 跨设备 / 跨账号 各自独立。
-- **自动更新默认关**：卡片「自动更新」一行 + 开关，默认每 6 小时检查一次并自动安装，装完提示重启、不自动重启。
-- **服务注入拆掉**：五行都只 `inject(['agents'])`，不再 provide/inject 连锁。
-
-**更早（0.8.8 / 0.8.7 / 0.8.6 / 0.8.5 / 0.8.2 / 0.8.0）**
-
-- 0.8.7：修 0.8.6 的回归（卡片「云端设备」整块消失，接口报 `layout is not defined`）；
-  合并逻辑变成可测纯函数 `mergeDevices({ old, fresh, selfId, ownerDevice })`，配套 20 项单测；
-  离线时间按 `at → lastSeen → updatedAt` 先归一毫秒再排。
-- **云端设备只列「别人」**：卡片里那行不再显示本机（自己已经在「当前终端」一栏），
-  只列同一账号下的其他设备。
-- **每台带权限和状态**：逐台显示 `名称 · 管理员/成员 · 在线/离线（x 分钟前）· v版本号`；
-  管理员就是云端 `_account.json` 里 `ownerDevice` 那台，其余都是成员。
-- `term_list` 的云端行也带角色。
-
-- 0.8.5：负责人留痕 `MAINTAINERS.md`、运行日志可轮转（5 MB 压 `logs/archive/` 留 20 份）、
-  卡片「维护者」行与「运行日志」按钮、`GET /crossterm/api/logs`。
-- 0.8.2：死信按 20s/1m/5m/15m/1h 退避，8 次后进 `dead/`；收件人写设备名会回退「最近活跃会话」；
-  同一个信封不会投两次；`/crossterm/api/*` 要求本机回环 `Host`。
+**本版更新（0.8.13）**
+
+- **已经是最新就不装**：点「更新」时若 npm 最新版 ≤ 当前版本，直接回「已经是最新（0.8.12），不用更新」，
+  不再跑一次 15 秒的安装、也不再重写 `node_modules`。
+- **没写收件人的信优先投给维护者**：跨设备信封没写收件人（或写的名字本机认不出）时，原来按「最近活跃会话」投，
+  可能落进 QQ 或无关会话 —— YOCE_C 的 0.8.12 验收报告就投到了 `im:qq_39`。现在先找 `MAINTAINERS.md` 里的
+  主维护会话，命中就用它，否则仍按最近活跃投。
+- 本机是 `link:` 源码版，点更新仍提示「改源码后重启」；以上对用 npm 安装的其他设备生效。
+
+**上一版（0.8.12）**
+
+- **修「点更新必定失败」**：0.8.11 给三级兜底都加了 `--prefer-online`，而这是 pnpm 11 的非法选项；
+  现在只给 pnpm 那步加它认识的 `--config.prefer-offline=false`。
+- **新版本发布不到 24h 也能装**：撞 `minimumReleaseAge` 策略时自动用 `--config.minimumReleaseAge=0` 重试一次。
+- **npm 最新版读得准了**：两个源都问、取最大版本（原来谁先返回用谁，镜像滞后会把版本号读旧）。
+
+**更早（0.8.11 / 0.8.10 / 0.8.9 / 0.8.8 / 0.8.7 / 0.8.6 / 0.8.5 / 0.8.0）**
+
+- 0.8.11：钉死版本号、装低自动回滚；同 id 邮件副本不再各自重投。
+- 0.8.10 / 0.8.9 / 0.8.8 / 0.8.7：云端设备只列别人、带权限与状态、版本仅在差异时显示；插件页标题改「跨端互通（自更新）」；
+  入口组件从「总开关」改为「自更新开关」，四个业务组件互不依赖。
+- 0.8.5：负责人留痕 `MAINTAINERS.md`、运行日志可轮转、卡片「维护者」行与「运行日志」按钮。
 - 0.8.0 安全加固：附件名净化 + 越界校验、写接口要 `x-crossterm-token`、信封 HMAC 签名、入站限额、按 id 去重。
 
 ## 一、安装与卸载

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.11'
+export const VERSION = '0.8.13'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/lib/index.js

@@ -41,7 +41,7 @@ import { createCloudHome } from './cloud/home.js'
 import { runSetup } from './cloud/setup.js'
 import { deviceRow, matchDevice } from './cloud/match.js'
 import { registerWeb, selfUpdate } from './web.js'
-import { recordOwnership } from './logs.js'
+import { recordOwnership, readMaintainersDoc } from './logs.js'
 
 const PLUGIN = 'dsh-crossterm'
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
@@ -852,13 +852,22 @@ class CrossTerm {
     let fallbackNote = ''
     if (!targets.length) {
       const list = this.sessions()
-      const latest = list.find((s) => s && s.active) || list[0]
+      // 0.8.13：信封没写收件人（或写的名字本机认不出）时，优先投给 MAINTAINERS.md 里的主维护会话，
+      // 别让跨设备的维护信落进 QQ / 无关会话 —— YOCE_C 的 0.8.12 验收报告就这样投到了 im:qq_39。
+      const doc = readMaintainersDoc(ROOT)
+      const owner = doc && doc.current
+      const ownerIds = owner ? [owner.short, owner.session, owner.id].map((v) => String(v || '').trim()).filter(Boolean) : []
+      const owned = ownerIds.length
+        ? list.find((s) => s && ownerIds.some((id) => s.id === id || s.short === id || String(s.id || '').startsWith(id)))
+        : null
+      const latest = owned || list.find((s) => s && s.active) || list[0]
       if (!latest) return { ok: false, reason: `收件人「${rawTargets.join('、') || '空'}」在本机找不到会话，本机也没有可投递的会话` }
       targets = [latest.name || latest.short]
       const what = rawTargets.length ? `收件人「${rawTargets.join('、')}」不是本机会话名` : '信封没写收件人'
       const selfNames = [this.nodeId, this.name, os.hostname()].map((v) => String(v || '').trim().toLowerCase())
       const deviceHint = rawTargets.some((t) => selfNames.includes(String(t).trim().toLowerCase())) ? '（写的是本机设备名）' : ''
-      fallbackNote = `（${what}${deviceHint}，按「最近活跃会话」投给「${targets[0]}」）`
+      const how = owned ? '按维护者 MAINTAINERS.md' : '按「最近活跃会话」'
+      fallbackNote = `（${what}${deviceHint}，${how}投给「${targets[0]}」）`
     } else if (unknown.length) {
       fallbackNote = `（收件人「${unknown.join('、')}」没匹配到会话，已投给能匹配的 ${targets.length} 个）`
     }

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')
 }
 
@@ -369,10 +377,31 @@ function appendUpdateLog(cfg, record) {
  */
 async function updatePlugin(term, info, latest) {
   // 0.8.11：不再用 @latest —— pnpm 可能拿缓存里的旧 packument，把机器「更新」成老版本
-  // （YOCE_C 实测 0.8.2 → 0.6.1，还判成功）。已知确切版本就钉版本号，并加 --prefer-online。
+  // （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)
+  // 0.8.13：已经是最新就直接返回，不再白跑一次安装（YOCE_C 实测：等于最新时仍跑了 15.7s
+  // 重写 node_modules）。only-when-newer 也避免 @latest 把机器降级。
+  if (latest && before && compareVersion(latest, before) <= 0) {
+    const out = {
+      profile: info.name,
+      ok: true,
+      updated: false,
+      skipped: 'latest',
+      via: 'none',
+      before,
+      installed: before,
+      latest,
+      downgraded: false,
+      rollback: null,
+      steps: [],
+    }
+    appendUpdateLog(term.cfg, out)
+    return out
+  }
   const steps = []
   const record = async (label, cmd, args, opts) => {
     const started = Date.now()
@@ -408,23 +437,33 @@ async function updatePlugin(term, info, latest) {
 
   const { cmd: node, env } = nodeTool(term.cfg)
   const cli = cliScript()
-  const flags = pin ? ['--prefer-online'] : []
-  const plan = [{ label: 'dsh', cmd: 'dsh', args: ['plugin', '--profile', info.name, 'add', target, ...flags], opts: {} }]
+  // 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({
       label: 'cli',
       cmd: process.execPath,
-      args: ['--expose-internals', cli, 'plugin', '--profile', info.name, 'add', target, ...flags],
+      args: ['--expose-internals', cli, 'plugin', '--profile', info.name, 'add', target],
       opts: { shell: false, env: { ELECTRON_RUN_AS_NODE: '1' } },
     })
   }
   for (const pnpm of pnpmCandidates(term.cfg)) {
-    plan.push({ label: 'pnpm', cmd: node, args: [pnpm, 'add', target, ...flags], 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 record(step.label, step.cmd, step.args, step.opts)
+  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)

package/package.json

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