dsh-crossterm 0.8.15 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # 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 个组件）**
+
+User said (m12143)：“将自动重启插件变成组件融合到互通插件内，任命原会话继续负责自动重启模块，
+不再单独发版也不负责发版，每次修改更新后向你汇报，由你上传插件新版本”
+
+- 原 `dsh-restart` 插件（包名 `dsh-restart-module` 0.3.28）代码并入 `lib/restart/`：`core.js`（`dsh_restart` 全套动作）
+  + `scripts/`（`trigger-restart.mjs` / `dsh-restart-helper.mjs` / `busy-check.mjs` / `rearm-watch.mjs` / UI 页面等 8 个）
+  + `runtime.js`（`ensureRestartRuntime()` 按版本把脚本同步到运行目录）。
+- 新组件 `parts/restart`（插件页显示「自动重启」）：`cordis.patch.yml` 第 6 行 insert、`config.part: restart`；
+  它不参与总线，只把 `dsh_restart` 工具挂到每个会话上。
+- 运行目录：`<busDir>/restart-module/`（默认 `C:\Users\<你>\.dsh\crossterm\restart-module`），
+  启动时按版本同步脚本；`logs/`、`request.json`、`result.json` 一律不动，重启记录不会因为升级丢失。
+- 旧插件 `dsh-restart-module` 若还装着，会与本组件重复注册 `dsh_restart`，需在 profile 里摘掉。
+- 负责人：自动重启模块由原 `dsh-restart` 会话（`a3e9f80e`，会话名「自动重启」）继续维护，不单独发版；
+  改动汇报给插件主维护会话，由主维护会话并入 `dsh-crossterm` 一起发版。
 ## 0.8.15 — 2026-10-20
 
 **为什么发这版**：YOCE_C 从 0.8.13 点更新到 0.8.14 后回归发现，没重启前 `/status` 仍只有 `version=0.8.13`、

package/MAINTAINERS.md

@@ -26,6 +26,17 @@
     "since": "2026-10-18T00:00:00+08:00",
     "scope": "按负责人派活改 lib/*.js；不得改版本号、总线状态、重启、C 盘写入、AGENTS.md"
   },
