dsh-crossterm 1.0.3 → 1.0.5

package/CHANGELOG.md

@@ -1,3 +1,45 @@
+## 1.0.5 — 2026-10-21
+### 修复：插件卡片「简介 / 更新日志 / 运行日志」消失
+
+- 现象（机主 2026-10-21 报）：插件面板卡片上的插件简介没了，「更新日志」「运行日志」两个按钮也没了。
+- 根因：1.0.3 目录重组把 `lib/web.js` 搬到 `components/ui/lib/web.js`，但 `ROOT` 仍按「上一级」算 ⇒ 只到 `components/ui`；`aboutOf()` 于是读不到 `locale/zh.json` 与 `components/*/manifest.json`，接口 `/crossterm/api/about` 返回 `ok:true` 但 `description`/`changelog` 为空、组件版本全空。卡片渲染条件是 `about && about.changelog`，changelog 空 ⇒ 按钮整块不渲染。
+- 修复：`ROOT` 改成往上三级（真正回到包根）；`/crossterm/api/logs` 本身正常（实测 `ok:true`、120 行），不需要改。
+- 附带修复：`components/terminal/manifest.json` 曾带 UTF-8 BOM（PowerShell 5.1 写回所致），`JSON.parse` 直接抛 ⇒ 组件版本读不到；已去 BOM，并在 `aboutOf()` 里增加 `readJsonFile()` 容忍 BOM。
+- 生效条件：`components/**` 由宿主启动时加载，**必须重启 DSH 才生效**（机主定：随 1.0.5 一起重启）。
+- 回归网：新增 `test/about.test.mjs`，直接问 `aboutOf()` 要「简介 / 更新日志 / 五组件版本」，ROOT 再算错或 manifest 再带 BOM 就会红（此前没有任何测试覆盖这条，1.0.3 才漏出去）。
+
+### 变更：磁盘邮件头按机主口径调整（跨工作区 0.2.4）
+
+- 机主 2026-10-21 直接下令：去掉「发件终端」行；「发件会话」改名「发件人」；其下新增「收件人」行。
+- 落点：`lib/bus.js` `writeMail()` 头部顺序改为「主题 → 特征码（仅链）→ 发件人 → 收件人 → 发件工作区 → 邮件 id → 发出时间 → 附件」；`lib/index.js` `send()→enqueueTo()` 的信封 `to{}` 新增 `sessionLabel`（优先「名字（短号）」，撞车用 idTag，解析不出退回 `labelOf`）。
+- 「发件工作区」保留（机主只要求去掉终端）。
+- 已知限制：接收侧若发件方是旧版本（信封无 `sessionLabel`），发件人一行退化为裸 `sessionId`；跨机老版本兼容不做额外处理。
+- 越界备案：`lib/bus.js` 属跨会话/主负责人范围，本次为机主直接令就地改，已记 `ownership.log` 追认，不回滚。
+
+### 变更：M2 接线落地（mapFanoutResults 进仓库）
+
+- `functions/cloud-ops/cloud/fanout.js` 现含 `mapFanoutResults`（M2 结果映射），落盘基线 31,692 B / `302e5c75`；相对云端候选另补两项：`recipients`（取 `plan.counts.input`）、合并组目标设备版本 <1.0.2 时 `warnings` 记 `v1-degrade`。
+- 形状定稿 v3：`docs/sendmany-result-shape.md`（4,341 B）——行按目标数展开、`summary` 只数成行目标、`expectedReceipts` 单独记信封数、`fallback` 为 `{device,sessionId?,sessionLabel?,reason,dropped[]}`；`plan.failed/skipped` 不并入 `summary`，仍需消费方并列展示。
+- 回归网：`test/map-fanout.test.mjs` 20 组（含 recipients / v1-degrade 新增用例）。
+### 变更：跨设备信封 silent 附加字段（跨设备 0.4.4 内）
+
+- `functions/cloud-ops/cloud/relay.js` `sendEnvelope` 支持 `silent`：**仅 true 时**写 `envelope.silent = true`；未签名附加字段，v1/v2 canonical 串与验签结果逐字节不变；`parseEnvelope` 透传给 `deliver`，由接收端决定是否自动注入。
+- 多目标 + `silent` **本轮不放开**：`sendManyCloud` fail-closed 拒绝（detail：`silent 只支持本机/单目标`），语义等 1.0.6 再议；`docs/sendmany-result-shape.md` 已记「本轮实现约束」。
+
+### 变更：M2 一发多投接线（`sendManyCloud` / `term_send`）
+
+- `lib/index.js` `send()` 接受 `targets` / `toStrict`；解析出多于 1 个目标即走 `sendManyCloud()`：`planFanout`（本终端目标直接拒、带 version）→ 逐组 `groupSendArgs` + `home.send` → `mapFanoutResults` → `{...out, via:'cloud'}`。
+- `term_send` 增加 `targets`（数组）与 `toStrict`，透传 `send()`；**`to` 与 `targets` 同给时拒绝**（`to 与 targets 只能给一个`）。
+- 单目标老路径零改动（含 `to="self"` + `sessionId`）。
+
+### 修复：默认会话失效时不再乱投（跨会话 0.5.7）
+
+- `pickDeliverSession` 第 2 级 `defaultSessionId` 指向**未打开**的会话时，明确返回失败原因（`默认会话『X』当前没打开…`）并按留件重试，不再静默落到第 3/4 级猜测。
+
+### 修复：倒计时窗口在检查点卡住、进度跳 0（自动重启 0.3.46）
+
+- `components/restart/scripts/countdown.html` 的检查点改为异步探测 `busy-check`，删除 2 秒硬截断，零点等结论再关窗；新增 `test/countdown.test.mjs`（假时钟两幕）。
+
 ## 1.0.3 — 2026-10-21
 ### 重构：目录按组件/功能分文件夹（机主指令）
 

