dsh-crossterm 0.8.8 → 0.8.10

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # dsh-crossterm 变更记录
 
+## 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
+
+### 第一个组件从「总开关」改成「自更新开关」
+
+来源：User said (m10846)：**"把第一个组件总开关改为自更新开关，"**；追问后用户选「自动更新开关，四个业务组件不再受它约束」+「默认关」。
+
+- **语义变更**：入口行（裸包名 `dsh-crossterm`，`config.part: ui`）不再 provide `crossterm` 服务，
+  也不再约束另外四个组件。以前关掉它 → 服务消失 → 跨会话/跨终端/跨设备/跨账号的 `inject` 回调根本不执行
+  （工具、心跳、云同步、中转站、会话备份一起停）；0.8.9 起五行一律 `root.inject(['agents'], …)`，各挂各的，
+  关掉入口行只失去「配置卡片 + 自动更新」。
+- **自动更新**：`lib/web.js` 新增导出 `selfUpdate(term)` —— `profileInfo()` 定位 profile、
+  `installMode() === 'link'` 直接跳过（源码版不自动覆盖）、`latestVersion()` 读不到返回失败、
+  `compareVersion(latest, VERSION) <= 0` 视为已最新，否则走既有 `updatePlugin()`（dsh → cli → pnpm 三级兜底）。
+  装完**不自动重启**，只回 `needRestart: true`，由卡片/日志提示「重启 DSH 后生效」。
+- **定时器**：`lib/index.js` 新增 `autoUpdateStatus()` / `enableAutoUpdate({ immediate })` / `disableAutoUpdate()` /
+  `autoUpdateOnce()`；`start()` 在 `cfg.autoUpdate` 为真时启动（首次 30 s 后查一次，之后按周期），`stop()` 清定时器。
+  结果记 `this.autoLast` 并写 `logs/update.log`。
+- **配置**：`bus.js` DEFAULTS 新增 `autoUpdate: false`、`autoUpdateIntervalMs: 21600000`（6 小时）；
+  `readConfig()` 把 `autoUpdate` 归一为布尔、`autoUpdateIntervalMs` 夹到 1 分钟–7 天。
+- **接口**：`status` 新增 `autoUpdate: {enabled, running, intervalMs, last}`；
+  新增 `POST /crossterm/api/auto-update/start|stop`（要 `x-crossterm-token`，写 `config.json` 并即时生效）。
+- **界面**：卡片新增「自动更新」一行 + 复用云同步样式的开关；开启时显示周期与上次结果
+  （已装 / 已是最新 / 失败原因），关闭时显示「已关闭（打开后自动检查并安装新版本）」。
+- **文案**：`locale/zh.json` 标题改「跨端互通（自更新）」、`en.json` 改 `CrossTerm (self-update)`；
+  `cordis.patch.yml` 顶部说明与 ui 行注释同步改写。
+
 ## 0.8.8 — 2026-10-19
 
 ### 「维护者」一栏只给维护端看

package/README.md

@@ -12,46 +12,43 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 
 ## 零、简介与本版更新（每次发版重写这一节）
 
-**插件名称**：`dsh-crossterm`（插件页显示 **跨端互通（总开关）**）｜ **插件简介**：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份。
+**插件名称**：`dsh-crossterm`（插件页显示 **跨端互通（自更新）**）｜ **插件简介**：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份。
 
-**组件列表（插件页第一个是总开关，后面四个是业务组件，名称与简介来自各自的 manifest）**
+**组件列表（插件页第一个是入口／自更新，后面四个是业务组件，名称与简介来自各自的 manifest）**
 
 | 顺序 | 组件名称 | 作用 | 工具 |
 |---|---|---|---|
