dsh-crossterm 0.9.9 → 0.9.11

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 0.9.11 — 2026-10-20
+
+### 负责人变更（只改文档，无代码改动）
+
+- 负责人变更：`b6aa099b`（互通插件主维护）→ `3195b037`（「插件—互通插件负责人001」，工作区 `H:\dshGZQ\dsh-crossterm`），时间 2026-10-20 19:55，依据机主指令「负责人交接，权限交接：插件—互通插件负责人001」。
+- 发版权限一并移交：此后版本号、备份、npm 发布、zip、云盘上传、重启都由新负责人执行。
+- `MAINTAINERS.md` 的 `current` / `previous[]` / `modules` / 任期表已同步；助手 `ccf34a5a` 随交接暂停派活，去留由新负责人决定。
+- 组件版本不变（跨会话仍 0.5.2 等），本版只变更归属。
+
+## 0.9.10 — 2026-10-20
+
+### 修复：无主链台账收口（清除所有特征码的最后一步）
+
+- 现象：本机 `links` 里没有某串码的记录、`chains/<code>.json` 里只剩别的机器早已下线的成员，`term_unlink all=true` 只能回「本终端没有接在特征码上」，台账留在磁盘上没人清。
+- 修法：`lib/bus.js` 新增 `dropChainIfOrphan(code, nodeId)` —— 本节点不在链上、且链上所有成员节点都离线（超过 `offlineAfterMs * 3`）时删掉该链文件；`unlinkChain()` 的 ghost 分支在上一步没摘到成员时调用它，成功返回 `{ ok:true, droppedChain:true }`。
+- 安全性：本节点是成员、或有任一成员在线时一律不删；探针 `probe-0910.mjs` 10 项覆盖四种分支。
+- 组件版本：跨会话 `0.5.1` → `0.5.2`。
+
 ## 0.9.9 — 2026-10-20
 
 ### 修复：幽灵链成员退不掉（YOCE_C 报告）

package/MAINTAINERS.md

