dsh-crossterm 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # dsh-crossterm 变更记录
 
+## 0.7.2 — 2026-10-19
+
+### 停用云端老文件夹：设备心跳搬进账号共享目录
+
+- 背景（User said, paraphrased）：查清云盘老目录 `/dsh云盘/crossterm/bus` 里没有必须迁移的数据后，停用老文件夹。
+- 老目录盘点：17 个目录 / 412 个文件 / 679,619 B，其中 200 个 `.md` 是历史邮件、200 个 `.tmp` 是原子写残留、
+  12 个 `json` 是状态镜像；本机 `F:\dsh\001X\crossterm-data\mail` 有 253 个（342,402 B）、`inbox` 306 个（537,410 B），
+  云端那份只是子集。唯一可能陌生的是发往本机的 2 封 `pending`，内容是 10-19 00:52 的跨终端验收测试信。
+- 新文件 `lib/cloud/presence.js`：`DEVICE_FILE='_device.json'`、`makePresence()`、`writePresence({pan,layout,info})`
+  （写到 `shared/<deviceId>/_device.json`）、`listPresences({pan,layout,onlineMs=3分钟})`（遍历共享目录、按 `at` 倒序、标 `online`）。
+- `lib/cloud/home.js`：新增 `deviceInfo` 参数（实时快照：版本/会话数/链/pid）、`presenceNow()`、`devices()`；
+  `status().presence = { at, error, intervalMs }`；`start()` 起 `presenceIntervalMs`（默认 60 s）定时器，启动 5 s 先报一次。
+- `lib/index.js`：`enableCloud()` 里只有 `cfg.busSyncEnabled === true` 才创建老 `createCloud` 镜像；云端目录（home）
+  一律启用。`term_cloud` 的 `once` 在镜像停用后明确回「总线镜像已停用」，status 兜底对象带 `design:'cloud-home'` 与 `home`。
+- `lib/bus.js` DEFAULTS：新增 `busSyncEnabled: false`（老镜像默认关闭，需要时在 config.json 里开回来）与 `presenceIntervalMs: 60000`。
+- `lib/web.js`：`/crossterm/api/devices` 合并两份来源 —— 老目录 `listCloudDevices(cloudRoot)`（给 `<0.7.2` 的设备）
+  + 新布局 `listPresences()`（`source: 'layout'`，同 nodeId 时新布局优先）；`status.cloud` 增 `design`，
+  非镜像模式下 `root` 显示账号目录、`intervalMs` 显示心跳间隔。
+- 探针 `probe-presence.mjs`：16 项全 PASS（心跳字段/落点/两台设备在线判定/排序/跳过无心跳目录/无布局返回 no-layout/
+  上传失败抛错/home 集成：`presenceNow`、`status.presence`、`devices`、`start` 后间隔）。
+- 兼容：还跑 `<0.7.2` 的设备仍然读老目录里的邮件与 presence，所以老目录**只停写、不删除**；
+  等所有设备升到 0.7.2 之后再整体删掉。
+- 要不要跟着动手：**要** —— 别的机器升级到 0.7.2 后云端设备列表才来自新布局；老目录可在全部升级后删除。
+
+## 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
 
 ### 入口行升格为「总开关」，排到组件列表第一位

package/README.md

