dsh-crossterm 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## 1.0.1 — 2026-10-20
+
+### 修复：换台机器就跑不了的三处写死（第二设备验收 F1/F2/F3）
+
+- 背景：1.0.0 发布后，第二设备（YOCE_C）按 npm 1.0.0 做本机验收，报三条阻断，全部成立 —— 根因是代码里带着 TS-01 的环境常量。报告：`D:\dsh\dsh-crossterm\acceptance\v1.0.0\验收报告-第二设备.md`。
+- **F1 端口写死**：`busy-check.mjs` 的 `DEFAULT_PORT = Number(process.env.DSH_RESTART_PORT || 19387)`。第二设备 19387 关闭，市场接口在 `DSH_WEB_URL`（`http://127.0.0.1:63875`）→ 探测恒 unknown → 排程被前置守卫误拦。改法：新增 `resolveWebPort()`，顺序 `DSH_RESTART_PORT` → `DSH_WEB_URL`（缺协议头也认，无端口按协议默认）→ `19387`；`DEFAULT_PORT` 与 helper 的 `PORT` 都用它。
+- **F2 App 路径写死**：helper 里 `APP_EXE = 'F:\dsh\DeepSeek Harness.exe'`。第二设备真 exe 在 `D:\dsh`；helper 先按镜像名全杀、再 `fs.existsSync(APP_EXE)` 失败即放弃 → 真实重启会「杀而不起」。改法：`resolveAppExe()` 依次试 `DSH_RESTART_APP_EXE` → 用 PowerShell 查正在跑的宿主进程 ImagePath → 各盘 `\dsh\DeepSeek Harness.exe` → `%LOCALAPPDATA%\Programs\DeepSeek Harness`；**非 dryRun 且解析不到 exe 时直接拒绝 kill**（`reason:'app-exe-not-found'`，exit 1），并写进 result.json。
+- **F3 守卫一刀切**：`trigger-restart.mjs` 里 `if (!opts.force && !probe.ok)` 把「读不到权威信号」与「真有人忙」报成同一句「其他会话正在跑任务：[]」。改法：unknown 单独分支，打印 `sources` 与端口提示，退出码 4（busy 仍 exit 7）。
+- 自测：新增 `test-portability.mjs`（端口七种取值、exe 环境变量优先、import 不产生落盘副作用）全部 PASS；TS-01 上模拟第二设备（`DSH_RESTART_PORT=19999` + 心跳文件不存在）→ 守卫 `exit 4` 且提示「读不到权威信号（unknown）」；默认环境全链 dry-run → `app exe: F:\dsh\DeepSeek Harness.exe dir=F:\dsh port=19387`、`DRY-RUN result ok:true`、`exit code=0`。
+- 组件版本：自动重启 `0.3.40` → `0.3.41`。
+
 ## 1.0.0 — 2026-10-20
 
 ### 1.0.0 概览：自动重启组件从 0.3.30 走到 0.3.40

package/README.md

