dsh-lan-relay 1.0.2 → 1.1.0

package/README.md

@@ -192,8 +192,7 @@ dsh plugin --profile desktop add dsh-lan-relay
 ## 11. 开发
 
 ```powershell
-npm test           # 31 项端到端 smoke + 9 项 node:test（hub 内核 / 插件集成 / Web 半结构）
-npm run test:unit  # 只跑 node:test
+npm test   # 9 项 node:test：hub 内核 / 插件集成（含真实 hub + 唤醒投递）/ Web 半结构
 ```
 
 | 路径 | 作用 |

package/docs/TWO-MACHINE-SETUP.md

@@ -1,7 +1,7 @@
 # 两台机器，5 分钟装好（1.0 插件版）
 
 前置：两台机器都装 **DSH Desktop（≥ 0.2.1-rc.2）**，在同一局域网，能互相 ping 通。
-不需要预装 Node、不需要复制文件夹、不需要 MCP 连接器、不需要计划任务。
+不需要预装 Node、不需要复制文件夹、不需要额外配置、不需要计划任务。
 
 > 假设：机器 A = `pc1` 当服务端；机器 B = `pc2` 当客户端。名字可以在设置页改。
 
@@ -20,7 +20,7 @@
 验证：
 
 - 页面「Hub 状态：运行中」，消息数/最新序号正常；
-- 同一台机器上 `node relay-cli.mjs status` 显示 🟢（可选，需要仓库里的 CLI）。
+- 页面「在线 peer」里能看到本机（刚启动时可能只显示自己）。
 
 ---
 
@@ -59,4 +59,3 @@
 
 - 关闭：**运行角色 → 关闭 → 保存**（hub 与轮询停止，工具仍在但会提示未启用）。
 - 卸载：**插件 → dsh-lan-relay → 卸载**。配置文件 `~/.dsh/lan-relay/config.json` 会保留，重新装回来即恢复。
-- 回退到 0.4.x 旧链路：见 [MIGRATION-0.4-to-1.0.md](MIGRATION-0.4-to-1.0.md)（反向操作）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lan-relay",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "DeepSeek Harness 局域网中继插件：一台机器在 DSH 进程内做 hub，其余机器粘贴加入码即可加入；跨机器 Agent 消息互通、离线补投、自动唤醒会话，标准 DSH bundle，装完即用。",
   "type": "module",
   "main": "./index.js",
@@ -11,9 +11,6 @@
     "./locale/*.json": "./locale/*.json",
     "./icon": "./icon.svg"
   },