package/MAINTAINERS.md

@@ -147,6 +147,33 @@
 4. 发版顺序固定：组件负责人改 → 主负责人预检（`node --check` + 三套测试 + `pnpm pack` 检查残留）→ 主负责人发布 → 次负责人验收 → 结论回写 `STATE`。
 5. 只有主负责人能改 `package.json` / `lib/bus.js` 的 `VERSION` / `CHANGELOG.md` / `README.md` 的版本段 / `MAINTAINERS.md`。
 
+## 任务下发（2026-10-21 机主指令：「任务不一定要全部自己完成，可以按匹配度下发」）
+
+主负责人是**派活的人**，不是唯一的干活的人。凡是能落到某个组件/功能负责人职责范围内的事，一律下发，不自己代做。
+
+| 任务类型 | 匹配给 | 说明 |
+|---|---|---|
+| `components/restart/**` 的改动与自测 | `357e0561` | 含 helper / busy-check / countdown / rearm / trigger / core |
+| `components/device/**`、信封协议、版本门控 | `61b1ec6c` | 协议代码在 `functions/cloud-ops/cloud/{relay,presence}.js`，他提 diff |
+| `components/session/**`、投递路由与收件箱语义 | `d4984f54` | `lib/index.js` 的投递调用点也归他（定点改、落地即报） |
+| `components/terminal/**`、presence 与 `term_list` 展示 | `b71bbc49` | 显示层与解析层都在他范围 |
+| `functions/cloud-ops/**`、网盘与备份链路 | `eb661573` | 该目录唯一落盘人 |
+| 发版后的第二设备验收 | 副手 `yoce-c-4fb38e` | 阻断/建议两栏，不自行发版 |
+| 本机装包后的实装自检、跨机对比 | 兜底 `71734ef7` | 只读为主，不参与写代码与发版 |
+| 打包、版本号、CHANGELOG 定稿、`MAINTAINERS.md`、跨组件取舍、对外代表 | **主负责人保留** | 这些不下发 |
+
+**下发格式**（每封必含五段，缺一段就会被退回来问）：
+
+1. **目标**：要解决什么现象 / 达成什么。
+2. **范围**：允许改哪些文件（含「不许碰」清单）。
+3. **验收**：跑哪几个测试、看哪个字段、期望值是什么。
+4. **约束**：版本号归属、冻结窗口、锚点写法（函数名 + 唯一片段，不用行号）、落地即报。
+5. **回报**：交什么（diff / 自测输出 / 新 sha256 + mtime / 待我拍的点），以及**不需要我回信时直接做**。
+
+**并行纪律**：同一文件同一时间只有一个写者；`lib/index.js` 按「跨工作区 → 跨设备 → 跨会话」排队；跨组件依赖先报主负责人裁决，不许自行扩大范围。
+
+**留痕**：每封任务下发与完成各记一行进 `STATE-0.9.13.md`（下发人、负责人、目标、验收、状态）。
+
 ## 兜底会话（2026-10-20 机主指令：「任命兜底会话为互通插件组的兜底工作」）
 
 `兜底会话` = `session-71734ef7-e18b-496e-a621-054b79b3afa1`（短号 `71734ef7`，TS-01）。它的定位是**尽量不依赖插件**：宿主原生的 `pwsh` / `read` / `write` / `glob` / `grep` 能做的就不走插件，插件整体失效时仍要能值守。

package/README.md

@@ -32,7 +32,17 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 >
 > 重启脚本的调用位置：只从部署副本 `~/.dsh/crossterm/restart-module/` 调（`trigger-restart.mjs` / `busy-check.mjs` / `rearm-watch.mjs` / `dsh-restart-helper.mjs`）。直接跑 `node_modules` 里的副本时，那个目录下没有 `logs/busy-agents.json`，倒计时检查点会判 `unknown` 并取消本次重启 —— 这是预期的 fail-closed，不是缺陷。
 
-**本版更新（1.0.3）**
+**本版更新（1.0.5）**
+
+- **修复：插件卡片「简介 / 更新日志 / 运行日志」消失** —— 1.0.3 目录重组把 `lib/web.js` 搬到 `components/ui/lib/web.js` 后，`ROOT` 只算到 `components/ui`，`aboutOf()` 读不到 `locale/zh.json` 与组件 manifest，接口 `ok:true` 但简介与更新日志为空，卡片整块不渲染。`ROOT` 已回到包根；另加 `readJsonFile()` 容忍 BOM（`components/terminal/manifest.json` 曾带 BOM）。新增 `test/about.test.mjs` 覆盖。
+- **变更：磁盘邮件头按机主口径** —— 去掉「发件终端」，`发件会话` 改「发件人」，其下新增「收件人」行，「发件工作区」保留。
+- **跨设备：信封 `silent` 附加字段** —— `sendEnvelope` 仅在 `true` 时写 `envelope.silent`，不参与签名；收端透传给 `deliver`。多目标 + `silent` 本轮仍 fail-closed 拒绝。
+- **M2 一发多投接线** —— `send()` 接受 `targets` / `toStrict`，多于 1 个目标走 `sendManyCloud()`（`planFanout` → 逐组发送 → `mapFanoutResults`）；`term_send` 增 `targets` / `toStrict`；形状按 `docs/sendmany-result-shape.md` v3（`recipients` 数目标、`expectedReceipts` 数信封）。
+- **跨会话 0.5.7：默认会话失效 fail-closed** —— `pickDeliverSession` 第 2 级遇到 `defaultSessionId` 指向未打开的会话时明确报错并留件重试，不猜会话。
+- **自动重启 0.3.46：倒计时不再「卡住跳 0」** —— 检查点异步探测 `busy-check`、删 2 秒硬截断、零点等结论；新增 `test/countdown.test.mjs`。
+- 组件版本：跨会话 **0.5.7**、跨工作区 **0.2.4**、跨设备 **0.4.4**、自动重启 **0.3.46**、入口 **0.9.3**；`test/` 下 **15 个** `*.test.mjs`，本版 **15/15 全绿**。
+
+**上一版（1.0.3）**
 
 - **修复：换台机器就重启不了（第二设备验收 B1）** —— 桌面端的 web 端口是动态的，helper / 倒计时窗 / `rearm-watch` 由 mshta 或 WMI 拉起时拿不到 `DSH_WEB_URL`，端口退回 19387 → `waitUp` 永远判失败 → 把刚拉起来的健康实例杀掉再拉一次，一次重启变两次还报错。现在 `trigger` 把 `resolveWebPort()` 写进 `request.webPort`，helper 用 `applyWebPort(req)` 优先取请求里的端口（日志写 `port=19387 (request)`），`busy-check` / `rearm-watch` 认 `--port` 一路透传。顺带修 taskkill 输出在中文系统上的 GBK 乱码。
 - **重构：目录按组件/功能分文件夹（机主指令）** —— `lib/cloud/**` → `functions/cloud-ops/cloud/**`，`lib/web.js` → `components/ui/lib/web.js`；`lib/` 只剩宿主入口 `index.js` 与共享核心 `bus.js` / `logs.js` / `names.js`。`MAINTAINERS.md` 新增「目录归属」表与硬规矩（新功能一律 `functions/<名字>/`，越界即误改）。

