dsh-crossterm 0.9.0 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,33 @@
+## 0.9.2 — 2026-10-20
+
+**组件拆成目录 + 每个组件有自己的版本号**（User said：组件文件分开存放、插件页每个组件显示版本、改到哪个组件就升哪个）。
+
+- 目录结构：每个组件一个目录 `components/<part>/`，内含 `manifest.json`（`name` / `description` / `version`）与自己的代码；
+  原 `parts/<part>.manifest.json` 与 `lib/restart/` 全部迁入，`parts/` 删除。
+  `components/restart/` 里是 `core.js` / `runtime.js` / `scripts/`（原 `dsh-restart` 的 8 个 helper）。
+- 组件版本号：`ui` / `session` / `terminal` / `device` / `account` 记 `0.9.2`，`restart` 记 `0.3.28`（沿用并入时那版代码）。
+  规则：只在该组件自己的文件改动时升它的版本号，跟着插件一起发版；插件总版本仍按发版技能三分位判定。
+- 插件页：`GET /crossterm/api/about` 的 `components[]` 增 `version`，卡片「包含的组件」显示「名称 vX.Y.Z」；
+  更新说明表格加「组件版本」列（`make-release-notes.mjs` 从 `components/<part>/manifest.json` 读）。
+- 接线：`cordis.patch.yml` 五行 `name` 改 `dsh-crossterm/components/<part>`，`package.json` 的 `exports` 同步
+  （`./components/<part>` → `./lib/index.js`、`./components/<part>/package.json` → `./components/<part>/manifest.json`）；
+  `files` 用 `components` 取代 `parts`。
+- 清理：删掉 profile `node_modules` 里指向 `F:\dsh\001X\dsh-restart` 的两个旧 junction（`dsh-restart`、`dsh-restart-module`）。
+- 升级后需重启 DSH；已装 0.9.1 的机器点卡片「更新」即可。
+
 # dsh-crossterm 变更记录
 
+## 0.9.1 — 2026-10-20
+
+**修 0.9.0 的致命笔误：`cordis.patch.yml` 注释少写两个 `#`，整份 overlay 解析失败**
+
+- 现象：升级到 0.9.0 的机器启动时 `YAMLException: end of the stream or a document separator is expected (41:1)`，
+  `dsh plugin list` 报 `Cannot validate installed package dsh-crossterm`，插件整包不加载（卡片、总线、工具全没了）。
+- 根因：加第 ⑥ 行说明时把两行注释写成了正文（缩进 4 空格、没有 `#`），YAML 走到 `- insert:` 就认为文档已结束。
+- 修法：这两行补回 `#`；`js-yaml` 解析校验 `insert` 共 6 行，id 依次为
+  `crossterm-ui / crossterm-session / crossterm-terminal / crossterm-device / crossterm-account / crossterm-restart`。
+- **教训（写进发版流程）**：改完 `cordis.patch.yml` 必须真实解析一次（`js-yaml` 读一遍、看 `insert` 行数与 id），
+  光靠肉眼看注释块不够 —— 这类错误会让插件启动即失效，而且探针只测文本、测不出解析失败。
 ## 0.9.0 — 2026-10-20
 
 **自动重启并进互通插件（插件页第 6 个组件）**

package/README.md

@@ -14,49 +14,42 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 
 **插件名称**：`dsh-crossterm`（插件页显示 **跨端互通（自更新）**）｜ **插件简介**：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份。
 
-**组件列表（插件页第一个是入口／自更新，后面四个是业务组件，名称与简介来自各自的 manifest）**
+**组件列表（插件页第一个是入口／自更新，后面五个是业务组件；名称、简介、版本号来自各自的 `components/<part>/manifest.json`）**
 