-  "bin": {
-    "dsh-lan-relay": "./relay-cli.mjs"
-  },
   "files": [
     "index.js",
     "client.js",
@@ -22,12 +19,7 @@
     "cordis.patch.yml",
     "icon.svg",
     "hub.mjs",
-    "mcp-server.mjs",
-    "relay-cli.mjs",
-    "start-hub.cmd",
     "scripts/allow-firewall.ps1",
-    "scripts/setup.ps1",
-    "scripts/install-autostart.ps1",
     "examples",
     "docs",
     "README.md",
@@ -50,13 +42,7 @@
   },
   "scripts": {
     "hub": "node hub.mjs",
-    "mcp": "node mcp-server.mjs",
-    "cli": "node relay-cli.mjs",
-    "test": "node test/smoke.mjs && node --test test/hub-core.test.mjs test/plugin.test.mjs test/client.test.mjs",
-    "test:unit": "node --test test/hub-core.test.mjs test/plugin.test.mjs test/client.test.mjs",
-    "test:smoke": "node test/smoke.mjs",
-    "setup:hub": "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/setup.ps1 -Role hub",
-    "setup:peer": "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/setup.ps1 -Role peer"
+    "test": "node --test test/hub-core.test.mjs test/plugin.test.mjs test/client.test.mjs"
   },
   "engines": {
     "node": ">=18"
@@ -71,9 +57,7 @@
     "message-bus",
     "multi-agent",
     "agent-to-agent",
-    "wake-on-message",
-    "mcp",
-    "mcp-server"
+    "wake-on-message"
   ],
   "repository": {
     "type": "git",

package/docs/MIGRATION-0.4-to-1.0.md

@@ -1,80 +0,0 @@
-# 从 0.4.x（push 插件 + MCP 连接器）迁移到 1.0 单包插件
-
-1.0 起，**一个 bundle 包做完所有事**：
-
-| 旧组件 | 1.0 里还需要吗 | 说明 |
-|---|---|---|
-| `dsh-lan-relay-push` bundle | ❌ 卸载/关闭 | 功能已合并进 `dsh-lan-relay`；同时开会重复唤醒 |
-| `lan-relay` MCP 连接（`mcp-server.mjs`） | ❌ 删除连接 | 6 个工具已由插件原生注册（`lan_relay_*`） |
-| 独立 `hub.mjs` 进程 | ❌ 不用启动 | 服务端角色在 DSH 进程内起 hub |
-| `scripts/install-autostart.ps1` 装的自启 | ❌ 删除 | hub 跟随 DSH 启动 |
-| `scripts/setup.ps1` 写配置 | ❌ 不需要 | 设置页写同一份 `config.json` |
-| `~/.dsh/lan-relay/config.json` | ✅ 保留 | 字段兼容，多了 `role` |
-
-消息协议、`messages.jsonl`、游标文件都没变，所以新旧客户端可以混用（升级过程中不会丢消息）。
-
----
-
-## 步骤
-
-### 1. 安装新插件
-
-GUI：**插件 → 添加插件** → `dsh-lan-relay`（npm）或本地目录 / Git 地址。
-CLI：
-
-```powershell
-dsh plugin --profile desktop add "D:\path\to\dsh-lan-relay"
-```
-
-### 2. 卸载旧 push 插件
-
-GUI：**插件 → 已安装插件 → dsh-lan-relay-push → 关闭/卸载**。
-CLI：
-
-```powershell
-dsh plugin --profile desktop remove dsh-lan-relay-push
-```
-
-> 旧插件用的是独立游标 `state/push-<self>.json`，新插件也用它，所以升级后不会重放历史消息。
-
-### 3. 删除旧 MCP 连接
-
-GUI：**MCP 连接器 → lan-relay → 删除**。
-或者让 Agent 执行 `mcp_connector_disconnect`（连接 key 形如 `json-lan-relay`）。
-删除后旧的 `mcp__lan_relay__relay_*` 工具消失，改用插件原生的 `lan_relay_*`。
-
-### 4. 清理开机自启
-
-如果之前给独立 hub 装过自启：
-
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install-autostart.ps1 -Remove
-```
-
-会删除计划任务 `DSH-LAN-Relay-Hub`、启动文件夹快捷方式、`HKCU\...\Run` 键和隐藏启动器；已运行的独立 hub 不受影响（需要的话手动停掉）。
-
-### 5. 确认角色与连通性
-
-打开 **设置 → 局域网中继**：
-
-- 旧配置里已经有 `token` + `relay_url`，插件会自动推断为**客户端**，直接可用（顶部应显示「客户端已连接」）。
-- 原来的 hub 机器：切到**服务端** → 保存。插件会复用旧 token、在进程内起 hub，并给出新的**加入码**（地址取本机局域网 IP）。
-- 其他机器如果换了 token 或地址，粘贴新加入码即可。
-
-### 6. 验证
-
-```powershell
-node relay-cli.mjs status      # 🟢 + 可达
-node relay-cli.mjs peers
-```
-
-或在设置页看「在线 peer」。再让 Agent 用 `lan_relay_status` 确认角色、hub、唤醒统计。
-
----
-
-## 常见问题
-
-- **升级后同一条消息投递两次**：旧 push 插件没关。关掉它即可。
-- **服务端保存后报「端口已被占用」**：旧的独立 `hub.mjs` 还在跑。停掉它（或先把它在用的 8787 让出来），再保存一次。
-- **对端连不上新 hub**：加入码里的地址可能是多网卡里选错的那个；在服务端「本机地址」里换一个，重新复制加入码。
-- **回退**：删掉新 bundle，重新装回 `dsh-lan-relay-push` 并恢复 MCP 连接即可；配置文件一直兼容。

package/examples/mcp-connector.json

@@ -1,13 +0,0 @@
-{
-  "mcpServers": {
-    "lan-relay": {
-      "command": "node",
-      "args": [
-        "F:\\work\\dsh\\dsh_workspace\\dsh-lan-relay\\mcp-server.mjs"
-      ],
-      "env": {
-        "LAN_RELAY_CONFIG": "C:\\Users\\you\\.dsh\\lan-relay\\config.json"
-      }
-    }
-  }
-}

package/examples/skill-lan-relay/SKILL.md

@@ -1,59 +0,0 @@
----
-name: lan-relay
-description: 在没有 MCP 连接器（或 MCP 工具未启用）的机器上，用命令行与局域网内另一台 DSH 互发消息时使用。发送、收件、等消息、查看在线 peer、排障。
----
-
-# 局域网 Agent 通信（LAN Relay CLI）
-
-通过命令行调用本机的 `dsh-lan-relay` 项目，与另一台机器上的 DSH 互发消息。
-所有命令都读取 `~/.dsh/lan-relay/config.json`（relay_url / token / self）。
-
-项目目录（按实际部署改）：`F:\work\dsh\dsh_workspace\dsh-lan-relay`
-
-## 1. 先确认连通
-
-```bash
-node "F:/work/dsh/dsh_workspace/dsh-lan-relay/relay-cli.mjs" status
-```
-
-- `可达=是` 说明 hub 正常；`可达=否` 看输出里的错误与提示（hub 没开 / IP 不对 / 防火墙 / token 不一致）。
-
-## 2. 发消息
-
-```bash
-node "F:/work/dsh/dsh_workspace/dsh-lan-relay/relay-cli.mjs" send --to pc2 --text "帮我看下 X，回我 Y"
-```
-
-- `--to` 填对方 peer 名；`--to "*"` 广播给所有其他 peer。
-- 对方离线也会入队，上线后能补收。
-
-## 3. 收消息
-
-```bash
-node "F:/work/dsh/dsh_workspace/dsh-lan-relay/relay-cli.mjs" inbox --limit 10
-```
-
-同一条消息只会出现一次（本地游标）；想重读历史加 `--from-seq 0 --no-mark-read`。
-
-## 4. 等消息（长轮询）
-
-```bash
-node "F:/work/dsh/dsh_workspace/dsh-lan-relay/relay-cli.mjs" wait --timeout 25
-```
-
-- 最多阻塞 25~50 秒，有新消息立即返回；超时返回空。
-- 循环调用会持续消耗模型调用，建议只在明确的"等对方回复"场景用。
-
-## 5. 查看在线 peer
-
-```bash
-node "F:/work/dsh/dsh_workspace/dsh-lan-relay/relay-cli.mjs" peers
-```
-
-120 秒内有过请求的 peer 视为在线。
-
-## 6. 给 Agent 的使用约定
-
-- 消息里写清：背景、你要对方做什么、期望的回复格式、是否需要 `relay_wait` 继续等。
-- 对方是另一个 Agent，不要假设它有你的上下文。
-- 任务结束用一句话总结回执，避免两边无止境互相等待。

package/mcp-server.mjs

@@ -1,284 +0,0 @@
-#!/usr/bin/env node
-/**
- * LAN Relay MCP Server —— 把局域网消息总线暴露成 Agent 工具（stdio / JSON-RPC）
- *
- * 由 DSH 的 MCP 客户端按需拉起，进程生命周期跟随 DSH，不需要手动启动。
- * 配置全部来自 ~/.dsh/lan-relay/config.json（或 LAN_RELAY_* 环境变量）。
- *
- * 工具：
- *   relay_send    给另一台机器上的 Agent 发消息
- *   relay_inbox   取自己的新消息（推进游标，同一条只返回一次）
- *   relay_wait    长轮询等新消息（≤50 秒，避免超出 MCP 工具调用超时）
- *   relay_peers   看谁在线
- *   relay_status  看自己的配置与连通性
- */
-import readline from 'node:readline';
-import { loadConfig, RelayError } from './lib/config.mjs';
-import { RelayClient } from './lib/relay-client.mjs';
-
-const VERSION = '0.1.0';
-const SERVER_INFO = { name: 'dsh-lan-relay', version: VERSION };
-
-let client;
-let configError = null;
-try {
-  client = new RelayClient(loadConfig());
-} catch (error) {
-  configError = error;
-  console.error(`[lan-relay] 配置错误：${error.message}`);
-}
-
-function textResult(payload) {
-  return {
-    content: [{ type: 'text', text: typeof payload === 'string' ? payload : JSON.stringify(payload, null, 2) }],
-  };
-}
-
-function errorResult(error) {
-  const detail = error instanceof RelayError
-    ? { error: error.message, hint: error.hint || undefined }
-    : { error: String(error?.message || error) };
-  return {
-    content: [{ type: 'text', text: JSON.stringify(detail, null, 2) }],
-    isError: true,
-  };
-}
-
-function requireClient() {
-  if (client) return client;
-  throw new RelayError(
-    `LAN relay 配置不可用：${configError?.message || '未知原因'}`,
-    { hint: '运行 scripts/setup.ps1 生成 ~/.dsh/lan-relay/config.json，然后重启 DSH 或重连 MCP。' },
-  );
-}
-
-function decorateMessages(result) {
-  const now = Date.now();
-  return {
-    ...result,
-    messages: result.messages.map((message) => ({
-      seq: message.seq,
-      from: message.from,
-      from_session: message.from_session || '',
-      to: message.to,
-      to_session: message.to_session || '',
-      thread: message.thread || '',
-      text: message.text,
-      sent_at: new Date(message.ts).toISOString(),
-      age_seconds: Math.max(0, Math.round((now - message.ts) / 1000)),
-    })),
-  };
-}
-
-const TOOLS = [
-  {
-    name: 'relay_send',
-    description:
-      '给局域网内另一台机器上的 DSH Agent 发一条消息。to 填对方 peer 名（如 "pc1" / "b"），'
-      + '或填 "*" 广播给所有其他 peer。to_session 可指定对方某个会话（如 session-a37a161f-...），'
-      + '不填则由对方的 relay 插件投递到它配置的默认会话。消息会落盘在中继 hub 上，对方离线也会在下次上线时收到。'
-      + '发送成功返回 seq，可用于引用/排障。',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        to: { type: 'string', description: '收件 peer 名（小写字母/数字/._-，≤32 字符），或 "*" 表示广播' },
-        text: { type: 'string', description: '消息正文（≤32000 字符，建议写清背景与期望回复，因为对方是另一个 Agent）' },
-        thread: { type: 'string', description: '可选话题标签，方便双方按 thread 归档（≤64 字符）' },
-        to_session: { type: 'string', description: '可选：对方会话 id（如 session-a37a161f-...），用于精确投递/唤醒' },
-        from_session: { type: 'string', description: '可选：你的会话 id，便于对方回复到同一会话' },
-      },
-      required: ['to', 'text'],
-      additionalProperties: false,
-    },
-  },
-  {
-    name: 'relay_inbox',
-    description:
-      '读取发给自己的新消息。默认会推进本地游标，所以同一条消息不会重复返回；'
-      + '若想重读历史，可显式传 from_seq=0。返回 messages 数组（含 from/text/seq/age_seconds）和 has_more。',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        limit: { type: 'integer', minimum: 1, maximum: 100, description: '本次最多取多少条，默认 20' },
-        from_seq: { type: 'integer', minimum: 0, description: '可选：从这个 seq 之后开始读（不传则用本地游标）' },
-        mark_read: { type: 'boolean', description: '是否推进游标，默认 true；调试时可传 false' },
-      },
-      additionalProperties: false,
-    },
-  },
-  {
-    name: 'relay_wait',
-    description:
-      '长轮询等待新消息：没有消息时会阻塞到超时（最多 50 秒），有新消息立即返回。'
-      + '典型用法：对方说"等我 30 秒"，你就调用 relay_wait(timeout_seconds=30)；'
-      + '想持续在线可以循环调用，但每轮都会消耗一次模型调用。',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        timeout_seconds: { type: 'number', minimum: 1, maximum: 50, description: '等待秒数，默认 25，上限 50' },
-        after_seq: { type: 'integer', minimum: 0, description: '可选：从这个 seq 之后等（不传则用本地游标）' },
-      },
-      additionalProperties: false,
-    },
-  },
-  {
-    name: 'relay_peers',
-    description: '查看同一中继上还有哪些 peer，以及各自是否在线（120 秒内有请求即视为在线）。',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-  },
-  {
-    name: 'relay_status',
-    description:
-      '查看本机 relay 配置（self、relay_url、游标）与 hub 连通性。首次使用或通信失败时先调它排障。',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-  },
-];
-
-const HANDLERS = {
-  relay_send: async (args) => {
-    const result = await requireClient().send({
-      to: args?.to,
-      text: args?.text,
-      thread: args?.thread || '',
-      toSession: args?.to_session || '',
-      fromSession: args?.from_session || '',
-    });
-    return {
-      ok: true,
-      seq: result.message.seq,
-      from: result.message.from,
-      from_session: result.message.from_session || '',
-      to: result.message.to,
-      to_session: result.message.to_session || '',
-      sent_at: new Date(result.message.ts).toISOString(),
-      latest: result.latest,
-      hub: result.hub,
-    };
-  },
-  relay_inbox: async (args) => {
-    const result = await requireClient().inbox({
-      limit: Number.isInteger(args?.limit) ? args.limit : 20,
-      fromSeq: Number.isInteger(args?.from_seq) ? args.from_seq : null,
-      markRead: args?.mark_read !== false,
-    });
-    return decorateMessages(result);
-  },
-  relay_wait: async (args) => {
-    const result = await requireClient().wait({
-      timeoutSeconds: Number.isFinite(args?.timeout_seconds) ? args.timeout_seconds : 25,
-      afterSeq: Number.isInteger(args?.after_seq) ? args.after_seq : null,
-    });
-    return decorateMessages(result);
-  },
-  relay_peers: async () => {
-    const peers = await requireClient().peers();
-    return {
-      self: requireClient().self,
-      relay_url: requireClient().relayUrl,
-      peers: peers.peers || [],
-      online_window_seconds: peers.online_window_seconds,
-      latest: peers.latest,
-    };
-  },
-  relay_status: async () => {
-    const instance = requireClient();
-    return instance.status();
-  },
-};
-
-// ---------- MCP stdio 传输（换行分隔的 JSON-RPC 2.0） ----------
-function writeMessage(payload) {
-  process.stdout.write(`${JSON.stringify(payload)}\n`);
-}
-
-function ok(id, result) {
-  return { jsonrpc: '2.0', id, result };
-}
-
-function fail(id, code, message, data) {
-  return { jsonrpc: '2.0', id, error: data === undefined ? { code, message } : { code, message, data } };
-}
-
-const SUPPORTED_PROTOCOLS = ['2024-11-05', '2025-03-26', '2025-06-18'];
-
-async function handleRequest(message) {
-  const { id, method, params } = message;
-  const isNotification = id === undefined || id === null;
-
-  switch (method) {
-    case 'initialize': {
-      const requested = params?.protocolVersion;
-      const protocolVersion = SUPPORTED_PROTOCOLS.includes(requested) ? requested : '2024-11-05';
-      return ok(id, {
-        protocolVersion,
-        capabilities: { tools: { listChanged: false } },
-        serverInfo: SERVER_INFO,
-        instructions:
-          '这是两台机器之间的局域网通信通道。用 relay_send 给对面发消息，用 relay_inbox / relay_wait 收消息。'
-          + '对方是另一个 DSH Agent，消息要写清楚背景、你要什么、期望的回复格式。',
-      });
-    }
-    case 'notifications/initialized':
-    case 'notifications/cancelled':
-    case 'notifications/roots/list_changed':
-      return undefined;
-    case 'ping':
-      return ok(id, {});
-    case 'tools/list':
-      return ok(id, { tools: TOOLS });
-    case 'tools/call': {
-      const name = params?.name;
-      const handler = HANDLERS[name];
-      if (!handler) return fail(id, -32602, `未知工具：${name}`);
-      try {
-        const payload = await handler(params?.arguments || {});
-        return ok(id, textResult(payload));
-      } catch (error) {
-        console.error(`[lan-relay] 工具 ${name} 失败：${error?.message || error}`);
-        return ok(id, errorResult(error));
-      }
-    }
-    case 'resources/list':
-      return ok(id, { resources: [] });
-    case 'prompts/list':
-      return ok(id, { prompts: [] });
-    default:
-      if (isNotification) return undefined;
-      return fail(id, -32601, `未实现的方法：${method}`);
-  }
-}
-
-const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
-
-rl.on('line', (line) => {
-  const trimmed = line.trim();
-  if (!trimmed) return;
-  let message;
-  try {
-    message = JSON.parse(trimmed);
-  } catch {
-    console.error(`[lan-relay] 收到非 JSON 行：${trimmed.slice(0, 200)}`);
-    return;
-  }
-  Promise.resolve()
-    .then(() => handleRequest(message))
-    .then((response) => {
-      if (response) writeMessage(response);
-    })
-    .catch((error) => {
-      console.error(`[lan-relay] 处理请求异常：${error?.stack || error}`);
-      if (message?.id !== undefined) {
-        writeMessage(fail(message.id, -32603, String(error?.message || error)));
-      }
-    });
-});
-
-rl.on('close', () => process.exit(0));
-process.on('uncaughtException', (error) => {
-  console.error(`[lan-relay] uncaught: ${error?.stack || error}`);
-});
-process.on('unhandledRejection', (error) => {
-  console.error(`[lan-relay] unhandledRejection: ${error?.stack || error}`);
-});
-
-console.error(`[lan-relay] MCP server v${VERSION} 已启动（self=${client?.self || '?'}，relay=${client?.relayUrl || '未配置'}）`);

package/relay-cli.mjs

@@ -1,169 +0,0 @@
-#!/usr/bin/env node
-/**
- * LAN Relay CLI —— 不开 DSH 也能收发/排障（也用于本插件自测）
- *
- *   node relay-cli.mjs status
- *   node relay-cli.mjs send --to pc2 --text "你好，帮我看下 X"
- *   node relay-cli.mjs inbox --limit 10
- *   node relay-cli.mjs wait --timeout 30
- *   node relay-cli.mjs peers
- *
- * 通用参数：--config <文件> --url <http://ip:port> --token <token> --self <peer名> --json
- */
-import { spawn } from 'node:child_process';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { loadConfig, RelayError } from './lib/config.mjs';
-import { RelayClient } from './lib/relay-client.mjs';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-function parseArgs(argv) {
-  const out = { _: [] };
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (!arg.startsWith('--')) {
-      out._.push(arg);
-      continue;
-    }
-    const eq = arg.indexOf('=');
-    if (eq > 2) {
-      out[arg.slice(2, eq)] = arg.slice(eq + 1);
-      continue;
-    }
-    const key = arg.slice(2);
-    const next = argv[i + 1];
-    if (next !== undefined && !next.startsWith('--')) {
-      out[key] = next;
-      i += 1;
-    } else {
-      out[key] = true;
-    }
-  }
-  return out;
-}
-
-function fmtTime(iso) {
-  if (!iso) return '(未知时间)';
-  const d = new Date(iso);
-  return Number.isNaN(d.getTime()) ? iso : d.toLocaleString('zh-CN', { hour12: false });
-}
-
-function decorate(messages) {
-  const now = Date.now();
-  return (messages || []).map((message) => ({
-    ...message,
-    sent_at: message.sent_at || (message.ts ? new Date(message.ts).toISOString() : ''),
-    age_seconds: typeof message.age_seconds === 'number'
-      ? message.age_seconds
-      : Math.max(0, Math.round((now - (message.ts || now)) / 1000)),
-  }));
-}
-
-function printInbox(result) {
-  if (!result.messages.length) {
-    console.log(result.timed_out ? `⌛ 等待 ${result.waited_seconds}s，没有新消息` : '📭 没有新消息');
-    return;
-  }
-  for (const message of decorate(result.messages)) {
-    const thread = message.thread ? ` [#${message.thread}]` : '';
-    console.log(`\n📨 seq=${message.seq} ${message.from} → ${message.to}${thread}  ${fmtTime(message.sent_at)}（${message.age_seconds}s 前）`);
-    console.log(message.text);
-  }
-  console.log(`\n— 共 ${result.messages.length} 条，cursor=${result.cursor}，latest=${result.latest}${result.has_more ? '，还有更多' : ''}`);
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const command = args._[0] || 'status';
-  const json = Boolean(args.json);
-
-  if (command === 'serve' || command === 'hub') {
-    const hubArgs = [path.join(__dirname, 'hub.mjs')];
-    if (args.config) hubArgs.push('--config', args.config);
-    if (args.port) hubArgs.push('--port', String(args.port));
-    if (args.host) hubArgs.push('--host', String(args.host));
-    if (args.token) hubArgs.push('--token', String(args.token));
-    if (args.data) hubArgs.push('--data', String(args.data));
-    const child = spawn(process.execPath, hubArgs, { stdio: 'inherit' });
-    child.on('exit', (code) => process.exit(code ?? 0));
-    return;
-  }
-
-  const config = loadConfig({
-    config: typeof args.config === 'string' ? args.config : undefined,
-    url: typeof args.url === 'string' ? args.url : undefined,
-    token: typeof args.token === 'string' ? args.token : undefined,
-    self: typeof args.self === 'string' ? args.self : undefined,
-    state: typeof args.state === 'string' ? args.state : undefined,
-  });
-  const client = new RelayClient(config);
-
-  switch (command) {
-    case 'status': {
-      const status = await client.status();
-      if (json) return console.log(JSON.stringify(status, null, 2));
-      const dot = status.reachable ? '🟢' : '🔴';
-      console.log(`${dot} self=${status.self}  hub=${status.relay_url}  可达=${status.reachable ? '是' : '否'}`);
-      if (status.hub) console.log(`   hub=${status.hub.name}@${status.hub.hostname}:${status.hub.port} 运行 ${status.hub.uptime_seconds}s，最新 seq=${status.latest}`);
-      console.log(`   游标 cursor=${status.cursor}  配置=${status.config_path || '(env)'}`);
-      if (status.peers?.length) console.log(`   peers: ${status.peers.map((p) => `${p.name}${p.online ? '(在线)' : '(离线)'}`).join(', ')}`);
-      if (status.error) console.log(`   错误: ${status.error}\n   提示: ${status.hint}`);
-      return undefined;
-    }
-    case 'send': {
-      if (!args.to || !args.text) {
-        throw new RelayError('用法：send --to <peer> --text <内容> [--to-session <session-id>] [--from-session <session-id>] [--thread <标签>]');
-      }
-      const result = await client.send({
-        to: args.to,
-        text: args.text,
-        thread: args.thread,
-        toSession: args['to-session'],
-        fromSession: args['from-session'],
-      });
-      if (json) return console.log(JSON.stringify(result, null, 2));
-      const sessionHint = result.message.to_session ? `（会话 ${result.message.to_session}）` : '';
-      console.log(`✅ 已发送 #${result.message.seq} → ${result.message.to}${sessionHint}（${result.message.text.length} 字符）`);
-      return undefined;
-    }
-    case 'inbox': {
-      const result = await client.inbox({
-        limit: Number(args.limit) || 20,
-        fromSeq: args['from-seq'] !== undefined ? Number(args['from-seq']) : null,
-        markRead: args['no-mark-read'] ? false : true,
-      });
-      if (json) return console.log(JSON.stringify(result, null, 2));
-      printInbox(result);
-      return undefined;
-    }
-    case 'wait': {
-      const result = await client.wait({
-        timeoutSeconds: Number(args.timeout) || 25,
-        afterSeq: args['after-seq'] !== undefined ? Number(args['after-seq']) : null,
-      });
-      if (json) return console.log(JSON.stringify(result, null, 2));
-      printInbox(result);
-      return undefined;
-    }
-    case 'peers': {
-      const result = await client.peers();
-      if (json) return console.log(JSON.stringify(result, null, 2));
-      if (!result.peers?.length) console.log('（暂无 peer 记录：只有至少发过一次请求的 peer 才会出现）');
-      for (const peer of result.peers || []) {
-        console.log(`${peer.online ? '🟢' : '⚪'} ${peer.name}  最后活跃 ${peer.last_seen_seconds}s 前`);
-      }
-      return undefined;
-    }
-    default:
-      throw new RelayError(`未知命令：${command}`, {
-        hint: '可用命令：status / send / inbox / wait / peers / serve',
-      });
-  }
-}
-
-main().catch((error) => {
-  const message = error instanceof RelayError ? error.toString() : String(error?.stack || error);
-  console.error(`❌ ${message}`);
-  process.exit(1);
-});

