dsh-crossterm 0.8.12 → 0.8.14

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # dsh-crossterm 变更记录
 
+## 0.8.14 — 2026-10-20
+
+### 修「更新按钮看起来没用」（YOCE_C 实测反馈）
+
+上一版起更新链路已经能装成功，但宿主进程里还是旧版本，卡片继续显示「有更新」，
+再点一次却回「已经是最新」—— 主观上就是点了没用。
+
+- `/crossterm/api/status` 新增 `installed`（磁盘上 node_modules 里的真实版本）与
+  `needRestart`（磁盘版本 > 进程版本）。
+- `/crossterm/api/check`：磁盘版本已达最新但进程未重启时返回
+  `updateAvailable=false, needRestart=true`，不再报「有更新」。
+- `/crossterm/api/update`：已装未重启时提示「已装 X，重启 DSH 后生效（当前进程还在跑 Y）」。
+- 卡片：多一行「待重启」，更新按钮变成不可点的「已装待重启」，检查更新也提示重启后生效。
+
+## 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 被镜像滞后带偏

package/README.md

@@ -28,38 +28,35 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（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.14）**
+
+- **「更新」按钮不再看起来没用**：装完新版但还没重启时，卡片多一行「待重启」、
+  更新按钮变成不可点的「已装待重启」，接口 `/check` 改回 `needRestart=true` 而不是继续报「有更新」。
+- 根因是状态表达：宿主进程里还是旧版本号，而磁盘上已经装了新版 —— 现在这两个版本分开显示。
+- 本机是 `link:` 源码版（磁盘版本永远等于源码版本），所以这行只会在 npm 安装的设备上出现。
 
-**上一版（0.8.11）**
+**上一版（0.8.13）**
+
+- **已经是最新就不装**：点「更新」时若 npm 最新版 ≤ 当前版本，直接回「已经是最新（0.8.12），不用更新」，
+  不再跑一次 15 秒的安装、也不再重写 `node_modules`。
+- **没写收件人的信优先投给维护者**：跨设备信封没写收件人（或写的名字本机认不出）时，原来按「最近活跃会话」投，
+  可能落进 QQ 或无关会话 —— YOCE_C 的 0.8.12 验收报告就投到了 `im:qq_39`。现在先找 `MAINTAINERS.md` 里的
+  主维护会话，命中就用它，否则仍按最近活跃投。
+- 本机是 `link:` 源码版，点更新仍提示「改源码后重启」；以上对用 npm 安装的其他设备生效。
 
-- **更新不再把版本装低**：钉死 `dsh-crossterm@<npm 最新版>`（原来是 `@latest`，会命中 pnpm 缓存的旧 packument，
-  实测把 0.8.2 装成 0.6.1 还判成功）；装完必须**等于**最新版才算成功，装低了自动回滚并报错。
-- **同 id 邮件副本不再各自重投**：一份投递失败时，同 id 的其他副本直接归档。
+**上一版（0.8.12）**
 
-**更早（0.8.8 / 0.8.7 / 0.8.6 / 0.8.5 / 0.8.2 / 0.8.0）**
+- **修「点更新必定失败」**：0.8.11 给三级兜底都加了 `--prefer-online`，而这是 pnpm 11 的非法选项；
+  现在只给 pnpm 那步加它认识的 `--config.prefer-offline=false`。
+- **新版本发布不到 24h 也能装**：撞 `minimumReleaseAge` 策略时自动用 `--config.minimumReleaseAge=0` 重试一次。
+- **npm 最新版读得准了**：两个源都问、取最大版本（原来谁先返回用谁，镜像滞后会把版本号读旧）。
 
-- 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.11 / 0.8.10 / 0.8.9 / 0.8.8 / 0.8.7 / 0.8.6 / 0.8.5 / 0.8.0）**
 
-- 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.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/client/client.js

