dsh-crossterm 0.7.2 → 0.7.4

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # 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：本机总线找不到时自动走云端信封
+
+- 背景：0.7.2 把总线镜像默认关掉之后，`term_send` 只能看见本机总线里的节点，**跨设备发信会直接报「找不到终端」**；
+  收信侧（云端中转站）本来就是好的，缺的是发信侧的出口。（实测：YOCE_C 0.7.1 来信能进会话，回信只能手工写信封。）
+- 新文件 `lib/cloud/match.js`（纯函数）：`normTarget()`、`matchDevice(devices, raw, { selfId })` —— 先 nodeId / 终端名精确，
+  再 nodeId 前缀 / 名字或主机名包含；同名候选里在线的优先、心跳新的优先；`selfId` 把本机排除掉。`deviceRow(device)` 把云端设备变成 `term_list` 的一行（`cloud:true`、`sessionCount`）。
+- `lib/index.js`：`term.send()` 在 `resolveNode()` 落空时改为查 `cloudDevice(target)`（`home.devices()` + `matchDevice`，
+  排除本机），命中就走新的 `sendViaCloud()` → `home.send({toDevice, toSession, text, files, subject, from})`；
+  回包带 `via:'cloud'`、`mailId`、`to`，提示「对方中转站 20 秒内取走」。找不到才报错，文案区分「本机总线没有 / 云端设备也没有」。
+- `term_list`：本地节点之外补上云端设备（同 nodeId 不重复），渲染成「（云端设备 v0.7.3，在线）N 个会话」；
+  这样跨设备发信前能直接看到目标 nodeId/名字。
+- 工具描述同步：`term_send` 说明「别的机器（云端设备）也认」；`term_list` 说明含云端设备。
+- 探针 `probe-cloud-send.mjs`：**24 项全 PASS**（精确/前缀/包含匹配、大小写、selfId 排除、在线优先、空表与空目标、
+  `deviceRow` 字段、`index.js` 里兜底与 `via:'cloud'` 接线、`home.send` 仍走 `relay.sendEnvelope`）。
+- 已知边界：跨设备 **一发多投**（`term_broadcast` 走特征码）仍然只在本机总线上扩散；云端群发后续再做。
+- 要不要跟着动手：**不用** —— 但两边都要 ≥0.7.3 才能互相 `term_send`；只升一边时可以用云端收件箱写信封兜底。
+
 ## 0.7.2 — 2026-10-19
 
 ### 停用云端老文件夹：设备心跳搬进账号共享目录

package/README.md

@@ -28,15 +28,13 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做总开关，标题带「（总开关）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.7.2）**
-
-- **云端老文件夹停用**：不再把本机总线镜像到 `/dsh云盘/crossterm/bus`（老目录里 12 个 json 是状态镜像、
-  200 个 md 是本机邮件的子集、200 个 tmp 是原子写残留，没有必须迁移的数据）。
-- **设备心跳搬进账号共享目录**：`<云端根>/<账号>/shared/<设备>/_device.json`，每 60 s 写一次；
-  「云端设备」列表改为新布局优先，老目录只作 `<0.7.2` 设备的兼容来源。
-- 老镜像需要时可在 `config.json` 里把 `busSyncEnabled` 设 true 开回来；`term_cloud` 的 `once` 在镜像停用时给出说明。
-- 老目录**只停写、不删除**：还跑 `<0.7.2` 的设备仍从那里读邮件与 presence，等全部升级后再整体删掉。
-- 要不要跟着动手：**要** —— 别的机器升到 0.7.2 后，云端设备列表才会来自新布局。
+**本版更新（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.2'
+export const VERSION = '0.7.4'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/lib/cloud/match.js

