dsh-crossterm 0.8.12 → 0.8.13

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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 被镜像滞后带偏

package/README.md

@@ -28,38 +28,28 @@ 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.13）**
 
-**上一版（0.8.11）**
+- **已经是最新就不装**：点「更新」时若 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/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.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

@@ -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()

package/package.json

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