@@ -22,7 +22,7 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 | ② | 跨会话 | v0.5.3 | 同一终端里的多个会话之间互通：特征码链、内联邮件、收件箱 | `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.40 | 改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 `dsh-restart` 插件，0.9.0 起并入） | `dsh_restart` |
+| ⑤ | 自动重启 | v0.3.41 | 改完插件/配置后让 DSH 自己重启一次，并自动拉起离线会话（原 `dsh-restart` 插件，0.9.0 起并入） | `dsh_restart` |
 
 > 入口行为什么必须用裸包名：浏览器 client 半端只对裸包名行生效（`dsh-client-modules` 的
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
@@ -30,7 +30,13 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 >
 > 组件版本号怎么升：**只在该组件自己的文件改动时升它**，跟着插件一起发版（例：只改自动重启 → `components/restart` 的 `0.3.28` → `0.3.29`，其余四个不动）。插件总版本仍按发版技能的三分位规则。
 
-**本版更新（1.0.0）**
+**本版更新（1.0.1）**
+
+- 可移植性修复（第二设备验收报的三条阻断，全部在本机复现后修掉）：**端口不再写死 19387** —— `DSH_RESTART_PORT` → `DSH_WEB_URL` → `19387` 三级回退，`dsh web` 或换端口的机器不再恒判 unknown；**桌面 App 路径不再写死 `F:\dsh`** —— 依次试 `DSH_RESTART_APP_EXE` → 正在跑的宿主进程 ImagePath → 各盘 `\dsh\DeepSeek Harness.exe` → `%LOCALAPPDATA%\Programs`，一个都找不到就**拒绝执行 kill**（「杀而不起」比不重启更糟）；**守卫区分 unknown 与 busy** —— 读不到权威信号时退出码 4 并明说「市场接口与心跳都没读到」，不再误报「其他会话正在跑任务：[]」。
+- 组件版本：自动重启 `0.3.40` → `0.3.41`；其余组件不动。新增 `test-portability.mjs` 覆盖端口回退与 exe 解析。
+- 本版只动 `components/restart/`，`lib/*.js` 除版本号外未改。
+
+**上一版（1.0.0）**
 
 - **版本号正式跨过 1.0**：这一版把「自动重启」组件从 0.3.30 推到 0.3.40，十次连续加固全部来自真实事故与本机复现 —— wmic 在新系统失效后改走 PowerShell CIM；安全软件拦 `mshta` 时用 `conhost --headless` 无界面兜底；helper 加单实例锁（mtime 心跳判活、休眠后二次确认、跨主机让路）；node 运行时不再依赖旧家目录；`launch:` / `exit code=` 两行让每次重启事后可审。
 - **空闲守卫重做**：心跳从「读会话快照」改成订阅实时 `session/event`，生产端写 `producer` / `eventsSeen` / `src`；消费端把「市场残影」「权威的零」「读不到权威信号」分开判，退出码 `busy=3` / `unknown=4`，不再把「读不到」当成「没人忙」。

package/components/restart/manifest.json

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

package/components/restart/scripts/busy-check.mjs

@@ -12,7 +12,25 @@ import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 export const QUIET_MS = 3000
-export const DEFAULT_PORT = Number(process.env.DSH_RESTART_PORT || 19387)
+
+// 宿主 web 端口解析（第二设备验收 F1）：不能写死 19387。
+// 顺序：DSH_RESTART_PORT（显式覆盖）→ DSH_WEB_URL（宿主自己给的地址，最可靠）→ 19387（单机默认）。
+// TS-01 上 19387 确实开着，但换个 profile / 换台机器端口就未必是这个数；
+// 拼错或读不到都只是回退，不抛错。
+export function resolveWebPort(env = process.env) {
+  const direct = Number(env.DSH_RESTART_PORT)
+  if (Number.isInteger(direct) && direct > 0 && direct < 65536) return direct
+  const raw = String(env.DSH_WEB_URL || '').trim()
+  if (raw) {
+    try {
+      const u = new URL(raw.includes('://') ? raw : `http://${raw}`)
+      const p = Number(u.port || (u.protocol === 'https:' ? 443 : 80))
+      if (Number.isInteger(p) && p > 0 && p < 65536) return p
+    } catch { /* 解析不了就继续退到默认值 */ }
+  }
+  return 19387
+}
+export const DEFAULT_PORT = resolveWebPort()
 
 // 心跳文件：插件（宿主进程内）每 2 秒写一次「谁还在回合中」，比市场 runningAgents
 // （工具调用期间会掉出列表）和 transcript mtime（长工具调用期间不写盘）都准。

package/components/restart/scripts/dsh-restart-helper.mjs

@@ -8,7 +8,7 @@ import net from 'node:net';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { waitQuiet } from './busy-check.mjs';
+import { waitQuiet, resolveWebPort } from './busy-check.mjs';
 
 const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
 const LOGS_DIR = path.join(MODULE_DIR, 'logs');
@@ -16,15 +16,47 @@ const REQUEST_FILE = path.join(MODULE_DIR, 'request.json');
 // 单实例锁：mshta 迟到（被安全软件延迟放行）与 CIM 直拉 helper 兜底同时发生时，
 // 两个 helper 都去 taskkill + 拉起，会把刚起来的 DSH 再杀一次。锁放总线目录，跨进程/会话可见。
 const LOCK_FILE = path.join(MODULE_DIR, 'helper.lock');