@@ -0,0 +1,45 @@
+// 云端设备匹配：term_send / term_list 用，纯函数便于单测
+export function normTarget(raw) {
+  return String(raw || '').trim().toLowerCase()
+}
+
+/**
+ * 在云端设备列表里找目标（nodeId 精确 / 名字精确 / nodeId 前缀 / 名字包含）。
+ * devices 元素至少要有 nodeId、name；可带 online。
+ * selfId 用来把「本机」排除掉（云端列表里可能还留着本机上次的心跳）。
+ */
+export function matchDevice(devices, raw, opts = {}) {
+  const list = Array.isArray(devices) ? devices.filter((d) => d && d.nodeId) : []
+  const selfId = String(opts.selfId || '')
+  const pool = selfId ? list.filter((d) => d.nodeId !== selfId) : list
+  const target = normTarget(raw)
+  if (!target || !pool.length) return undefined
+  const exact = pool.filter((d) => String(d.nodeId).toLowerCase() === target
+    || String(d.name || '').toLowerCase() === target)
+  const loose = pool.filter((d) => String(d.nodeId).toLowerCase().startsWith(target)
+    || String(d.name || '').toLowerCase().includes(target)
+    || String(d.hostname || '').toLowerCase().includes(target))
+  const hits = exact.length ? exact : loose
+  if (!hits.length) return undefined
+  // 在线的优先，其次心跳新的
+  return hits.slice().sort((a, b) => (b.online ? 1 : 0) - (a.online ? 1 : 0)
+    || (Number(b.at) || 0) - (Number(a.at) || 0))[0]
+}
+
+/** 云端设备 → term_list 里的一行（本地总线里没有它时才补） */
+export function deviceRow(d) {
+  return {
+    nodeId: d.nodeId,
+    name: d.name || d.nodeId,
+    hostname: d.hostname || '',
+    workspace: '',
+    pid: d.pid,
+    ageMs: Number(d.at) ? Math.max(0, Date.now() - Number(d.at)) : 0,
+    online: d.online !== false,
+    sessions: [],
+    chains: Array.isArray(d.chains) ? d.chains : [],
+    cloud: true,
+    version: d.version || '',
+    sessionCount: Number(d.sessions) || 0,
+  }
+}

package/lib/index.js

@@ -38,6 +38,7 @@ import { createPan } from './cloud/pan.js'
 import { createCloud } from './cloud/sync.js'
 import { createCloudHome } from './cloud/home.js'
 import { runSetup } from './cloud/setup.js'
+import { deviceRow, matchDevice } from './cloud/match.js'
 import { registerWeb } from './web.js'
 
 const PLUGIN = 'dsh-crossterm'
@@ -342,6 +343,67 @@ class CrossTerm {
     return pool[0]
   }
 
