dsh-crossterm 0.7.3 → 0.7.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # dsh-crossterm 变更记录
 
+## 0.7.4 — 2026-10-19
+
+### 没写收件人的信封不再卡死：回落「最近活跃会话」
+
+- 现象：0.7.3 的跨设备 `term_send` 只写 `to.device`、不写会话名时，对方中转站收到信却**投不出去** ——
+  `relayDeliver()` 一看收件人列表为空就返回「信封里没有收件人（要填会话名）」，按设计「失败留件」，
+  于是信一直躺在对方 `shared/<设备>/inbox/` 里。实测：本机 17:44 与 17:52 发给 YOCE_C 的两封都还在它 inbox 里、`done/` 是空的。
+- 修法（`lib/index.js` 的 `relayDeliver`）：收件人为空时不再直接失败，改为取本机会话列表里
+  **活跃会话优先、否则第一个**（`const latest = list.find((s) => s && s.active) || list[0]`），
+  用它做收件人并把「（信封没写收件人，按「最近活跃会话」投给「X」）」写进正文；
+  连一个会话都没有时才回「信封里没有收件人，本机也没有可投递的会话」。
+- 效果：别的设备直接 `term_send` 到本机（不指会话）也能进到当前在聊的那个会话；发信侧照旧只写设备名即可。
+- 探针 `probe-relay-fallback.mjs`：5 项全 PASS（fallback 分支、活跃会话优先、无会话明确失败、提示文案、名字回落短号）；
+  `probe-cloud-send.mjs` 24 项不回归。
+- 要不要跟着动手：**要** —— 收信方必须 ≥0.7.4 才能接住「没写收件人」的信；发信方 0.7.3 就够。
+
 ## 0.7.3 — 2026-10-19
 
 ### 跨设备 term_send：本机总线找不到时自动走云端信封

package/README.md

@@ -28,15 +28,13 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做总开关，标题带「（总开关）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.7.3）**
-
-- **跨设备 `term_send` 通了**：本机总线里找不到目标时，自动去云端设备列表里按 nodeId / 终端名找，
-  命中就走云端信封 —— 对方的中转站 20 秒内取走并投进对应会话。回包里会带 `via:"cloud"` 和信封号。
-- **`term_list` 会列出云端设备**：别的机器即使没写本机总线，也会显示成「（云端设备 v0.7.3，在线）N 个会话」，
-  发信前能直接拿到 nodeId / 名字。
-- 匹配规则：先 nodeId、终端名精确，再 nodeId 前缀、名字/主机名包含；同名候选里在线优先、心跳新的优先；本机自动排除。
-- 已知边界：跨设备**一发多投**（`term_broadcast` 走特征码）仍只在本机总线上扩散，云端群发后续再做。
-- 要不要跟着动手：**不用** —— 但两边都要 ≥0.7.3 才能互相 `term_send`。
+**本版更新（0.7.4）**
+
+- **没写收件人的信不再卡住**：别的设备直接 `term_send` 到本机（只写设备名、不指会话）时，收信方会投给
+  **最近活跃的会话**，并在正文注明「信封没写收件人，按最近活跃会话投给 X」；连一个会话都没有才留件。
+- 起因：0.7.3 发信只写设备名，对方 `relayDeliver()` 见收件人为空就判失败、按设计留件 —— 实测两封信在对方 inbox 里躺了半小时。
+- 只改收信侧：发信方 0.7.3 就够，**收信方要 ≥0.7.4**。
+- 要不要跟着动手：**要** —— 至少把收信的那台升上来。
 
 ## 一、安装与卸载
 

package/lib/bus.js

@@ -22,7 +22,7 @@ import os from 'node:os'
 import path from 'node:path'
 import crypto from 'node:crypto'
 
-export const VERSION = '0.7.3'
+export const VERSION = '0.7.4'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/lib/index.js

@@ -816,10 +816,18 @@ class CrossTerm {
 
   /** 中转站投递：把云端收件箱里的一封信投进本机对应会话（按收件人会话名） */
   async relayDeliver({ to, envelope = {}, files = [] }) {
-    const targets = (Array.isArray(to) ? to : String(to || '').split(/[,，;；\s]+/))
+    let targets = (Array.isArray(to) ? to : String(to || '').split(/[,，;；\s]+/))
       .map((s) => String(s || '').trim())
       .filter(Boolean)
-    if (!targets.length) return { ok: false, reason: '信封里没有收件人（要填会话名）' }
+    let fallbackNote = ''
+    if (!targets.length) {
+      // 信封里没写收件人（例如别的设备直接 term_send 到本机、没指会话）→ 投给最近活跃会话
+      const list = this.sessions()
+      const latest = list.find((s) => s && s.active) || list[0]
+      if (!latest) return { ok: false, reason: '信封里没有收件人，本机也没有可投递的会话' }
+      targets = [latest.name || latest.short]
+      fallbackNote = `（信封没写收件人，按「最近活跃会话」投给「${targets[0]}」）`
+    }
     const controller = this.sessionController()
     if (!controller || typeof controller.prompt !== 'function') {
       return { ok: false, reason: '本 Host 没有 sessionController.prompt，中转站只能留件' }
@@ -837,6 +845,7 @@ class CrossTerm {
     const bad = files.filter((f) => !f || !f.local)
     if (bad.length) lines.push('', `（有 ${bad.length} 个附件没下载下来：${bad.map((f) => (f && f.name) || '未知').join('、')}）`)
     lines.push('', `（这封信由云端中转站投递；收件人：${targets.join('、')}。回复用 term_send。）`)
+    if (fallbackNote) lines.push(fallbackNote)
     const text = lines.join('\n')
     const delivered = []
     const failed = []

package/package.json

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