@@ -7,14 +7,15 @@
 <!-- maintainers
 {
   "current": {
-    "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
-    "short": "b6aa099b",
-    "name": "互通插件主维护",
+    "session": "session-3195b037-9ebd-4e9a-83dd-fb6acfc8a77c",
+    "short": "3195b037",
+    "name": "插件—互通插件负责人001",
     "role": "负责人",
     "terminal": "TS-01",
     "nodeId": "ts-01-a52535",
-    "since": "2026-10-18T00:59:27+08:00",
-    "basis": "用户交接：原负责人会话故障，指定本会话接手"
+    "workspace": "H:\\dshGZQ\\dsh-crossterm",
+    "since": "2026-10-20T19:55:00+08:00",
+    "basis": "机主指令：「负责人交接，权限交接：插件—互通插件负责人001」"
   },
   "assistant": {
     "session": "session-ccf34a5a-ad6d-4423-9fa8-fd6ffc44052b",
@@ -24,47 +25,59 @@
     "terminal": "TS-01",
     "nodeId": "ts-01-a52535",
     "since": "2026-10-18T00:00:00+08:00",
-    "scope": "按负责人派活改 lib/*.js；不得改版本号、总线状态、重启、C 盘写入、AGENTS.md"
+    "scope": "按负责人派活改 lib/*.js；不得改版本号、总线状态、重启、C 盘写入、AGENTS.md",
+    "status": "2026-10-20 19:55 随负责人交接暂停派活；是否续用由新负责人 3195b037 决定"
   },
   "modules": {
     "ui": {
-      "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
-      "short": "b6aa099b",
+      "session": "session-3195b037-9ebd-4e9a-83dd-fb6acfc8a77c",
+      "short": "3195b037",
       "role": "入口/自更新组件负责人（= 插件负责人）",
       "since": "2026-10-20",
       "scope": "components/ui/**、client/**、lib/web.js 的卡片与自动更新、locale/**"
     },
     "session": {
-      "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
-      "short": "b6aa099b",
+      "session": "session-3195b037-9ebd-4e9a-83dd-fb6acfc8a77c",
+      "short": "3195b037",
       "role": "跨会话组件负责人（= 插件负责人）",
       "since": "2026-10-20",
       "scope": "components/session/**、lib/bus.js 的链/邮件/收件箱"
     },
     "terminal": {
-      "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
-      "short": "b6aa099b",
+      "session": "session-3195b037-9ebd-4e9a-83dd-fb6acfc8a77c",
+      "short": "3195b037",
       "role": "跨工作区组件负责人（= 插件负责人）",
       "since": "2026-10-20",
       "scope": "components/terminal/**、本机 presence / term_send / term_send_files"
     },
     "device": {
-      "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
-      "short": "b6aa099b",
+      "session": "session-3195b037-9ebd-4e9a-83dd-fb6acfc8a77c",
+      "short": "3195b037",
       "role": "跨设备组件负责人（= 插件负责人）",
       "since": "2026-10-20",
       "scope": "components/device/**、lib/cloud/**（中转站、备份、layout）"
     },
     "restart": {
-      "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
-      "short": "b6aa099b",
+      "session": "session-3195b037-9ebd-4e9a-83dd-fb6acfc8a77c",
+      "short": "3195b037",
       "role": "自动重启组件负责人（暂由插件负责人直管，等后续交接时任命新的）",
       "since": "2026-10-20",
       "scope": "components/restart/ 下的 core.js、runtime.js、scripts/**",
-      "rule": "原负责人 a3e9f80e 已于 2026-10-20 19:33 交回维护权（机主指示：转给插件负责人，等负责人任命新的）；暂由 b6aa099b 直管，只改 components/restart/** 时把组件版本号（现 0.3.29）加一，仍由插件负责人统一发版"
+      "rule": "原负责人 a3e9f80e 已于 2026-10-20 19:33 交回维护权（机主指示：转给插件负责人，等负责人任命新的）；暂由 3195b037 直管，只改 components/restart/** 时把组件版本号（现 0.3.29）加一，仍由插件负责人统一发版"
     }
   },
   "previous": [
+    {
+      "session": "session-b6aa099b-cfa6-42b7-961c-10f720236219",
+      "short": "b6aa099b",
+      "name": "互通插件主维护（第三任）",
+      "role": "负责人",
+      "terminal": "TS-01",
+      "nodeId": "ts-01-a52535",
+      "from": "2026-10-18T00:59:27+08:00",
+      "to": "2026-10-20T19:55:00+08:00",
+      "reason": "机主指令交接给「插件—互通插件负责人001」"
+    },
     {
       "session": "session-6ef6da30-a7f1-4a4e-...",
       "short": "6ef6da30",
@@ -86,11 +99,11 @@
 
 | 组件（插件页顺序） | 当前版本 | 负责人 | 范围 | 规矩 |
 |---|---|---|---|---|
-| ① 跨端互通（自更新） | v0.9.3 | `b6aa099b` | `components/ui/**`、`client/**`、`locale/**`、`lib/web.js` | 组件版本号在 `components/ui/manifest.json` |
-| ② 跨会话 | 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/**`） | 不单独发版；新负责人等后续交接时任命；只动它就把它的版本号加一 |
+| ① 跨端互通（自更新） | v0.9.3 | `3195b037` | `components/ui/**`、`client/**`、`locale/**`、`lib/web.js` | 组件版本号在 `components/ui/manifest.json` |
+| ② 跨会话 | v0.5.2 | `3195b037` | `components/session/**`、`lib/bus.js` 的链/邮件 | 同上 |
+| ③ 跨工作区 | v0.1.0 | `3195b037` | `components/terminal/**`、presence / `term_send` | 同上 |
+| ④ 跨设备 | v0.4.0 | `3195b037` | `components/device/**`、`lib/cloud/**` | 同上 |
+| ⑤ 自动重启 | v0.3.29 | `3195b037`（暂管；原 `a3e9f80e` 已于 2026-10-20 19:33 交回） | `components/restart/**`（`core.js` / `runtime.js` / `scripts/**`） | 不单独发版；新负责人等后续交接时任命；只动它就把它的版本号加一 |
 
 **组件版本号怎么升**：只在该组件自己的文件改动时升它（在 `components/<part>/manifest.json` 的 `version`），
 跟着插件一起发版；插件总版本仍按发版技能的三分位规则。插件页与 `GET /crossterm/api/about` 的 `components[].version` 读的就是这里。
@@ -108,9 +121,10 @@
 | 起（本地时间） | 止（本地时间） | 会话 | 终端 / 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-18 00:59 | 2026-10-20 19:55 | `session-b6aa099b…`（互通插件主维护） | TS-01 / `ts-01-a52535` | 负责人 | 用户首条指令：「你现在是互通插件的新负责人」；交卸依据：机主「负责人交接，权限交接」 |
+| 2026-10-20 19:55 | 至今 | `session-3195b037…`（插件—互通插件负责人001） | TS-01 / `ts-01-a52535`（工作区 `H:\dshGZQ\dsh-crossterm`） | 负责人 | 机主指令：「负责人交接，权限交接：插件—互通插件负责人001」 |
 | 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为你的助手，部分修改可让他进行」 |
+| 2026-10-17 21:44 | 2026-10-20 19:55（随交接暂停派活，去留由新负责人定） | `session-ccf34a5a…`（同端多会话2） | TS-01 / `ts-01-a52535` | 助手 | 用户：「指定同端多会话2为你的助手，部分修改可让他进行」 |
 
 时间口径：接手取该会话转录 `session.v4.jsonl.zstd` 的**创建时间**，交卸取其**最后写入时间**（本机 `C:\Users\Administrator\.dsh\sessions\--F-dsh-001X--\<会话>\`）。
 
@@ -126,6 +140,7 @@
 
 ```json
 {"at":"2026-10-18T00:59:27+08:00","from":"6ef6da30","to":"b6aa099b","role":"负责人","basis":"用户交接：原负责人会话故障"}
+{"at":"2026-10-20T19:55:00+08:00","from":"b6aa099b","to":"3195b037","role":"负责人","basis":"机主指令：负责人交接，权限交接：插件—互通插件负责人001"}
 ```
 
 ## 规则（与 AGENTS.md §7 一致）

package/README.md

@@ -19,7 +19,7 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 | 顺序 | 组件名称 | 版本 | 作用 | 工具 |
 |---|---|---|---|---|
 | ① | 跨端互通（入口／自更新） | v0.9.3 | 自更新开关：打开后定期检查 npm 新版本并自动安装（默认关；装完要重启 DSH 生效）。关掉它只失去卡片与自动更新，下面四个组件照常工作。裸包名行，承载插件标题/简介与配置卡片，不挂工具 | — |
-| ② | 跨会话 | v0.5.1 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `term_link` `term_unlink` `term_broadcast` `term_inbox` `term_config` |
+| ② | 跨会话 | v0.5.2 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `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,7 +30,21 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 >
 > 组件版本号怎么升：**只在该组件自己的文件改动时升它**，跟着插件一起发版（例：只改自动重启 → `components/restart` 的 `0.3.28` → `0.3.29`，其余四个不动）。插件总版本仍按发版技能的三分位规则。
 
-**本版更新（0.9.9）**
+**本版更新（0.9.11）**
+
+- **负责人交接**：本插件维护权与发版权限由 `b6aa099b` 移交给 `3195b037`（显示名「插件—互通插件负责人001」，工作区 `H:\dshGZQ\dsh-crossterm`），时间 2026-10-20 19:55，依据机主「负责人交接，权限交接」。
+- 本版只改文档：`MAINTAINERS.md`（`current` / `previous[]` / `modules` / 任期表）、`AGENTS.md` §7、发版技能、`README` 负责人段。
+- 助手 `ccf34a5a`（同端多会话2）随交接暂停派活，是否续用由新负责人决定；其他会话仍只读。
+- 功能零变化：跨会话 0.5.2 / 跨工作区 0.1.0 / 跨设备 0.4.0 / 自动重启 0.3.29 / 入口 0.9.3。
+
+**上一版（0.9.10）**
+
+- **「清除所有特征码」最后一步收口**：本终端已经不在某串码上、links 里也没有记录、而这串码上的成员全部离线时，`term_unlink ... all=true` 现在会把这份无主台账一并删掉（返回 `droppedChain:true`），不用再人工去删 `chains/<code>.json`。
+- 判定很保守：本节点还在链上、或有任何一个成员节点在线（含刚心跳过），都**不会**删；只清「谁都不在线」的残档。
+- 起因：0.9.9 修好了「台账有本机成员却退不掉」，但还有一种「本机根本没有成员、别的机器早解散了」的残档，之前只能人工删文件（C 盘写入要审批）。
+- 组件版本：跨会话 0.5.1 → **0.5.2**，其余组件不动。
+
+**上一版（0.9.9）**
 
 - **修「幽灵链成员」退不掉**（YOCE_C 2026-10-20 报的坑）：`term_unlink ... all=true` 以前只遍历内存里的 links，遇到「链台账里还留着本终端成员、但 links 已没有这条记录」就永远退不掉（一直回「本终端没有接在特征码上」）。
 - 现在 `all=true` 在 links 为空时也会按 **nodeId** 把本终端在这串码上的成员从台账里摘掉，返回值带 `ghosts`；成员清空时链文件自动删除。
@@ -38,14 +52,9 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 - 显式传 `sessionId` 的行为不变——只退那一个，不动其它会话（笔误不会误删）。
 - 组件版本：跨会话 0.5.0 → **0.5.1**，其余组件不动。
 
-**上一版（0.9.8）**
-
-- **自动重启组件交回维护权**：原负责人会话「自动重启」按机主指示即日起停止改动，`components/restart/**` 暂由插件负责人 `b6aa099b` 直管；新负责人等后续交接时再任命（`MAINTAINERS.md` 的 `modules.restart` 已改，旧负责人记入任期）。
-- 它交回时留了两条观察，已记进 `MAINTAINERS.md` 的「待定事项」，下次动这个组件前先定口径。
-- 只改 `MAINTAINERS.md` / `CHANGELOG.md` / README，代码与组件版本都不动。
-
-**更早（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.8 / 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.8：自动重启组件维护权交回、暂由插件负责人直管；只改文档。
 - 0.9.7：组件版本按机主要求重新定起点（跨会话 v0.5.0 / 跨设备 v0.4.0 / 跨工作区 v0.1.0）。
 - 0.9.6：去掉「跨账号」组件，插件页变成 5 个组件。
 - 0.9.5：组件「跨终端」改名「跨工作区」（跨终端本轮不做）。
@@ -499,7 +508,7 @@ dsh/
   共享盘方式下，谁能写这个目录，谁就能往你的会话里塞话。
 - 文件落地目录可被 agent 读写，`inboxDir` 建议指向专门目录而非系统目录。
 - **谁能改这个插件**：看仓库根目录的 [`MAINTAINERS.md`](./MAINTAINERS.md)。当前负责人是
-  `session-b6aa099b…`（TS-01 / `ts-01-a52535`，自 2026-10-18 00:59），助手是 `session-ccf34a5a…`
+  `session-3195b037…`（「插件—互通插件负责人001」，TS-01 / `ts-01-a52535`，自 2026-10-20 19:55），助手是 `session-ccf34a5a…`
   （同端多会话2，只能按负责人派活改 `lib/*.js`）。其他会话（QQ 会话、别的终端/窗口）默认只读，
   可协助测试与报 bug；**要改代码必须经用户明确点名允许**（见工作区 `AGENTS.md` 第 7 条）。
 

package/components/session/manifest.json

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

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.9'
+export const VERSION = '0.9.11'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {
@@ -544,6 +544,25 @@ export class Bus {
     return { code, removed, found: true }
   }
 
+  /**
+   * 无主台账清理：本节点不在链上、且链上所有成员所属节点都离线 / 过期时，把这串码的本地台账删掉。
+   * 场景：别的机器早就解散了链，本机 links 里也没有它，但 chains/<code>.json 还留着离线成员记录 ——
+   * 以前只能人工删文件（C 盘写入要审批），0.9.10 让 term_unlink all=true 顺手收口。
+   */
+  async dropChainIfOrphan(code, nodeId) {
+    const file = this.chainFile(code)
+    const chain = await readJson(file)
+    if (!chain || !Array.isArray(chain.members)) return { code, dropped: false, reason: 'no-chain' }
+    if (chain.members.some((m) => m.nodeId === nodeId)) return { code, dropped: false, reason: 'self-member' }
+    const nodes = await this.listNodes().catch(() => [])
+    const alive = new Map(nodes.map((n) => [n.nodeId, Number(n.updatedAt) || 0]))
+    const limit = Date.now() - this.cfg.offlineAfterMs * 3
+    const anyAlive = chain.members.some((m) => (alive.get(m.nodeId) || 0) >= limit)
+    if (anyAlive) return { code, dropped: false, reason: 'member-online', members: chain.members.length }
+    await fsp.unlink(file).catch(() => {})
+    return { code, dropped: true, members: chain.members.length }
+  }
+
   /** 剔掉已经不存在的成员（进程退出 / 长时间没心跳） */
   async pruneChain(code, nodes) {
     const chain = await readJson(this.chainFile(code))

package/lib/index.js

@@ -1191,6 +1191,12 @@ class CrossTerm {
           await this.note(`unlinked ${norm} [ghost ${ghost.removed}]`)
           return { ok: true, code: norm, removed: ghost.removed, ghosts: ghost.removed, empty: !!ghost.empty, sessions: [] }
         }
+        // 本终端在台账里也没有成员：如果这串码上的成员全部离线，就当无主台账清掉（0.9.10）
+        const orphan = await this.bus.dropChainIfOrphan(norm, this.nodeId).catch(() => undefined)
+        if (orphan && orphan.dropped) {
+          await this.note(`unlinked ${norm} [orphan chain, ${orphan.members} 个离线成员]`)
+          return { ok: true, code: norm, removed: 0, droppedChain: true, empty: true, sessions: [] }
+        }
       }
       return { ok: false, detail: `本终端${scope.length ? `的会话 ${this.labelOf(scope[0])}` : ''}没有接在特征码「${norm}」上` }
     }

package/package.json

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