@@ -310,6 +310,7 @@ window.__ModuleLoader__.load({
 				try {
 					const data = await call("/crossterm/api/check", "POST");
 					if (!data || !data.ok) setMsg("检查失败：" + ((data && data.message) || "未知错误"));
+					else if (data.needRestart) setMsg(`已装 ${data.installed}，重启 DSH 后生效（当前进程还在跑 ${data.current}）`);
 					else if (data.updateAvailable) setMsg(`发现新版本 ${data.latest}（当前 ${data.current}）`);
 					else if (data.ahead) setMsg(`本地 ${data.current} 领先已发布版 ${data.latest}`);
 					else setMsg(`已是最新版本 ${data.current}`);
@@ -446,7 +447,9 @@ window.__ModuleLoader__.load({
 
 			const version = status ? "v" + status.version : "";
 			const mode = status && status.install ? status.install.mode : "";
-			const cloud = (status && status.cloud) || {};
+			// 0.8.14：磁盘版本 > 进程版本 = 已装好但还没重启，卡片要明说，别再提示「有更新」。
+			const installedVer = (status && status.installed) || "";
+			const needRestart = Boolean(status && status.needRestart);			const cloud = (status && status.cloud) || {};
 			const autoUpdate = (status && status.autoUpdate) || {};
 			const home = (status && status.home) || null;
 			const subtitle = status
@@ -498,6 +501,12 @@ window.__ModuleLoader__.load({
 							)
 							: null,
 						h(FriendlyRow, { label: "当前版本", value: status ? `v${status.version}${mode === "link" ? "（源码 link:）" : ""}` : "" }),
+						needRestart
+							? h(FriendlyRow, {
+								label: "待重启",
+								value: `已装 v${installedVer}，重启 DSH 后生效（当前进程还在跑 v${status && status.version}）`,
+							})
+							: null,
 						h(FriendlyRow, {
 							label: "当前终端",
 							value: status ? `${status.node}（${status.nodeId}）· ${status.hostname}` : "",
@@ -613,7 +622,16 @@ window.__ModuleLoader__.load({
 							"div",
 							{ style: S.actions },
 							h("button", { style: S.btn, onClick: onCheck, disabled: busy !== "" }, busy === "check" ? "检查中…" : "检查更新"),
-							h("button", { style: S.btnPrimary, onClick: onUpdate, disabled: busy !== "" }, busy === "update" ? "更新中…" : "更新"),
+							h(
+								"button",
+								{
+									style: needRestart ? S.btn : S.btnPrimary,
+									onClick: needRestart ? undefined : onUpdate,
+									disabled: busy !== "" || needRestart,
+									title: needRestart ? `已装 v${installedVer}，重启 DSH 后生效` : "检查并安装最新版本",
+								},
+								busy === "update" ? "更新中…" : needRestart ? "已装待重启" : "更新",
+							),
 							h("button", { style: S.btn, onClick: () => void loadDevices(), disabled: Boolean(devices && devices.loading) }, devices && devices.loading ? "读取中…" : "刷新设备"),
 							h("button", { style: S.btn, onClick: onRelayCloud, disabled: busy !== "" }, busy === "relay" ? "收信中…" : "收信"),
 							h("button", { style: S.btn, onClick: onBackupNow, disabled: busy !== "" }, busy === "backup" ? "备份中…" : "备份会话"),

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

@@ -383,6 +383,25 @@ async function updatePlugin(term, info, latest) {
   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()
@@ -483,6 +502,10 @@ function statusOf(term) {
   const cfg = term.cfg || {}
   const info = profileInfo(cfg.busDir)
   const mode = installMode(info && info.spec)
+  // 0.8.14：磁盘上装着的版本可能比进程内存里的 VERSION 新（更新完还没重启），
+  // 这个状态必须能表达出来，否则卡片一直显示「有更新」、再点又说「已是最新」。
+  const onDisk = installedVersion(info) || ''
+  const pendingRestart = Boolean(onDisk && compareVersion(onDisk, VERSION) > 0)
   const chains = []
   try {
     for (const link of term.links.values()) if (!chains.includes(link.code)) chains.push(link.code)
@@ -497,6 +520,8 @@ function statusOf(term) {
   return {
     ok: true,
     version: VERSION,
+    installed: onDisk,
+    needRestart: pendingRestart,
     node: cfg.name || '',
     nodeId: term.nodeId || '',
     hostname: os.hostname(),
@@ -828,9 +853,15 @@ export function registerWeb(ctx, term, log) {
                 const latest = await latestVersion()
                 // 只有 npm 上的版本「更新」才算有更新：本地源码版常领先于已发布版，
                 // 用 !== 会把 0.3.32 说成「发现新版本 0.3.31」。
-                const updateAvailable = compareVersion(latest, VERSION) > 0
-                const ahead = compareVersion(VERSION, latest) > 0
-                json(res, 200, { ok: true, current: VERSION, latest, updateAvailable, ahead })
+                const info = profileInfo(term.cfg && term.cfg.busDir)
+                const installed = installedVersion(info) || ''
+                // 磁盘上已经装上新版、只是还没重启时：不再报「有更新」，改报「待重启」，
+                // 否则用户会以为「点了更新没用」。
+                const needRestart = Boolean(installed && compareVersion(installed, latest) >= 0 && compareVersion(installed, VERSION) > 0)
+                const base = installed && compareVersion(installed, VERSION) > 0 ? installed : VERSION
+                const updateAvailable = !needRestart && compareVersion(latest, base) > 0
+                const ahead = !needRestart && compareVersion(VERSION, latest) > 0
+                json(res, 200, { ok: true, current: VERSION, installed, latest, updateAvailable, ahead, needRestart })
               } catch (error) {
                 json(res, 200, { ok: false, message: String((error && error.message) || error) })
               }
@@ -980,7 +1011,14 @@ export function registerWeb(ctx, term, log) {
               const steps = (result.steps || []).map((s) => ({ label: s.label, code: s.code, ms: s.ms, out: s.out }))
               let message
               if (result.ok && result.updated) message = `已更新到 ${installed}，重启 DSH 后生效`
-              else if (result.ok) message = `已经是最新（${installed || latest}），不用更新`
+              else if (result.ok) {
+                // 已经装上了新版、只是进程还是旧的：这时候要说清「重启后生效」，
+                // 不能只说「已经是最新」，否则用户会觉得点了没反应。
+                const pending = Boolean(installed && compareVersion(installed, VERSION) > 0)
+                message = pending
+                  ? `已装 ${installed}，重启 DSH 后生效（当前进程还在跑 ${VERSION}）`
+                  : `已经是最新（${installed || latest}），不用更新`
+              }
               else if (result.downgraded) {
                 message = result.rollback && result.rollback.ok
                   ? `更新把版本装低了（原 ${result.before}，装成更旧版本），已恢复到 ${installed}；请重试`

package/package.json

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