package/components/device/manifest.json

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

package/components/restart/manifest.json

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

package/components/restart/scripts/countdown.html

@@ -300,9 +300,15 @@ function fitWindow() {
   // 忙 → 删 request.json 自动取消本次重启、窗口转后台，并拉起 rearm-watch.mjs；
   // 它等连续 5 s 无其他会话活动后，再用 trigger 重新排一次（delay 由 rearm 派生 max(15, quiet+10)，
   // 这里不再写死 15，两个检查点必须放得进新窗口）。
+  //
+  // 0.3.46：探测必须**异步**拉起。旧实现是同步等待（`sh.Run` 第三个参数为 true），而 busy-check
+  // 要先攒够 3 s 连续静默（quiet 默认 3 s）才出结论 —— 等于把最后 5 s 整段冻住；回到窗口时已过
+  // 零点，屏幕从 5 直接跳到 00:00（机主报的「5 s 卡顿一下直接跳 0」）。现在改成异步拉起
+  // + 每拍轮询结果文件，窗口继续走秒；到零点还没结论就停在 00:00 等结论（最多再等 ~10 s）。
   var CP10 = BASE + "\\logs\\busy-10s.json", CP5 = BASE + "\\logs\\busy-5s.json";
   var cp10 = false, cp5 = false;
   var selfId = req.selfSessionId || req.sessionId || "";
+  var pend = null;   // 正在跑的探测：{ tag, out, at, maxWaitMs }
 
   // B1：mshta 不继承宿主环境，端口只能从 request.json 里取；没写就不加参数（内部再回退 env/19387）。
   function portArg() {
@@ -310,12 +316,45 @@ function fitWindow() {
     return (p > 0 && p < 65536) ? ' --port ' + p : '';
   }
 
-  function probeBusy(maxWaitSec, out) {
+  function probeCmd(maxWaitSec, out) {
+    return '"' + (req.nodeExe || "node") + '" "' + BASE + '\\busy-check.mjs" --self "' + selfId +
+           '" --max-wait ' + maxWaitSec + ' --out "' + out + '"' + portArg();
+  }
+
+  function startProbe(tag, maxWaitSec, out) {
     try { if (fso.FileExists(out)) fso.DeleteFile(out, true); } catch (e) {}
-    var cmd = '"' + (req.nodeExe || "node") + '" "' + BASE + '\\busy-check.mjs" --self "' + selfId +
-              '" --max-wait ' + maxWaitSec + ' --out "' + out + '"' + portArg();
-    try { sh.Run(cmd, 0, true); } catch (e) { dbg("probe err " + e.message); return null; }
-    return readJson(out);
+    try { sh.Run(probeCmd(maxWaitSec, out), 0, false); }
+    catch (e) { dbg("probe " + tag + " spawn err " + e.message); return false; }
+    pend = { tag: tag, out: out, at: Date.now(), maxWaitMs: Math.max(0, Number(maxWaitSec) || 0) * 1000 };
+    dbg("probe " + tag + " spawned");
+    return true;
+  }
+
+  // 每拍调一次：出结论返回 { tag, res, waitedMs }，还在跑返回 null。
+  // 超时（比 busy-check 自己的 max-wait 再多 10 s）当「没结论」，沿用旧口径：不误取消。
+  function pollProbe() {
+    if (!pend) return null;
+    var res = readJson(pend.out);
+    if (res) { var p = pend; pend = null; return { tag: p.tag, res: res, waitedMs: Date.now() - p.at }; }
+    if (Date.now() - pend.at > pend.maxWaitMs + 10000) {
+      var q = pend; pend = null;
+      dbg("probe " + q.tag + " timeout");
+      return { tag: q.tag, res: null, timeout: true };
+    }
+    return null;
+  }
+
+  function handleProbe(got) {
+    if (!got) return;
+    if (got.tag === "10s") {
+      if (got.res && got.res.ok === false && got.res.busy && got.res.busy.length) { toBackground(got.res.busy, "10s"); return; }
+      if (got.res) { dbg("cp10 idle -> keep counting"); el("hint").textContent = "10 秒检查：其他会话都空闲，继续重启"; }
+      else dbg("cp10 no result");
+      return;
+    }
+    if (got.res && got.res.ok === true) { dbg("cp5 idle -> keep counting (" + got.waitedMs + "ms)"); el("hint").textContent = "其他会话已空闲，继续重启"; return; }
+    if (got.res) { toBackground(got.res.busy, "5s"); return; }
+    dbg("cp5 no result -> keep counting");
   }
 
   function toBackground(busy, tag) {
@@ -337,22 +376,6 @@ function fitWindow() {
     setTimeout(closeWin, 2800);
   }
 
-  function checkpoint10() {
-    var res = probeBusy(0, CP10);
-    if (!res) { dbg("cp10 no result"); return; }
-    if (res.ok === false && res.busy && res.busy.length) { toBackground(res.busy, "10s"); return; }
-    dbg("cp10 idle -> keep counting");
-    el("hint").textContent = "10 秒检查：其他会话都空闲，继续重启";
-  }
-
-  function checkpoint5() {
-    el("hint").textContent = "5 秒检查：等其他会话空闲（最多 15 秒）…";
-    var res = probeBusy(15, CP5);
-    if (!res) { dbg("cp5 no result"); return; }
-    if (res.ok === true) { dbg("cp5 idle -> keep counting"); el("hint").textContent = "其他会话已空闲，继续重启"; return; }
-    toBackground(res.busy, "5s");
-  }
-
   el("now").onclick = function () {
     if (done || spawned) return;
     if (req.dryRun === true) { bail("试运行没有真实重启", "warn", 1600); return; }
@@ -377,43 +400,46 @@ function fitWindow() {
 
     if (!fso.FileExists(REQ) && !spawned) { bail("已取消：DSH 不会重启", "warn", 1600); return; }
 
-    // 检查点只在「还没拉 helper、还在倒计时、且没有 force」时跑
-    if (!done && !spawned && left > 0 && req.force !== true) {
-      // 短窗口（delay < 12 s）跳过 10 s 检查点：否则它在倒计时刚开始就开火，和 5 s 检查点挤在一起，
-      // 等于白做两次探测、还多两个 busy-check 进程。
-      if (!cp10 && MAX > 12000 && left <= 10000 && left > 5000) { cp10 = true; checkpoint10(); }
-      else if (!cp5 && left <= 5000) { cp5 = true; checkpoint5(); }
-      if (done) return;
+    // 检查点只在「还没拉 helper、还在倒计时、且没有 force」时开火。
+    // 短窗口（delay < 12 s）跳过 10 s 检查点：否则它在倒计时刚开始就开火，和 5 s 检查点挤在一起，
+    // 等于白做两次探测、还多两个 busy-check 进程。
+    if (!spawned && left > 0 && req.force !== true) {
+      if (!cp10 && MAX > 12000 && left <= 10000 && left > 5000) { cp10 = true; startProbe("10s", 0, CP10); }
+      else if (!cp5 && left <= 5000) { cp5 = true; startProbe("5s", 15, CP5); }
     }
+    if (pend) handleProbe(pollProbe());   // 探测结果每拍收一次，窗口不再冻结
+    if (done) return;
 
-    if (left > 2000) {
+    // 走秒：最后 2 s 也照常显示（旧版在 left ≤ 2 s 就直接钉 00:00，看起来同样像「跳 0」），到 0 才停住。
+    if (left > 0) {
       el("clock").textContent = mmss(left / 1000);
       el("fill").style.width = Math.max(0, Math.min(100, (left / MAX) * 100)) + "%";
-      return;
+    } else {
+      el("clock").textContent = "00:00";
+      el("fill").style.width = "0%";
+    }
+
+    // 剩 2 s 拉起 helper（保留原来的提前量）；但探测还没出结论就先停在 00:00 等，别抢跑。
+    if (left <= 2000 && !spawned) {
+      if (pend) { el("hint").textContent = "正在确认其他会话是否空闲…"; return; }
+      if (!zeroAt) zeroAt = Date.now();
+      spawnHelper();
     }
-    if (!spawned) { el("clock").textContent = "00:00"; el("fill").style.width = "0%"; zeroAt = Date.now(); spawnHelper(); }
 
     // 归零后先停在 00:00 等 helper 真动手（守卫可能还在等空闲），
     // 只有 helper 进入 killing/starting 才切正计时 + 转圈，避免“倒计时没读完就开始 +”。
-    var u = readJson(UI);
+    var u = spawned ? readJson(UI) : null;
     var phase = u && u.phase ? String(u.phase) : "";
     var killing = phase === "killing" || phase === "starting";
-    if (zeroAt && !done) {
-      if (killing) {
-        el("clock").textContent = "+" + mmss((Date.now() - zeroAt) / 1000);
-        if (el("fill").style.display !== "none") {
-          el("fill").style.display = "none";
-          var bar = el("bar");
-          if (bar) bar.className = "bar off";
-          var sp = el("spin");
-          if (sp) sp.className = "spin on";
-          dbg("spinner on");
-        }
-      } else {
-        el("clock").textContent = "00:00";
-        if (el("fill").style.display !== "none") {
-          el("fill").style.width = "0%";
-        }
+    if (zeroAt && !done && killing) {
+      el("clock").textContent = "+" + mmss((Date.now() - zeroAt) / 1000);
+      if (el("fill").style.display !== "none") {
+        el("fill").style.display = "none";
+        var bar = el("bar");
+        if (bar) bar.className = "bar off";
+        var sp = el("spin");
+        if (sp) sp.className = "spin on";
+        dbg("spinner on");
       }
     }
 
@@ -422,7 +448,7 @@ function fitWindow() {
     else if (phase === "waiting") el("hint").textContent = "等待其他会话空闲后重启…";
     else if (zeroAt && !killing) el("hint").textContent = "倒计时结束，正在准备重启…";
 
-    var r = readJson(RES);
+    var r = spawned ? readJson(RES) : null;
     var when = r ? Date.parse(r.finishedAt || r.at || "") : NaN;
     if (r && !isNaN(when) && when >= spawnedAt - 2000) {
       if (r.ok === true && r.dryRun === true) { bail("试运行完成：进程未被结束", "warn", 2200); return; }

package/components/restart/scripts/trigger-restart.mjs

@@ -5,6 +5,7 @@
 // 用法：
 //   node trigger-restart.mjs --delay 45 [--note "说明"] [--dry-run]
 //   node trigger-restart.mjs --cancel
+//   node trigger-restart.mjs --print-log-dir   （只打印解析到的日志目录，不建目录、不排程）
 //
 // 退出码：0 已排程 / 3 已有 helper 在跑 / 4 request.json 写失败 / 5 WMI 拉起失败 / 6 参数错误
 import fs from 'node:fs';
@@ -15,9 +16,54 @@ import { fileURLToPath } from 'node:url';
 import { waitQuiet, resolveWebPort } from './busy-check.mjs';
 
 const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
-const LOGS_DIR = path.join(MODULE_DIR, 'logs');
+
+// 0.3.45：日志目录不再默认落在脚本旁边。从仓库直跑 trigger 时旧写法会把 logs/ 写进待打包树
+// （1.0.0 就因此混进过 45 个文件）。候选顺序 = DSH_RESTART_MODULE_DIR → 当前工作目录（生产环境
+// core.runTrigger 以部署副本为 cwd）→ 脚本所在目录；每个候选都必须不在插件仓库内，全不合格就
+// 整体不写日志、只在 stderr 提示——绝不回落到仓库内路径。
+function pluginRepoRoot(startDir) {
+  let cur = path.resolve(startDir);
+  for (;;) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(cur, 'package.json'), 'utf8'));
+      if (pkg && pkg.name === 'dsh-crossterm') return cur;
+    } catch { /* 这一层没有 package.json，继续往上 */ }
+    const up = path.dirname(cur);
+    if (up === cur) return '';
+    cur = up;
+  }
+}
+
+function insideOrEqual(child, parent) {
+  const c = path.resolve(child).toLowerCase();
+  const p = path.resolve(parent).toLowerCase();
+  return c === p || c.startsWith(p + path.sep);
+}
+
+function resolveLogsDir(rawEnv, cwdDir) {
+  const repoRoot = pluginRepoRoot(MODULE_DIR);
+  const rejected = [];
+  for (const raw of [rawEnv, cwdDir, MODULE_DIR]) {
+    const v = String(raw || '').trim();
+    if (!v) continue;
+    const abs = path.resolve(cwdDir, v);
+    if (repoRoot && insideOrEqual(abs, repoRoot)) { rejected.push(`${abs} (在插件仓库内，拒绝)`); continue; }
+    return path.join(abs, 'logs');
+  }
+  console.error(rejected.length
+    ? `[trigger] 没有合规的日志目录：${rejected.join('; ')}；本次不写日志`
+    : '[trigger] 没有可用的日志目录（未设 DSH_RESTART_MODULE_DIR）；本次不写日志');
+  return '';
+}
+
+const LOGS_DIR = resolveLogsDir(process.env.DSH_RESTART_MODULE_DIR, process.cwd());
+// 排障/单测用：只打印解析结果，不建目录、不排程。
+if (process.argv.includes('--print-log-dir')) {
+  console.log(LOGS_DIR || '');
+  process.exit(0);
+}
 const REQUEST_FILE = path.join(MODULE_DIR, 'request.json');
-const PID_FILE = path.join(LOGS_DIR, 'helper.pid');
+const PID_FILE = LOGS_DIR ? path.join(LOGS_DIR, 'helper.pid') : '';
 const RUN_CMD = path.join(MODULE_DIR, 'run-helper.cmd');
 const UI_FILE = path.join(MODULE_DIR, 'countdown.html');
 // helper 用真 node 拉起（不是 Electron 宿主），所以这里必须解析出一个真实存在的 node.exe。
@@ -75,6 +121,7 @@ function alive(pid) {
 }
 
 function helperStillRunning() {
+  if (!PID_FILE) return 0;
   try {
     const pid = Number(fs.readFileSync(PID_FILE, 'utf8').trim());
     if (!pid || !alive(pid)) return 0;
@@ -84,27 +131,33 @@ function helperStillRunning() {
 }
 
 const opts = parseArgs(process.argv.slice(2));
-fs.mkdirSync(LOGS_DIR, { recursive: true });
+if (LOGS_DIR) fs.mkdirSync(LOGS_DIR, { recursive: true });
 
 if (opts.cancel) {
   // 撤请求 + 杀掉还在等待的 helper（helper 自己也会在 500ms 内发现文件消失并作废，双保险）
   let killed = null;
-  try {
-    const pid = Number(String(fs.readFileSync(PID_FILE, 'utf8')).trim());
-    if (Number.isFinite(pid) && pid > 0) {
-      try { execFileSync('taskkill', ['/F', '/PID', String(pid)], { windowsHide: true }); killed = pid; } catch {}
-    }
-  } catch {}
-  try { fs.unlinkSync(PID_FILE); } catch {}
-  try { fs.unlinkSync(REQUEST_FILE); } catch {}
-  if (killed) {
+  if (PID_FILE) {
     try {
-      fs.writeFileSync(path.join(LOGS_DIR, 'result.json'), JSON.stringify({
-        ok: false, dryRun: false, reason: 'cancelled', by: 'trigger-cancel',
-        at: new Date().toISOString(), helperPid: killed,
-      }, null, 2), 'utf8');
+      const pid = Number(String(fs.readFileSync(PID_FILE, 'utf8')).trim());
+      if (Number.isFinite(pid) && pid > 0) {
+        try { execFileSync('taskkill', ['/F', '/PID', String(pid)], { windowsHide: true }); killed = pid; } catch {}
+      }
     } catch {}
   }
+  if (PID_FILE) { try { fs.unlinkSync(PID_FILE); } catch {} }
+  try { fs.unlinkSync(REQUEST_FILE); } catch {}
+  if (killed) {
+    if (!LOGS_DIR) {
+      console.error(`[trigger] 已取消 helper ${killed}，但日志目录不可用，result.json 未落盘`);
+    } else {
+      try {
+        fs.writeFileSync(path.join(LOGS_DIR, 'result.json'), JSON.stringify({
+          ok: false, dryRun: false, reason: 'cancelled', by: 'trigger-cancel',
+          at: new Date().toISOString(), helperPid: killed,
+        }, null, 2), 'utf8');
+      } catch {}
+    }
+  }
   console.log(killed ? `cancelled: helper ${killed} killed + request.json removed` : 'cancelled: request.json removed');
   process.exit(0);
 }
@@ -189,6 +242,7 @@ function wmiCreate(commandLine) {
 // 倒计时窗口要贴在 DSH 窗口正中间（而不是屏幕正中）：先取一次 DSH 主窗口矩形写到 logs\ui-geom.json，
 // 窗口那边读它定位。拿不到就写 {}，窗口自动回退成屏幕居中。
 function writeWindowGeom() {
+  if (!LOGS_DIR) return {};
   const out = path.join(LOGS_DIR, 'ui-geom.json');
   let geom = {};
   try {
@@ -277,5 +331,5 @@ if (!spawnPid) { console.error('WMI create 未返回 ProcessId'); process.exit(5
 console.log(`WMI create ok; ${via} pid=${spawnPid}`);
 if (via === 'node') console.log('无界面兜底：窗口没起来，已直接拉起 node helper（到点照样杀进程重拉；取消用 dsh_restart action=cancel）');
 console.log(`已排程：${new Date(now + opts.delay * 1000).toISOString()} 杀 DSH 并重拉（dryRun=${opts.dryRun}）`);
-console.log(`日志目录：${LOGS_DIR}`);
+console.log(`日志目录：${LOGS_DIR || '(不写日志：没有合规目录)'}`);
 process.exit(0);

package/components/session/manifest.json

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

package/components/terminal/manifest.json

@@ -1,5 +1,5 @@
 {
   "name": "跨工作区",
   "description": "在本机不同工作区、不同会话之间互发邮件与文件（跨终端本轮不做，暂无条件）",
-  "version": "0.2.2"
+  "version": "0.2.4"
 }

package/components/terminal/selftest.mjs

@@ -1,19 +1,23 @@
 /**
- * 跨工作区组件自测（terminal 0.2.2）
+ * 跨工作区组件自测（terminal 版本取自 components/terminal/manifest.json，不写死）
  *   1) term_list / term_whoami 的渲染里必须带 8 位短号（以前有名字就把短号吞掉，
  *      事故里"找会话 id 得去翻 presence 文件"就是这个坑）
  *   2) 同终端投递必须把目标会话钉死（复用 pickDeliverSession）：短名、显示名、完整 id
  *      都能投；打错、有歧义、宿主也不认识的一律当场报错并列候选
  *   3) 宿主认识但当前没打开的会话仍放行（留给投递侧 resume）
- *   4) 目标终端心跳超过 3 分钟：仍可发、仍回 ok:true，但必须带 offline 示警
+ *   4) 目标终端心跳超过 3 分钟（3–9 分钟窗口）：仍可发、仍回 ok:true，但必须带 offline 示警，
+ *      且这档不能被回收——回收期 9 分钟（PRESENCE_CLEANUP_MS）必须显著长于展示阈值，否则离线档看不见
  *   5) term_list 显示 defaultSessionId=<值|未设>、离线节点标「离线：presence 已 N 分钟未更新」
  *
  * 运行：node --import ./test/register.mjs components/terminal/selftest.mjs
  */
-import realAssert from 'node:assert/strict'
+import realAssert from 'node:assert/strict'
+import fs from 'node:fs'
 import fsp from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
+
+const MANIFEST_VERSION = JSON.parse(fs.readFileSync(new URL('./manifest.json', import.meta.url), 'utf8').replace(/^/, '')).version
 
 // 运行时统计真正执行过的断言数（以前手写「22 项 / 28 项」跟脚本对不上，被主负责人抓过三次；
 // 现在数字是量出来的：静态 assert.* 调用 + 循环里的多次执行都算）
@@ -124,6 +128,7 @@ const listText = text(listed)
 assert.match(listText, /组件—跨工作区负责人001（acme1111）/, '本终端会话行必须带 8 位短号')
 assert.match(listText, /组件—跨会话负责人001（acme2222）/, '其它会话行也必须带短号')
 assert.match(listText, /★当前/, '调用方自己那条要标 ★当前')
+assert.doesNotMatch(listText, /◆默认投递/, '未设置默认投递时不出现 ◆默认投递')
 
 const who = await tool('term_whoami').execute({})
 assert.match(render('term_whoami', who), /（acme2222）/, 'whoami 也带短号')
@@ -133,11 +138,26 @@ const send = (sessionId, extra = {}) => tool('term_send').execute({ to: 'self',
 
 const byShort = await send('acme2222')
 assert.equal(byShort.ok, true, byShort.detail)
+// 1.0.4 / P3：回执要带「真正钉住的会话」，名字 + 短号
+assert.match(byShort.detail, /的会话「组件—跨会话负责人001（acme2222）」/, '回执要带钉住的会话名和短号')
 let queue = await pendingOf()
 assert.equal(queue.length, 1)
 assert.equal(queue[0].to.nodeId, me.nodeId)
 assert.equal(queue[0].to.sessionId, ID_B, '短名必须展开成完整会话 id')
 
+// ── 2b. 磁盘邮件头（机主 2026-10-21 要求）：去「发件终端」，「发件会话」改「发件人」，其下加「收件人」──
+// .md 由 mailView → bus.writeMail 在**投递时**写；这里没有自动投递，就直接拿入队信封喂 writeMail，
+// 既验证我把收件人显示名塞进信封，也验证 mail.js 的渲染顺序。
+const pinnedMail = queue[0]
+assert.equal(pinnedMail.to.sessionLabel, '组件—跨会话负责人001（acme2222）', '收件人显示名要随信封走')
+const shortMail = await fsp.readFile(bus.writeMail(pinnedMail, '自测：短名寻址'), 'utf8')
+assert.ok(!/发件终端/.test(shortMail), '磁盘邮件头不应再有「发件终端」')
+assert.ok(!/- 发件会话：/.test(shortMail), '「发件会话」应改名为「发件人」')
+assert.match(shortMail, /^- 发件人：\S/m, '发件人要有显示名')
+assert.match(shortMail, /^- 收件人：组件—跨会话负责人001（acme2222）$/m, '发件人下面要有收件人，解析成会话名+短号')
+assert.ok(shortMail.indexOf('- 发件人：') < shortMail.indexOf('- 收件人：'), '收件人必须在发件人下面')
+assert.ok(shortMail.indexOf('- 收件人：') < shortMail.indexOf('- 邮件 id：'), '收件人要在邮件 id 之前')
+
 const byName = await send('组件—跨会话负责人001')
 assert.equal(byName.ok, true, byName.detail)
 queue = await pendingOf()
@@ -183,11 +203,20 @@ queue = await pendingOf()
 assert.equal(queue.length, 6)
 assert.equal(queue[5].to.sessionId, ID_GHOST, '短名寻址必须换成完整 id 再入队')
 
-// ── 4. 回归：发给别的终端不受影响 ───────────────────────────────────────
-await bus.beat({ nodeId: 'node-b', name: 'selftest-B', hostname: os.hostname(), sessions: [] })
+// ── 4. 回归：发给别的终端不受影响；远端默认投递标记同规则（P2） ──────────
+const ID_REMOTE = 'session-remb7777-0000-4000-8000-000000000007'
+await bus.beat({
+  nodeId: 'node-b',
+  name: 'selftest-B',
+  hostname: os.hostname(),
+  sessions: [{ id: ID_REMOTE, name: '远端会话', short: 'remb7777', active: false }],
+  defaultSessionId: ID_REMOTE,
+})
 const remote = await tool('term_send').execute({ to: 'selftest-B', text: '跨终端' })
 assert.equal(remote.ok, true, remote.detail)
 assert.equal((await bus.listPending('node-b')).length, 1)
+const remoteMail = await fsp.readFile(bus.writeMail((await bus.listPending('node-b'))[0], '自测：跨终端'), 'utf8')
+assert.match(remoteMail, /^- 收件人：未指定（等兜底路由）$/m, '没指定会话的跨终端邮件也要有收件人行')
 
 // 本终端不带 sessionId 仍要明确拒绝（老规矩）
 const noSession = await tool('term_send').execute({ to: 'self', text: '发给当前会话' })
@@ -212,11 +241,16 @@ assert.equal(reloaded.ok, true, reloaded.detail)
 
 const whoDefault = await tool('term_whoami').execute({})
 assert.equal(whoDefault.defaultSessionId, ID_A, '配置的是短名，presence 里必须写完整 id')
+const withDefault = render('term_list', await tool('term_list').execute({}))
 assert.match(
-  render('term_list', await tool('term_list').execute({})),
-  new RegExp(`defaultSessionId=${ID_A}（组件—跨工作区负责人001 / acme1111）`),
+  withDefault,
+  new RegExp(`defaultSessionId=${ID_A}（组件—跨工作区负责人001（acme1111））`),
   'term_list 要能看见默认会话是谁',
 )
+// P2：本终端与远端都按同一规则出 ◆默认投递，且和 ★当前 并存
+assert.match(withDefault, /组件—跨工作区负责人001（acme1111） ★当前 ◆默认投递/, '默认投递会话要标 ◆默认投递')
+assert.match(withDefault, /远端会话（remb7777） ◆默认投递/, '远端节点同样规则标 ◆默认投递')
+assert.match(withDefault, new RegExp(`defaultSessionId=${ID_REMOTE}（远端会话（remb7777））`), '远端也要显示默认会话')
 
 // ── 6. 离线目标（0.2.2 / 主负责人 15:11 口径）：照样发，但必须示警 ──────
 const ID_STALE = 'session-sle33333-0000-4000-8000-000000000003'
@@ -229,7 +263,7 @@ await fsp.writeFile(
     workspace: 'F:\\ws-stale',
     pid: 1,
     version: '0.9.13',
-    updatedAt: Date.now() - 11 * 60 * 1000, // 11 分钟没心跳 → 离线
+    updatedAt: Date.now() - 5 * 60 * 1000, // 5 分钟没心跳 → 落在 3–9 分钟「离线但未回收」窗口
     sessions: [{ id: ID_STALE, name: '离线会话', short: 'sle33333', active: false }],
   }),
   'utf8',
@@ -237,13 +271,71 @@ await fsp.writeFile(
 const offlineSend = await tool('term_send').execute({ to: 'selftest-C', text: '发给离线终端' })
 assert.equal(offlineSend.ok, true, '离线也必须 ok:true（否则云端 relay 会反复退避）')
 assert.equal(offlineSend.offline, true, '必须带 offline 示警')
-assert.ok(offlineSend.presenceAgeMs >= 10 * 60 * 1000, '要带 presenceAgeMs')
+assert.ok(
+  offlineSend.presenceAgeMs >= 3 * 60 * 1000 && offlineSend.presenceAgeMs < 9 * 60 * 1000,
+  '要带 presenceAgeMs，且落在 3–9 分钟的「离线但未回收」窗口',
+)
 assert.match(offlineSend.detail, /离线/, '文案要说明目标离线')
 assert.match(offlineSend.detail, /分钟未更新/, '文案要给出多久没心跳')
 assert.match(offlineSend.detail, /收件箱/, '要说明消息留在对方收件箱')
 assert.equal((await bus.listPending('node-stale')).length, 1, '离线消息仍要入队，不许丢')
+// 回收期 9 分钟（PRESENCE_CLEANUP_MS）：5 分钟的 stale 节点必须还在。
+// 0.9.x 里回收是 60 秒，节点会从「在线」直接跳到「消失」，3 分钟离线档永远看不见。
+await bus.cleanupStale()
+assert.ok(
+  await fsp.stat(path.join(sandbox, 'crossterm', 'presence', 'node-stale.json')).then(() => true, () => false),
+  '5 分钟 stale 的 presence 必须还在（cleanupStale 阈值 9 分钟，跨工作区 001 报的老缝隙）',
+)
 
 const staleList = render('term_list', await tool('term_list').execute({}))
-assert.match(staleList, /「selftest-C」.*（离线：presence 已 \d+ 分钟未更新，仍可发，消息留它收件箱）/, 'term_list 要显式标离线')
+// P2：离线行补「约 N 分钟后从列表回收」（回收 9 分钟、展示 3 分钟，别让发送方以为它一直挂着）
+assert.match(
+  staleList,
+  /「selftest-C」.*（离线：presence 已 \d+ 分钟未更新，仍可发，消息留它收件箱；约 \d+ 分钟后从列表回收）/,
+  'term_list 要显式标离线，并预告回收时间',
+)
+
+// ── 7. 短号撞车（1.0.4 / P1·P4）─────────────────────────────────────────
+// dsh-automation-session-<uuid> 短号全塌成 dsh：旧实现 find(short===lower) 静默钉第一个。
+const AUTO = [
+  'dsh-automation-session-230a1668-1111-4000-8000-000000000011',
+  'dsh-automation-session-31bb2779-2222-4000-8000-000000000012',
+  'dsh-automation-session-42cc388a-3333-4000-8000-000000000013',
+  'dsh-automation-session-53dd499b-4444-4000-8000-000000000014',
+  'dsh-automation-session-64ee5aac-5555-4000-8000-000000000015',
+]
+for (const id of AUTO) agents.set(id, makeAgent(id))
+const tags = ['230a1668', '31bb2779', '42cc388a', '53dd499b', '64ee5aac']
+
+const collided = render('term_list', await tool('term_list').execute({}))
+for (const tag of tags) assert.match(collided, new RegExp(`dsh（${tag}）`), `撞车的自动化会话必须用 8 位段区分：${tag}`)
+
+const ambiguousShort = await send('dsh')
+assert.equal(ambiguousShort.ok, false, '5 个短号都是 dsh 时必须报歧义，不许静默钉第一个')
+assert.match(ambiguousShort.detail, /多个候选/)
+for (const tag of tags) assert.match(ambiguousShort.detail, new RegExp(tag), `候选必须列全，包含 ${tag}`)
+
+// 渲染出来的 8 位段必须可直接寻址（否则「看得见、发不进去」）
+const byTag = await send(tags[2])
+assert.equal(byTag.ok, true, byTag.detail)
+assert.equal((await pendingOf()).slice(-1)[0].to.sessionId, AUTO[2], 'idTag 寻址要落到对应会话')
+
+// defaultSessionId 撞车时也不许归一（返回原样，让消费方 fail-closed）
+await fsp.writeFile(
+  path.join(sandbox, 'crossterm', 'config.json'),
+  JSON.stringify({ defaultSessionId: 'dsh' }),
+  'utf8',
+)
+await tool('term_config').execute({ inboxDir: '' })
+assert.equal((await tool('term_whoami').execute({})).defaultSessionId, 'dsh', '撞车的默认会话不许归一成第一个')
+
+// ── 8. P4：候选超 20 条才截断 ────────────────────────────────────────────
+for (let i = 0; i < 16; i += 1) {
+  const tag = (0x70000000 + i).toString(16).padStart(8, '0')
+  agents.set(`dsh-automation-session-${tag}-6666-4000-8000-0000000001${String(i).padStart(2, '0')}`, makeAgent(`dsh-automation-session-${tag}-6666-4000-8000-0000000001${String(i).padStart(2, '0')}`))
+}
+const tooMany = await send('zzzz9999')
+assert.equal(tooMany.ok, false, '查无此会话必须失败')
+assert.match(tooMany.detail, /等 \d+ 个（用 term_list 看全量）/, '超过 20 条要截断并提示 term_list')
 
-console.log(`terminal 0.2.2 自测通过：${assertionCount} 项断言（term_list/whoami 短号与 defaultSessionId、短名/显示名/完整 id 钉死、歧义与查无报错并列候选、ghost 放行、离线示警与入队、跨终端回归）`)
+console.log(`terminal ${MANIFEST_VERSION} 自测通过：${assertionCount} 项断言（短号/idTag 渲染与寻址、撞车报歧义列全候选、默认投递标记、回执带钉住会话、离线示警与回收预告、候选截断、跨终端回归）`)