-| 顺序 | 组件名称 | 作用 | 工具 |
-|---|---|---|---|
-| ① | 跨端互通（自更新） | 自更新开关：打开后定期检查 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` |
-| ⑤ | 跨账号 | 预留位：后续用于跨账号互通，当前不挂工具 | — |
-| ⑥ | 自动重启 | 改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 `dsh-restart` 插件，0.9.0 起并入） | `dsh_restart` |
+| 顺序 | 组件名称 | 版本 | 作用 | 工具 |
+|---|---|---|---|---|
+| ① | 跨端互通（自更新） | v0.9.2 | 自更新开关：打开后定期检查 npm 新版本并自动安装（默认关；装完要重启 DSH 生效）。关掉它只失去卡片与自动更新，下面五个组件照常工作。裸包名行，承载插件标题/简介与配置卡片，不挂工具 | — |
+| ② | 跨会话 | v0.9.2 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `term_link` `term_unlink` `term_broadcast` `term_inbox` `term_config` |
+| ③ | 跨终端 | v0.9.2 | 同一台机器上的多个 DSH 终端/进程之间互发邮件与文件 | `term_whoami` `term_list` `term_send` `term_send_files` |
+| ④ | 跨设备 | v0.9.2 | 经云端中转站，在多台机器的 DSH 之间互发邮件与文件 | `term_cloud` |
+| ⑤ | 跨账号 | v0.9.2 | 预留位：后续用于跨账号互通，当前不挂工具 | — |
+| ⑥ | 自动重启 | v0.3.28 | 改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 `dsh-restart` 插件，0.9.0 起并入） | `dsh_restart` |
 
 > 入口行为什么必须用裸包名：浏览器 client 半端只对裸包名行生效（`dsh-client-modules` 的
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
+>
+> 组件版本号怎么升：**只在该组件自己的文件改动时升它**，跟着插件一起发版（例：只改自动重启 → `components/restart` 的 `0.3.28` → `0.3.29`，其余五个不动）。插件总版本仍按发版技能的三分位规则。
 
-**本版更新（0.9.0）**
+**本版更新（0.9.2）**
 
-- **升级当次就能提示「待重启」**：以前这一步要等服务端换成新版才认得出来（YOCE_C 回归的第 3/4 步就是这样「看不见」）。
-  现在浏览器 client 自己带版本号（`CLIENT_VERSION`），点完更新就从 `/update` 响应的 `installed` / `before` 判断，
-  立刻把卡片切成「已装待重启」；渲染时还会按「磁盘版本 > 进程版本」持续推导，旧进程也提示得出来。
-- `/check` 多返回一个 `running`（= 进程版本），与 `current` 并列，旧客户端也能照常解析。
-- **自动重启并进来当第 6 个组件**：原 `dsh-restart` 插件的 `dsh_restart` 工具与 8 个 helper 脚本并入 `lib/restart/`，
-  插件页多一行「自动重启」。它不参与总线，只在每个会话上挂 `dsh_restart`；脚本首次启动时同步到
-  `<总线目录>/restart-module/`（默认 `C:\Users\<你>\.dsh\crossterm\restart-module`）。
-- **不再单独发版**：自动重启模块由原 `dsh-restart` 会话（`a3e9f80e`，会话名「自动重启」）继续维护，
-  改动汇报给插件主维护会话，由主维护会话并入本插件一起发版。
-- 旧的 `dsh-restart-module` 插件还装着时会重复注册 `dsh_restart`，需在 profile 里摘掉它（本机另行处理）。
-- 本机是 `link:` 源码版，没有这层差别；以上对用 npm 安装的设备生效。
+- **组件分目录存放**：`components/<part>/` 各放各的 `manifest.json` 与代码，`parts/` 删除；原 `lib/restart/` 整体搬进 `components/restart/`。npm 包与安装 zip 里也只带 `components/`。
+- **每个组件有独立版本号**：插件页与更新说明都显示「名称 vX.Y.Z」，方便看清这次改的是哪个组件、由谁维护。
+- **组件维护分出去**：`MAINTAINERS.md` 的 `modules` 段记录每个组件的负责人；自动重启 = `a3e9f80e`（只管 `components/restart/**`），其余由主维护会话 `b6aa099b` 负责。
+- 兼容：`cordis.patch.yml` 的 `name` 改为 `dsh-crossterm/components/<part>`，`exports` 同步；升级后重启 DSH 生效。
 
-**上一版（0.8.15）**
+**上一版（0.9.1）**
 
-- **「更新」按钮不再看起来没用**：装完新版但还没重启时，卡片多一行「待重启」、
-  更新按钮变成不可点的「已装待重启」，接口 `/check` 改回 `needRestart=true` 而不是继续报「有更新」。
-- 根因是状态表达：宿主进程里还是旧版本号，而磁盘上已经装了新版 —— 现在这两个版本分开显示。
-- 本机是 `link:` 源码版（磁盘版本永远等于源码版本），所以这行只会在 npm 安装的设备上出现。
+- 修 0.9.0 的启动即失效：`cordis.patch.yml` 第 ⑥ 行两行说明漏了 `#`，整份 overlay 解析失败、插件整包不加载（卡片/总线/工具全没有）。0.9.1 补回注释符。
+- 发版流程加硬规矩：**改完 `cordis.patch.yml` 必须用 `js-yaml` 真解析一次，核对 `insert` 行数与 id**。
 
-**更早（0.8.14 / 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.9.0 / 0.8.14 / 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.9.0：自动重启并进来当第 6 个组件（`dsh_restart` + 8 个 helper 脚本），由原 `dsh-restart` 会话继续维护、不再单独发版。
 - 0.8.14：装完未重启时卡片显示「待重启」、更新按钮变灰「已装待重启」，`/check` 回 `needRestart=true`。
 - 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.10 / 0.8.9 / 0.8.8 / 0.8.7：云端设备只列别人、带权限与状态、版本仅在差异时显示；插件页标题改「跨端互通（自更新）」；入口组件从「总开关」改为「自更新开关」。
 - 0.8.5：负责人留痕 `MAINTAINERS.md`、运行日志可轮转、卡片「维护者」行与「运行日志」按钮。
 - 0.8.0 安全加固：附件名净化 + 越界校验、写接口要 `x-crossterm-token`、信封 HMAC 签名、入站限额、按 id 去重。
 

package/client/client.js

@@ -83,6 +83,7 @@ window.__ModuleLoader__.load({
 			comp: { display: "grid", gridTemplateColumns: "max-content 1fr", gap: "4px 12px" },
 			compName: { fontWeight: 600 },
 			compDesc: { opacity: 0.75, lineHeight: 1.5 },
+			compVer: { opacity: 0.55, fontSize: "11px", marginLeft: "2px" },
 			log: {
 				whiteSpace: "pre-wrap",
 				fontSize: 11.5,
@@ -526,7 +527,12 @@ window.__ModuleLoader__.load({
 										h(
 											React.Fragment,
 											{ key: c.part },
-											h("div", { style: S.compName }, c.name),
+											h(
+												"div",
+												{ style: S.compName },
+												c.name,
+												c.version ? h("span", { style: S.compVer }, " v" + c.version) : null,
+											),
 											h("div", { style: S.compDesc }, c.description || "—"),
 										),
 									),

package/components/account/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "跨账号",
+  "description": "预留位：后续用于跨账号互通，当前不挂工具",
+  "version": "0.9.2"
+}

package/components/device/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "跨设备",
+  "description": "经云端总线，在多台机器的 DSH 之间互发邮件与文件",
+  "version": "0.9.2"
+}

package/{lib → components}/restart/core.js

@@ -27,7 +27,7 @@ import { fileURLToPath } from 'node:url'
 const PKG_ROOT = path.dirname(path.dirname(path.dirname(fileURLToPath(import.meta.url))))
 // 源码里脚本在 lib/restart/scripts/；运行时由 lib/index.js 复制到可写目录，
 // 再用 DSH_RESTART_MODULE_DIR 指过来（request.json 与 logs 都写在那个目录）。
-export const SRC_DIR = path.join(PKG_ROOT, 'lib', 'restart', 'scripts')
+export const SRC_DIR = path.join(PKG_ROOT, 'components', 'restart', 'scripts')
 const MODULE_DIR = process.env.DSH_RESTART_MODULE_DIR || SRC_DIR
 const TRIGGER = path.join(MODULE_DIR, 'trigger-restart.mjs')
 const LOG_DIR = path.join(MODULE_DIR, 'logs')

package/{parts/restart.manifest.json → components/restart/manifest.json}

@@ -1,4 +1,5 @@
 {
   "name": "自动重启",
-  "description": "改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 dsh-restart 插件，0.9.0 起并入）"
+  "description": "改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 dsh-restart 插件，0.9.0 起并入）",
+  "version": "0.3.28"
 }

package/{lib → components}/restart/scripts/countdown.html

@@ -313,7 +313,8 @@ function fitWindow() {
     try { if (fso.FileExists(REQ)) fso.DeleteFile(REQ, true); } catch (e) {}
     dbg("checkpoint " + tag + " busy -> cancel + background: " + JSON.stringify(busy));
     var wd = '"' + (req.nodeExe || "node") + '" "' + BASE + '\\rearm-watch.mjs" --self "' + selfId +
-             '" --quiet 5 --max-wait 600 --delay 15 --wake-file "' + BASE + '\\logs\\wake-list.json"';
+             '" --quiet 5 --max-wait 600 --delay 15 --wake-file "' + BASE + '\\logs\\wake-list.json"' +
+             (req.dryRun === true ? ' --dry' : '');
     try { sh.Run(wd, 0, false); dbg("rearm-watch spawned"); } catch (e) { dbg("rearm spawn err " + e.message); }
     el("mode").textContent = "后台";
     el("clock").className = "big";

package/{lib → components}/restart/scripts/rearm-watch.mjs

@@ -29,6 +29,8 @@ const maxWait = Math.max(0, Number(arg('--max-wait', '600')) || 600);
 const delay = Math.max(5, Number(arg('--delay', '15')) || 15);
 const wakeFile = String(arg('--wake-file', '') || '');
 const note = String(arg('--note', '空闲后自动重排的重启') || '');
+// 原来是不是试运行（dry-run）：转后台重排后要保持同样的语义，别把试运行变成真重启。
+const dry = process.argv.includes('--dry');
 
 function log(line) {
   try { fs.appendFileSync(path.join(LOGS, 'rearm.log'), `[${new Date().toISOString()}] ${line}\n`); } catch { /* ignore */ }