package/scripts/install-autostart.ps1

@@ -1,282 +0,0 @@
-[CmdletBinding()]
-param(
-  [ValidateSet('auto', 'task', 'startup', 'runkey')][string]$Method = 'auto',
-  [string]$ConfigPath = '',
-  [string]$TaskName = 'DSH-LAN-Relay-Hub',
-  [switch]$Remove,
-  [switch]$NoStart,
-  [switch]$Force
-)
-
-$ErrorActionPreference = 'Stop'
-$ProjectDir = Split-Path -Parent $PSScriptRoot
-
-if (-not $ConfigPath) {
-  $ConfigPath = Join-Path $env:USERPROFILE '.dsh\lan-relay\config.json'
-}
-
-$startupDir = Join-Path $env:APPDATA 'Microsoft\Windows\Start Menu\Programs\Startup'
-$startupShortcut = Join-Path $startupDir 'DSH LAN Relay.lnk'
-$legacyStartupVbs = Join-Path $startupDir 'DSH-LAN-Relay.vbs'
-$runKeyPath = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Run'
-$runKeyName = 'DSH-LAN-Relay'
-$launcherVbs = Join-Path (Split-Path -Parent $ConfigPath) 'launch-hub.vbs'
-
-function Get-LauncherCommand {
-  return "wscript.exe `"$launcherVbs`""
-}
-
-function New-Launcher {
-  param([string]$NodePath, [string]$HubPath, [string]$LogPath)
-  $vbs = @"
-' DSH LAN Relay Hub hidden launcher with auto-restart - generated by dsh-lan-relay
-' Delete the autostart entry (and this file) to disable.
-Set sh = CreateObject("WScript.Shell")
-cmd = """$NodePath"" ""$HubPath"" --config ""$ConfigPath"" --log ""$LogPath"""
-failures = 0
-Do
-  started = Timer
-  code = sh.Run(cmd, 0, True)
-  elapsed = Timer - started
-  If elapsed < 0 Then elapsed = elapsed + 86400
-  If elapsed > 30 Then failures = 0
-  If code = 2 Then WScript.Quit 0
-  If code <> 0 Then
-    failures = failures + 1
-    If failures >= 3 Then WScript.Quit code
-  Else
-    failures = 0
-  End If
-  WScript.Sleep 3000
-Loop
-"@
-  try {
-    [System.IO.File]::WriteAllText($launcherVbs, $vbs, (New-Object System.Text.ASCIIEncoding))
-  } catch {
-    Set-Content -Path $launcherVbs -Value $vbs -Encoding Ascii
-  }
-}
-
-function Remove-All {
-  $removed = @()
-
-  $task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
-  if ($task) {
-    try { Stop-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue } catch { }
-    Unregister-ScheduledTask -TaskName $TaskName -Confirm:$false -ErrorAction SilentlyContinue
-    $removed += "计划任务 $TaskName"
-  }
-
-  if (Test-Path $startupShortcut) {
-    Remove-Item $startupShortcut -Force
-    $removed += "启动文件夹快捷方式 $startupShortcut"
-  }
-
-  if (Test-Path $legacyStartupVbs) {
-    Remove-Item $legacyStartupVbs -Force
-    $removed += "旧启动项 $legacyStartupVbs"
-  }
-
-  try {
-    $value = Get-ItemProperty -Path $runKeyPath -Name $runKeyName -ErrorAction SilentlyContinue
-    if ($value) {
-      Remove-ItemProperty -Path $runKeyPath -Name $runKeyName -Force
-      $removed += "注册表自启项 HKCU\...\Run\$runKeyName"
-    }
-  } catch { }
-
-  try {
-    Get-CimInstance Win32_Process -Filter "Name='wscript.exe'" |
-      Where-Object { $_.CommandLine -like '*launch-hub.vbs*' } |
-      ForEach-Object {
-        Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue
-        $removed += "启动器进程 PID $($_.ProcessId)"
-      }
-  } catch { }
-
-  if ($removed.Count) {
-    Write-Host "已移除：$($removed -join '；')" -ForegroundColor Green
-  } else {
-    Write-Host '没有找到任何自启项。' -ForegroundColor Yellow
-  }
-  Write-Host "hub 本身如果还在运行，需要的话手动结束：Get-NetTCPConnection -LocalPort 8787 -State Listen" -ForegroundColor DarkGray
-}
-
-if ($Remove) {
-  Remove-All
-  exit 0
-}
-
-if (-not (Test-Path $ConfigPath)) {
-  Write-Host "配置文件不存在：$ConfigPath" -ForegroundColor Red
-  Write-Host '请先运行：scripts\setup.ps1 -Role hub' -ForegroundColor Yellow
-  exit 1
-}
-
-try {
-  $nodePath = (Get-Command node -ErrorAction Stop).Source
-} catch {
-  Write-Host '未找到 node.exe，请安装 Node.js 18+ 并加入 PATH 后重试。' -ForegroundColor Red
-  exit 1
-}
-
-$hubPath = Join-Path $ProjectDir 'hub.mjs'
-if (-not (Test-Path $hubPath)) {
-  Write-Host "找不到 hub.mjs：$hubPath" -ForegroundColor Red
-  exit 1
-}
-
-$hubData = Join-Path (Split-Path -Parent $ConfigPath) 'hub'
-if (-not (Test-Path $hubData)) { New-Item -ItemType Directory -Force -Path $hubData | Out-Null }
-$logPath = Join-Path $hubData 'hub.log'
-
-New-Launcher -NodePath $nodePath -HubPath $hubPath -LogPath $logPath
-
-# 老版本可能残留启动文件夹 VBS，统一清掉，避免重复启动
-if (Test-Path $legacyStartupVbs) { Remove-Item $legacyStartupVbs -Force }
-
-function Install-Task {
-  $argument = "`"$hubPath`" --config `"$ConfigPath`" --log `"$logPath`""
-  $action = New-ScheduledTaskAction -Execute $nodePath -Argument $argument -WorkingDirectory $ProjectDir
-  $trigger = New-ScheduledTaskTrigger -AtLogOn
-  $settings = New-ScheduledTaskSettingsSet `
-    -AllowStartIfOnBatteries `
-    -DontStopIfGoingOnBatteries `
-    -StartWhenAvailable `
-    -RestartCount 3 `
-    -RestartInterval (New-TimeSpan -Minutes 1) `
-    -MultipleInstances IgnoreNew `
-    -ExecutionTimeLimit ([TimeSpan]::Zero)
-  $description = 'DSH LAN Relay Hub 开机自启（dsh-lan-relay 生成）。删除：scripts\install-autostart.ps1 -Remove'
-  Register-ScheduledTask -TaskName $TaskName -Action $action -Trigger $trigger -Settings $settings -Description $description -Force -ErrorAction Stop | Out-Null
-}
-
-function Install-StartupShortcut {
-  if (-not (Test-Path $startupDir)) { New-Item -ItemType Directory -Force -Path $startupDir | Out-Null }
-  $shell = New-Object -ComObject WScript.Shell
-  $shortcut = $shell.CreateShortcut($startupShortcut)
-  $shortcut.TargetPath = 'C:\Windows\System32\wscript.exe'
-  $shortcut.Arguments = "`"$launcherVbs`""
-  $shortcut.WorkingDirectory = $ProjectDir
-  $shortcut.WindowStyle = 7
-  $shortcut.Description = 'DSH LAN Relay Hub（局域网消息总线）'
-  $shortcut.Save()
-  if (-not (Test-Path $startupShortcut)) { throw '快捷方式未创建成功' }
-}
-
-function Install-RunKey {
-  if (-not (Test-Path $runKeyPath)) { New-Item -Path $runKeyPath -Force | Out-Null }
-  New-ItemProperty -Path $runKeyPath -Name $runKeyName -Value (Get-LauncherCommand) -PropertyType String -Force | Out-Null
-}
-
-$installed = ''
-$errors = @()
-$order = switch ($Method) {
-  'auto' { @('task', 'startup', 'runkey') }
-  'task' { @('task') }
-  'startup' { @('startup') }
-  'runkey' { @('runkey') }
-}
-
-foreach ($candidate in $order) {
-  try {
-    switch ($candidate) {
-      'task' { Install-Task; $installed = 'task' }
-      'startup' { Install-StartupShortcut; $installed = 'startup' }
-      'runkey' { Install-RunKey; $installed = 'runkey' }
-    }
-    if ($installed) { break }
-  } catch {
-    $errors += "$candidate：$($_.Exception.Message)"
-  }
-}
-
-if (-not $installed) {
-  Write-Host '所有自启方式都失败：' -ForegroundColor Red
-  $errors | ForEach-Object { Write-Host "  - $_" -ForegroundColor Red }
-  Write-Host ''
-  Write-Host '可以手动把启动文件夹快捷方式指向：' -ForegroundColor Yellow
-  Write-Host "  wscript.exe `"$launcherVbs`""
-  exit 1
-}
-
-# 只保留一种方式，避免重复启动
-if ($installed -ne 'task') {
-  $task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
-  if ($task) {
-    try { Unregister-ScheduledTask -TaskName $TaskName -Confirm:$false -ErrorAction SilentlyContinue } catch { }
-  }
-}
-if ($installed -ne 'runkey') {
-  try {
-    if (Get-ItemProperty -Path $runKeyPath -Name $runKeyName -ErrorAction SilentlyContinue) {
-      Remove-ItemProperty -Path $runKeyPath -Name $runKeyName -Force
-    }
-  } catch { }
-}
-if ($installed -ne 'startup' -and (Test-Path $startupShortcut)) {
-  Remove-Item $startupShortcut -Force
-}
-
-$methodLabel = switch ($installed) {
-  'task' { "计划任务 $TaskName（登录时启动，支持异常重启）" }
-  'startup' { "启动文件夹快捷方式 $startupShortcut" }
-  'runkey' { "注册表自启项 HKCU\Software\Microsoft\Windows\CurrentVersion\Run\$runKeyName" }
-}
-
-Write-Host ''
-Write-Host '============================================================' -ForegroundColor Cyan
-Write-Host '  LAN Relay Hub 开机自启已安装' -ForegroundColor Cyan
-Write-Host '============================================================' -ForegroundColor Cyan
-Write-Host "  方式     : $methodLabel"
-Write-Host "  启动器   : $launcherVbs"
-Write-Host "  日志     : $logPath"
-Write-Host "  配置文件 : $ConfigPath"
-if ($errors.Count) {
-  Write-Host "  回退记录 : $($errors -join ' / ')" -ForegroundColor DarkYellow
-}
-Write-Host ''
-
-$existingListener = Get-NetTCPConnection -LocalPort 8787 -State Listen -ErrorAction SilentlyContinue | Select-Object -First 1
-$launcherRunning = @(
-  Get-CimInstance Win32_Process -Filter "Name='wscript.exe'" -ErrorAction SilentlyContinue |
-    Where-Object { $_.CommandLine -like '*launch-hub.vbs*' }
-).Count -gt 0
-
-if (-not $NoStart) {
-  if ($launcherRunning) {
-    Write-Host "hub 已由启动器守护运行（PID $($existingListener.OwningProcess)），无需重复启动。" -ForegroundColor Green
-  } else {
-    if ($existingListener) {
-      $proc = Get-CimInstance Win32_Process -Filter "ProcessId=$($existingListener.OwningProcess)" -ErrorAction SilentlyContinue
-      if ($proc -and $proc.CommandLine -like '*hub.mjs*') {
-        Write-Host "检测到未受启动器托管的 hub（PID $($existingListener.OwningProcess)），停止后交给自启动器守护…" -ForegroundColor Yellow
-        Stop-Process -Id $existingListener.OwningProcess -Force -ErrorAction SilentlyContinue
-        Start-Sleep -Milliseconds 800
-      }
-    }
-    if ($installed -eq 'task') {
-      Start-ScheduledTask -TaskName $TaskName
-    } else {
-      Start-Process -FilePath 'wscript.exe' -ArgumentList "`"$launcherVbs`"" -WindowStyle Hidden
-    }
-  }
-  Start-Sleep -Seconds 2
-}
-
-$listen = Get-NetTCPConnection -LocalPort 8787 -State Listen -ErrorAction SilentlyContinue
-Write-Host '当前状态：' -ForegroundColor Cyan
-if ($listen) {
-  Write-Host "  ✅ hub 正在监听 8787（PID $($listen[0].OwningProcess)）" -ForegroundColor Green
-} else {
-  Write-Host '  ⚠️ 8787 未监听，查看日志：' -ForegroundColor Yellow
-  Write-Host "     Get-Content `"$logPath`" -Tail 30"
-}
-Write-Host ''
-Write-Host '验证：' -ForegroundColor Cyan
-Write-Host "  node `"$ProjectDir\relay-cli.mjs`" status"
-Write-Host '取消自启：' -ForegroundColor Cyan
-Write-Host "  powershell -NoProfile -ExecutionPolicy Bypass -File `"$ProjectDir\scripts\install-autostart.ps1`" -Remove"
-Write-Host '说明：' -ForegroundColor DarkGray
-Write-Host '  这是“登录时自启”。DSH 本身需要登录后使用，所以登录自启足够；' -ForegroundColor DarkGray
-Write-Host '  计划任务方式失败通常是因为当前账户没有注册计划任务的权限，脚本会自动退回启动文件夹方式。' -ForegroundColor DarkGray

package/scripts/setup.ps1

@@ -1,231 +0,0 @@
-[CmdletBinding()]
-param(
-  [ValidateSet('hub', 'peer')][string]$Role = 'hub',
-  [string]$Self = '',
-  [string]$HubUrl = '',
-  [string]$Token = '',
-  [int]$Port = 8787,
-  [string]$ConfigPath = '',
-  [string]$DefaultSession = '',
-  [switch]$DisablePush,
-  [switch]$Force
-)
-
-$ErrorActionPreference = 'Stop'
-$ProjectDir = Split-Path -Parent $PSScriptRoot
-
-function New-Token {
-  $bytes = New-Object byte[] 24
-  $rng = [System.Security.Cryptography.RandomNumberGenerator]::Create()
-  try {
-    $rng.GetBytes($bytes)
-  } finally {
-    $rng.Dispose()
-  }
-  return -join ($bytes | ForEach-Object { $_.ToString('x2') })
-}
-
-function Get-LanIps {
-  try {
-    Get-NetIPAddress -AddressFamily IPv4 -ErrorAction Stop |
-      Where-Object { $_.IPAddress -notlike '127.*' -and $_.IPAddress -notlike '169.254.*' } |
-      Select-Object -ExpandProperty IPAddress
-  } catch {
-    @()
-  }
-}
-
-function Pick-LanIp {
-  param([string[]]$Ips)
-  $order = @('192.168.*', '10.*', '172.16.*', '172.17.*', '172.18.*', '172.19.*', '172.20.*', '172.21.*', '172.22.*', '172.23.*', '172.24.*', '172.25.*', '172.26.*', '172.27.*', '172.28.*', '172.29.*', '172.30.*', '172.31.*')
-  foreach ($pattern in $order) {
-    $hit = $Ips | Where-Object { $_ -like $pattern } | Select-Object -First 1
-    if ($hit) { return $hit }
-  }
-  return ($Ips | Select-Object -First 1)
-}
-
-if (-not $ConfigPath) {
-  $ConfigPath = Join-Path $env:USERPROFILE '.dsh\lan-relay\config.json'
-}
-$ConfigDir = Split-Path -Parent $ConfigPath
-
-$existing = $null
-if ((Test-Path $ConfigPath) -and -not $Force) {
-  try {
-    $existing = Get-Content -Path $ConfigPath -Raw | ConvertFrom-Json
-  } catch {
-    Write-Warning "已存在的配置无法解析，将按参数重新生成：$ConfigPath"
-    $existing = $null
-  }
-}
-
-function Get-ExistingValue {
-  param([string]$Name, $Default)
-  if ($existing -and ($existing.PSObject.Properties.Name -contains $Name)) {
-    $value = $existing.$Name
-    if ($null -ne $value -and "$value" -ne '') { return $value }
-  }
-  return $Default
-}
-
-$hostname = ($env:COMPUTERNAME -as [string])
-if (-not $hostname) { $hostname = 'dsh' }
-$defaultSelf = $hostname.ToLower() -replace '[^a-z0-9._-]', '-'
-
-$resolvedSelf = if ($Self) { $Self.ToLower() } else { Get-ExistingValue -Name 'self' -Default $defaultSelf }
-$resolvedToken = if ($Token) { $Token } else { Get-ExistingValue -Name 'token' -Default (New-Token) }
-
-if ($Role -eq 'hub') {
-  $lanIp = Pick-LanIp -Ips (Get-LanIps)
-  $defaultUrl = if ($lanIp) { "http://${lanIp}:$Port" } else { "http://127.0.0.1:$Port" }
-  $resolvedUrl = if ($HubUrl) { $HubUrl } else { Get-ExistingValue -Name 'relay_url' -Default $defaultUrl }
-} else {
-  $resolvedUrl = if ($HubUrl) { $HubUrl } else { Get-ExistingValue -Name 'relay_url' -Default '' }
-  if (-not $resolvedUrl) {
-    $resolvedUrl = Read-Host '请输入 hub 机器的局域网地址（例如 http://192.168.0.105:8787）'
-    if (-not $resolvedUrl) { throw '缺少 -HubUrl：peer 模式必须知道 hub 的地址' }
-  }
-}
-
-$resolvedUrl = $resolvedUrl.TrimEnd('/')
-
-$hubConfig = $null
-if ($existing -and ($existing.PSObject.Properties.Name -contains 'hub')) { $hubConfig = $existing.hub }
-
-$dataDir = if ($hubConfig -and ($hubConfig.PSObject.Properties.Name -contains 'data_dir') -and $hubConfig.data_dir) {
-  $hubConfig.data_dir
-} else {
-  Join-Path $env:USERPROFILE '.dsh\lan-relay\hub'
-}
-
-$stateDir = Get-ExistingValue -Name 'state_dir' -Default (Join-Path $env:USERPROFILE '.dsh\lan-relay\state')
-
-# push 段：保留已有配置；可用 -DefaultSession 指定默认投递会话，-DisablePush 关闭自动唤醒
-$existingPush = $null
-if ($existing -and ($existing.PSObject.Properties.Name -contains 'push')) { $existingPush = $existing.push }
-$pushDefault = ''
-if ($DefaultSession) {
-  $pushDefault = $DefaultSession
-} elseif ($existingPush -and ($existingPush.PSObject.Properties.Name -contains 'default_session')) {
-  $pushDefault = [string]$existingPush.default_session
-}
-$pushEnabled = $true
-if ($DisablePush) {
-  $pushEnabled = $false
-} elseif ($existingPush -and ($existingPush.PSObject.Properties.Name -contains 'enabled')) {
-  $pushEnabled = [bool]$existingPush.enabled
-}
-$pushWake = $true
-if ($existingPush -and ($existingPush.PSObject.Properties.Name -contains 'wake')) { $pushWake = [bool]$existingPush.wake }
-$pushTimeout = 25
-if ($existingPush -and ($existingPush.PSObject.Properties.Name -contains 'poll_timeout_seconds')) { $pushTimeout = [int]$existingPush.poll_timeout_seconds }
-# 策略开关：目标会话不在线时是否兜底改投；无 to_session 是否拒收
-$pushOfflineFallback = $false
-if ($existingPush -and ($existingPush.PSObject.Properties.Name -contains 'offline_fallback')) { $pushOfflineFallback = [bool]$existingPush.offline_fallback }
-$pushRequireSession = $false
-if ($existingPush -and ($existingPush.PSObject.Properties.Name -contains 'require_session')) { $pushRequireSession = [bool]$existingPush.require_session }
-# 目标会话不在线时：prompt = 冷启动投递（sessionController.prompt 自动 resume）；drop = 放弃
-$pushColdSession = 'prompt'
-if ($existingPush -and ($existingPush.PSObject.Properties.Name -contains 'cold_session') -and "$($existingPush.cold_session)" -eq 'drop') { $pushColdSession = 'drop' }
-
-New-Item -ItemType Directory -Force -Path $ConfigDir, $stateDir | Out-Null
-
-$config = [ordered]@{
-  role               = $(if ($Role -eq 'hub') { 'server' } else { 'client' })
-  relay_url          = $resolvedUrl
-  token              = $resolvedToken
-  self               = $resolvedSelf
-  state_dir          = $stateDir
-  request_timeout_ms = 15000
-  hub                = [ordered]@{
-    enabled  = ($Role -eq 'hub')
-    host     = '0.0.0.0'
-    port     = $Port
-    data_dir = $dataDir
-  }
-  push               = [ordered]@{
-    enabled              = $pushEnabled
-    default_session      = $pushDefault
-    wake                 = $pushWake
-    poll_timeout_seconds = $pushTimeout
-    offline_fallback     = $pushOfflineFallback
-    require_session      = $pushRequireSession
-    cold_session         = $pushColdSession
-  }
-}
-
-$json = $config | ConvertTo-Json -Depth 6
-[System.IO.File]::WriteAllText($ConfigPath, $json, (New-Object System.Text.UTF8Encoding($false)))
-
-$nodePath = $null
-try { $nodePath = (Get-Command node -ErrorAction Stop).Source } catch { $nodePath = $null }
-
-$mcpServerPath = Join-Path $ProjectDir 'mcp-server.mjs'
-$connectorJson = [ordered]@{
-  mcpServers = [ordered]@{
-    'lan-relay' = [ordered]@{
-      command = 'node'
-      args    = @($mcpServerPath)
-      env     = [ordered]@{ LAN_RELAY_CONFIG = $ConfigPath }
-    }
-  }
-} | ConvertTo-Json -Depth 8
-
-$connectorFile = Join-Path $ConfigDir 'mcp-connector.json'
-[System.IO.File]::WriteAllText($connectorFile, $connectorJson, (New-Object System.Text.UTF8Encoding($false)))
-
-Write-Host ''
-Write-Host '============================================================' -ForegroundColor Cyan
-Write-Host "  LAN Relay 配置完成（$Role）" -ForegroundColor Cyan
-Write-Host '============================================================' -ForegroundColor Cyan
-Write-Host "  角色       : $Role"
-Write-Host "  peer 名    : $resolvedSelf"
-Write-Host "  hub 地址   : $resolvedUrl"
-Write-Host "  token      : $resolvedToken"
-Write-Host "  配置文件   : $ConfigPath"
-Write-Host "  游标目录   : $stateDir"
-Write-Host "  push 自动唤醒 : $(if ($pushEnabled) { '开启' } else { '关闭' })  默认会话: $(if ($pushDefault) { $pushDefault } else { '(最近活跃会话)' })"
-Write-Host "  MCP 路径   : $mcpServerPath"
-Write-Host "  MCP 配置   : $connectorFile"
-Write-Host "  Node       : $(if ($nodePath) { "$nodePath $(& node --version)" } else { '未找到！请安装 Node.js 18+ 并加入 PATH' })"
-Write-Host ''
-
-if ($Role -eq 'hub') {
-  $allIps = Get-LanIps
-  if ($allIps.Count -gt 1) {
-    Write-Host "  注意：检测到多个局域网 IP：$($allIps -join ', ')" -ForegroundColor Yellow
-    Write-Host "        relay_url 目前用的是 $resolvedUrl，请确认与另一台机器在同一网段；不对就改配置文件或用 -HubUrl 重跑。" -ForegroundColor Yellow
-    Write-Host ''
-  }
-  Write-Host '接下来（hub 机器）：' -ForegroundColor Yellow
-  Write-Host "  1) 启动 hub："
-  Write-Host "       node `"$ProjectDir\hub.mjs`" --config `"$ConfigPath`""
-  Write-Host "     或后台常驻："
-  Write-Host "       powershell -NoProfile -ExecutionPolicy Bypass -File `"$ProjectDir\scripts\install-autostart.ps1`""
-  Write-Host "  2) 放行防火墙（管理员 PowerShell 执行一次）："
-  Write-Host "       powershell -NoProfile -ExecutionPolicy Bypass -File `"$ProjectDir\scripts\allow-firewall.ps1`" -Port $Port"
-  Write-Host ''
-} else {
-  Write-Host '接下来（peer 机器）：' -ForegroundColor Yellow
-  Write-Host "  1) 确认能访问 hub：node `"$ProjectDir\relay-cli.mjs`" status"
-  Write-Host "  2) 装自动唤醒插件（需要本机 DSH 自带的 CLI，装完重启 DSH）："
-  Write-Host "       & `"<本机 DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd`" plugin --profile desktop add `"file:$ProjectDir\push-plugin`""
-  Write-Host "  3) 想让消息默认投到某个会话：先拿到会话 id（DSH 会话里执行 echo `$env:DSH_SESSION_ID），再重跑："
-  Write-Host "       scripts\setup.ps1 -Role peer -Self $resolvedSelf -HubUrl $resolvedUrl -Token $resolvedToken -DefaultSession <session-id>"
-  Write-Host "  4) 重启 DSH 后验证：node `"$ProjectDir\relay-cli.mjs`" status && node `"$ProjectDir\relay-cli.mjs`" peers"
-  Write-Host '  注意：peer 机器不要启动 hub（不要跑 install-autostart.ps1 / start-hub.cmd），hub 只跑在 hub 机器上。'
-  Write-Host ''
-}
-
-Write-Host '把下面这段作为自定义 stdio MCP 连接加进 DSH（两台机器都要加）：' -ForegroundColor Yellow
-Write-Host '  - GUI：设置 → MCP 连接器 → 自定义 → 传输方式 stdio，命令填 node，参数填 mcp-server.mjs 的绝对路径'
-Write-Host '  - 或把 mcp-connector.json 导入：'
-Write-Host '       mcp_connector_import_json，内容如下：' -ForegroundColor DarkGray
-Write-Host ''
-Write-Host $connectorJson -ForegroundColor Gray
-Write-Host ''
-Write-Host '另一台机器的配置只需要改 relay_url（指向 hub）和 self（本机名字），token 必须一致。' -ForegroundColor DarkGray
-Write-Host '把该值发给另一台机器，在那边执行：' -ForegroundColor DarkGray
-Write-Host "  scripts\setup.ps1 -Role peer -Self <对方名字> -HubUrl $resolvedUrl -Token $resolvedToken" -ForegroundColor DarkGray
-Write-Host ''

package/start-hub.cmd

@@ -1,13 +0,0 @@
-@echo off
-setlocal
-set CONFIG=%USERPROFILE%\.dsh\lan-relay\config.json
-if not exist "%CONFIG%" (
-  echo 找不到配置：%CONFIG%
-  echo 请先运行：scripts\setup.ps1 -Role hub
-  pause
-  exit /b 1
-)
-node "%~dp0hub.mjs" --config "%CONFIG%"
-echo.
-echo hub 已退出（退出码 %ERRORLEVEL%）
-pause