dsh-crossterm 0.9.7 → 0.9.9

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 0.9.9 — 2026-10-20
+
+### 修复：幽灵链成员退不掉（YOCE_C 报告）
+
+- 现象：`term_unlink code="X" all=true` 回「本终端没有接在特征码「X」上」，但链台账里确实还留着本终端成员；只能先 `term_link` 补回 links 再 `term_unlink` 绕开。
+- 根因：`unlinkChain()` 只遍历内存 `this.links`（`lib/index.js`），台账里的成员它看不见；`leaveChain()` 只能按 `nodeId::sessionId` 精确删。
+- 修法：
+  - `lib/bus.js` 新增 `leaveChainNode(code, nodeId)`：按 nodeId 摘掉该节点在链上的全部成员，空了删链文件。
+  - `lib/index.js` 的 `unlinkChain()`：`all=true` 且 links 无记录时改走 `leaveChainNode`，成功则返回 `{ ok:true, ghosts, removed }`。
+  - `chainSweep` 加自愈：`linksLoaded` 之后，本节点在台账里有、links 里没有的成员会被摘掉并记日志。
+- 组件版本：跨会话 `0.5.0` → `0.5.1`。
+
+## 0.9.8 — 2026-10-20
+
+- 自动重启组件维护权交回：原负责人会话「自动重启」（`a3e9f80e`）按机主指示即日起停止改动 `components/restart/**`；`MAINTAINERS.md` 的 `modules.restart` 改为插件负责人 `b6aa099b` 暂管，新负责人等后续交接时再任命。
+- 记入其交回时的两条观察（待下次动该组件前定口径）：① market `runningAgents` 比心跳"粘"，现取并集偏保守，可选「心跳权威、market 兜底」；② 检查点取消后 `rearm-watch.mjs` 用固定 `--delay 15`，与「空闲 5 秒后再重排」是否统一。
+- 只改 `MAINTAINERS.md` / `CHANGELOG.md` / `README.md`；代码与组件版本不动（入口 0.9.3 / 跨会话 0.5.0 / 跨工作区 0.1.0 / 跨设备 0.4.0 / 自动重启 0.3.29），插件总版本 0.9.7 → 0.9.8。
+
 ## 0.9.7 — 2026-10-20
 
 - 组件版本按用户要求重新定起点：跨会话 `0.9.2 → 0.5.0`、跨设备 `0.9.2 → 0.4.0`、跨工作区 `0.9.5 → 0.1.0`；入口（ui）仍 `0.9.3`、自动重启仍 `0.3.29`。

package/MAINTAINERS.md

