dsh-crossterm 0.9.8 → 0.9.9

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 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` 暂管，新负责人等后续交接时再任命。

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,18 +30,23 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 >
 > 组件版本号怎么升：**只在该组件自己的文件改动时升它**，跟着插件一起发版（例：只改自动重启 → `components/restart` 的 `0.3.28` → `0.3.29`，其余四个不动）。插件总版本仍按发版技能的三分位规则。
 
-**本版更新（0.9.8）**
+**本版更新（0.9.9）**
 
-- **自动重启组件交回维护权**：原负责人会话「自动重启」按机主指示即日起停止改动，`components/restart/**` 暂由插件负责人 `b6aa099b` 直管；新负责人等后续交接时再任命（`MAINTAINERS.md` 的 `modules.restart` 已改，旧负责人记入任期）。
-- 它交回时留了两条观察，已记进 `MAINTAINERS.md` 的「待定事项」，下次动这个组件前先定口径。
-- 只改 `MAINTAINERS.md` / `CHANGELOG.md` / README，代码与组件版本都不动（入口 0.9.3 / 跨会话 0.5.0 / 跨工作区 0.1.0 / 跨设备 0.4.0 / 自动重启 0.3.29）。
+- **修「幽灵链成员」退不掉**（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.7）**
+**上一版（0.9.8）**
 
-- **组件版本按机主要求重新定起点**：跨会话 → v0.5.0、跨设备 → v0.4.0、跨工作区 → v0.1.0；入口仍 v0.9.3、自动重启仍 v0.3.29。数字变小是故意的，之后哪个组件改了才升哪个。
+- **自动重启组件交回维护权**：原负责人会话「自动重启」按机主指示即日起停止改动，`components/restart/**` 暂由插件负责人 `b6aa099b` 直管；新负责人等后续交接时再任命（`MAINTAINERS.md` 的 `modules.restart` 已改，旧负责人记入任期）。
+- 它交回时留了两条观察，已记进 `MAINTAINERS.md` 的「待定事项」，下次动这个组件前先定口径。
+- 只改 `MAINTAINERS.md` / `CHANGELOG.md` / README，代码与组件版本都不动。
 
-**更早（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 / 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` 改成「跨端互通（入口）」，组件版本号各升各的第一次落地。

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.8'
+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.8",
+  "version": "0.9.9",
   "description": "跨端互通：同一 DSH 账号下的会话、工作区、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份",
   "type": "module",
   "main": "./lib/index.js",