+  // ── 云端设备（跨设备投递，0.7.3 起）─────────────────────────────────
+
+  /** 云端设备列表：没连云端、没布局、或还读不到时统一回空数组 */
+  async cloudDevices() {
+    if (!this.home) return []
+    try {
+      const r = await this.home.devices()
+      return r && r.ok && Array.isArray(r.devices) ? r.devices : []
+    } catch (e) {
+      this.warn(`cloudDevices: ${(e && e.message) || String(e)}`)
+      return []
+    }
+  }
+
+  /** 按 nodeId / 终端名在云端设备里找目标（排除本机） */
+  async cloudDevice(to) {
+    const list = await this.cloudDevices()
+    return matchDevice(list, to, { selfId: this.nodeId })
+  }
+
+  /** 走云端信封投递：对方中转站轮询自己的 inbox 取信 */
+  async sendViaCloud({ device, sessionId, text, files = [], subject = '', fromSessionId }) {
+    if (!this.home) return { ok: false, detail: '云端目录还没起来，暂时没法跨设备投递' }
+    const from = {
+      nodeId: this.nodeId,
+      name: this.cfg.name,
+      hostname: os.hostname(),
+      version: VERSION,
+      device: this.nodeId,
+      sessionId: fromSessionId || '',
+      sessionLabel: fromSessionId ? this.labelOf(fromSessionId) : '',
+    }
+    const r = await this.home.send({
+      toDevice: device.nodeId,
+      toSession: sessionId || '',
+      text,
+      files: Array.isArray(files) ? files : [],
+      subject,
+      from,
+    })
+    if (!r || !r.ok) {
+      return {
+        ok: false,
+        detail: `云端投递失败：${(r && r.reason) || '未知原因'}`,
+        to: device.nodeId,
+        via: 'cloud',
+      }
+    }
+    await this.note(`cloud sent ${r.mailId} -> ${device.nodeId}`)
+    const fileNames = (Array.isArray(files) ? files : []).map((f) => path.basename(f))
+    return {
+      ok: true,
+      detail: `已通过云端投递给「${device.name || device.nodeId}」（设备 ${device.nodeId}，信封 ${r.mailId}）`
+        + `${fileNames.length ? `（含 ${fileNames.length} 个附件）` : ''}；对方中转站 20 秒内取走`,
+      mailId: r.mailId,
+      to: device.nodeId,
+      via: 'cloud',
+      files: fileNames,
+    }
+  }
+
   // ── 投递（接收侧）──────────────────────────────────────────────────────
 
   async landFiles(msg, sessionId) {
@@ -610,9 +672,15 @@ class CrossTerm {
     const target = raw || (sessionId ? this.nodeId : '')
     const node = await this.resolveNode(target)
     if (!node) {
+      // 本机总线里没有：再看云端设备（0.7.3 起跨设备也能直接 term_send）
+      const device = await this.cloudDevice(target)
+      if (device) {
+        return this.sendViaCloud({ device, sessionId, text, files, subject, fromSessionId })
+      }
       return {
         ok: false,
-        detail: `找不到终端或特征码「${target || to}」；先调用 term_list 看有哪些节点在线，或先 term_link 建一串特征码`,
+        detail: `找不到终端或特征码「${target || to}」；本机总线里没有，云端设备里也没有。`
+          + '先用 term_list 看有哪些节点在线（云端设备要求本机已连云端），或先 term_link 建一串特征码',
       }
     }
     if (node.nodeId === this.nodeId && !sessionId) {
@@ -748,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，中转站只能留件' }
@@ -769,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 = []
@@ -1369,7 +1446,7 @@ function buildTools(term, agent, part = 'all') {
 
   const list = defineTool({
     name: 'term_list',
-    description: '列出同一账号下所有在线的 DSH 终端（桌面端 / dsh web / dsh headless 等），以及每个终端当前活着的会话 id。要给别的终端发消息或传文件时，先用它确认目标。',
+    description: '列出同一账号下所有在线的 DSH 终端（桌面端 / dsh web / dsh headless 等，含别的机器上的云端设备），以及每个终端当前活着的会话 id。要给别的终端发消息或传文件时，先用它确认目标。',
     parameters: {
       includeSelf: { type: 'boolean', description: '是否把自己也算进去，默认 false' },
     },
@@ -1386,6 +1463,11 @@ function buildTools(term, agent, part = 'all') {
         if (v.nodes.length) {
           lines.push('', `其它终端 ${v.nodes.length} 个：`)
           for (const node of v.nodes) {
+            if (node.cloud) {
+              lines.push(`- 「${node.name}」 nodeId=${node.nodeId}（云端设备${node.version ? ` v${node.version}` : ''}`
+                + `${node.online ? '，在线' : '，心跳已过期'}）${node.sessionCount ? ` ${node.sessionCount} 个会话` : ''}`)
+              continue
+            }
             const codes = Array.isArray(node.chains) && node.chains.length
               ? ` 特征码 ${[...new Set(node.chains.map((c) => c.code))].join('/')}`
               : ''
@@ -1434,6 +1516,16 @@ function buildTools(term, agent, part = 'all') {
             sessions: Array.isArray(node.sessions) ? node.sessions : [],
             chains: Array.isArray(node.chains) ? node.chains : [],
           }))
+        // 云端设备（别的机器，不写本机总线）：本地节点列表里没有的补一行
+        const seenNode = new Set(nodes.map((n) => n.nodeId))
+        seenNode.add(term.nodeId)
+        try {
+          for (const d of await term.cloudDevices()) {
+            if (seenNode.has(d.nodeId)) continue
+            nodes.push(deviceRow(d))
+            seenNode.add(d.nodeId)
+          }
+        } catch { /* 云端抖动不影响本地列表 */ }
         return {
           ok: true,
           // 本终端：同一个 DSH 进程里可能开着好几个会话，它们彼此也算「房间里的成员」
@@ -1485,7 +1577,7 @@ function buildTools(term, agent, part = 'all') {
 
   const send = defineTool({
     name: 'term_send',
-    description: '把一条消息投递给另一个 DSH 终端（或同一个终端里的另一个会话）里正在运行的会话（消息会以 user 消息进入那个会话，那边的 agent 会像收到用户输入一样处理）。target 用 term_list 里的 nodeId 或终端显示名；同一个终端里的其它会话用 to="self" 并带上 sessionId；要一发多投就把 to 写成一串特征码（先 term_link）。',
+    description: '把一条消息投递给另一个 DSH 终端（或同一个终端里的另一个会话）里正在运行的会话（消息会以 user 消息进入那个会话，那边的 agent 会像收到用户输入一样处理）。target 用 term_list 里的 nodeId 或终端显示名；别的机器（云端设备）也认，本机总线找不到时会自动走云端信封；同一个终端里的其它会话用 to="self" 并带上 sessionId；要一发多投就把 to 写成一串特征码（先 term_link）。',
     parameters: {
       to: { type: 'string', description: '目标终端：nodeId 或显示名（term_list 里的 name）、特征码，"self" 表示本终端' },
       text: { type: 'string', description: '消息内容' },

package/package.json

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