dsh-crossterm 0.6.2 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # dsh-crossterm 变更记录
 
+## 0.7.1 — 2026-10-19
+
+### 「更新」按钮在别的机器上装不上：三级兜底 + 全步骤回执
+
+- 现象（User said, paraphrased）：别的设备点卡片里的「更新」，看起来装不上。
+- 根因：旧实现只有两条路 —— PATH 里的 `dsh`，或 `%USERPROFILE%\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\{node,pnpm}`
+  这一固定目录。桌面版默认**不把 `dsh` 放进 PATH**，别的机器也不一定有这套运行时目录，
+  于是直接落到「找不到可用的 dsh 命令」，卡片只显示一行字，看不出卡在哪一步。
+- 桌面版的 `dsh` 真身（`F:\dsh\resources\runtime\cli\bin\dsh.cmd`）：
+  `set ELECTRON_RUN_AS_NODE=1` + `DeepSeek Harness.exe --expose-internals <resources>\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js %*`，
+  而 `dsh plugin ...` 内部就是在 profile 目录里跑 pnpm（`--profile` 必填）。所以不依赖 PATH 也能调起同一个 CLI。
+- 现行三级兜底（`lib/web.js` 的 `updatePlugin(term, info, latest)`，按顺序尝试，第一个成功即止，每步都记档）：
+  1. `dsh plugin --profile <p> add dsh-crossterm@latest`；
+  2. DSH 自带 CLI：`process.execPath --expose-internals <resources>\app.asar\...\cli.js plugin --profile <p> add ...`
+     （env 加 `ELECTRON_RUN_AS_NODE=1`）；
+  3. 直接 pnpm：`pnpmCandidates()` 依次找 `<DSH_HOME>\dsh-runtimes\...\dependencies\pnpm\bin\pnpm.cjs`
+     与 `<安装目录>\resources\runtime\pnpm\bin\pnpm.cjs`；node 用自带 `node.exe`，没有就拿宿主 Electron 当 node。
+- 每步记录 `{label, cmd, code, ms, out}`；装完读 `<profile>\node_modules\dsh-crossterm\package.json` **核对真实版本**，
+  回执区分「已更新到 X，重启 DSH 后生效」「已经是最新（X）」「更新没成功（当前装着 X）」。
+- 卡片：失败时把每步退出码、耗时、输出尾部（各 400 字）直接显示在卡片里，不用去翻宿主日志。
+- 更新日志：`<busDir>\logs\update.log` 追加 JSON 行（含 profile / before / installed / latest / steps），
+  别的会话排查时直接读这个文件。
+- 顺带补 0.7.0 漏的字段：`GET /crossterm/api/status` 的 `home.layout` 现在带 `rulesVersion` / `rulesFailed` / `accountSource`。
+- 探针 `F:\dsh\001X\crossterm-work\probe-update-plan.mjs` **14 项全 PASS**。
+- 要不要跟着动手：**不用**，重启 DSH 即生效（本机是 `link:` 源码版，重启加载即可）。
+
+## 0.7.0 — 2026-10-19
+
+### 入口行升格为「总开关」，排到组件列表第一位
+- 用户要求（paraphrased）：把入口那一行放到第一个，开关做成和插件开关一样的**总开关**，并标注清楚。
+- `cordis.patch.yml` 顺序变化：`crossterm-ui`（裸包名 `dsh-crossterm`，`config.part: ui`）从列表末尾
+  移到**第一位**，其后依次是 session / terminal / device / account。五行指向同一个包，顺序只影响展示。
+- **总开关是真开关**，不是只关卡片（`lib/index.js` 的 `apply()`）：
+  - `part === 'ui'` 时 `root.provide('crossterm', { master: true, part, since })`；
+  - 其余四个组件改为 `root.inject(['agents', 'crossterm'], ...)` —— **总开关关掉时服务不存在，
+    这四个回调根本不会执行**，工具、心跳、云同步、云端中转站、会话备份一起停；
+  - 总开关开着时，四个组件之间仍可各自单独开关；
+  - 总开关 3 秒内没出现时打一行 `console.warn`（`总开关（入口组件）未启用，组件「X」已跳过挂载`）方便排查；
+  - 用 cordis 服务注入而不是「读配置 / 看加载顺序」，所以谁先加载都不影响结果。
+- 标注清楚：`locale/zh.json` 的 `meta.title` 改为 **跨端互通（总开关）**，`meta.description` 写明
+  「关掉这一项，下面四个组件全部停用……开着它时四个组件可各自单独开关」；
+  新增 `meta.shortTitle = 跨端互通`，配置卡片标题用短名（`GET /crossterm/api/about` 多返回一个 `shortTitle`）。
+- 探针 `probe-about.mjs` 改为断言 `title === '跨端互通（总开关）'` 且 `shortTitle === '跨端互通'`。
+
 ## 0.6.2 — 2026-10-19
 
 ### 插件页：插件名/简介/组件表/更新日志

