dsh-crossterm 0.8.13 → 0.8.15

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # dsh-crossterm 变更记录
 
+## 0.8.15 — 2026-10-20
+
+**为什么发这版**：YOCE_C 从 0.8.13 点更新到 0.8.14 后回归发现，没重启前 `/status` 仍只有 `version=0.8.13`、
+`/check` 也继续报有更新 —— 因为 `installed` / `needRestart` 是 0.8.14 的**服务端**代码才加的，
+当前进程还跑着 0.8.13，升级当次天然读不到。结论：待重启的提示不能只靠服务端新字段。
+
+- **client 自带版本号**：`client/client.js` 顶部新增 `const CLIENT_VERSION = "0.8.15"`，随包发布，等于磁盘上的版本。
+- **点完更新立刻提示**：`onUpdate` 从 `/update` 响应取 `installed` 与 `before`（0.8.13 起响应里本来就有 `needRestart`），
+  装成了就 `setRestartPending(true)`，不依赖服务端 `status.needRestart`。
+- **持续推导**：渲染处按「磁盘版本 > 进程版本」判断，`needRestart = status.needRestart || restartPending || onDiskNewer`，
+  旧进程也提示得出来；「待重启」行的版本号缺失时用 `CLIENT_VERSION` 兜底。
+- **`/check` 并列返回 `running`**（= 进程版本，与 `current` 同值），旧客户端也能照常解析。
+
+回归：`probe-0815.mjs` 19 项。
+
+## 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
 
 ### 优化：已经是最新就不再重装；没写收件人的信优先投给维护者

package/README.md

@@ -28,25 +28,25 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.8.13）**
+**本版更新（0.8.15）**
 
-- **已经是最新就不装**：点「更新」时若 npm 最新版 ≤ 当前版本，直接回「已经是最新（0.8.12），不用更新」，
-  不再跑一次 15 秒的安装、也不再重写 `node_modules`。
-- **没写收件人的信优先投给维护者**：跨设备信封没写收件人（或写的名字本机认不出）时，原来按「最近活跃会话」投，
-  可能落进 QQ 或无关会话 —— YOCE_C 的 0.8.12 验收报告就投到了 `im:qq_39`。现在先找 `MAINTAINERS.md` 里的
-  主维护会话，命中就用它，否则仍按最近活跃投。
-- 本机是 `link:` 源码版，点更新仍提示「改源码后重启」；以上对用 npm 安装的其他设备生效。
+- **升级当次就能提示「待重启」**：以前这一步要等服务端换成新版才认得出来（YOCE_C 回归的第 3/4 步就是这样「看不见」）。
+  现在浏览器 client 自己带版本号（`CLIENT_VERSION`），点完更新就从 `/update` 响应的 `installed` / `before` 判断，
+  立刻把卡片切成「已装待重启」；渲染时还会按「磁盘版本 > 进程版本」持续推导，旧进程也提示得出来。
+- `/check` 多返回一个 `running`（= 进程版本），与 `current` 并列，旧客户端也能照常解析。
+- 本机是 `link:` 源码版，没有这层差别；以上对用 npm 安装的设备生效。
 
-**上一版（0.8.12）**
+**上一版（0.8.14）**
 
-- **修「点更新必定失败」**：0.8.11 给三级兜底都加了 `--prefer-online`，而这是 pnpm 11 的非法选项；
-  现在只给 pnpm 那步加它认识的 `--config.prefer-offline=false`。
-- **新版本发布不到 24h 也能装**：撞 `minimumReleaseAge` 策略时自动用 `--config.minimumReleaseAge=0` 重试一次。
-- **npm 最新版读得准了**：两个源都问、取最大版本（原来谁先返回用谁，镜像滞后会把版本号读旧）。
+- **「更新」按钮不再看起来没用**：装完新版但还没重启时，卡片多一行「待重启」、
+  更新按钮变成不可点的「已装待重启」，接口 `/check` 改回 `needRestart=true` 而不是继续报「有更新」。
+- 根因是状态表达：宿主进程里还是旧版本号，而磁盘上已经装了新版 —— 现在这两个版本分开显示。
+- 本机是 `link:` 源码版（磁盘版本永远等于源码版本），所以这行只会在 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.13 / 0.8.12 / 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.13：已经是最新就不装；没写收件人的信优先投给 `MAINTAINERS.md` 里的维护者会话。
+- 0.8.12 / 0.8.11：修「点更新必定失败」（pnpm 不认 `--prefer-online`）、装低自动回滚、最新版取两个源的最大值。
 - 0.8.10 / 0.8.9 / 0.8.8 / 0.8.7：云端设备只列别人、带权限与状态、版本仅在差异时显示；插件页标题改「跨端互通（自更新）」；
   入口组件从「总开关」改为「自更新开关」，四个业务组件互不依赖。
 - 0.8.5：负责人留痕 `MAINTAINERS.md`、运行日志可轮转、卡片「维护者」行与「运行日志」按钮。

package/client/client.js