@@ -56,13 +56,12 @@
       "scope": "components/device/**、lib/cloud/**（中转站、备份、layout）"
     },
     "restart": {
-      "session": "session-a3e9f80e-6f28-425c-9807-0b9d8b872b5e",
-      "short": "a3e9f80e",
-      "name": "自动重启",
-      "role": "自动重启模块负责人（原 dsh-restart 插件作者会话）",
+      "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
+      "short": "b6aa099b",
+      "role": "自动重启组件负责人（暂由插件负责人直管，等后续交接时任命新的）",
       "since": "2026-10-20",
       "scope": "components/restart/ 下的 core.js、runtime.js、scripts/**",
-      "rule": "不单独发版、不自己发版；改完向主维护会话（b6aa099b）汇报，由主维护并入 dsh-crossterm 发版；只改 components/restart/** 时把它的组件版本号（现 0.3.28）加一"
+      "rule": "原负责人 a3e9f80e 已于 2026-10-20 19:33 交回维护权（机主指示：转给插件负责人，等负责人任命新的）；暂由 b6aa099b 直管，只改 components/restart/** 时把组件版本号（现 0.3.29）加一，仍由插件负责人统一发版"
     }
   },
   "previous": [
@@ -88,19 +87,29 @@
 | 组件（插件页顺序） | 当前版本 | 负责人 | 范围 | 规矩 |
 |---|---|---|---|---|
 | ① 跨端互通（自更新） | v0.9.3 | `b6aa099b` | `components/ui/**`、`client/**`、`locale/**`、`lib/web.js` | 组件版本号在 `components/ui/manifest.json` |
-| ② 跨会话 | v0.9.2 | `b6aa099b` | `components/session/**`、`lib/bus.js` 的链/邮件 | 同上 |
-| ③ 跨工作区 | v0.9.5 | `b6aa099b` | `components/terminal/**`、presence / `term_send` | 同上 |
-| ④ 跨设备 | v0.9.2 | `b6aa099b` | `components/device/**`、`lib/cloud/**` | 同上 |
-| ⑤ 自动重启 | v0.3.29 | `a3e9f80e`（会话名「自动重启」） | `components/restart/**`（`core.js` / `runtime.js` / `scripts/**`） | 不单独发版、不自己发版；改完汇报 `b6aa099b`，由插件负责人并入 `dsh-crossterm` 发版；只动它就把它的版本号加一 |
+| ② 跨会话 | v0.5.0 | `b6aa099b` | `components/session/**`、`lib/bus.js` 的链/邮件 | 同上 |
+| ③ 跨工作区 | v0.1.0 | `b6aa099b` | `components/terminal/**`、presence / `term_send` | 同上 |
+| ④ 跨设备 | v0.4.0 | `b6aa099b` | `components/device/**`、`lib/cloud/**` | 同上 |
+| ⑤ 自动重启 | v0.3.29 | `b6aa099b`（暂管；原 `a3e9f80e` 已于 2026-10-20 19:33 交回） | `components/restart/**`（`core.js` / `runtime.js` / `scripts/**`） | 不单独发版；新负责人等后续交接时任命；只动它就把它的版本号加一 |
 
 **组件版本号怎么升**：只在该组件自己的文件改动时升它（在 `components/<part>/manifest.json` 的 `version`），
 跟着插件一起发版；插件总版本仍按发版技能的三分位规则。插件页与 `GET /crossterm/api/about` 的 `components[].version` 读的就是这里。
+## 待定事项（自动重启组件交回时留的）
+
+原负责人 `a3e9f80e` 交回维护权时留下两条，下次动 `components/restart/**` 前先定口径：
+
+1. market `/dsh-market/status` 的 `runningAgents` 有时比心跳"粘"（会话已不在回合里，市场还列着）——现在三路取并集偏保守，可选「心跳权威、market 只兜底」。
+2. 检查点取消后 `rearm-watch.mjs` 用固定 `--delay 15`，与「空闲 5 秒后再重排」的口径是否统一、是否沿用同一份唤醒清单。
+
+现场验证（10 s 检查点取消 → 转后台 → 空闲后重排）仍挂起，等机主安排；不得自行触发真重启。
+
 ## 任期表
 
 | 起（本地时间） | 止（本地时间） | 会话 | 终端 / nodeId | 角色 | 交接依据 |
 | --- | --- | --- | --- | --- | --- |
 | 2026-10-17 20:30 | 2026-10-18 01:09 | `session-6ef6da30…`（初版负责人） | TS-01 / `ts-01-a52535` | 负责人 | 会话故障，转录停止增长、投递不消费；用户改派 |
 | 2026-10-18 00:59 | 至今 | `session-b6aa099b…`（互通插件主维护） | TS-01 / `ts-01-a52535` | 负责人 | 用户首条指令：「你现在是互通插件的新负责人」 |
+| 2026-10-20 19:33 | 2026-10-20 19:33 | `session-a3e9f80e…`（自动重启组件） | TS-01 / `ts-01-a52535` | 组件负责人 | 交回：机主指示「将组件权限转给插件负责人，等负责人任命新的」 |
 | 2026-10-17 21:44 | 至今（按派活） | `session-ccf34a5a…`（同端多会话2） | TS-01 / `ts-01-a52535` | 助手 | 用户：「指定同端多会话2为你的助手，部分修改可让他进行」 |
 
 时间口径：接手取该会话转录 `session.v4.jsonl.zstd` 的**创建时间**，交卸取其**最后写入时间**（本机 `C:\Users\Administrator\.dsh\sessions\--F-dsh-001X--\<会话>\`）。

package/README.md

@@ -19,7 +19,7 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 | 顺序 | 组件名称 | 版本 | 作用 | 工具 |
 |---|---|---|---|---|
 | ① | 跨端互通（入口／自更新） | v0.9.3 | 自更新开关：打开后定期检查 npm 新版本并自动安装（默认关；装完要重启 DSH 生效）。关掉它只失去卡片与自动更新，下面四个组件照常工作。裸包名行，承载插件标题/简介与配置卡片，不挂工具 | — |
-| ② | 跨会话 | v0.5.0 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `term_link` `term_unlink` `term_broadcast` `term_inbox` `term_config` |
+| ② | 跨会话 | v0.5.1 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `term_link` `term_unlink` `term_broadcast` `term_inbox` `term_config` |
 | ③ | 跨工作区 | v0.1.0 | 在本机不同工作区、不同会话之间互发邮件与文件（跨终端本轮不做，暂无条件） | `term_whoami` `term_list` `term_send` `term_send_files` |
 | ④ | 跨设备 | v0.4.0 | 经云端中转站，在多台机器的 DSH 之间互发邮件与文件 | `term_cloud` |
 | ⑤ | 自动重启 | v0.3.29 | 改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 `dsh-restart` 插件，0.9.0 起并入） | `dsh_restart` |
@@ -30,22 +30,25 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 >
 > 组件版本号怎么升：**只在该组件自己的文件改动时升它**，跟着插件一起发版（例：只改自动重启 → `components/restart` 的 `0.3.28` → `0.3.29`，其余四个不动）。插件总版本仍按发版技能的三分位规则。
 
-**本版更新（0.9.7）**
+**本版更新（0.9.9）**
 
-- **组件版本按你的要求重新给了起点**：跨会话 0.9.2 → **0.5.0**、跨设备 0.9.2 → **0.4.0**、跨工作区 0.9.5 → **0.1.0**；入口仍 0.9.3、自动重启仍 0.3.29。
-- **数字变小是故意的**：每个组件按自己从零开始的时间线走，和插件总版本（0.9.6 → 0.9.7）不再绑定；之后只有哪个组件改了才加哪个。
-- **只动了三个 `components/<part>/manifest.json` 的 `version` 与文档**：代码、`cordis.patch.yml`、已装机器都不用改，重启后插件页组件表即显示新号。
+- **修「幽灵链成员」退不掉**（YOCE_C 2026-10-20 报的坑）：`term_unlink ... all=true` 以前只遍历内存里的 links，遇到「链台账里还留着本终端成员、但 links 已没有这条记录」就永远退不掉（一直回「本终端没有接在特征码上」）。
+- 现在 `all=true` 在 links 为空时也会按 **nodeId** 把本终端在这串码上的成员从台账里摘掉，返回值带 `ghosts`；成员清空时链文件自动删除。
+- `chainSweep` 每 6 拍自愈一次：本节点在台账里有、links 里却没有的成员会被摘掉，并记一行日志「chain sweep: 摘掉幽灵成员」。
+- 显式传 `sessionId` 的行为不变——只退那一个，不动其它会话（笔误不会误删）。
+- 组件版本：跨会话 0.5.0 → **0.5.1**，其余组件不动。
 
-**上一版（0.9.6）**
+**上一版（0.9.8）**
 
-- **去掉「跨账号」组件**：插件页从 6 个组件变成 5 个，`components/account/` 与那行 insert 一起删掉，源码归档在 `archive/components-removed/account-0.9.2/`。
+- **自动重启组件交回维护权**：原负责人会话「自动重启」按机主指示即日起停止改动，`components/restart/**` 暂由插件负责人 `b6aa099b` 直管；新负责人等后续交接时再任命（`MAINTAINERS.md` 的 `modules.restart` 已改，旧负责人记入任期）。
+- 它交回时留了两条观察，已记进 `MAINTAINERS.md` 的「待定事项」，下次动这个组件前先定口径。
+- 只改 `MAINTAINERS.md` / `CHANGELOG.md` / README，代码与组件版本都不动。
 
-**上一版（0.9.5）**
-
-- **组件改名：跨终端 → 跨工作区**（跨终端本轮不做，暂无条件）；part 标识仍是 `terminal`，改的只是显示名，已装机器不用改配置。
-
-**更早（0.9.4 / 0.9.3 / 0.9.2 / 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.7 / 0.9.6 / 0.9.5 / 0.9.4 / 0.9.3 / 0.9.2 / 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.7：组件版本按机主要求重新定起点（跨会话 v0.5.0 / 跨设备 v0.4.0 / 跨工作区 v0.1.0）。
+- 0.9.6：去掉「跨账号」组件，插件页变成 5 个组件。
+- 0.9.5：组件「跨终端」改名「跨工作区」（跨终端本轮不做）。
 - 0.9.3：组件表补全六个组件，入口名从 `ui` 改成「跨端互通（入口）」，组件版本号各升各的第一次落地。
 - 0.9.0：自动重启并进来当第 6 个组件（`dsh_restart` + 8 个 helper 脚本），由原 `dsh-restart` 会话继续维护、不再单独发版。
 - 0.8.14：装完未重启时卡片显示「待重启」、更新按钮变灰「已装待重启」，`/check` 回 `needRestart=true`。

package/components/session/manifest.json

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

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.7'
+export const VERSION = '0.9.9'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {
@@ -524,6 +524,26 @@ export class Bus {
     return { code, removed }
   }
 
+  /**
+   * 按代码 + 节点退出：把这个节点在链上的**全部**成员一次性摘掉。
+   * 用途是清「链台账里还有成员、但本机 links 已经没有记录」的幽灵成员 ——
+   * 0.9.9 之前 unlinkChain 只遍历内存 this.links，这种残留永远退不掉（YOCE_C 2026-10-20 报的坑）。
+   */
+  async leaveChainNode(code, nodeId) {
+    const file = this.chainFile(code)
+    const chain = await readJson(file)
+    if (!chain || !Array.isArray(chain.members)) return { code, removed: 0, found: false }
+    const before = chain.members.length
+    chain.members = chain.members.filter((m) => m.nodeId !== nodeId)
+    const removed = before - chain.members.length
+    if (!chain.members.length) {
+      await fsp.unlink(file).catch(() => {})
+      return { code, removed, empty: true, found: true }
+    }
+    if (removed) await writeJsonAtomic(file, { ...chain, updatedAt: Date.now() })
+    return { code, removed, found: true }
+  }
+
   /** 剔掉已经不存在的成员（进程退出 / 长时间没心跳） */
   async pruneChain(code, nodes) {
     const chain = await readJson(this.chainFile(code))

package/lib/index.js

@@ -1024,6 +1024,16 @@ class CrossTerm {
         for (const chain of await this.bus.listChains()) {
           for (const m of chain.members || []) {
             if (m.nodeId !== this.nodeId || !m.sessionId) continue
+            // 自愈：本节点在台账里有成员，但 links 里已经没有这条记录 → 摘掉（0.9.9）。
+            // 只在 links 已从磁盘载入之后做，避免启动早期把合法成员误删。
+            if (this.linksLoaded) {
+              const stillLinked = [...this.links.values()].some((l) => l.code === chain.code && String(l.sessionId || '') === String(m.sessionId))
+              if (!stillLinked) {
+                await this.bus.leaveChain(chain.code, this.nodeId, m.sessionId).catch(() => {})
+                await this.note(`chain sweep: 摘掉幽灵成员 ${shortId(m.sessionId)} @ ${chain.code}`)
+                continue
+              }
+            }
             const { known } = this.sessionPresence(m.sessionId)
             if (known) this.chainMisses.delete(`${chain.code}::${m.sessionId}`)
             if (Number(m.pid) !== process.pid || m.version !== VERSION) {
@@ -1172,6 +1182,16 @@ class CrossTerm {
     if (!sid && !all && !caller) return { ok: false, detail: '不知道该退哪个会话：请传 sessionId，或显式 all=true 退掉本终端在这串码上的全部会话' }
     const victims = [...this.links.entries()].filter(([, l]) => l.code === norm && (!scope.length || scope.includes(l.sessionId)))
     if (!victims.length) {
+      // 幽灵成员：links 里没有本终端的记录，但链台账里还留着本节点的人（0.9.9 修）。
+      // all=true 视为「把本终端在这串码上的痕迹全清」，连台账一起摘；
+      // 显式指定 sessionId 时不动 —— 那可能是笔误，不能顺手清别的会话。
+      if (all) {
+        const ghost = await this.bus.leaveChainNode(norm, this.nodeId).catch(() => undefined)
+        if (ghost && ghost.removed > 0) {
+          await this.note(`unlinked ${norm} [ghost ${ghost.removed}]`)
+          return { ok: true, code: norm, removed: ghost.removed, ghosts: ghost.removed, empty: !!ghost.empty, sessions: [] }
+        }
+      }
       return { ok: false, detail: `本终端${scope.length ? `的会话 ${this.labelOf(scope[0])}` : ''}没有接在特征码「${norm}」上` }
     }
     let removed = 0

package/package.json

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