-| ① | 跨端互通（总开关） | 插件总开关：关掉它，下面四个组件全部停用（工具、心跳、云同步、中转站、备份一起停）；开着时四个组件可各自单独开关。裸包名行，承载插件标题/简介与配置卡片，不挂工具 | — |
+| ① | 跨端互通（自更新） | 自更新开关：打开后定期检查 npm 新版本并自动安装（默认关；装完要重启 DSH 生效）。关掉它只失去卡片与自动更新，下面四个组件照常工作。裸包名行，承载插件标题/简介与配置卡片，不挂工具 | — |
 | ② | 跨会话 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `term_link` `term_unlink` `term_broadcast` `term_inbox` `term_config` |
 | ③ | 跨终端 | 同一台机器上的多个 DSH 终端/进程之间互发邮件与文件 | `term_whoami` `term_list` `term_send` `term_send_files` |
 | ④ | 跨设备 | 经云端总线，在多台机器的 DSH 之间互发邮件与文件 | `term_cloud` |
 | ⑤ | 跨账号 | 预留位：后续用于跨账号互通，当前不挂工具 | — |
 
-> 总开关为什么必须用裸包名：浏览器 client 半端只对裸包名行生效（`dsh-client-modules` 的
+> 入口行为什么必须用裸包名：浏览器 client 半端只对裸包名行生效（`dsh-client-modules` 的
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
-> 所以它单独做总开关，标题带「（总开关）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
+> 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.8.8）**
+**本版更新（0.8.10）**
 
-- **「维护者」一栏只给维护端看**：以前任何设备装上插件都能看到负责人是谁；现在只在维护端显示 ——
-  本机 `nodeId` 必须出现在 `MAINTAINERS.md` 的负责人/助手条目里（两者在同一台机器上时都算），
-  或用配置 `maintainerDevices` 显式放行。其他设备上这行直接不渲染。
-- **换机器只改一个字段**：负责人换机器时，把 `MAINTAINERS.md` 里 `current.nodeId` 改成新机器，
-  旧机器下次刷新卡片自动隐藏，不用改代码。
-- 纯展示改动，装上重启即可，不用改配置。
+- **云端设备显示规则调整**：每台设备显示 `名称（权限） · 在线状态`，例如 `YOCE_C（成员） · 3 小时前`；
+  版本号**只在它与本机版本不一致时**才显示（如 ` · v0.8.2`），与本机一致的设备不再挂版本号。
+- 只改客户端渲染，接口与数据不变；升级后刷新卡片即生效。
 
-**上一版（0.8.7）**
+**上一版（0.8.9）**
 
-- **修 0.8.6 的回归**：0.8.6 装上后卡片「云端设备」整块消失（接口报 `layout is not defined`）；
-  0.8.7 已修，没升 0.8.6 的设备可直接装 0.8.7。
-- **合并逻辑变成可测的纯函数**：`mergeDevices({ old, fresh, selfId, ownerDevice })`，配套 20 项单测。
-- **离线时间排序口径统一**：`at → lastSeen → updatedAt` 先归一毫秒再排。
+- **第一个组件从「总开关」改成「自更新开关」**：关掉它只失去卡片与自动更新，跨会话 / 跨终端 / 跨设备 / 跨账号 各自独立。
+- **自动更新默认关**：卡片「自动更新」一行 + 开关，默认每 6 小时检查一次并自动安装，装完提示重启、不自动重启。
+- **服务注入拆掉**：五行都只 `inject(['agents'])`，不再 provide/inject 连锁。
 
