dsh-remote-agent 0.9.2 → 0.9.4

package/lib/setup-routes.js

@@ -31,10 +31,30 @@ import fs from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
 import { ERROR_CODE, RemoteAgentError } from './protocol.js'
-import { writePatchBlock } from './setup.js'
+import {
+  FORM_OWNED_KEYS,
+  extractPreservedConfig,
+  newNodeToken,
+  readManagedBlockBody,
+  upsertTokenInBlock,
+  writePatchBlock,
+} from './setup.js'
 // 角色解析必须**只有一份实现** —— 面板说"未配置"而插件实际在跑 hub，
 // 是最难排查的撕裂（v0.7.0 踩过）。所以这里直接复用 lib/index.js 的解析器。
 import { resolveRoleDetail } from './index.js'
+// 配置分层（2026-10-18）：DSH 插件管理器会重写 cordis.patch.yml 并冲掉手工段，
+// 所以每次写配置时也在 <stateDir>/instance.json 存一份（插件加载时合并回来）。
+import { writeInstanceConfig, readInstanceConfig } from './instance-config.js'
+
+/**
+ * 面板表单**管辖**的顶层 config 键由 `lib/setup.js` 的 `FORM_OWNED_KEYS` 定义
+ * （CLI 向导与测试共用同一份，避免两处各写一份再分叉 —— 本版审查的 C2/L2
+ * 就是这么来的）。所以这里直接用那份常量，不再本地复制。
+ *
+ * 其余的一切（nodeToken / uiPullRoot / relay / listenHost / listenPort /
+ * agentMode…）在重写托管块时必须**原样保留** —— 否则用户在面板点一次保存，
+ * 凭证与设置就被静默抹掉（已实证）。
+ */
 
 /** 引导路由的前缀。与 hub 的 `/api/remote-agent/ui` 分开 —— 未配置时后者不存在。 */
 export const SETUP_API_PREFIX = '/api/remote-agent/setup'