@@ -65,6 +67,7 @@ log(`quiet ${quiet}s reached (waited ${Math.round(res.waitedMs / 1000)}s) -> rea
 const args = [TRIGGER, '--delay', String(delay), '--note', note];
 if (self) args.push('--self-session', self);
 if (wakeFile) args.push('--wake-file', wakeFile);
+if (dry) args.push('--dry-run');
 
 const child = spawn(process.execPath, args, { cwd: BASE, detached: true, stdio: 'ignore', windowsHide: true });
 child.on('error', (error) => {

package/components/session/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "跨会话",
+  "description": "同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱",
+  "version": "0.9.2"
+}

package/components/terminal/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "跨终端",
+  "description": "同一台机器上的多个 DSH 终端/进程之间互发邮件与文件",
+  "version": "0.9.2"
+}

package/components/ui/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "ui",
+  "description": "自更新开关：打开后插件会定期检查 npm 上的新版本并自动安装（默认关；装完要重启 DSH 才生效，不会自己重启）。关掉它不影响下面五个组件 —— 跨会话 / 跨终端 / 跨设备 / 跨账号 / 自动重启，各自独立开关、各有版本号。",
+  "version": "0.9.2"
+}

package/cordis.patch.yml

@@ -1,69 +1,70 @@
-# ============================================================================
-# dsh-crossterm —— DSH bundle patch
-# ============================================================================
-# 安装（本地目录，对每个要互通的 profile 各装一次）：
-#   dsh plugin --profile desktop add link:F:\dsh\001X\dsh-crossterm
-#   dsh plugin --profile web     add link:F:\dsh\001X\dsh-crossterm
-# 卸载：
-#   dsh plugin --profile desktop remove dsh-crossterm
-#
-# 每个 insert 行在 DSH「插件 → 跨端互通 → 包含的组件」里是一行组件，可单独开关。
-# 五行指向同一个包，只是走不同子路径 / 不同 config.part：
-#
-#   ① 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（云端总线同步）
-#   ⑤ dsh-crossterm/parts/account  跨账号：预留占位，暂不挂工具
-   ⑥ dsh-crossterm/parts/restart  自动重启：dsh_restart（原 dsh-restart 插件，0.9.0 起并入）
-                                  它不碰总线，只把 dsh_restart 工具挂到每个会话上。
-#
-# 组件名来自 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 —— 所以裸包名行单独做入口（卡片 + 自动更新），
-# 标题写「跨端互通（自更新）」，四个业务组件排在它后面、名字仍是跨会话/跨终端/跨设备/跨账号。
-#
-# 0.8.9 起五个组件互不依赖：谁都不用 provide/inject 别人，各挂各的工具与开销。
-# 关掉入口行只失去「配置卡片 + 自动更新」，四个业务组件照常工作、各自仍可单独关。
-# 之前（0.7.x–0.8.8）是 ui 行 provide('crossterm')、其余四行 inject 它，关入口会连坐——已废弃。
-#
-# 前五个组件在同一 DSH 进程里共用一份总线实例（自动重启不参与，它只挂自己的工具）：心跳只起一次，云同步只在 device 组件启用
-# 且 config.json 里 cloudEnabled=true 时才跑。安装/改动后需重启对应的 DSH 进程。
-# ============================================================================
-
-- insert:
-    - id: crossterm-ui
-      # 入口（自更新）：裸包名，浏览器半端的配置卡片 + 插件页标题/简介 + 「自动更新」开关。
-      # 关掉这一行只失去卡片与自动更新，四个业务组件不受影响；它自己不挂工具。
-      name: dsh-crossterm
-      config:
-        part: ui
-    - id: crossterm-session
-      name: dsh-crossterm/parts/session
-      config:
-        part: session
-    - id: crossterm-terminal
-      name: dsh-crossterm/parts/terminal
-      config:
-        part: terminal
-    - id: crossterm-device
-      name: dsh-crossterm/parts/device
-      config:
-        part: device
-    - id: crossterm-account
-      name: dsh-crossterm/parts/account
-      config:
-        part: account
-    - id: crossterm-restart
-      # 自动重启（原 dsh-restart 插件）：不参与总线，只挂 dsh_restart 工具。
-      # helper 脚本随包分发在 lib/restart/scripts/，启动时复制到 <busDir>/restart-module/。
-      name: dsh-crossterm/parts/restart
-      config:
-        part: restart
+# ============================================================================
+# dsh-crossterm —— DSH bundle patch
+# ============================================================================
+# 安装（本地目录，对每个要互通的 profile 各装一次）：
+#   dsh plugin --profile desktop add link:F:\dsh\001X\dsh-crossterm
+#   dsh plugin --profile web     add link:F:\dsh\001X\dsh-crossterm
+# 卸载：
+#   dsh plugin --profile desktop remove dsh-crossterm
+#
+# 每个 insert 行在 DSH「插件 → 跨端互通 → 包含的组件」里是一行组件，可单独开关。
+# 五行指向同一个包，只是走不同子路径 / 不同 config.part：
+#
+#   ① dsh-crossterm                自更新（入口）：插件页标题/简介/配置卡片，不挂任何工具
+#                                  （config.part: ui）。0.8.9 起它不再是总开关 —— 关掉它只失去
+#                                  卡片与「自动更新」，下面四个组件照常跑。
+#                                  自动更新默认关，开关在卡片里，值落 config.json 的 autoUpdate。
+#   ② dsh-crossterm/components/session  跨会话：term_link / term_unlink / term_broadcast / term_inbox / term_config
+#   ③ dsh-crossterm/components/terminal 跨终端：term_whoami / term_list / term_send / term_send_files
+#   ④ dsh-crossterm/components/device   跨设备：term_cloud（云端总线同步）
+#   ⑤ dsh-crossterm/components/account  跨账号：预留占位，暂不挂工具
+#   ⑥ dsh-crossterm/components/restart  自动重启：dsh_restart（原 dsh-restart 插件，0.9.0 起并入）
+# 它不碰总线，只把 dsh_restart 工具挂到每个会话上。
+#
+# 组件名/简介/版本来自 package.json 的 exports 映射 + components/<part>/manifest.json：
+#   "./components/session/package.json" -> "./components/session/manifest.json"
+# 每个组件显示自己的中文名、简介和独立版本号，实际加载的仍是 lib/index.js，靠 config.part 决定挂哪组工具。
+# 组件版本号由该组件负责人维护：只在该组件文件改动时升，跟着插件一起发版（见 MAINTAINERS.md）。
+#
+# 为什么入口行必须用「裸包名」：浏览器的 client 半端只对裸包名行生效
+# （dsh-client-modules 的 locatePkgJson 对子路径行直接返回 undefined），而插件页顶部标题
+# 与裸包名行共用同一份 locale/zh.json 的 meta —— 所以裸包名行单独做入口（卡片 + 自动更新），
+# 标题写「跨端互通（自更新）」，四个业务组件排在它后面、名字仍是跨会话/跨终端/跨设备/跨账号。
+#
+# 0.8.9 起五个组件互不依赖：谁都不用 provide/inject 别人，各挂各的工具与开销。
+# 关掉入口行只失去「配置卡片 + 自动更新」，四个业务组件照常工作、各自仍可单独关。
+# 之前（0.7.x–0.8.8）是 ui 行 provide('crossterm')、其余四行 inject 它，关入口会连坐——已废弃。
+#
+# 前五个组件（ui/session/terminal/device/account）在同一 DSH 进程里共用一份总线实例（自动重启不参与，它只挂自己的工具）：心跳只起一次，云同步只在 device 组件启用
+# 且 config.json 里 cloudEnabled=true 时才跑。安装/改动后需重启对应的 DSH 进程。
+# ============================================================================
+
+- insert:
+    - id: crossterm-ui
+      # 入口（自更新）：裸包名，浏览器半端的配置卡片 + 插件页标题/简介 + 「自动更新」开关。
+      # 关掉这一行只失去卡片与自动更新，四个业务组件不受影响；它自己不挂工具。
+      name: dsh-crossterm
+      config:
+        part: ui
+    - id: crossterm-session
+      name: dsh-crossterm/components/session
+      config:
+        part: session
+    - id: crossterm-terminal
+      name: dsh-crossterm/components/terminal
+      config:
+        part: terminal
+    - id: crossterm-device
+      name: dsh-crossterm/components/device
+      config:
+        part: device
+    - id: crossterm-account
+      name: dsh-crossterm/components/account
+      config:
+        part: account
+    - id: crossterm-restart
+      # 自动重启（原 dsh-restart 插件）：不参与总线，只挂 dsh_restart 工具。
+      # helper 脚本随包分发在 lib/restart/scripts/，启动时复制到 <busDir>/restart-module/。
+      name: dsh-crossterm/components/restart
+      config:
+        part: restart

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.9.0'
+export const VERSION = '0.9.2'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/lib/index.js

@@ -42,7 +42,7 @@ import { runSetup } from './cloud/setup.js'
 import { deviceRow, matchDevice } from './cloud/match.js'
 import { registerWeb, selfUpdate } from './web.js'
 import { recordOwnership, readMaintainersDoc } from './logs.js'
-import { ensureRestartRuntime } from './restart/runtime.js'
+import { ensureRestartRuntime } from '../components/restart/runtime.js'
 
 const PLUGIN = 'dsh-crossterm'
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
@@ -2081,7 +2081,7 @@ function releaseTerm(term) {
 
 // ── 入口 ──────────────────────────────────────────────────────────────────
 
-const RESTART_SRC = path.join(ROOT, 'lib', 'restart', 'scripts')
+const RESTART_SRC = path.join(ROOT, 'components', 'restart', 'scripts')
 
 /**
  * 「自动重启」组件（原 dsh-restart 插件，0.9.0 起并入）。

package/lib/web.js

@@ -15,7 +15,7 @@ import { listLogs, tailLogs, readMaintainersDoc, listOwnership } from './logs.js
 
 const PKG = 'dsh-crossterm'
 const NPM_REGISTRIES = ['https://registry.npmmirror.com', 'https://registry.npmjs.org']
-// 包根目录：lib/web.js 的上一级（README.md / CHANGELOG.md / locale / parts 都在这里）
+// 包根目录：lib/web.js 的上一级（README.md / CHANGELOG.md / locale / components 都在这里）
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
 
 let installed = false
@@ -617,12 +617,13 @@ function aboutOf(term) {
   const components = PART_ORDER.map((item) => {
     let doc = {}
     try {
-      doc = JSON.parse(fs.readFileSync(path.join(ROOT, 'parts', `${item.part}.manifest.json`), 'utf8'))
+      doc = JSON.parse(fs.readFileSync(path.join(ROOT, 'components', item.part, 'manifest.json'), 'utf8'))
     } catch { /* ignore */ }
     return {
       part: item.part,
       name: doc.name || item.fallback,
       description: doc.description || '',
+      version: doc.version || '',
     }
   })
   const maintainers = readMaintainers()

package/locale/en.json

@@ -2,6 +2,6 @@
   "meta": {
     "title": "CrossTerm (self-update)",
     "shortTitle": "CrossTerm",
-    "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."
+    "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 five components below — session / terminal / device / account / auto-restart — each has its own switch and version. 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

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

package/package.json

@@ -1,31 +1,33 @@
 {
   "name": "dsh-crossterm",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "跨端互通：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份",
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
     ".": "./lib/index.js",
-    "./client": "./client/client.js",
     "./package.json": "./package.json",
+    "./client": "./client/client.js",
+    "./components/ui": "./lib/index.js",
+    "./components/ui/package.json": "./components/ui/manifest.json",
+    "./components/session": "./lib/index.js",
+    "./components/session/package.json": "./components/session/manifest.json",
+    "./components/terminal": "./lib/index.js",
+    "./components/terminal/package.json": "./components/terminal/manifest.json",
+    "./components/device": "./lib/index.js",
+    "./components/device/package.json": "./components/device/manifest.json",
+    "./components/account": "./lib/index.js",
+    "./components/account/package.json": "./components/account/manifest.json",
+    "./components/restart": "./lib/index.js",
+    "./components/restart/package.json": "./components/restart/manifest.json",
     "./locale/en.json": "./locale/en.json",
-    "./locale/zh.json": "./locale/zh.json",
-    "./parts/session": "./lib/index.js",
-    "./parts/terminal": "./lib/index.js",
-    "./parts/device": "./lib/index.js",
-    "./parts/account": "./lib/index.js",
-    "./parts/session/package.json": "./parts/session.manifest.json",
-    "./parts/terminal/package.json": "./parts/terminal.manifest.json",
-    "./parts/device/package.json": "./parts/device.manifest.json",
-    "./parts/account/package.json": "./parts/account.manifest.json",
-    "./parts/restart": "./lib/index.js",
-    "./parts/restart/package.json": "./parts/restart.manifest.json"
+    "./locale/zh.json": "./locale/zh.json"
   },
   "files": [
     "lib",
+    "components",
     "client",
     "locale",
-    "parts",
     "cordis.patch.yml",
     "README.md",
     "CHANGELOG.md",

package/parts/account.manifest.json

@@ -1,4 +0,0 @@
-{
-    "name":  "跨账号",
-    "description":  "预留位：后续用于跨账号互通，当前不挂工具"
-}

package/parts/device.manifest.json

@@ -1,4 +0,0 @@
-{
-    "name":  "跨设备",
-    "description":  "经云端总线，在多台机器的 DSH 之间互发邮件与文件"
-}

package/parts/session.manifest.json

@@ -1,4 +0,0 @@
-{
-    "name":  "跨会话",
-    "description":  "同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱"
-}

package/parts/terminal.manifest.json

@@ -1,4 +0,0 @@
-{
-    "name":  "跨终端",
-    "description":  "同一台机器上的多个 DSH 终端/进程之间互发邮件与文件"
-}