-const APP_EXE = 'F:\\dsh\\DeepSeek Harness.exe';
-const APP_DIR = 'F:\\dsh';
 const APP_IMAGE = 'DeepSeek Harness.exe';
-const PORT = 19387;
+// 可移植性（第二设备验收 F2）：exe 路径与端口都不能写死成 TS-01 的名字。
+// 解析顺序：DSH_RESTART_APP_EXE → 正在跑的宿主进程 ImagePath → 各盘 \dsh\DeepSeek Harness.exe
+// → %LOCALAPPDATA%\Programs\…。一个都找不到就返回 ''，main() 会拒绝执行 kill（「杀而不起」比不重启更糟）。
+function detectRunningAppExe() {
+  try {
+    const out = execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+      `(Get-Process -Name 'DeepSeek Harness' -ErrorAction SilentlyContinue | Where-Object { $_.Path } | Select-Object -First 1).Path`,
+    ], { encoding: 'utf8', timeout: 8000, windowsHide: true }).trim();
+    if (out && fs.existsSync(out)) return out;
+  } catch { /* 拿不到就继续退 */ }
+  return '';
+}
+
+function resolveAppExe() {
+  const list = [];
+  if (process.env.DSH_RESTART_APP_EXE) list.push(process.env.DSH_RESTART_APP_EXE);
+  const detected = detectRunningAppExe();
+  if (detected) list.push(detected);
+  for (const drive of 'CDEFGHIJKLMNOPQRSTUVWXYZ') list.push(`${drive}:\\dsh\\${APP_IMAGE}`);
+  list.push(path.join(os.homedir(), 'AppData', 'Local', 'Programs', 'DeepSeek Harness', APP_IMAGE));
+  for (const c of list) {
+    try { if (c && fs.existsSync(c)) return path.resolve(c); } catch { /* 忽略坏路径 */ }
+  }
+  return '';
+}
+
+const APP_EXE = resolveAppExe();
+const APP_DIR = APP_EXE ? path.dirname(APP_EXE) : '';
+const PORT = resolveWebPort();
 const WAIT_GONE_MS = 40000;
 const WAIT_UP_MS = 120000;
 const RETRY_UP_MS = 60000;
 