@@ -216,12 +236,28 @@ export function registerSetupRoutes(ctx, config = {}, log = () => {}) {
     // `configured` 的语义是"用户已经做过选择，不需要引导"。
     // auto 也算已选择：它是个明确的工作模式（按 hubUrl 推断），不是"还没配"。
     const configured = role === 'auto' || detail.unconfigured !== true
+
+    // ── 独立配置状态（2026-10-18）──────────────────────────────────────
+    //
+    // 报告 `<stateDir>/instance.json` 里存了什么。这不是给用户看的细节，
+    // 而是排查"配置被 DSH 重写冲掉"这个坑的关键线索：
+    //   · instance 有值 = 配置抗住了重写（重启后 apply() 会合并回来）
+    //   · instance 为 null 但 patch 有值 = 只靠 patch 那层，下次重写会丢
+    const saved = readInstanceConfig(config)
     writeJson(res, 200, {
       ok: true,
       configured,
       // 推断结果（面板据此显示"当前生效角色"）—— auto 时它是有值的
       effectiveRole: detail.role,
       inferred: typeof detail.inferred === 'string' ? detail.inferred : '',
+      // 配置持久化的两层状态
+      persist: {
+        // DSH 会重写 cordis.patch.yml（实测会把我们的段整段冲掉）
+        patchFile: currentPatchFile(),
+        // 这一层 DSH 冲不掉，是"重启后配置还在"的真正保障
+        instanceFile: saved !== null,
+        instanceRole: saved && typeof saved.role === 'string' ? saved.role : null,
+      },
       // 回显当前配置里已有的值，方便用户"改一个字段"而不是从头填
       current: {
         role: typeof config.role === 'string' ? role : '',
@@ -230,6 +266,10 @@ export function registerSetupRoutes(ctx, config = {}, log = () => {}) {
         hubUrl: typeof config.hubUrl === 'string' ? config.hubUrl : '',
         relayUrl: typeof config.relayUrl === 'string' ? config.relayUrl : '',
         roots: Array.isArray(config.roots) ? config.roots : [],
+        // H3（2026-10-20）：面板必须知道"有没有口令"。此前完全不回显 → 用户
+        // 走面板配完 hub 永远是空口令，而独立监听因此只能绑回环、副机连不上。
+        // ⚠ 只回布尔，绝不回 token 本身（与 /config 的披露边界一致）。
+        tokenSet: typeof config.nodeToken === 'string' && config.nodeToken.trim() !== '',
       },
       // 写入目标（让用户知道改的是哪个文件）
       patchFile: currentPatchFile(),
@@ -330,7 +370,28 @@ export function registerSetupRoutes(ctx, config = {}, log = () => {}) {
 
     const blockYaml = `${lines.join('\n')}\n`
     const file = currentPatchFile()
-    const result = writePatchBlock({ file, blockYaml, force: body.force === true })
+
+    // ── 保留本次表单不管辖的字段（H2，2026-10-20）────────────────────
+    //
+    // 托管块是**整体替换**的：新块进来，旧块整段消失。而本表单只提交
+    // role/nodeId/transportMode/hubUrl/relayUrl/roots —— 于是用户在面板点一次
+    // 「保存」，托管块里的 nodeToken / uiPullRoot / relay / listenHost /
+    // listenPort 全部被静默删掉（已实证）。
+    //
+    // 这里把旧块里"不归表单管"的行原样搬到新块末尾（文本级搬运，保留用户的
+    // 格式与顺序；不解析 YAML，避免零依赖被打破）。
+    let preservedLines = []
+    try {
+      const existing = readManagedBlockBody(fs.readFileSync(file, 'utf8'))
+      preservedLines = extractPreservedConfig(existing, FORM_OWNED_KEYS)
+    } catch {
+      // 首次写入（文件不存在）—— 没有可保留的
+    }
+    const blockWithPreserved = preservedLines.length > 0
+      ? `${blockYaml.replace(/\s+$/, '')}\n${preservedLines.join('\n')}\n`
+      : blockYaml
+
+    const result = writePatchBlock({ file, blockYaml: blockWithPreserved, force: body.force === true })
     if (result.ok !== true) {
       // 冲突（有手写条目）是可预期的用户可修复状态，单独给个 code 让面板
       // 能显示"替换手写配置"按钮，而不是把整段错误文案丢给用户。
@@ -342,12 +403,50 @@ export function registerSetupRoutes(ctx, config = {}, log = () => {}) {
       })
     }
     log('info', 'setup applied', { role, file: result.file, mode: result.mode, warnings: applyWarnings })
+
+    // ── 同时写独立配置（2026-10-18，方案 B：防被 DSH 重写冲掉）──────────
+    //
+    // 事故：用户在 DSH 里卸载重装插件后，`cordis.patch.yml` 被重写成只剩
+    // 4 条 —— 我们的 role + webserver 整段消失，重启后又回引导页。
+    //
+    // 所以每次 setup 写入成功后，把**同样的值**再存一份到
+    // `<stateDir>/instance.json`。插件 `apply()` 时会把它合并回来
+    // （独立配置优先）。这样 DSH 怎么重写 patch 文件都不影响角色配置。
+    //
+    // ⚠ 2026-10-20 修两处：
+    //   · **必须传 config**（第二个参数）。此前漏了 → 写默认目录、读自定义
+    //     stateDir → 配了 stateDir 的机器持久化完全失效（M1，已复现）。
+    //   · 先铺上已有值再覆盖表单字段，否则每次保存都会把 nodeToken / relay /
+    //     listenHost 这类"表单不管辖"的字段从 instance.json 里抹掉（H2 的另一半）。
+    const prev = readInstanceConfig(config) ?? {}
+    const nextPersist = { ...prev }
+    // 表单管辖的键以本次提交为准（这样"清空"也能真正生效）
+    for (const k of FORM_OWNED_KEYS) delete nextPersist[k]
+    const persisted = writeInstanceConfig({
+      ...nextPersist,
+      role,
+      nodeId: str(body.nodeId),
+      transportMode: str(body.transportMode) || undefined,
+      hubUrl: str(body.hubUrl) || undefined,
+      relayUrl: str(body.relayUrl) || undefined,
+      roots,
+    }, config)
+    if (persisted.ok !== true) {
+      applyWarnings.push(`独立配置写入失败（${persisted.error}）—— 角色配置仍写进了 patch 文件，`
+        + '但下次 DSH 重写该文件时可能丢失，建议重启后到面板确认一次。')
+      log('warn', 'instance config write failed', { file: persisted.file, error: persisted.error })
+    } else {
+      log('info', 'instance config persisted', { file: persisted.file })
+    }
+
     writeJson(res, 200, {
       ok: true,
       role,
       file: result.file,
       backup: result.backup,
       mode: result.mode,
+      // 独立配置的落点（让用户/排查者知道配置存在哪两处）
+      instanceFile: persisted.ok === true ? persisted.file : null,
       // 非致命提示（自动建目录的结果等）—— 面板要显示，否则用户以为
       // "目录已就绪"而实际没有
       warnings: applyWarnings,
@@ -355,5 +454,90 @@ export function registerSetupRoutes(ctx, config = {}, log = () => {}) {
     })
   })
 
+  // ── 生成 / 轮换入网口令（nodeToken）──────────────────────────────
+  //
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 为什么必须有这条（v0.9.3 审查 H3，2026-10-20）
+  // ═══════════════════════════════════════════════════════════════════════════
+  //
+  // CLI 向导（`dsh-remote-setup --role hub`）会生成 `nt_` 开头的口令，
+  // **面板这条路却完全没有** —— YAML 里不写 nodeToken、instance.json 里也不写。
+  //
+  // 后果链（实测）：
+  //   面板配 hub → nodeToken 空 → 独立监听按安全策略只能绑回环
+  //   → 副机连不上 → 体检报"需要口令" → 而面板没有任何生成入口
+  //   → 用户只能去手改 patch → 被 DSH 重写冲掉 → 死循环
+  //
+  // 安全边界：
+  //   · 只对**回环请求**生成并回显明文（与 pair-info 的 token 披露边界一致）
+  //   · 明文只回这一次，之后任何接口都不再吐 token（`/state` 只给 tokenSet）
+  //   · 走的是同一套 patch 写盘（备份 / 校验 / 回滚）
+  route(`${SETUP_API_PREFIX}/rotate-token`, async (req, res) => {
+    if (req.method !== 'POST') return writeJson(res, 405, { error: 'method' })
+
+    const ra = String(req.socket?.remoteAddress ?? '')
+    const loopback = ra === '127.0.0.1' || ra === '::1' || ra === '::ffff:127.0.0.1'
+    if (!loopback) {
+      return writeJson(res, 403, {
+        error: 'loopback-only',
+        message: '生成口令只能在主机本机打开的面板里操作（避免局域网内其他人拿到凭证）',
+      })
+    }
+
+    const token = newNodeToken()
+    const file = currentPatchFile()
+
+    // 只改 nodeToken 这一行，其余字段（roots / uiPullRoot / relay / listen*）原样不动
+    let blockBody = ''
+    try {
+      blockBody = readManagedBlockBody(fs.readFileSync(file, 'utf8'))
+    } catch {
+      // 还没有 patch 文件：生成一个最小的托管块，role 取当前生效角色
+    }
+    if (blockBody.trim() === '') {
+      const detail = resolveRoleDetail(config)
+      const r = detail.role === 'worker' ? 'worker' : 'hub'
+      const inject = r === 'worker'
+        ? "['tools', 'agentLoop', 'sessions']"
+        : "['webServer', 'tools', 'systemPrompt']"
+      blockBody = `- id: remote-agent\n  name: dsh-remote-agent\n  inject: ${inject}\n  config:\n    role: ${r}\n`
+    }
+
+    const result = writePatchBlock({
+      file,
+      blockYaml: upsertTokenInBlock(blockBody, token),
+      force: false,
+    })
+    if (result.ok !== true) {
+      const conflict = /手写的 remote-agent 条目/.test(String(result.error ?? ''))
+      return writeJson(res, conflict ? 409 : 400, {
+        error: conflict ? 'handwritten-conflict' : 'write-failed',
+        message: result.error,
+        file: result.file,
+      })
+    }
+
+    // instance.json 也存一份（这一层 DSH 冲不掉）—— 同样保留已有字段
+    const prev = readInstanceConfig(config) ?? {}
+    const persisted = writeInstanceConfig({ ...prev, nodeToken: token }, config)
+
+    log('info', 'node token rotated', {
+      file: result.file,
+      instance: persisted.ok === true ? persisted.file : null,
+      instanceError: persisted.ok === true ? undefined : persisted.error,
+    })
+
+    writeJson(res, 200, {
+      ok: true,
+      // 明文只此一次：面板要提示用户"复制保存"，之后不再回显
+      token,
+      file: result.file,
+      backup: result.backup,
+      instanceFile: persisted.ok === true ? persisted.file : null,
+      note: '口令已写入。**重启 DSH 后生效**；副机需要用新口令重新配对。'
+        + '这串口令只显示这一次，请立即复制保存。',
+    })
+  })
+
   return disposers
 }

package/lib/setup.js

@@ -15,6 +15,10 @@ import fs from 'node:fs'
 import net from 'node:net'
 import { randomBytes } from 'node:crypto'
 import { expandPairConfig } from './pairing.js'
+// 地址枚举**必须只有一份实现**（2026-10-20 收口）：
+// 此前 detectLanIps（私网优先）与 resolveListenHost（Tailscale 优先）各写一套，
+// 排序方向相反 → 面板生成的配对码第一条必定不是实际绑定地址（C2）。
+import { listCandidateAddresses } from './listen-server.js'
 
 /** 与 hub 侧 newNodeToken 完全同构（nt_ 前缀 + 24 字节 base64url）。 */
 export function newNodeToken() {
@@ -26,23 +30,38 @@ export const NODE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/
 
 /**
  * 枚举本机局域网 IPv4（排除 loopback / 链路本地 / 虚拟接口）。
- * 返回 [{ name, address, private }]，private = RFC1918。
+ * 返回 [{ name, address, private }]，private = RFC1918 或 Tailscale（可信内网）。
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * 2026-10-20 改为复用 `listCandidateAddresses()`（v0.9.3 审查 C2）
+ * ═══════════════════════════════════════════════════════════════════════════
+ *
+ * 原来这里自己实现了"枚举 + 私网优先排序"，而 `lib/listen-server.js` 的
+ * `resolveListenHost()` 实现了"Tailscale 优先"。两套判据方向**相反**，于是：
+ *
+ *   独立监听实际绑   → 100.86.48.54（Tailscale）
+ *   面板配对码第一条 → ws://10.239.22.41:56594/...（WLAN，私网优先排第一）
+ *
+ * 用户复制第一条 → 连不上，而两端都不报错。
+ *
+ * 现在**一份实现**：排序 / 私网判定 / APIPA 过滤全部交给 listen-server，
+ * 这里只做字段名适配（它返回 iface，历史调用方要 name）。
+ *
+ * @returns {Array<{name:string, address:string, private:boolean, score:number}>}
  */
 export function detectLanIps() {
-  const out = []
-  const ifaces = os.networkInterfaces()
-  for (const [name, addrs] of Object.entries(ifaces)) {
-    for (const a of addrs ?? []) {
-      if (a.family !== 'IPv4' || a.internal) continue
-      if (a.address.startsWith('169.254.')) continue // 链路本地：没拿到 DHCP 的假地址
-      const [o1, o2] = a.address.split('.').map(Number)
-      const priv = o1 === 10 || (o1 === 172 && o2 >= 16 && o2 <= 31) || (o1 === 192 && o2 === 168)
-      out.push({ name, address: a.address, private: priv })
-    }
+  try {
+    return listCandidateAddresses().map((c) => ({
+      name: c.iface,
+      address: c.address,
+      // Tailscale（100.64/10）在语义上属于"可信内网"，与 RFC1918 同等看待：
+      // 面板用它区分"要不要提示公网风险"，把它算公网会给出错误警告。
+      private: c.score <= 1,
+      score: c.score,
+    }))
+  } catch {
+    return []
   }
-  // 私网优先，稳定的地址排前面
-  out.sort((x, y) => (x.private === y.private ? 0 : x.private ? -1 : 1))
-  return out
 }
 
 /**
@@ -455,6 +474,145 @@ export function hasUnmanagedRemoteAgent(fileText) {
   return RA_ENTRY_RE.test(src.slice(0, i) + src.slice(j + MANAGED_END.length))
 }
 
+/**
+ * 面板 setup 表单**管辖**的顶层 config 键。
+ *
+ * 只有这些字段允许被"整块重写"覆盖；其余（`nodeToken` / `uiPullRoot` /
+ * `listenHost` / `listenPort` / `relay` / `pair` / `token` …）一律原样保留。
+ *
+ * 放在这里而不是 setup-routes.js：它是「哪些字段归表单管」这个**领域事实**，
+ * CLI 向导与测试也要按同一份清单判断（两处各写一份就会分叉 —— 本版审查里
+ * C2/L2 就是这么来的）。
+ */
+export const FORM_OWNED_KEYS = Object.freeze([
+  'role',
+  'nodeId',
+  'transportMode',
+  'hubUrl',
+  'relayUrl',
+  'roots',
+])
+
+/**
+ * 从**现有托管块**里抽出"本次表单不管辖"的 config 字段，原样返回（含缩进）。
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * 为什么需要（2026-10-20，v0.9.3 审查 H2）
+ * ═══════════════════════════════════════════════════════════════════════════
+ *
+ * `upsertManagedBlock` 是**块级整体替换**：新块进来，旧块整段消失。
+ * 而面板的 setup 表单只提交 role/nodeId/transportMode/hubUrl/relayUrl/roots。
+ *
+ * 于是用户在面板点一次「保存」，托管块里的 `nodeToken`、`uiPullRoot`、
+ * `listenHost`、`listenPort`、`relay` **全部被静默删掉**（已实证）。
+ * 而 instance.json 那边也没存这些 —— 等于"点一次保存，凭证和设置就没了"。
+ *
+ * 修法不是让表单管更多字段（字段会一直加），而是**只重写自己管辖的那几个**，
+ * 其余原样搬回来。
+ *
+ * 实现刻意走**文本级切分**而不是 YAML 解析：
+ *   · 不需要引入解析器（本包零运行时依赖是硬约束）
+ *   · 保留用户的原始格式（注释、引号风格、键顺序）—— 解析再序列化会全部丢失
+ *
+ * @param {string} blockText 托管块正文（`MANAGED_BEGIN/END` 之间的内容）
+ * @param {Set<string>|string[]} ownedKeys 本次由表单管辖的顶层 config 键
+ * @returns {string[]} 需要原样保留的行
+ */
+export function extractPreservedConfig(blockText, ownedKeys) {
+  const src = typeof blockText === 'string' ? blockText : ''
+  const owned = ownedKeys instanceof Set ? ownedKeys : new Set(Array.isArray(ownedKeys) ? ownedKeys : [])
+  const lines = src.split('\n')
+
+  // 定位 `  config:`（两个空格缩进 —— loader 条目的标准形态）
+  const start = lines.findIndex((l) => /^\s{2}config:\s*$/.test(l))
+  if (start === -1) return []
+
+  const groups = []
+  let cur = null
+  for (let i = start + 1; i < lines.length; i += 1) {
+    const line = lines[i]
+    if (line.trim() === '') {
+      // 空行跟着当前组（保留段落感），组还没开始就忽略
+      if (cur) cur.lines.push(line)
+      continue
+    }
+    // 顶层字段：4 个空格 + key:
+    const m = /^ {4}([A-Za-z0-9_]+):/.exec(line)
+    if (m) {
+      cur = { key: m[1], lines: [line] }
+      groups.push(cur)
+      continue
+    }
+    // 更深缩进（嵌套对象 / 列表项）→ 属于当前组
+    if (cur && /^ {5,}\S/.test(line)) {
+      cur.lines.push(line)
+      continue
+    }
+    // 缩进 ≤3 或新条目 —— config 段结束
+    break
+  }
+
+  const kept = []
+  for (const g of groups) {
+    if (owned.has(g.key)) continue
+    // 去掉尾部多余空行，避免拼回去时积累空行
+    const ls = g.lines.slice()
+    while (ls.length > 0 && ls[ls.length - 1].trim() === '') ls.pop()
+    kept.push(...ls)
+  }
+  return kept
+}
+
+/**
+ * 读取文件里现有托管块的正文（不含标记行）。没有托管块时返回 ''。
+ * @param {string} fileText
+ * @returns {string}
+ */
+export function readManagedBlockBody(fileText) {
+  const src = typeof fileText === 'string' ? fileText : ''
+  const i = src.indexOf(MANAGED_BEGIN)
+  if (i === -1) return ''
+  const j = src.indexOf(MANAGED_END, i)
+  if (j === -1) return ''
+  return src.slice(i + MANAGED_BEGIN.length, j)
+}
+
+/**
+ * 在托管块正文里设置 `nodeToken`（有则替换，无则插入），返回**新的块正文**。
+ *
+ * 为什么不是"重新生成整个块"：那会把用户手写的其它字段一起冲掉（H2）。
+ * 这里只动 token 这一行，其余字节保持原样。
+ *
+ * @param {string} blockText 托管块正文（不含标记）
+ * @param {string} token 新口令
+ * @returns {string}
+ */
+export function upsertTokenInBlock(blockText, token) {
+  const body = typeof blockText === 'string' ? blockText : ''
+  const t = typeof token === 'string' ? token.trim() : ''
+  if (t === '') return body
+  // 单引号包裹 + 转义：token 是 nt_ + base64url，理论上不含引号，但不赌
+  const line = `    nodeToken: '${t.replace(/'/g, "''")}'`
+  const lines = body.split('\n')
+
+  const i = lines.findIndex((l) => /^ {4}nodeToken:/.test(l))
+  if (i !== -1) {
+    lines[i] = line
+    return lines.join('\n')
+  }
+
+  // 没有 → 插到 `  config:` 之后（保持它作为 config 的第一个子键，可读性好）
+  const ci = lines.findIndex((l) => /^\s{2}config:\s*$/.test(l))
+  if (ci !== -1) {
+    lines.splice(ci + 1, 0, line)
+    return lines.join('\n')
+  }
+
+  // 连 config 行都没有（极早期手写块）→ 追加一个 config 段
+  const trimmed = body.replace(/\s+$/, '')
+  return `${trimmed}${trimmed === '' ? '' : '\n'}  config:\n${line}\n`
+}
+
 /**
  * 写盘主流程：备份 → 合并 → 写入 → 校验，失败自动回滚。
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-agent",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "type": "module",
   "description": "把另一台电脑变成你 DSH 的远程 Agent 同事：副机本地持久跑任务、独立 Agent 循环，只回传 handoff 摘要与产物清单，成品按需拉取。",
   "license": "MIT",

package/scripts/check-doc-drift.mjs

@@ -1113,7 +1113,7 @@ check('65', 'eslint 严格档：lint script + 配置文件 + CI job 三件套齐
     })(),
     'lib/hub/ui-routes.js（role: resolveRole(config) 而非原始 config.role）')
 
-  check('85', 'SMB 面板发真实 dir + CLI doctor 有 loopback 检查（H2 / M1）',
+  check('85', 'SMB 面板发真实 dir + CLI doctor 走独立监听判可达性（H2 / M1 / H5）',
     // H2：不得写死 dir: ''
     (() => {
       const i = clientSrc5.indexOf('function doPlan()')
@@ -1125,8 +1125,56 @@ check('65', 'eslint 严格档：lint script + 配置文件 + CI job 三件套齐
     && /nodeRoots/.test(clientSrc5)
     // M1：CLI 必须调 envChecks（否则没有 loopback 诊断）
     && /envChecks/.test(setupBin)
-    && /isLoopbackOrigin/.test(setupBin),
-    'lib/client.js（dir: shareDir + nodeRoots UI）+ bin/dsh-remote-setup.js（envChecks）')
+    // H5：回环判据必须来自 listen-server（一份实现），不是 CLI 自己拼 origin
+    && /isLoopbackHost/.test(setupBin)
+    // H5 负向守卫：CLI **不得**再从 patch 里找 webserver 段判可达性。
+    // 0.9.3 起端点由插件自己的独立监听承载，webserver 的 host 与副机接入
+    // 毫无关系 —— 读了会把人引向"改 webserver"这个改了也会被冲掉的死路。
+    // ⚠ 扫**剥注释后**的代码：注释里必须保留事故说明（含 `- id: webserver`
+    // 字样），那是给后来者的警示，不该被这条断言判违规。
+    && !/- id:\s*webserver/.test(stripComments(setupBin))
+    // 生效配置以 instance.json 为准（否则体检报告的是已失效的 patch 值）
+    && /readInstanceConfig/.test(setupBin),
+    'lib/client.js（dir: shareDir + nodeRoots UI）+ bin/dsh-remote-setup.js（envChecks + listen-server 判据）')
+}
+
+/* ── 86~87. 独立监听端口（2026-10-18，架构级修复）──
+ *
+ * 副机端点原来注册在 `ctx.webServer` 上 → 副机必须访问 DSH 的 webserver 端口。
+ * 而那个端口：
+ *   · **DSH 每次启动重写 profile patch**，把写进去的 `webserver` 段删掉
+ *     （实测：3962B/15 条 → 661B/3 条）→ 绑回 127.0.0.1 → 副机永远连不上
+ *   · `webServer` 激活即 listen，没有 rebind 方法
+ *   · 新版硬拒绝 0.0.0.0（会让 DSH 启动崩溃，踩过 10 份 crash 日志）
+ *
+ * 所以插件自己开一个 node:http server 服务节点端点，完全绕开 DSH 的 webserver。
+ * 这两条断言钉住"这条通道存在且不依赖 webServer"。
+ */
+{
+  const hubSrc2 = read('lib/hub/index.js')
+  const listenSrc = read('lib/listen-server.js')
+
+  check('86', '独立监听：插件自己开端口服务节点端点（不依赖 webServer 配置）',
+    /startListenServer/.test(hubSrc2)
+    && /resolveListenHost/.test(hubSrc2)
+    // 默认端口 19387（与历史配置/配对码/文档一致）
+    && /DEFAULT_LISTEN_PORT/.test(listenSrc)
+    && /19387/.test(listenSrc)
+    // 必须真的用 node:http 起 server（不是只 import 不用）
+    && /createServer/.test(listenSrc)
+    && /node:http/.test(listenSrc)
+    // 路径精确匹配（只承载节点端点，不做通用 web server）
+    && /pathname !== upgradePath/.test(listenSrc),
+    'lib/hub/index.js + lib/listen-server.js（node:http + acceptUpgrade + 精确路径）')
+
+  check('87', '独立监听：拒绝 0.0.0.0 + Tailscale 优先 + 测试环境不占端口',
+    // 拒绝通配地址（与新版 DSH 同规则；0.0.0.0 会让 DSH 崩溃，我们踩过）
+    /h !== '0\.0\.0\.0'/.test(listenSrc)
+    // 自动选地址时 Tailscale 优先（本插件的目标场景就是跨网）
+    && /isTailscaleIp/.test(listenSrc)
+    // 测试环境下不真的监听（否则 npm test 会挂住 —— 实测过）
+    && /NODE_TEST_CONTEXT/.test(hubSrc2),
+    'lib/listen-server.js（拒 0.0.0.0 + Tailscale 优先）+ hub/index.js（测试环境跳过）')
 }
 
 /* ── 输出 ── */