-**更早（0.8.6 / 0.8.5 / 0.8.2 / 0.8.0）**
+**更早（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` 那台，其余都是成员。
-- **离线时间不再显示「未知」**：以前只认 `updatedAt`，新布局心跳写的是 `at`，
-  离线设备一律「未知」；现在按 `updatedAt → at → lastSeen` 依次取。
 - `term_list` 的云端行也带角色。
 
 - 0.8.5：负责人留痕 `MAINTAINERS.md`、运行日志可轮转（5 MB 压 `logs/archive/` 留 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("；");
 		}
@@ -356,6 +360,21 @@ window.__ModuleLoader__.load({
 				}
 			};
 
+			const onToggleAutoUpdate = async () => {
+				const enabled = Boolean(status && status.autoUpdate && status.autoUpdate.enabled);
+				setBusy("auto");
+				setMsg(enabled ? "正在关闭自动更新…" : "正在开启自动更新…");
+				try {
+					const data = await call(enabled ? "/crossterm/api/auto-update/stop" : "/crossterm/api/auto-update/start", "POST");
+					setMsg((data && data.message) || (data && data.ok ? "已切换" : "未能切换"));
+					if (data && data.autoUpdate && status) setStatus({ ...status, autoUpdate: data.autoUpdate });
+				} catch (error) {
+					setMsg("切换失败：" + String((error && error.message) || error));
+				} finally {
+					setBusy("");
+				}
+			};
+
 			const onSetupCloud = async () => {
 				setBusy("setup");
 				setMsg("正在打开记事本…把 AppKey / AppSecret 填进引号里，保存并关闭记事本");
@@ -428,6 +447,7 @@ window.__ModuleLoader__.load({
 			const version = status ? "v" + status.version : "";
 			const mode = status && status.install ? status.install.mode : "";
 			const cloud = (status && status.cloud) || {};
+			const autoUpdate = (status && status.autoUpdate) || {};
 			const home = (status && status.home) || null;
 			const subtitle = status
 				? `${status.node || "本机"} · ${status.chains && status.chains.length ? status.chains.join(" / ") : "未入链"}`
@@ -557,6 +577,38 @@ window.__ModuleLoader__.load({
 						home && home.backup
 							? h(FriendlyRow, { label: "会话备份", value: backupText(home.backup) })
 							: null,
+						h(
+							"div",
+							{ style: S.grid },
+							h("div", { style: S.key }, "自动更新"),
+							h(
+								"div",
+								{ style: S.val },
+								h(
+									"span",
+									null,
+									autoUpdate.enabled
+										? `已开启 · 每 ${Math.max(1, Math.round((autoUpdate.intervalMs || 0) / 3600000))} 小时检查一次${autoUpdate.last
+											? `；上次：${autoUpdate.last.updated ? `已装 ${autoUpdate.last.installed || ""}` : autoUpdate.last.ok ? "已是最新" : `失败（${autoUpdate.last.message || "未知"}）`}`
+											: ""}`
+										: "已关闭（打开后自动检查并安装新版本）",
+								),
+								h(
+									"button",
+									{
+										style: autoUpdate.enabled ? S.switchOn : S.switchOff,
+										onClick: (event) => {
+											event.stopPropagation();
+											void onToggleAutoUpdate();
+										},
+										disabled: busy !== "",
+										title: autoUpdate.enabled ? "点击关闭自动更新" : "点击开启自动更新",
+										"aria-label": autoUpdate.enabled ? "自动更新开启中" : "自动更新已关闭",
+									},
+									h("span", { style: autoUpdate.enabled ? S.knobOn : S.knobOff }),
+								),
+							),
+						),
 						h(
 							"div",
 							{ style: S.actions },

package/cordis.patch.yml

@@ -10,10 +10,10 @@
 # 每个 insert 行在 DSH「插件 → 跨端互通 → 包含的组件」里是一行组件，可单独开关。
 # 五行指向同一个包，只是走不同子路径 / 不同 config.part：
 #
-#   ① dsh-crossterm                总开关（入口）：提供 crossterm 服务，插件页标题/简介/配置卡片，
-#                                  不挂任何工具（config.part: ui）。
-#                                  关掉它 → 服务消失 → 下面四个组件全部停用
-#                                  （工具、心跳、云同步、中转站、会话备份一起停）。
+#   ① dsh-crossterm                自更新（入口）：插件页标题/简介/配置卡片，不挂任何工具
+#                                  （config.part: ui）。0.8.9 起它不再是总开关 —— 关掉它只失去
+#                                  卡片与「自动更新」，下面四个组件照常跑。
+#                                  自动更新默认关，开关在卡片里，值落 config.json 的 autoUpdate。
 #   ② dsh-crossterm/parts/session  跨会话：term_link / term_unlink / term_broadcast / term_inbox / term_config
 #   ③ dsh-crossterm/parts/terminal 跨终端：term_whoami / term_list / term_send / term_send_files
 #   ④ dsh-crossterm/parts/device   跨设备：term_cloud（云端总线同步）
@@ -23,13 +23,14 @@
 #   "./parts/session/package.json" -> "./parts/session.manifest.json"
 # 每个组件显示自己的中文名，实际加载的仍是 lib/index.js，靠 config.part 决定挂哪组工具。
 #
-# 为什么总开关必须用「裸包名」：浏览器的 client 半端只对裸包名行生效
+# 为什么入口行必须用「裸包名」：浏览器的 client 半端只对裸包名行生效
 # （dsh-client-modules 的 locatePkgJson 对子路径行直接返回 undefined），而插件页顶部标题
-# 与裸包名行共用同一份 locale/zh.json 的 meta —— 所以裸包名行单独做总开关，
-# 标题写「跨端互通（总开关）」，四个业务组件排在它后面、名字仍是跨会话/跨终端/跨设备/跨账号。
+# 与裸包名行共用同一份 locale/zh.json 的 meta —— 所以裸包名行单独做入口（卡片 + 自动更新），
+# 标题写「跨端互通（自更新）」，四个业务组件排在它后面、名字仍是跨会话/跨终端/跨设备/跨账号。
 #
-# 总开关是「服务注入」实现的：ui 行 root.provide('crossterm')，其余四行 root.inject 它。
-# 谁先加载不影响结果（cordis 的 inject 会等服务出现），顺序只为让列表好看。
+# 0.8.9 起五个组件互不依赖：谁都不用 provide/inject 别人，各挂各的工具与开销。
+# 关掉入口行只失去「配置卡片 + 自动更新」，四个业务组件照常工作、各自仍可单独关。
+# 之前（0.7.x–0.8.8）是 ui 行 provide('crossterm')、其余四行 inject 它，关入口会连坐——已废弃。
 #
 # 五个组件在同一 DSH 进程里共用一份总线实例：心跳只起一次，云同步只在 device 组件启用
 # 且 config.json 里 cloudEnabled=true 时才跑。安装/改动后需重启对应的 DSH 进程。
@@ -37,8 +38,8 @@
 
 - insert:
     - id: crossterm-ui
-      # 总开关（入口）：裸包名，提供 crossterm 服务 + 浏览器半端的配置卡片 + 插件页标题/简介。
-      # 关掉这一行等于整插件停用；它自己不挂工具。
+      # 入口（自更新）：裸包名，浏览器半端的配置卡片 + 插件页标题/简介 + 「自动更新」开关。
+      # 关掉这一行只失去卡片与自动更新，四个业务组件不受影响；它自己不挂工具。
       name: dsh-crossterm
       config:
         part: ui

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.8'
+export const VERSION = '0.8.10'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {
@@ -82,6 +82,10 @@ const DEFAULTS = {
   // 卡片「维护者」一栏只在维护端显示：默认按 MAINTAINERS.md 里的 nodeId 判断，
   // 这里可以额外放行别的设备（例如用户授权过的本机另装环境）。
   maintainerDevices: [],
+  // 自动更新（0.8.9）：入口组件不再当总开关，只负责这件事 —— 打开后每 autoUpdateIntervalMs
+  // 检查一次 npm 上的新版本，有更新就装；装完要重启 DSH 才生效，绝不自动重启。
+  autoUpdate: false,
+  autoUpdateIntervalMs: 6 * 60 * 60 * 1000,
   baiduAppFile: '',
   baiduAuthFile: '',
   cloudStateFile: '',
@@ -142,6 +146,13 @@ export function readConfig() {
   cfg.maxFileBytes = clampNum(cfg.maxFileBytes, 1024, 2 * 1024 * 1024 * 1024, DEFAULTS.maxFileBytes)
   cfg.maxFiles = clampNum(cfg.maxFiles, 1, 50, DEFAULTS.maxFiles)
   cfg.deliverAttempts = clampNum(cfg.deliverAttempts, 1, 20, DEFAULTS.deliverAttempts)
+  cfg.autoUpdate = cfg.autoUpdate === true
+  cfg.autoUpdateIntervalMs = clampNum(
+    cfg.autoUpdateIntervalMs,
+    60000,
+    7 * 24 * 60 * 60 * 1000,
+    DEFAULTS.autoUpdateIntervalMs,
+  )
   return cfg
 }
 

package/lib/index.js

@@ -40,7 +40,7 @@ import { createCloud } from './cloud/sync.js'
 import { createCloudHome } from './cloud/home.js'
 import { runSetup } from './cloud/setup.js'
 import { deviceRow, matchDevice } from './cloud/match.js'
-import { registerWeb } from './web.js'
+import { registerWeb, selfUpdate } from './web.js'
 import { recordOwnership } from './logs.js'
 
 const PLUGIN = 'dsh-crossterm'
@@ -1396,6 +1396,59 @@ class CrossTerm {
     return true
   }
 
+  // ── 自动更新（0.8.9）──────────────────────────────────────────────────
+  // 入口组件不再是总开关，它只负责「有没有新版本」。开关落在 cfg.autoUpdate，
+  // 卡片上的开关走 /crossterm/api/auto-update/start|stop 写进 config.json。
+  autoUpdateStatus() {
+    const cfg = this.cfg || {}
+    return {
+      enabled: cfg.autoUpdate === true,
+      running: Boolean(this.autoTimer),
+      intervalMs: Number(cfg.autoUpdateIntervalMs) || 0,
+      last: this.autoLast || null,
+    }
+  }
+
+  enableAutoUpdate({ immediate = false } = {}) {
+    if (this.autoTimer) return false
+    const every = Math.max(60000, Number(this.cfg && this.cfg.autoUpdateIntervalMs) || 6 * 60 * 60 * 1000)
+    const tick = () => { void this.autoUpdateOnce() }
+    this.autoTimer = setInterval(tick, every)
+    if (typeof this.autoTimer.unref === 'function') this.autoTimer.unref()
+    // 首次不用等满一个周期：30 秒后先查一次，之后按周期走
+    const first = setTimeout(tick, immediate ? 5000 : 30000)
+    if (typeof first.unref === 'function') first.unref()
+    void this.note(`auto-update: 已开启，每 ${Math.max(1, Math.round(every / 3600000))} 小时检查一次`)
+    return true
+  }
+
+  disableAutoUpdate() {
+    if (!this.autoTimer) return false
+    clearInterval(this.autoTimer)
+    this.autoTimer = undefined
+    void this.note('auto-update: 已关闭')
+    return true
+  }
+
+  async autoUpdateOnce() {
+    let result
+    try {
+      result = await selfUpdate(this)
+    } catch (e) {
+      result = { ok: false, message: (e && e.message) || String(e) }
+    }
+    this.autoLast = { at: Date.now(), ...result }
+    try {
+      const line = result.updated
+        ? `已装 ${result.installed || ''}（重启后生效）`
+        : result.ok
+          ? `${result.skipped ? '跳过' : '已是最新'} ${result.latest || VERSION}`
+          : `失败 ${result.message || ''}`
+      await this.note(`auto-update: ${line}`)
+    } catch { /* ignore */ }
+    return result
+  }
+
   async start() {
     if (this.started) return
     this.started = true
@@ -1409,6 +1462,9 @@ class CrossTerm {
     if (this.cfg.cloudEnabled && wantsCloud) {
       try { this.enableCloud() } catch (e) { void this.warn('cloud sync 启动失败：' + ((e && e.message) || String(e))) }
     }
+    if (this.cfg.autoUpdate) {
+      try { this.enableAutoUpdate() } catch (e) { void this.warn('auto-update 启动失败：' + ((e && e.message) || String(e))) }
+    }
     await this.beat()
     await this.note(`started node=${this.nodeId} name=${this.cfg.name} bus=${this.bus.root}`)
     this.timer = setInterval(() => { void this.tick() }, this.cfg.pollMs)
@@ -1422,6 +1478,7 @@ class CrossTerm {
     if (this.timer) clearInterval(this.timer)
     this.timer = undefined
     if (this.cloud) { this.cloud.stop(); this.cloud = null }
+    if (this.autoTimer) { clearInterval(this.autoTimer); this.autoTimer = undefined }
     if (this.home) { this.home.stop(); this.home = null }
     await this.bus.leave(this.nodeId).catch(() => {})
     await this.note('stopped')
@@ -2017,24 +2074,10 @@ export default {
   name: PLUGIN,
   apply(root, config) {
     const part = normalizePart(config?.part)
-    // 「入口」这一行就是总开关：它提供 crossterm 服务，其余四个组件都 inject 它。
-    // 关掉这一行 → 服务不存在 → 另外四个组件的 inject 回调根本不会执行，
-    // 工具、心跳、云同步、中转站、会话备份一起停（不是只关卡片）。
-    // 反过来，只要总开关开着，四个组件各自还能单独关。
-    const isMaster = part === 'ui'
-    if (isMaster) {
-      root.provide('crossterm', { master: true, part, since: Date.now() })
-    } else {
-      const timer = setTimeout(() => {
-        let alive = true
-        try {
-          alive = Boolean(root.get?.('crossterm'))
-        } catch { alive = true }
-        if (!alive) console.warn(`[dsh-crossterm] 总开关（入口组件）未启用，组件「${PART_LABEL[part]}」已跳过挂载`)
-      }, 3000)
-      if (timer && typeof timer.unref === 'function') timer.unref()
-    }
-    root.inject(isMaster ? ['agents'] : ['agents', 'crossterm'], (ctx) => {
+    // 0.8.9 起「入口」组件不再当总开关：它只负责插件卡片与「自动更新」，
+    // 四个业务组件（跨会话/跨终端/跨设备/跨账号）各挂各的 —— 关掉入口行不会连坐。
+    // 自动更新默认关（cfg.autoUpdate=false），开关在卡片里，改了落 config.json。
+    root.inject(['agents'], (ctx) => {
       // 四个组件跑在同一个进程里，共用一份总线实例：各自只挂自己那组工具，
       // 心跳/云同步只在第一个组件加载时启动一次，最后一个组件卸载时才停。
       const term = acquireTerm(ctx)

package/lib/web.js

@@ -429,6 +429,26 @@ async function updatePlugin(term, info, latest) {
   }
 }
 
+/**
+ * 自动更新（0.8.9）：给定时器用的一步式「检查 + 安装」。
+ * 只在 registry 安装模式下有意义；link: 源码版直接跳过（代码就在工作区里）。
+ * 装完不重启，由调用方提示「重启 DSH 后生效」。
+ */
+export async function selfUpdate(term) {
+  const info = profileInfo(term.cfg && term.cfg.busDir)
+  if (!info) return { ok: false, updated: false, current: VERSION, latest: '', message: '找不到安装本插件的 profile' }
+  if (installMode(info.spec) === 'link') {
+    return { ok: true, updated: false, skipped: 'link', current: VERSION, latest: '' }
+  }
+  const latest = await latestVersion().catch(() => '')
+  if (!latest) return { ok: false, updated: false, current: VERSION, latest: '', message: '读不到 npm 最新版本' }
+  if (compareVersion(latest, VERSION) <= 0) {
+    return { ok: true, updated: false, current: VERSION, latest }
+  }
+  const result = await updatePlugin(term, info, latest)
+  return { ...result, current: VERSION, latest, needRestart: Boolean(result.ok && result.updated) }
+}
+
 function statusOf(term) {
   const cfg = term.cfg || {}
   const info = profileInfo(cfg.busDir)
@@ -468,6 +488,11 @@ function statusOf(term) {
       provider,
     },
     chains,
+    // 自动更新（0.8.9）：入口组件不再是总开关，开关与状态都走这里
+    autoUpdate:
+      typeof term.autoUpdateStatus === 'function'
+        ? term.autoUpdateStatus()
+        : { enabled: cfg.autoUpdate === true, running: false, intervalMs: 0, last: null },
     // 云端目录（0.3.39）：账号/角色/设备目录/中转站/会话备份/设备心跳
     home: homeStatus,
   }
@@ -821,6 +846,48 @@ export function registerWeb(ctx, term, log) {
             },
           }),
         )
+        disposers.push(
+          webCtx.webServer.register({
+            kind: 'exact',
+            path: '/crossterm/api/auto-update/start',
+            handler: async (req, res) => {
+              if (!checkHttp(req, res, term.cfg)) return
+              try {
+                await writeConfig({ autoUpdate: true })
+                term.cfg = readConfig()
+                term.enableAutoUpdate()
+                json(res, 200, {
+                  ok: true,
+                  message: '自动更新已开启：发现新版本会自动安装，装完重启 DSH 生效',
+                  autoUpdate: statusOf(term).autoUpdate,
+                })
+              } catch (error) {
+                json(res, 200, { ok: false, message: `开启失败：${String((error && error.message) || error)}` })
+              }
+            },
+          }),
+        )
+        disposers.push(
+          webCtx.webServer.register({
+            kind: 'exact',
+            path: '/crossterm/api/auto-update/stop',
+            handler: async (req, res) => {
+              if (!checkHttp(req, res, term.cfg)) return
+              try {
+                await writeConfig({ autoUpdate: false })
+                term.cfg = readConfig()
+                term.disableAutoUpdate()
+                json(res, 200, {
+                  ok: true,
+                  message: '自动更新已关闭（仍可手动点「检查更新 / 更新」）',
+                  autoUpdate: statusOf(term).autoUpdate,
+                })
+              } catch (error) {
+                json(res, 200, { ok: false, message: `关闭失败：${String((error && error.message) || error)}` })
+              }
+            },
+          }),
+        )
         disposers.push(
           webCtx.webServer.register({
             kind: 'exact',

package/locale/en.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "title": "CrossTerm (master switch)",
+    "title": "CrossTerm (self-update)",
     "shortTitle": "CrossTerm",
-    "description": "Master switch: turning this off stops everything below — tools, heartbeat, cloud sync, cloud relay and session backups for all four components (cross-session / cross-terminal / cross-device / cross-account). While it is on, each component can still be switched off individually."
+    "description": "Self-update switch: when on, the plugin periodically checks npm for a newer version and installs it (off by default; restart DSH afterwards to take effect — it never restarts on its own). Turning it off does not affect the four components below — cross-session / cross-terminal / cross-device / cross-account each have their own switch. About: synchronize sessions, terminals and devices under one DSH account, with feature-code chains, inline mail, a cloud relay and automatic session backups."
   }
 }

package/locale/zh.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "title": "跨端互通（总开关）",
+    "title": "跨端互通（自更新）",
     "shortTitle": "跨端互通",
-    "description": "总开关：关掉这一项，下面四个组件（跨会话 / 跨终端 / 跨设备 / 跨账号）全部停用 —— 工具、心跳、云同步、云端中转站与会话备份一起停。开着它时，四个组件可各自单独开关。插件简介：同一 DSH 账号下的会话、终端、设备之间互通。"
+    "description": "自更新开关：打开后插件会定期检查 npm 上的新版本并自动安装（默认关；装完要重启 DSH 才生效，不会自己重启）。关掉它不影响下面四个组件 —— 跨会话 / 跨终端 / 跨设备 / 跨账号 各自独立开关。插件简介：同一 DSH 账号下的会话、终端、设备之间互通，支持特征码链、内联邮件、云端中转站与会话自动备份。"
   }
 }

package/package.json

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