-fs.mkdirSync(LOGS_DIR, { recursive: true });
+// 只有被直接执行时才做落盘副作用；被 import（单测）时保持只读，免得测试在仓库里留 logs/helper.pid。
+const invokedDirectly = (() => {
+  try {
+    return path.resolve(fileURLToPath(import.meta.url)) === path.resolve(process.argv[1] || '');
+  } catch { return true; }
+})();
+if (invokedDirectly) fs.mkdirSync(LOGS_DIR, { recursive: true });
 
 function stampName(d = new Date()) {
   const p = (n) => String(n).padStart(2, '0');
@@ -32,7 +64,9 @@ function stampName(d = new Date()) {
 }
 
 const logFile = path.join(LOGS_DIR, `helper-${stampName()}.log`);
-try { fs.writeFileSync(path.join(LOGS_DIR, 'helper.pid'), String(process.pid), 'utf8'); } catch {}
+if (invokedDirectly) {
+  try { fs.writeFileSync(path.join(LOGS_DIR, 'helper.pid'), String(process.pid), 'utf8'); } catch {}
+}
 function log(msg) {
   const line = `[${new Date().toISOString()}] ${msg}`;
   try { fs.appendFileSync(logFile, line + '\n', 'utf8'); } catch {}
@@ -60,8 +94,11 @@ const LAUNCH_MODE = ARG_MODE || {
   'WmiPrvSE.exe': 'cim-direct',
   'node.exe': 'node-direct',
 }[PARENT_IMAGE] || (PARENT_IMAGE ? `parent:${PARENT_IMAGE}` : 'unknown');
-log(`launch: mode=${LAUNCH_MODE} parent=${PARENT_IMAGE || '?'} pid=${process.pid} ppid=${process.ppid}`);
-process.on('exit', (code) => log(`exit code=${code}`));
+// 这两行只在「被直接执行」时打：被 import（单测）时不该往仓库 logs 里写 launch/exit 痕迹。
+if (invokedDirectly) {
+  log(`launch: mode=${LAUNCH_MODE} parent=${PARENT_IMAGE || '?'} pid=${process.pid} ppid=${process.ppid}`);
+  process.on('exit', (code) => log(`exit code=${code}`));
+}
 
 // result.json 是「最近一次」的状态；再留一份带时间戳的进 logs\ 供排障翻查（trigger 清理 request.json 后尤其有用）。
 const RESULT_FILE = path.join(LOGS_DIR, 'result.json');
@@ -337,6 +374,16 @@ async function main() {
   process.on('SIGTERM', () => { log('signal SIGTERM received; releasing lock and exiting (143)'); releaseLock(); process.exit(143); });
   startLockHeartbeat(); // 从抢到锁到进程退出为止，每 10s 刷一次 mtime
 
+  // 找不到要拉起的 exe 就绝不杀：「杀而不起」等于把人机器关了。
+  // dry-run 不需要 exe（只验证链路），所以只在非 dryRun 时硬拦。
+  if (!APP_EXE && !dryRun) {
+    log('APP_EXE unresolved: tried DSH_RESTART_APP_EXE / running-process path / <drive>:\\dsh\\DeepSeek Harness.exe / %LOCALAPPDATA%; refusing to kill DSH');
+    writeResult({ ok: false, dryRun, reason: 'app-exe-not-found', at: new Date().toISOString(), logFile, note: '找不到要拉起的桌面 App 路径，为免「杀而不起」本次不执行' });
+    clearRequest(req);
+    return 1;
+  }
+  log(`app exe: ${APP_EXE || '(unresolved, dry-run only)'} dir=${APP_DIR} port=${PORT}`);
+
   const before = appProcesses();
   log(`pre-kill app processes: ${JSON.stringify(before)}`);
   log(`pre-kill port ${PORT}: ${(await portOpen()) ? 'open' : 'closed'}`);
@@ -540,8 +587,13 @@ async function main() {
   return up.ok ? 0 : 1;
 }
 
-main().then((code) => process.exit(code)).catch((err) => {
-  log(`FATAL: ${err && err.stack ? err.stack : err}`);
-  try { writeResult({ ok: false, error: String(err), logFile }); } catch {}
-  process.exit(2);
-});
+// 只有被直接执行时才跑 main()；被 import（单测/自检）时只导出纯函数，不碰进程。
+if (invokedDirectly) {
+  main().then((code) => process.exit(code)).catch((err) => {
+    log(`FATAL: ${err && err.stack ? err.stack : err}`);
+    try { writeResult({ ok: false, error: String(err), logFile }); } catch {}
+    process.exit(2);
+  });
+}
+
+export { resolveAppExe, detectRunningAppExe, PORT, APP_EXE, APP_DIR, MODULE_DIR, LOGS_DIR };

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

@@ -117,6 +117,13 @@ if (running) { console.error(`helper already running (pid=${running}); refuse`);
 const selfSession = opts.selfSession || process.env.DSH_SESSION_ID || '';
 const probe = await waitQuiet({ selfSessionId: selfSession, maxWaitMs: 0 });
 if (!opts.force && !probe.ok) {
+  // F3：unknown（读不到权威信号）与 busy（真有人在跑）必须分开说，否则用户看到「其他会话正在跑任务：[]」无从下手。
+  if (probe.unknown === true) {
+    console.error(`读不到权威信号（unknown），拒绝重启：sources=${JSON.stringify(probe.sources || [])}`);
+    console.error('市场接口与插件心跳都没读到（常见原因：宿主 web 端口不是 19387、或者这是 dsh web 而不是桌面端）。');
+    console.error('可设 DSH_RESTART_PORT / 让 DSH_WEB_URL 指向宿主地址后重试；或由用户同意后用 --force。');
+    process.exit(4);
+  }
   console.error(`其他会话正在跑任务，拒绝重启：${JSON.stringify(probe.busy)}`);
   console.error('要么等其他会话任务结束（到点前会等 3 秒静默），要么由用户同意后用 --force 重试。');
   process.exit(7);

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 = '1.0.0'
+export const VERSION = '1.0.1'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {

package/package.json

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