+  "modules": {
+    "restart": {
+      "session": "session-a3e9f80e-6f28-425c-9807-0b9d8b872b5e",
+      "short": "a3e9f80e",
+      "name": "自动重启",
+      "role": "自动重启模块负责人（原 dsh-restart 插件作者会话）",
+      "since": "2026-10-20",
+      "scope": "lib/restart/ 下的 core.js、runtime.js、scripts/**",
+      "rule": "不单独发版、不自己发版；改完向主维护会话（b6aa099b）汇报，由主维护并入 dsh-crossterm 发版"
+    }
+  },
   "previous": [
     {
       "session": "session-6ef6da30-a7f1-4a4e-...",
@@ -42,6 +53,13 @@
 }
 -->
 
+## 模块负责人（大插件里的小模块，可以分工）
+
+一份插件里可以拆给多人：模块负责人只管自己那几支文件，发版仍由插件负责人统一做。
+
+| 模块 | 负责人 | 范围 | 规矩 |
+|---|---|---|---|
+| 自动重启（`lib/restart/`，插件页第 ⑥ 个组件） | `a3e9f80e`（会话名「自动重启」） | `core.js` / `runtime.js` / `scripts/**` | 不单独发版、不自己发版；改完汇报给 `b6aa099b`，由插件负责人并入 `dsh-crossterm` 一起发版 |
 ## 任期表
 
 | 起（本地时间） | 止（本地时间） | 会话 | 终端 / nodeId | 角色 | 交接依据 |

package/README.md

@@ -23,28 +23,30 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 | ③ | 跨终端 | 同一台机器上的多个 DSH 终端/进程之间互发邮件与文件 | `term_whoami` `term_list` `term_send` `term_send_files` |
 | ④ | 跨设备 | 经云端总线，在多台机器的 DSH 之间互发邮件与文件 | `term_cloud` |
 | ⑤ | 跨账号 | 预留位：后续用于跨账号互通，当前不挂工具 | — |
+| ⑥ | 自动重启 | 改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 `dsh-restart` 插件，0.9.0 起并入） | `dsh_restart` |
 
 > 入口行为什么必须用裸包名：浏览器 client 半端只对裸包名行生效（`dsh-client-modules` 的
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做入口（配置卡片 + 自动更新开关），标题带「（自更新）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.8.15）**
+**本版更新（0.9.1）**
 
-- **升级当次就能提示「待重启」**：以前这一步要等服务端换成新版才认得出来（YOCE_C 回归的第 3/4 步就是这样「看不见」）。
-  现在浏览器 client 自己带版本号（`CLIENT_VERSION`），点完更新就从 `/update` 响应的 `installed` / `before` 判断，
-  立刻把卡片切成「已装待重启」；渲染时还会按「磁盘版本 > 进程版本」持续推导，旧进程也提示得出来。
-- `/check` 多返回一个 `running`（= 进程版本），与 `current` 并列，旧客户端也能照常解析。
-- 本机是 `link:` 源码版，没有这层差别；以上对用 npm 安装的设备生效。
+- **修 0.9.0 的启动即失效**：`cordis.patch.yml` 里第 ⑥ 行的两行说明漏了开头的 `#`，
+  整份 overlay 解析失败，插件整包不加载（卡片、总线、工具全没有）。0.9.1 补回注释符；
+  发版流程加了一条硬规矩：**改完 `cordis.patch.yml` 必须用 `js-yaml` 真解析一次，核对 `insert` 行数与 id**。
+- 0.9.0 的 npm 包与安装 zip 都带这份坏 YAML，请直接装 0.9.1。
 
-**上一版（0.8.14）**
+**上一版（0.9.0）**
 
-- **「更新」按钮不再看起来没用**：装完新版但还没重启时，卡片多一行「待重启」、
-  更新按钮变成不可点的「已装待重启」，接口 `/check` 改回 `needRestart=true` 而不是继续报「有更新」。
-- 根因是状态表达：宿主进程里还是旧版本号，而磁盘上已经装了新版 —— 现在这两个版本分开显示。
-- 本机是 `link:` 源码版（磁盘版本永远等于源码版本），所以这行只会在 npm 安装的设备上出现。
+- **自动重启并进来当第 6 个组件**：原 `dsh-restart` 插件的 `dsh_restart` 工具与 8 个 helper 脚本并入 `lib/restart/`，
+  插件页多一行「自动重启」；脚本首次启动时同步到 `<总线目录>/restart-module/`（默认 `C:\Users\<你>\.dsh\crossterm\restart-module`）。
+- 该模块不参与总线，只往每个会话挂 `dsh_restart`；由原 `dsh-restart` 会话（`a3e9f80e`，会话名「自动重启」）继续维护，
+  **不再单独发版**，改完报主维护会话、由主维护会话并入本插件一起发。
+- 旧的 `dsh-restart-module` 插件若还装着会重复注册 `dsh_restart`，需在 profile 里摘掉。
 
-**更早（0.8.13 / 0.8.12 / 0.8.11 / 0.8.10 / 0.8.9 / 0.8.8 / 0.8.7 / 0.8.6 / 0.8.5 / 0.8.0）**
+**更早（0.8.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.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：云端设备只列别人、带权限与状态、版本仅在差异时显示；插件页标题改「跨端互通（自更新）」；

package/cordis.patch.yml

@@ -1,61 +1,69 @@
-# ============================================================================
-# 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  跨账号：预留占位，暂不挂工具
-#
-# 组件名来自 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
+# ============================================================================
+# 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

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

package/lib/index.js

@@ -42,6 +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'
 
 const PLUGIN = 'dsh-crossterm'
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
@@ -1511,7 +1512,7 @@ const TOOL_PART = {
   term_cloud: 'device',
 }
 
-const PARTS = ['all', 'ui', 'session', 'terminal', 'device', 'account']
+const PARTS = ['all', 'ui', 'session', 'terminal', 'device', 'account', 'restart']
 
 const PART_LABEL = {
   all: '全部组件',
@@ -1520,6 +1521,7 @@ const PART_LABEL = {
   terminal: '跨终端',
   device: '跨设备',
   account: '跨账号（预留）',
+  restart: '自动重启',
 }
 
 function normalizePart(raw) {
@@ -2079,10 +2081,55 @@ function releaseTerm(term) {
 
 // ── 入口 ──────────────────────────────────────────────────────────────────
 
+const RESTART_SRC = path.join(ROOT, 'lib', 'restart', 'scripts')
+
+/**
+ * 「自动重启」组件（原 dsh-restart 插件，0.9.0 起并入）。
+ *
+ * 它不参与总线：只把 dsh_restart 工具挂到每个会话上，并把 helper 脚本复制到
+ * 可写目录后交给 ./restart/core.js。脚本必须在 import core.js **之前**落到
+ * DSH_RESTART_MODULE_DIR，因为 core.js 在模块顶层读这个环境变量。
+ */
+function mountRestart(root, config) {
+  const label = 'dsh-crossterm(自动重启)'
+  let destDir = ''
+  const mark = (line) => {
+    const text = `[${new Date().toISOString()}] ${label}: ${line}\n`
+    try {
+      if (destDir) {
+        const dir = path.join(destDir, 'logs')
+        fs.mkdirSync(dir, { recursive: true })
+        fs.appendFileSync(path.join(dir, 'plugin.log'), text)
+      }
+    } catch { /* ignore */ }
+  }
+  try {
+    const cfg = readConfig()
+    destDir = path.join(cfg.busDir, 'restart-module')
+    const info = ensureRestartRuntime({ srcDir: RESTART_SRC, destDir, version: VERSION })
+    if (info.skipped.length) mark(`脚本缺失：${info.skipped.join(', ')}`)
+    if (!process.env.DSH_RESTART_MODULE_DIR) process.env.DSH_RESTART_MODULE_DIR = destDir
+    mark(`运行目录就绪：${destDir}（本次复制 ${info.copied.length} 个脚本）`)
+    void import('./restart/core.js')
+      .then((mod) => {
+        mod.default.apply(root, { ...config, part: 'restart' })
+        mark('已挂载 dsh_restart 工具')
+      })
+      .catch((e) => mark(`加载失败：${(e && e.message) || String(e)}`))
+  } catch (e) {
+    mark(`启动失败：${(e && e.message) || String(e)}`)
+  }
+}
+
 export default {
   name: PLUGIN,
   apply(root, config) {
     const part = normalizePart(config?.part)
+    // 「自动重启」是独立组件：不碰总线，只挂 dsh_restart 工具。
+    if (part === 'restart') {
+      mountRestart(root, config)
+      return
+    }
     // 0.8.9 起「入口」组件不再当总开关：它只负责插件卡片与「自动更新」，
     // 四个业务组件（跨会话/跨终端/跨设备/跨账号）各挂各的 —— 关掉入口行不会连坐。
     // 自动更新默认关（cfg.autoUpdate=false），开关在卡片里，改了落 config.json。