dsh-crossterm 0.8.9 → 0.8.11

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # dsh-crossterm 变更记录
 
+## 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)：名称（权限）＋在线状态不变，版本只在有差异时显示）：
+  每台设备从 `名称 · 角色 · 状态 · v版本` 改为 `名称（角色） · 状态`，
+  例如 `YOCE_C（成员） · 3 小时前`；版本号只在该设备与**本机版本不一致**时才追加（` · v0.8.2`），
+  与本机一致的设备不再显示版本，避免每台都挂一串相同版本号。
+- 仅改 `client/client.js` 的 `devicesText()` 渲染逻辑，接口与数据不变。
+
 ## 0.8.9 — 2026-10-19
 
 ### 第一个组件从「总开关」改成「自更新开关」

package/README.md

@@ -28,27 +28,25 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.8.9）**
-
-- **第一个组件从「总开关」改成「自更新开关」**：它只管「有没有新版本、要不要自动装」，
-  不再管另外四个组件。以前关掉它会连坐停掉工具、心跳、云同步、中转站与备份；现在关掉它只失去卡片与自动更新，
-  跨会话 / 跨终端 / 跨设备 / 跨账号 各自独立开关、照常工作。
-- **自动更新默认关**：卡片新增「自动更新」一行与开关，打开后按 `autoUpdateIntervalMs`（默认 6 小时）检查
-  npm 最新版并自动安装，结果写进 `logs/update.log`。装完**不会自己重启**，卡片提示「重启 DSH 后生效」；
-  关掉后仍可手动点「检查更新 / 更新」。
-- **服务注入拆掉**：0.7.x–0.8.8 是 `ui` 行 `root.provide('crossterm')`、其余四行 `inject` 它；
-  0.8.9 起五行都只 `inject(['agents'])`，各挂各的。
-- 新增配置：`autoUpdate`（默认 `false`）、`autoUpdateIntervalMs`（默认 `21600000`，即 6 小时，范围 1 分钟–7 天）。
-
-**上一版（0.8.8）**
-
-- **「维护者」一栏只给维护端看**：以前任何设备装上插件都能看到负责人是谁；现在只在维护端显示 ——
-  本机 `nodeId` 必须出现在 `MAINTAINERS.md` 的负责人/助手条目里（两者在同一台机器上时都算），
-  或用配置 `maintainerDevices` 显式放行。其他设备上这行直接不渲染。
-- **换机器只改一个字段**：负责人换机器时，把 `MAINTAINERS.md` 里 `current.nodeId` 改成新机器，
-  旧机器下次刷新卡片自动隐藏，不用改代码。
-
-**更早（0.8.7 / 0.8.6 / 0.8.5 / 0.8.2 / 0.8.0）**
+**本版更新（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 项单测；

package/client/client.js

@@ -177,13 +177,17 @@ window.__ModuleLoader__.load({
 			if (!devices.ok) return devices.message || "读取失败";
 			const list = (devices.devices || []).filter((d) => d && (!devices.me || d.nodeId !== devices.me));
 			if (!list.length) return "云端还没有其他设备";
+			const local = String((status && status.version) || "");
 			return list
 				.map((d) => {
 					const label = d.name || d.nodeId || "未知设备";
 					const role = d.role || "成员";
 					const at = d.updatedAt || d.at || (d.lastSeen ? Date.parse(d.lastSeen) : 0);
 					const state = d.online ? "在线" : agoText(at);
-					return label + " · " + role + " · " + state + (d.version ? " · v" + d.version : "");
+					const ver = String(d.version || "");
+					// 版本只在「与本机不一致」时显示，避免每台都挂一串相同的 vX
+					const verText = ver && ver !== local ? " · v" + ver : "";
+					return label + "（" + role + "） · " + state + verText;
 				})
 				.join("；");
 		}

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.9'
+export const VERSION = '0.8.11'
 
 /** 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

@@ -368,10 +368,13 @@ 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，还判成功）。已知确切版本就钉版本号，并加 --prefer-online。
+  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,48 +386,55 @@ 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()
-  const plan = [{ label: 'dsh', cmd: 'dsh', args: ['plugin', '--profile', info.name, 'add', target], opts: {} }]
+  const flags = pin ? ['--prefer-online'] : []
+  const plan = [{ label: 'dsh', cmd: 'dsh', args: ['plugin', '--profile', info.name, 'add', target, ...flags], opts: {} }]
   if (fs.existsSync(cli)) {
     plan.push({
       label: 'cli',
       cmd: process.execPath,
-      args: ['--expose-internals', cli, 'plugin', '--profile', info.name, 'add', target],
+      args: ['--expose-internals', cli, 'plugin', '--profile', info.name, 'add', target, ...flags],
       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], opts: { shell: false, env } })
+    plan.push({ label: 'pnpm', cmd: node, args: [pnpm, 'add', target, ...flags], opts: { shell: false, env } })
   }
 
   let last = null
   for (const step of plan) {
-    const res = await attempt(step.label, step.cmd, step.args, step.opts)
+    const res = await record(step.label, step.cmd, step.args, step.opts)
     last = res
-    if (res.code === 0) {
-      const result = finish(step.label)
-      if (result.ok) return result
-    }
+    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 +961,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 +975,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.9",
+  "version": "0.8.11",
   "description": "跨端互通：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份",
   "type": "module",
   "main": "./lib/index.js",