@@ -28,12 +28,15 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做总开关，标题带「（总开关）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.7.0）**
-
-- **第一个组件变成总开关**：排到列表最前，标注「跨端互通（总开关）」，说明写明关掉它会停掉下面四个组件。
-- 它不再是「只关卡片的入口行」：现在用 cordis 服务注入实现 —— ui 行 `provide('crossterm')`，
-  其余四行 `inject` 它；**关掉总开关，那四个组件连回调都不会执行**，工具/心跳/云同步/中转站/备份一起停。
-- 四个业务组件仍可各自单独开关（总开关开着时）。
+**本版更新（0.7.2）**
+
+- **云端老文件夹停用**：不再把本机总线镜像到 `/dsh云盘/crossterm/bus`（老目录里 12 个 json 是状态镜像、
+  200 个 md 是本机邮件的子集、200 个 tmp 是原子写残留，没有必须迁移的数据）。
+- **设备心跳搬进账号共享目录**：`<云端根>/<账号>/shared/<设备>/_device.json`，每 60 s 写一次；
+  「云端设备」列表改为新布局优先，老目录只作 `<0.7.2` 设备的兼容来源。
+- 老镜像需要时可在 `config.json` 里把 `busSyncEnabled` 设 true 开回来；`term_cloud` 的 `once` 在镜像停用时给出说明。
+- 老目录**只停写、不删除**：还跑 `<0.7.2` 的设备仍从那里读邮件与 presence，等全部升级后再整体删掉。
+- 要不要跟着动手：**要** —— 别的机器升到 0.7.2 后，云端设备列表才会来自新布局。
 
 ## 一、安装与卸载
 

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 {

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.7.0'
+export const VERSION = '0.7.2'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {
@@ -61,6 +61,9 @@ const DEFAULTS = {
   inboxRoot: '',
   // 云总线（百度网盘）同步：默认关闭，开启后插件自己按 cloudIntervalMs 往返镜像。
   cloudEnabled: false,
+  // 0.7.2 起老的总线镜像（cloudRoot 那一套）默认不开，云端只用「账号/设备/共享收件箱」目录。
+  // 还跑 <0.7.2 的设备仍会把状态写进 cloudRoot，本机用只读方式兼容它。
+  busSyncEnabled: false,
   cloudRoot: '/dsh云盘/crossterm/bus',
   cloudIntervalMs: 4000,
   // 云端目录（0.3.39 起）：<cloudHome>/<账号>/<设备>/ + <账号>/shared/<设备>/inbox
@@ -68,6 +71,7 @@ const DEFAULTS = {
   cloudAccount: '',
   relayIntervalMs: 20000,
   backupIntervalMs: 300000,
+  presenceIntervalMs: 60000,
   backupSessionsPerRun: 20,
   backupAttachmentsPerRun: 20,
   attachmentBackupEnabled: true,

package/lib/cloud/home.js

@@ -4,19 +4,21 @@ import fs from 'node:fs'
 import path from 'node:path'
 import { ensureLayout, readLayoutCache, DEFAULT_HOME } from './layout.js'
 import { createRelay } from './relay.js'
+import { writePresence, listPresences } from './presence.js'
 import { backupSessions, backupAttachments, backupSummary } from './session-backup.js'
 
 /**
  * @param {object} opts
  * @param {object} opts.cfg 插件配置（readConfig 结果）
  * @param {object} opts.device { nodeId, name, version, platform, sessions }
+ * @param {Function} [opts.deviceInfo] 返回当前设备快照（版本/会话数/链），心跳用；不传就用 device
  * @param {object} opts.pan 云盘客户端
  * @param {string} opts.busDir 总线根（<DSH_HOME>/crossterm）
  * @param {Function} opts.deliver async ({ to, envelope, files }) => { ok, sessionId, reason }
  * @param {Function} [opts.names] 返回 { <会话短号>: { name } }，给 _session.json 补显示名
  * @param {Function} [opts.log]
  */
-export function createCloudHome({ cfg, device, pan, busDir, deliver, names, log = () => {} }) {
+export function createCloudHome({ cfg, device, deviceInfo, pan, busDir, deliver, names, log = () => {} }) {
   const home = path.dirname(busDir)
   const root = path.join(busDir, 'cloud')
   fs.mkdirSync(root, { recursive: true })
@@ -33,6 +35,9 @@ export function createCloudHome({ cfg, device, pan, busDir, deliver, names, log
   let backupBusy = null
   let relayTimer = 0
   let backupTimer = 0
+  let presenceTimer = 0
+  let presenceAt = 0
+  let presenceError = ''
 
   const relay = createRelay({
     pan,
@@ -114,15 +119,63 @@ export function createCloudHome({ cfg, device, pan, busDir, deliver, names, log
     return relay.sendEnvelope(opts)
   }
 
+  /** 把本机状态写进共享目录（0.7.2：取代云端老目录的 presence 镜像） */
+  async function presenceNow() {
+    try {
+      const layout = await getLayout(false)
+      if (!layout || !layout.paths) return { ok: false, reason: 'no-layout' }
+      const extra = typeof deviceInfo === 'function' ? deviceInfo() || {} : {}
+      const ret = await writePresence({
+        pan,
+        layout,
+        info: {
+          nodeId: device.nodeId,
+          name: extra.name || device.name,
+          hostname: extra.hostname || device.hostname || '',
+          version: extra.version || device.version,
+          platform: extra.platform || device.platform,
+          pid: extra.pid || device.pid || 0,
+          sessions: extra.sessions ?? device.sessions ?? 0,
+          chains: extra.chains || [],
+          startedAt: extra.startedAt || 0,
+        },
+        log: (line) => log(line),
+      })
+      presenceAt = Date.now()
+      presenceError = ret.ok ? '' : ret.reason || 'unknown'
+      return ret
+    } catch (e) {
+      presenceError = (e && e.message) || String(e)
+      return { ok: false, reason: presenceError }
+    }
+  }
+
+  /** 读云端所有设备心跳（新布局；不含老目录） */
+  async function devices() {
+    const layout = await getLayout(false)
+    if (!layout || !layout.paths) return { ok: false, devices: [] }
+    return listPresences({ pan, layout, log: (line) => log(line) })
+  }
+
   function status() {
     const layout = readLayoutCache(cacheFile)
     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 },
+      presence: { at: presenceAt, error: presenceError, intervalMs: presenceTimer },
       roots: { sessions: sessionsRoot, attachments: attachmentsRoot },
     }
   }
@@ -132,14 +185,17 @@ export function createCloudHome({ cfg, device, pan, busDir, deliver, names, log
     started = true
     relayTimer = Number(cfg.relayIntervalMs || 20000)
     backupTimer = Number(cfg.backupIntervalMs || 300000)
+    presenceTimer = Number(cfg.presenceIntervalMs || 60000)
     void getLayout(false).catch(() => {})
     timers.push(setInterval(() => { void relayNow().catch(() => {}) }, relayTimer))
     timers.push(setInterval(() => { void backupNow().catch(() => {}) }, backupTimer))
+    timers.push(setInterval(() => { void presenceNow().catch(() => {}) }, presenceTimer))
     for (const t of timers) if (t && typeof t.unref === 'function') t.unref()
     // 启动 8 秒后先跑一轮收信、30 秒后跑第一轮备份（别和宿主启动抢资源）
     setTimeout(() => { void relayNow().catch(() => {}) }, 8000)
     setTimeout(() => { void backupNow().catch(() => {}) }, 30000)
-    log(`云端目录就绪：relay ${relayTimer}ms / backup ${backupTimer}ms（根 ${cfg.cloudHome || DEFAULT_HOME}）`)
+    setTimeout(() => { void presenceNow().catch(() => {}) }, 5000)
+    log(`云端目录就绪：relay ${relayTimer}ms / backup ${backupTimer}ms / presence ${presenceTimer}ms（根 ${cfg.cloudHome || DEFAULT_HOME}）`)
   }
 
   function stop() {
@@ -148,5 +204,5 @@ export function createCloudHome({ cfg, device, pan, busDir, deliver, names, log
     timers = []
   }
 
-  return { start, stop, status, getLayout, backupNow, relayNow, send, cacheFile, relayDir }
+  return { start, stop, status, getLayout, backupNow, relayNow, send, presenceNow, devices, cacheFile, relayDir }
 }

package/lib/cloud/presence.js

@@ -0,0 +1,71 @@
+// 新布局下的设备心跳：<accountDir>/shared/<deviceId>/_device.json
+//
+// 为什么要它：0.7.2 起不再把本地总线镜像到云端老目录（/dsh云盘/crossterm/bus），
+// 但「云端设备」列表得继续有数据 —— 于是每台设备把自己的状态写进账号共享目录。
+// 老目录仍在读（给还跑旧版本的设备留兼容），只是不再写。
+
+export const DEVICE_FILE = '_device.json'
+
+/** 组装一份心跳内容（全字段可 JSON 序列化） */
+export function makePresence({
+  nodeId = '',
+  name = '',
+  hostname = '',
+  version = '',
+  platform = '',
+  pid = 0,
+  sessions = 0,
+  chains = [],
+  startedAt = 0,
+  at = Date.now(),
+} = {}) {
+  return {
+    nodeId,
+    name,
+    hostname,
+    version,
+    platform,
+    pid,
+    sessions,
+    chains: Array.isArray(chains) ? chains : [],
+    startedAt,
+    at,
+  }
+}
+
+/** 把心跳写进共享目录（覆盖自己那份） */
+export async function writePresence({ pan, layout, info, log = () => {} }) {
+  const paths = layout && layout.paths
+  if (!paths || !paths.deviceRoot) return { ok: false, reason: 'no-layout' }
+  const remote = `${paths.deviceRoot}/${DEVICE_FILE}`
+  const payload = makePresence(info)
+  const buf = Buffer.from(JSON.stringify(payload, null, 2) + '\n', 'utf8')
+  await pan.putBuffer(buf, remote)
+  log(`presence: 已上报 ${payload.name || payload.nodeId} v${payload.version} → ${remote}`)
+  return { ok: true, remote, payload }
+}
+
+/** 列出所有设备的共享目录，逐个取 _device.json */
+export async function listPresences({ pan, layout, onlineMs = 3 * 60 * 1000, now = Date.now(), log = () => {} }) {
+  const paths = layout && layout.paths
+  if (!paths || !paths.sharedDir) return { ok: false, devices: [], files: 0, reason: 'no-layout' }
+  const list = await pan.lsAll(paths.sharedDir)
+  const entries = (list && list.list) || []
+  const devices = []
+  let files = 0
+  for (const entry of entries) {
+    if (entry.isdir !== 1) continue
+    const remote = `${paths.sharedDir}/${entry.server_filename}/${DEVICE_FILE}`
+    try {
+      const got = await pan.getBuffer(remote)
+      const info = JSON.parse(got.buffer.toString('utf8'))
+      devices.push({ ...info, online: now - Number(info.at || 0) < onlineMs })
+      files += 1
+    } catch {
+      // 目录里还没心跳（或刚建好），跳过
+    }
+  }
+  devices.sort((a, b) => Number(b.at || 0) - Number(a.at || 0))
+  log(`presence: 共享目录里读到 ${devices.length} 台设备（文件 ${files}）`)
+  return { ok: true, devices, files, tmpFiles: 0 }
+}

package/lib/index.js

@@ -1205,27 +1205,30 @@ class CrossTerm {
     }
   }
 
-  /** 启动云总线同步（百度网盘）：只有配置里 cloudEnabled 才会跑 */
+  /** 启动云端：0.7.2 起默认只跑「云端目录」（账号/设备/共享收件箱/中转站/备份），
+   *  老的总线镜像（cloudRoot=/dsh云盘/crossterm/bus）需要 busSyncEnabled=true 才跑 */
   enableCloud() {
-    if (this.cloud) return this.cloud
     const pan = createPan({
       appFile: this.cfg.baiduAppFile,
       authFile: this.cfg.baiduAuthFile,
       log: (m) => void this.note('cloud: ' + m),
     })
-    this.cloud = createCloud({
-      busDir: this.bus.root,
-      mailDir: this.cfg.mailDir,
-      inboxDir: this.cfg.inboxRoot,
-      cloudRoot: this.cfg.cloudRoot,
-      stateFile: this.cfg.cloudStateFile,
-      intervalMs: this.cfg.cloudIntervalMs,
-      pan,
-      log: (m) => void this.note('cloud: ' + m),
-    })
-    this.cloud.start()
-    void this.note(`cloud sync 启动 → ${this.cfg.cloudRoot}（${this.cfg.cloudIntervalMs}ms）`)
+    if (this.cfg.busSyncEnabled && !this.cloud) {
+      this.cloud = createCloud({
+        busDir: this.bus.root,
+        mailDir: this.cfg.mailDir,
+        inboxDir: this.cfg.inboxRoot,
+        cloudRoot: this.cfg.cloudRoot,
+        stateFile: this.cfg.cloudStateFile,
+        intervalMs: this.cfg.cloudIntervalMs,
+        pan,
+        log: (m) => void this.note('cloud: ' + m),
+      })
+      this.cloud.start()
+      void this.note(`总线镜像启动 → ${this.cfg.cloudRoot}（${this.cfg.cloudIntervalMs}ms）`)
+    }
     this.enableCloudHome(pan)
+    this.pan = pan
     return this.cloud
   }
 
@@ -1246,6 +1249,17 @@ class CrossTerm {
         busDir: this.bus.root,
         deliver: (opts) => this.relayDeliver(opts),
         names: () => this.sessionNames(),
+        deviceInfo: () => ({
+          nodeId: this.nodeId,
+          name: this.cfg.name,
+          hostname: os.hostname(),
+          version: VERSION,
+          platform: process.platform,
+          pid: process.pid,
+          sessions: this.sessions().length,
+          chains: [...new Set([...this.links.values()].map((l) => l.code))],
+          startedAt: this.startedAt || 0,
+        }),
         log: (m) => void this.note('cloud: ' + m),
       })
       this.home.start()
@@ -1803,10 +1817,23 @@ function buildTools(term, agent, part = 'all') {
         }
         else if (action === 'once') {
           const c = term.cloud || term.enableCloud()
+          if (!c) return { ok: false, detail: '总线镜像已停用（0.7.2 起默认只跑云端目录：账号/设备/共享收件箱），改用 action="home" 或 "relay"/"backup"' }
           const result = await c.once()
           return { ok: true, status: c.status(), result }
         }
-        const status = term.cloud ? term.cloud.status() : { running: false, intervalMs: term.cfg.cloudIntervalMs, cloudRoot: term.cfg.cloudRoot, cycles: 0, up: 0, down: 0, merged: 0 }
+        const status = term.cloud
+          ? term.cloud.status()
+          : {
+              running: Boolean(term.home),
+              design: term.home ? 'cloud-home' : 'off',
+              intervalMs: term.cfg.cloudIntervalMs,
+              cloudRoot: term.home ? term.cfg.cloudHome || 'dsh' : '',
+              cycles: 0,
+              up: 0,
+              down: 0,
+              merged: 0,
+              home: term.home ? term.home.status() : null,
+            }
         return { ok: true, status }
       } catch (e) {
         return { ok: false, detail: (e && e.message) || String(e) }

package/lib/web.js

@@ -8,6 +8,7 @@ import { spawn } from 'node:child_process'
 import { VERSION, readConfig, writeConfig } from './bus.js'
 import { createPan } from './cloud/pan.js'
 import { listCloudDevices, localDevice } from './cloud/devices.js'
+import { listPresences } from './cloud/presence.js'
 import { runSetup } from './cloud/setup.js'
 
 const PKG = 'dsh-crossterm'
@@ -163,6 +164,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 +199,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 +247,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) {
@@ -241,7 +345,10 @@ function statusOf(term) {
     /* ignore */
   }
   const cloud = term.cloud
+  const home = term.home
+  const homeStatus = home ? home.status() : null
   const provider = cloudProvider(cfg)
+  const busMirror = cfg.busSyncEnabled === true
   return {
     ok: true,
     version: VERSION,
@@ -255,14 +362,19 @@ function statusOf(term) {
       // 没配云盘时不要把默认路径当成「已连接的云端」显示出来
       configured: provider.configured,
       enabled: cfg.cloudEnabled === true && provider.configured,
-      running: provider.configured && Boolean(cloud && cloud.running),
-      root: provider.configured ? cfg.cloudRoot || '' : '',
-      intervalMs: cfg.cloudIntervalMs || 0,
+      running: provider.configured && Boolean((cloud && cloud.running) || home),
+      root: provider.configured
+        ? busMirror
+          ? cfg.cloudRoot || ''
+          : (homeStatus && homeStatus.layout && homeStatus.layout.paths && homeStatus.layout.paths.accountDir) || cfg.cloudRoot || ''
+        : '',
+      intervalMs: busMirror ? cfg.cloudIntervalMs || 0 : (cfg.presenceIntervalMs || 60000),
+      design: busMirror ? 'bus+home' : 'home',
       provider,
     },
     chains,
-    // 云端目录（0.3.39）：账号/角色/设备目录/中转站/会话备份
-    home: term.home ? term.home.status() : null,
+    // 云端目录（0.3.39）：账号/角色/设备目录/中转站/会话备份/设备心跳
+    home: homeStatus,
   }
 }
 
@@ -379,6 +491,19 @@ export function registerWeb(ctx, term, log) {
                   log: (m) => log('devices: ' + m),
                 })
                 const result = await listCloudDevices(pan, cfg.cloudRoot)
+                let fresh = { devices: [], files: 0 }
+                try {
+                  const layout = term.home ? await term.home.getLayout(false) : null
+                  if (layout) fresh = await listPresences({ pan, layout, log: (m) => log('devices: ' + m) })
+                } catch (error) {
+                  log('devices: 新布局读取失败 ' + String((error && error.message) || error))
+                }
+                const byId = new Map()
+                for (const d of result.devices || []) byId.set(d.nodeId, d)
+                for (const d of fresh.devices || []) byId.set(d.nodeId, { ...byId.get(d.nodeId), ...d, source: 'layout' })
+                result.devices = [...byId.values()].sort((a, b) => Number(b.lastSeen ? Date.parse(b.lastSeen) : b.at || 0) - Number(a.lastSeen ? Date.parse(a.lastSeen) : a.at || 0))
+                delete result.tmpFiles
+                result.files = (result.files || 0) + (fresh.files || 0)
                 const me = await localDevice(path.join(cfg.busDir || '', 'presence'), info.nodeId || '')
                 if (me && !result.devices.some((d) => d.nodeId === me.nodeId)) result.devices.unshift(me)
                 json(res, 200, { ...result, configured: true, me: info.nodeId || '' })
@@ -566,17 +691,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/package.json

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