package/README.md

@@ -12,28 +12,30 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 
 ## 零、简介与本版更新（每次发版重写这一节）
 
-**插件名称**：`dsh-crossterm`（插件页显示 **跨端互通**）｜ **插件简介**：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份。
-
-**四个组件（插件页里就是这四个开关，名称与简介来自各自的 manifest）**
-
-| 组件名称 | 组件简介 | 工具 |
-|---|---|---|
-| 跨会话 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `term_link` `term_unlink` `term_broadcast` `term_inbox` `term_config` |
-| 跨终端 | 同一台机器上的多个 DSH 终端/进程之间互发邮件与文件 | `term_whoami` `term_list` `term_send` `term_send_files` |
-| 跨设备 | 经云端总线，在多台机器的 DSH 之间互发邮件与文件 | `term_cloud` |
-| 跨账号 | 预留位：后续用于跨账号互通，当前不挂工具 | — |
-
-> 插件页里还会多出一行 **跨端互通**（组件列表最后一行）：它是「入口行」，裸包名加载浏览器半端，
-> 承载插件标题与配置卡片，不挂任何工具。浏览器 client 半端只认裸包名行，所以这一行没法省。
-
-**本版更新（0.6.2）**
-
-- **插件页终于像个插件了**：插件改名 **跨端互通**（原来叫「跨会话」，看起来像只管会话），
-  并写上了插件级简介；四个业务组件名保持不变。
-- 配置卡片里新增：**插件简介**、**包含的组件（名称 + 简介两列表格）**、底部可折叠 **更新日志**
-  （直接读包内 `CHANGELOG.md`，展开就能看最近三版改了什么）。
-- 数据来自新接口 `GET /crossterm/api/about`（组件名与简介读 `parts/*.manifest.json`，与组件行同源）。
-- 上一版（0.6.1）的内容仍在：旧布局缓存不再挡住云端规则文档与 `inbox/_说明.md`。
+**插件名称**：`dsh-crossterm`（插件页显示 **跨端互通（总开关）**）｜ **插件简介**：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份。
+
+**组件列表（插件页第一个是总开关，后面四个是业务组件，名称与简介来自各自的 manifest）**
+
+| 顺序 | 组件名称 | 作用 | 工具 |
+|---|---|---|---|
+| ① | 跨端互通（总开关） | 插件总开关：关掉它，下面四个组件全部停用（工具、心跳、云同步、中转站、备份一起停）；开着时四个组件可各自单独开关。裸包名行，承载插件标题/简介与配置卡片，不挂工具 | — |
+| ② | 跨会话 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `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` 的
+> `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
+> 所以它单独做总开关，标题带「（总开关）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
+
+**本版更新（0.7.1）**
+
+- **修「别的机器点更新装不上」**：更新不再只依赖 PATH 里的 `dsh`，改成三级兜底 ——
+  ① PATH 里的 `dsh`；② DSH 自带 CLI（`Electron --expose-internals <安装目录>\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js`）；
+  ③ 直接调自带 pnpm（`<DSH_HOME>\dsh-runtimes\...\dependencies\pnpm` 或 `<安装目录>\resources\runtime\pnpm`）。
+- 装完会读 `<profile>\node_modules\dsh-crossterm\package.json` **核对真实版本**，分别提示「已更新到 X」「已经是最新」「更新没成功」。
+- 失败时卡片直接把每步的退出码、耗时、输出尾部显示出来；全过程写 `<总线目录>\logs\update.log`。
+- 顺带补上 `status.home.layout` 里缺的 `rulesVersion` / `rulesFailed` / `accountSource`。
 
 ## 一、安装与卸载
 

package/client/client.js

@@ -255,7 +255,15 @@ window.__ModuleLoader__.load({
 				setMsg("正在更新…");
 				try {
 					const data = await call("/crossterm/api/update", "POST");
-					setMsg((data && data.message) || (data && data.ok ? "已更新" : "未能更新"));
+					const text = (data && data.message) || (data && data.ok ? "已更新" : "未能更新");
+					const steps = (data && data.steps) || [];
+					// 失败时把每条尝试（dsh / DSH 自带 cli / pnpm）的退出码与输出带上，方便远端排查
+					const detail = data && data.ok
+						? ""
+						: steps.length
+							? "\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);
 				} catch (error) {
 					setMsg("更新失败：" + String((error && error.message) || error));
 				} finally {
@@ -373,7 +381,7 @@ window.__ModuleLoader__.load({
 					h(
 						"div",
 						null,
-						h("div", { style: S.title }, `${(about && about.title) || "跨端互通"} ${version}`),
+						h("div", { style: S.title }, `${(about && (about.shortTitle || about.title)) || "跨端互通"} ${version}`),
 						h("div", { style: S.sub }, subtitle),
 					),
 					// h("span", { style: S.chevron }, open ? "\u2303" : "\u2304"),

package/cordis.patch.yml

@@ -1,5 +1,5 @@
 # ============================================================================
-# dsh-crossterm —— DSH bundle patch（host-only 插件）
+# dsh-crossterm —— DSH bundle patch
 # ============================================================================
 # 安装（本地目录，对每个要互通的 profile 各装一次）：
 #   dsh plugin --profile desktop add link:F:\dsh\001X\dsh-crossterm
@@ -7,30 +7,41 @@
 # 卸载：
 #   dsh plugin --profile desktop remove dsh-crossterm
 #
-# 每个 insert 行在 DSH「插件 → dsh-crossterm → 包含的组件」里是一行组件，可单独开关。
-# 五行指向同一个包，只是走不同子路径：
+# 每个 insert 行在 DSH「插件 → 跨端互通 → 包含的组件」里是一行组件，可单独开关。
+# 五行指向同一个包，只是走不同子路径 / 不同 config.part：
 #
-#   dsh-crossterm                入口：插件页配置卡片（浏览器半端）+ 全插件简介/更新日志，
-#                                不挂任何工具（config.part: ui）
-#   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（云端总线同步）
-#   dsh-crossterm/parts/account  跨账号：预留占位，暂不挂工具
+#   ① dsh-crossterm                总开关（入口）：提供 crossterm 服务，插件页标题/简介/配置卡片，
+#                                  不挂任何工具（config.part: ui）。
+#                                  关掉它 → 服务消失 → 下面四个组件全部停用
+#                                  （工具、心跳、云同步、中转站、会话备份一起停）。
+#   ② 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（云端总线同步）
+#   ⑤ dsh-crossterm/parts/account  跨账号：预留占位，暂不挂工具
 #
 # 组件名来自 package.json 的 exports 映射：
 #   "./parts/session/package.json" -> "./parts/session.manifest.json"
 # 每个组件显示自己的中文名，实际加载的仍是 lib/index.js，靠 config.part 决定挂哪组工具。
 #
-# 为什么入口行放在最后：浏览器的 client 半端只对「裸包名」行生效（dsh-client-modules 的
-# locatePkgJson 对子路径行直接返回 undefined），而插件页顶部标题与裸包名行共用同一份
-# locale/zh.json 的 meta —— 插件叫「跨端互通」、四个业务组件叫跨会话/跨终端/跨设备/跨账号，
-# 只能让裸包名行单独做入口，且排在组件列表末尾，四个组件仍是列表里的前四行。
+# 为什么总开关必须用「裸包名」：浏览器的 client 半端只对裸包名行生效
+# （dsh-client-modules 的 locatePkgJson 对子路径行直接返回 undefined），而插件页顶部标题
+# 与裸包名行共用同一份 locale/zh.json 的 meta —— 所以裸包名行单独做总开关，
+# 标题写「跨端互通（总开关）」，四个业务组件排在它后面、名字仍是跨会话/跨终端/跨设备/跨账号。
+#
+# 总开关是「服务注入」实现的：ui 行 root.provide('crossterm')，其余四行 root.inject 它。
+# 谁先加载不影响结果（cordis 的 inject 会等服务出现），顺序只为让列表好看。
 #
 # 五个组件在同一 DSH 进程里共用一份总线实例：心跳只起一次，云同步只在 device 组件启用
 # 且 config.json 里 cloudEnabled=true 时才跑。安装/改动后需重启对应的 DSH 进程。
 # ============================================================================
 
 - insert:
+    - id: crossterm-ui
+      # 总开关（入口）：裸包名，提供 crossterm 服务 + 浏览器半端的配置卡片 + 插件页标题/简介。
+      # 关掉这一行等于整插件停用；它自己不挂工具。
+      name: dsh-crossterm
+      config:
+        part: ui
     - id: crossterm-session
       name: dsh-crossterm/parts/session
       config:
@@ -47,9 +58,3 @@
       name: dsh-crossterm/parts/account
       config:
         part: account
-    - id: crossterm-ui
-      # 裸包名：浏览器 client 半端只认这一行，插件页配置卡片挂在这里。
-      # 也是插件页顶部标题/简介的来源（locale/zh.json 的 meta）。
-      name: dsh-crossterm
-      config:
-        part: ui

package/lib/bus.js

@@ -22,7 +22,7 @@ import os from 'node:os'
 import path from 'node:path'
 import crypto from 'node:crypto'
 
-export const VERSION = '0.6.2'
+export const VERSION = '0.7.1'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/lib/cloud/home.js

@@ -119,7 +119,16 @@ export function createCloudHome({ cfg, device, pan, busDir, deliver, names, log
     return {
       home: `${cfg.cloudHome || DEFAULT_HOME}`,
       layout: layout
-        ? { account: layout.account, role: layout.role, deviceId: layout.deviceId, paths: layout.paths, ensuredAt: layout.ensuredAt }
+        ? {
+            account: layout.account,
+            role: layout.role,
+            deviceId: layout.deviceId,
+            paths: layout.paths,
+            ensuredAt: layout.ensuredAt,
+            rulesVersion: layout.rulesVersion || 0,
+            rulesFailed: layout.rulesFailed || 0,
+            accountSource: layout.accountSource || '',
+          }
         : null,
       relay: { ...relay.stats(), intervalMs: relayTimer },
       backup: { ...backupSummary(backupState), intervalMs: backupTimer },

package/lib/index.js

@@ -1859,7 +1859,24 @@ export default {
   name: PLUGIN,
   apply(root, config) {
     const part = normalizePart(config?.part)
-    root.inject(['agents'], (ctx) => {
+    // 「入口」这一行就是总开关：它提供 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) => {
       // 四个组件跑在同一个进程里，共用一份总线实例：各自只挂自己那组工具，
       // 心跳/云同步只在第一个组件加载时启动一次，最后一个组件卸载时才停。
       const term = acquireTerm(ctx)

package/lib/web.js

@@ -163,6 +163,7 @@ function run(cmd, args, cwd, opts) {
         cwd,
         shell,
         windowsHide: true,
+        env: opts && opts.env ? { ...process.env, ...opts.env } : process.env,
       })
     } catch (error) {
       resolve({ code: -1, out: String((error && error.message) || error) })
@@ -197,19 +198,46 @@ function updateErrorText(result) {
   return tail
 }
 
-// 有些机器没把 `dsh` 命令放进 PATH（桌面版就是），这时退回 DSH 自带运行时里的
-// node + pnpm 直接装：<DSH_HOME>\dsh-runtimes\dsh-primary-runtime\dependencies\{node,pnpm}
-function runtimeTools(cfg) {
+// DSH 安装根目录：process.resourcesPath = <root>\resources，上一级就是 <root>
+function dshRoot() {
+  if (process.resourcesPath) return path.dirname(process.resourcesPath)
+  return path.dirname(process.execPath || '')
+}
+
+// 桌面版把 `dsh` 命令实现成「让 Electron 以 node 模式跑 cli.js」：
+// <root>\DeepSeek Harness.exe --expose-internals <root>\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js
+// 所以不依赖 PATH 也能调起同一个 CLI（`dsh plugin add` 内部其实就是 pnpm add）。
+function cliScript() {
+  const res = process.resourcesPath || path.join(dshRoot(), 'resources')
+  return path.join(res, 'app.asar', 'dsh', 'node_modules', '@deepseek-ai', 'dsh-desktop-host', 'lib', 'cli.js')
+}
+
+function dshHome(cfg) {
   const busDir = (cfg && cfg.busDir) || ''
-  const home = busDir ? path.dirname(busDir) : path.join(os.homedir(), '.dsh')
-  const deps = path.join(home, 'dsh-runtimes', 'dsh-primary-runtime', 'dependencies')
-  return {
-    node: path.join(deps, 'node', 'bin', 'node.exe'),
-    pnpm: path.join(deps, 'pnpm', 'bin', 'pnpm.cjs'),
-    ok:
-      fs.existsSync(path.join(deps, 'node', 'bin', 'node.exe')) &&
-      fs.existsSync(path.join(deps, 'pnpm', 'bin', 'pnpm.cjs')),
-  }
+  return busDir ? path.dirname(busDir) : path.join(os.homedir(), '.dsh')
+}
+
+// pnpm 可能落在两处：DSH_HOME 的运行时依赖里，或安装目录的 resources\runtime\pnpm
+function pnpmCandidates(cfg) {
+  const deps = path.join(dshHome(cfg), 'dsh-runtimes', 'dsh-primary-runtime', 'dependencies')
+  const res = process.resourcesPath || path.join(dshRoot(), 'resources')
+  return [
+    path.join(deps, 'pnpm', 'bin', 'pnpm.cjs'),
+    path.join(res, 'runtime', 'pnpm', 'bin', 'pnpm.cjs'),
+  ].filter((p) => p && fs.existsSync(p))
+}
+
+// 没有独立 node.exe 时用宿主自己的 Electron 以 node 模式跑脚本
+function nodeTool(cfg) {
+  const deps = path.join(dshHome(cfg), 'dsh-runtimes', 'dsh-primary-runtime', 'dependencies')
+  const bundled = path.join(deps, 'node', 'bin', 'node.exe')
+  if (fs.existsSync(bundled)) return { cmd: bundled, env: {} }
+  return { cmd: process.execPath, env: { ELECTRON_RUN_AS_NODE: '1' } }
+}
+
+function runtimeTools(cfg) {
+  const pnpm = pnpmCandidates(cfg)[0] || ''
+  return { node: nodeTool(cfg).cmd, pnpm, ok: Boolean(pnpm) }
 }
 
 function looksMissingCommand(result) {
@@ -218,16 +246,91 @@ function looksMissingCommand(result) {
   )
 }
 
-async function updatePlugin(term, info) {
+/** 读 profile 里实际装着的版本（registry 模式下 node_modules/<pkg>/package.json） */
+function installedVersion(info) {
+  try {
+    const doc = JSON.parse(fs.readFileSync(path.join(info.dir, 'node_modules', PKG, 'package.json'), 'utf8'))
+    return typeof doc.version === 'string' ? doc.version : ''
+  } catch {
+    return ''
+  }
+}
+
+// 更新过程落一条日志，别的会话/排查时能直接看：<busDir>\logs\update.log
+function appendUpdateLog(cfg, record) {
+  try {
+    const dir = path.join((cfg && cfg.busDir) || path.join(os.homedir(), '.dsh', 'crossterm'), 'logs')
+    fs.mkdirSync(dir, { recursive: true })
+    fs.appendFileSync(path.join(dir, 'update.log'), `${JSON.stringify({ at: new Date().toISOString(), ...record })}\n`, 'utf8')
+  } catch {
+    /* 日志写不进去不影响更新本身 */
+  }
+}
+
+/**
+ * 更新已安装的 registry 版：按「PATH 里的 dsh → DSH 自带 CLI → 直接 pnpm」依次尝试，
+ * 每条都记进 steps（命令、退出码、耗时、输出尾部），最后核对 node_modules 里的真实版本。
+ */
+async function updatePlugin(term, info, latest) {
   const target = `${PKG}@latest`
-  const direct = await run('dsh', ['plugin', '--profile', info.name, 'add', target], info.dir)
-  if (direct.code === 0) return { ok: true, via: 'dsh', out: direct.out }
-  const miss = looksMissingCommand(direct) || direct.out.trim() === ''
-  if (!miss) return { ok: false, via: 'dsh', out: direct.out }
-  const tools = runtimeTools(term.cfg)
-  if (!tools.ok) return { ok: false, via: 'none', out: updateErrorText(direct) }
-  const fallback = await run(tools.node, [tools.pnpm, 'add', target], info.dir, { shell: false })
-  return { ok: fallback.code === 0, via: 'pnpm', out: fallback.out || updateErrorText(fallback) }
+  const before = installedVersion(info)
+  const steps = []
+  const attempt = async (label, cmd, args, opts) => {
+    const started = Date.now()
+    const res = await run(cmd, args, (opts && opts.cwd) || info.dir, opts)
+    steps.push({
+      label,
+      cmd: `${path.basename(cmd)} ${args.join(' ')}`.slice(0, 200),
+      code: res.code,
+      ms: Date.now() - started,
+      out: (res.out || '').trim().slice(-600),
+    })
+    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 }
+  }
+
+  const { cmd: node, env } = nodeTool(term.cfg)
+  const cli = cliScript()
+  const plan = [{ label: 'dsh', cmd: 'dsh', args: ['plugin', '--profile', info.name, 'add', target], opts: {} }]
+  if (fs.existsSync(cli)) {
+    plan.push({
+      label: 'cli',
+      cmd: process.execPath,
+      args: ['--expose-internals', cli, 'plugin', '--profile', info.name, 'add', target],
+      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 } })
+  }
+
+  let last = null
+  for (const step of plan) {
+    const res = await attempt(step.label, step.cmd, step.args, step.opts)
+    last = res
+    if (res.code === 0) {
+      const result = finish(step.label)
+      if (result.ok) return result
+    }
+  }
+  appendUpdateLog(term.cfg, { profile: info.name, ok: false, updated: false, before, latest: latest || '', steps })
+  return {
+    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),
+  }
 }
 
 function statusOf(term) {
@@ -316,6 +419,8 @@ function aboutOf() {
     name: PKG,
     version: VERSION,
     title: meta.title || PKG,
+    // 插件页顶部标题要带「（总开关）」才看得懂这一行是什么，但卡片头用短名更清爽
+    shortTitle: meta.shortTitle || meta.title || PKG,
     description: meta.description || '',
     components,
     changelog: readChangelog(),
@@ -564,17 +669,25 @@ export function registerWeb(ctx, term, log) {
                 })
                 return
               }
-              const result = await updatePlugin(term, info)
+              const latest = await latestVersion().catch(() => '')
+              const result = await updatePlugin(term, info, latest)
+              const installed = result.installed || ''
+              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 (installed) message = `更新没成功（当前装着 ${installed}）：${result.out || '命令都返回失败'}`
+              else message = `更新失败：${result.out || '未知原因'}`
               json(res, 200, {
                 ok: result.ok,
                 mode: 'registry',
                 via: result.via,
-                needRestart: result.ok,
-                message: result.ok
-                  ? `已更新${result.via === 'pnpm' ? '（用 DSH 自带 pnpm）' : ''}，重启 DSH 后生效`
-                  : result.via === 'none'
-                    ? result.out
-                    : (result.out || '').slice(-1200) || `更新失败（退出码不明）`,
+                before: result.before || '',
+                installed,
+                latest,
+                needRestart: Boolean(result.ok && result.updated),
+                steps,
+                message,
               })
             },
           }),

package/locale/en.json

@@ -1,6 +1,7 @@
 {
   "meta": {
-    "title": "CrossTerm",
-    "description": "Connect sessions, terminals and devices of one DSH account: chain codes, inline mail, a cloud relay and automatic backups. Four components, each with its own switch."
+    "title": "CrossTerm (master switch)",
+    "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."
   }
 }

package/locale/zh.json

@@ -1,6 +1,7 @@
 {
   "meta": {
-    "title": "跨端互通",
-    "description": "同一 DSH 账号下的会话、终端、设备之间互通：特征码链、内联邮件、云端中转站与自动备份。四个组件可单独开关。"
+    "title": "跨端互通（总开关）",
+    "shortTitle": "跨端互通",
+    "description": "总开关：关掉这一项，下面四个组件（跨会话 / 跨终端 / 跨设备 / 跨账号）全部停用 —— 工具、心跳、云同步、云端中转站与会话备份一起停。开着它时，四个组件可各自单独开关。插件简介：同一 DSH 账号下的会话、终端、设备之间互通。"
   }
 }

package/package.json

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