@@ -8,6 +8,21 @@ window.__ModuleLoader__.load({
 		const React = require("react");
 		const h = React.createElement;
 
+		// 0.8.15：这份 client 随包发布，它的版本号就是「磁盘上的版本」。
+		// 服务端进程可能还是旧版（装完没重启），拿它跟 /status.version 一比就知道该不该提示重启 ——
+		// 这样绕开了「旧进程读不到新字段」的死角（YOCE_C 的回归结论）。
+		const CLIENT_VERSION = "0.8.15";
+
+		const cmpVer = (a, b) => {
+			const pa = String(a || "").split(".").map((x) => Number(x) || 0);
+			const pb = String(b || "").split(".").map((x) => Number(x) || 0);
+			for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+				const d = (pa[i] || 0) - (pb[i] || 0);
+				if (d !== 0) return d < 0 ? -1 : 1;
+			}
+			return 0;
+		};
+
 		const S = {
 			card: {
 				border: "1px solid rgba(128,128,128,.28)",
@@ -246,6 +261,10 @@ window.__ModuleLoader__.load({
 			const [showLog, setShowLog] = React.useState(false);
 			const [runLog, setRunLog] = React.useState(null);
 			const [showRunLog, setShowRunLog] = React.useState(false);
+			// 0.8.15：本次页面会话里「刚装完、还没重启」的一次性标记。
+			// 旧版服务端不会返回 status.installed / needRestart，但 /update 的响应里一直带着
+			// installed 与 before（0.8.13 起还带 needRestart），所以升级当次就能立刻提示。
+			const [restartPending, setRestartPending] = React.useState(false);
 
 			const load = React.useCallback(() => {
 				call("/crossterm/api/status")
@@ -310,6 +329,8 @@ window.__ModuleLoader__.load({
 				try {
 					const data = await call("/crossterm/api/check", "POST");
 					if (!data || !data.ok) setMsg("检查失败：" + ((data && data.message) || "未知错误"));
+					else if (data.needRestart || (data.installed && cmpVer(data.installed, data.current) > 0))
+						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}`);
@@ -326,6 +347,14 @@ window.__ModuleLoader__.load({
 				try {
 					const data = await call("/crossterm/api/update", "POST");
 					const text = (data && data.message) || (data && data.ok ? "已更新" : "未能更新");
+					// 0.8.15：装完就记一笔「待重启」。旧版服务端的 /status 不返回 installed/needRestart，
+					// 但 /update 的响应里有 installed / before（0.8.13 起还有 needRestart），够判断了。
+					const after = data && (data.installed || "");
+					const beforeVer = data && (data.before || "");
+					const justInstalled = Boolean(
+						data && data.ok && (data.needRestart === true || (after && beforeVer && after !== beforeVer)),
+					);
+					if (justInstalled) setRestartPending(true);
 					const steps = (data && data.steps) || [];
 					// 失败时把每条尝试（dsh / DSH 自带 cli / pnpm）的退出码与输出带上，方便远端排查
 					const detail = data && data.ok
@@ -334,6 +363,7 @@ window.__ModuleLoader__.load({
 							? "\n\n" + steps.map((s) => `[${s.label}] 退出码 ${s.code} · ${Math.round((s.ms || 0) / 1000)}s` + (s.out ? `\n${String(s.out).slice(-400)}` : "")).join("\n\n")
 							: "";
 					setMsg(text + detail);
+					if (justInstalled) void load();
 				} catch (error) {
 					setMsg("更新失败：" + String((error && error.message) || error));
 				} finally {
@@ -446,6 +476,12 @@ window.__ModuleLoader__.load({
 
 			const version = status ? "v" + status.version : "";
 			const mode = status && status.install ? status.install.mode : "";
+			// 0.8.14/0.8.15：磁盘版本 > 进程版本 = 已装好但还没重启。
+			// 磁盘版本优先看服务端的 status.installed；旧版服务端没这个字段时用 client 自带的版本号兜底。
+			const diskVer = (status && status.installed) || (status ? CLIENT_VERSION : "");
+			const onDiskNewer = Boolean(status && status.version && diskVer && cmpVer(status.version, diskVer) < 0);
+			const installedVer = (status && status.installed) || (onDiskNewer ? CLIENT_VERSION : "");
+			const needRestart = Boolean((status && status.needRestart) || restartPending || onDiskNewer);
 			const cloud = (status && status.cloud) || {};
 			const autoUpdate = (status && status.autoUpdate) || {};
 			const home = (status && status.home) || null;
@@ -498,6 +534,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 +655,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.13'
+export const VERSION = '0.8.15'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/lib/web.js

@@ -502,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)
@@ -516,6 +520,8 @@ function statusOf(term) {
   return {
     ok: true,
     version: VERSION,
+    installed: onDisk,
+    needRestart: pendingRestart,
     node: cfg.name || '',
     nodeId: term.nodeId || '',
     hostname: os.hostname(),
@@ -847,9 +853,17 @@ 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
+                // current 是「进程正在跑的版本」，installed 是「磁盘上的版本」，两个都给，
+                // 别让客户端只能靠猜（0.8.15 起多给一个 running 别名，语义更直白）。
+                json(res, 200, { ok: true, current: VERSION, running: VERSION, installed, latest, updateAvailable, ahead, needRestart })
               } catch (error) {
                 json(res, 200, { ok: false, message: String((error && error.message) || error) })
               }
@@ -999,7 +1013,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.13",
+  "version": "0.8.15",
   "description": "跨端互通：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份",
   "type": "module",
   "main": "./lib/index.js",