@noob-stupid/dsh-plugin-console 0.5.29 → 0.5.31

package/lib/server/infra/framework-root.js

@@ -0,0 +1,99 @@
+// L0 · infra —— framework-root.js（框架运行时解析基准；0.5.30 加法）
+//
+// 为什么必须有它（**真机事故 2026-09-28 / 2026-09-29**）：
+//   框架 0.2.0-rc.1 把 `@deepseek-ai/*` 的实体全部搬进 `.pnpm` **内部**那层，profile 顶层
+//   projection 还停在旧版（本机实测：顶层 239 个 `@deepseek-ai` 目录仍是 0.1.5-rc.2 的残影）。
+//   任何"只拿 profileDir 当解析基准"的判断都会把**真存在的框架内置包**（`dsh-agent-preset`、
+//   `dsh-workflow-ptc`）判成"缺失" —— 实测后果：`healPatchSafety()` 给它们自动写了 4 个
+//   `disabled: true` 块（2026-09-29 01:05:44），把用户的 preset-router-* 三条全停掉。
+//
+// 所以「框架内置包在不在」必须走**多基准并集**：任一基准能解析即算命中。
+// 本模块把该判据集中一处，供只读体检（routes/patch-audit.js）与补丁自愈（domain/patch.js）共用 ——
+// 两处若各写一份，下次框架再挪目录就会只有一处被修好。
+//
+// 行数预算：独立小模块，留在 600 行架构硬顶内。
+
+import { existsSync } from 'node:fs'
+import { dirname, isAbsolute, join, resolve, sep } from 'node:path'
+import { resolvePackageJson } from './paths.js'
+
+/** 框架命名空间：`@deepseek-ai/*` 随框架版本走，承载者永远是框架安装树。 */
+const FRAMEWORK_SCOPE = '@deepseek-ai/'
+
+/** 包名归一：`@scope/name/sub` → `@scope/name`；裸名原样。 */
+function basePackageName(moduleName) {
+  const text = String(moduleName ?? '')
+  if (text.startsWith('@')) {
+    const parts = text.split('/')
+    return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : text
+  }
+  return text.split('/')[0]
+}
+
+/** 归一后的包名是否属于框架命名空间（`@deepseek-ai/dsh-*`）。 */
+function isFrameworkModuleName(moduleName) {
+  const name = basePackageName(moduleName)
+  return name === FRAMEWORK_SCOPE.slice(0, -1) || name.startsWith(FRAMEWORK_SCOPE)
+}
+
+/** 路径是否落在给定根目录内（大小写不敏感，Windows 与 POSIX 都成立）。 */
+function isUnder(childPath, rootDir) {
+  if (typeof childPath !== 'string' || childPath === '' || typeof rootDir !== 'string' || rootDir === '') return false
+  let child = resolve(childPath).toLowerCase()
+  let root = resolve(rootDir).toLowerCase()
+  if (!root.endsWith(sep)) root += sep
+  if (!child.endsWith(sep)) child += sep
+  return child.startsWith(root)
+}
+
+/**
+ * 框架运行时解析基准（**有序**，先准后宽）：
+ *   ① `@deepseek-ai/dsh` 所在的那层 `node_modules`（= `.pnpm` 实体内部，框架内置包的真正家）
+ *   ② 从 ① 向上逐级找到的第一个含 `.pnpm` 的目录（与 ① 同层时去重）
+ *   ③ `@deepseek-ai/dsh` 解析不出来时的兜底：`baseDir` / `profileDir` 自身（供离线测试桩使用）
+ * 返回去重后的绝对路径数组；一个都拿不到时返回 `[]`（调用方必须把空数组当"无法判定"而非"缺失"）。
+ */
+function frameworkBases(baseDir, profileDir) {
+  const out = []
+  const push = (dir) => {
+    if (typeof dir !== 'string' || dir === '' || !isAbsolute(dir)) return
+    const norm = resolve(dir)
+    if (!out.includes(norm)) out.push(norm)
+  }
+  let found = null
+  // base 有两种合法写法（`…/profiles/web` 这种**含 node_modules 的目录**，或 `…/.pnpm/<pkg>/node_modules`
+  // 这种 **node_modules 本身**）；resolvePackageJson 只认前者，所以后者要退一级再试 ——
+  // 否则框架基准这一路永远解析不到 `@deepseek-ai/dsh`，整个框架基准列表会退化成兜底值。
+  for (const base of [baseDir, profileDir]) {
+    if (typeof base !== 'string' || base === '') continue
+    for (const cand of [base, dirname(base)]) {
+      if (typeof cand !== 'string' || cand === '') continue
+      try {
+        found = resolvePackageJson('@deepseek-ai/dsh', cand, profileDir)
+      } catch { found = null }
+      if (found !== null) break
+    }
+    if (found !== null) break
+  }
+  if (found !== null) {
+    // ★ 2026-09-30 改错（本批修 A 事故时抓到）：这里过去是 `dirname(dirname(pkgPath))` ——
+    //   pkgPath 形如 `<…>/node_modules/@deepseek-ai/dsh/package.json`，两层 dirname 只退到
+    //   **scope 目录** `<…>/node_modules/@deepseek-ai`（实测 `existsSync(inner@deepseek-ai)` = false），
+    //   拿它当解析基准必然解析不到任何包。正确是**三层**：package.json → dsh → @deepseek-ai → node_modules。
+    const inner = dirname(dirname(dirname(found)))
+    push(inner)
+    let dir = inner
+    for (let i = 0; i < 6; i += 1) {
+      if (existsSync(join(dir, '.pnpm'))) { push(dir); break }
+      const parent = dirname(dir)
+      if (parent === dir) break
+      dir = parent
+    }
+  }
+  // 兜底：框架树找不到时，至少把 profile 目录本身当基准 —— 否则 `bases` 为空会让
+  // 自愈把所有 insert 行都判成"无法确认"（宁缺勿滥，但那会让真缺失的行不再被停用）。
+  if (out.length === 0) { push(profileDir); push(baseDir) }
+  return out
+}
+
+export { FRAMEWORK_SCOPE, basePackageName, frameworkBases, isFrameworkModuleName, isUnder }

package/lib/server/infra/fsx.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { existsSync, rmSync, readdirSync, mkdirSync, copyFileSync, chmodSync, lstatSync, renameSync } from 'node:fs'
 import { dirname, join, basename } from 'node:path'
@@ -66,9 +66,9 @@ let writeQueue = Promise.resolve()
 
 /**
  * 删除目录树并**核实删除结果**。
- * 为什么要核实：本机某些环境（受限令牌/沙箱/杀软占用）下 `rmSync` 会**静默落空**——不抛错、目录仍在。
+ * 为什么要核实：某些环境（受限令牌/沙箱/杀软占用）下 `rmSync` 会**静默落空**——不抛错、目录仍在。
  * 路由若删完直接 `{ok:true}` 就是对用户撒谎（2026-09-20 多类型演练实测：同一个 `rmSync` 在
- * `D:\dsh\repos` 删得掉，在 `C:\Users\<user>\.dsh\...` 下返回成功但目录原封不动）。
+ * 短路径（如 `C:\repos`）删得掉，在 `C:\Users\<user>\.dsh\...` 下返回成功但目录原封不动）。
  * 返回 `{ok, attempts, error}`；`ok:false` 时调用方必须如实报错，不能吞。
  */
 function removeDirVerified(dir) {

package/lib/server/infra/http.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { execFile } from 'node:child_process'
 import { resolve } from 'node:path'

package/lib/server/infra/httpd.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 
 /** 写请求跨站防护：浏览器同源策略不阻止跨站发送，必须校验 Origin / Sec-Fetch-Site。

package/lib/server/infra/mask.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 
 function maskUrl(url) {

package/lib/server/infra/package-resolve.js

@@ -0,0 +1,73 @@
+// L0 · infra —— package-resolve.js（Node 解析器封装：包名可解析性 + 可用包名枚举；0.5.30 加法）
+//
+// 为什么不用「store 目录名」判断包在不在（真机教训 2026-09-28）：
+//   pnpm 会**截断超长目录名**（`@deepseek-ai+dsh-workflow-ptc` → `@deepseek-ai+dsh-workflow-p_<hash>`），
+//   按目录名前缀匹配会把**存在的包**误判成不存在 —— 本机实测：`dsh-workflow-ptc`、`dsh-agent-preset`
+//   两个真存在的包都被目录名法误报。所以体检一律走 **Node 自己的解析器**（与框架加载补丁行同一套解析），
+//   并在多个基准上取并集：① profile 目录（第三方插件在这里）② 框架运行时根（`@deepseek-ai/*` 在这里）。
+
+import { createRequire } from 'node:module'
+import { existsSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+
+/**
+ * 基准目录 → `createRequire` 的探针位置。
+ * base 有两种合法写法，本函数把两者都收下（判据：base 自己是不是就叫 node_modules）：
+ *   · base 是**含 node_modules 的目录**（如 profile 目录 `<…>/profiles/web`）→ 探针 `<base>/__patch_audit_probe__.js`
+ *   · base 本身就是 **node_modules 目录**（如 `…/.pnpm/@deepseek-ai+dsh@…/node_modules`）→ 探针放它内部
+ * 为什么必须兼容第二种：框架内置包的实体只存在于 `.pnpm/<pkg>/node_modules/` 这一层，
+ * 说"框架基准"时最自然的写法就是那层本身；若一律拼 `<base>/node_modules/…`，
+ * 就会去找 `<…>/node_modules/node_modules` —— **真存在的包被判成不存在**（本套 ① 段即是回归）。
+ */
+function probePathOf(base) {
+  return base.replace(/[\\/]+$/u, '').toLowerCase().endsWith('node_modules')
+    ? join(base, '__patch_audit_probe__.js')
+    : join(base, 'node_modules', '__patch_audit_probe__.js')
+}
+
+/** 造多基准解析器：任一基准能解析即算命中（`from` 如实回带，便于报告里说明"从哪解析到的"）。 */
+function makePackageResolver(bases) {
+  const reqs = []
+  for (const base of (Array.isArray(bases) ? bases : [])) {
+    if (typeof base !== 'string' || base === '') continue
+    try { reqs.push(createRequire(probePathOf(base))) } catch {}
+  }
+  return (name) => {
+    for (const req of reqs) {
+      try { return { ok: true, from: req.resolve(name) } } catch {}
+    }
+    return { ok: false, reason: '所有基准都解析不到（包可能已被移除/改名，或该子路径不存在）' }
+  }
+}
+
+/** 枚举一个 node_modules 目录下可见的包名（含 scope 内一层）。 */
+function listPackageNames(nodeModulesDir, limit = 4000) {
+  const out = []
+  try {
+    for (const entry of readdirSync(nodeModulesDir, { withFileTypes: true })) {
+      if (out.length >= limit) break
+      if (!entry.isDirectory() || entry.name.startsWith('.')) continue
+      if (entry.name.startsWith('@')) {
+        for (const sub of readdirSync(join(nodeModulesDir, entry.name), { withFileTypes: true })) {
+          if (out.length >= limit) break
+          if (sub.isDirectory() && !sub.name.startsWith('.')) out.push(`${entry.name}/${sub.name}`)
+        }
+        continue
+      }
+      out.push(entry.name)
+    }
+  } catch {}
+  return out
+}
+
+/** 合并多个 node_modules 目录下的包名（去重）—— 供「疑似改名」当候选集。 */
+function listAvailablePackages(dirs) {
+  const set = new Set()
+  for (const dir of (Array.isArray(dirs) ? dirs : [])) {
+    if (typeof dir !== 'string' || dir === '' || !existsSync(dir)) continue
+    for (const name of listPackageNames(dir)) set.add(name)
+  }
+  return [...set]
+}
+
+export { listAvailablePackages, listPackageNames, makePackageResolver }

package/lib/server/infra/paths.js

@@ -1,5 +1,5 @@
 // L0 · infra（paths.js）—— 分层 Step 从 lib/index.js 搬出，只搬移未改逻辑
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, existsSync, statSync } from 'node:fs'
 import { dirname, join, resolve } from 'node:path'

package/lib/server/infra/registry-versions.js

@@ -0,0 +1,64 @@
+// L0 · infra —— registry-versions.js（registry 元数据探针：包名 → 某版本是否已发布；0.5.30 加法）
+//
+// 用途：**升级前**核对「profile 补丁里引用的框架包，在目标版本里还在不在」。
+// 真机事故 2026-09-28：0.2.0-rc.1 移除了 `@deepseek-ai/dsh-workflow-worker-thread`（引擎改为 ptc），
+// 补丁仍指向旧包 → 升级后 `workflowEngine` 无提供方 → 老会话 resume 失败。
+// 这类「官方移除/改名」在升级前**只能用 registry 元数据看见**（目标版本还没装到本机）。
+//
+// 三个取舍：
+//   ① 同一次预检里**同一个包只查一次**（内存缓存）—— 补丁里同名包可能出现在多处；
+//   ② 网络失败/元数据缺失 → 返回 **null（未知）**，绝不当作「不存在」；
+//   ③ 小并发（默认 4）+ 单请求超时，避免预检被 30 个包串行拖死。
+
+import { fetchJsonUrl } from './http.js'
+
+/** 包名 → URL 片段（`@a/b` → `@a%2fb`）。 */
+function encodePackageName(name) {
+  return String(name).replace('/', '%2f')
+}
+
+/** 造版本探针：`(name) => { ok, versions?, error? }`（带内存缓存）。 */
+function makeVersionProbe({ registry, fetchJson, timeoutMs = 9000, cache = new Map() } = {}) {
+  const fetchImpl = typeof fetchJson === 'function' ? fetchJson : (url, t) => fetchJsonUrl(url, t)
+  return async (name) => {
+    if (cache.has(name)) return cache.get(name)
+    let result
+    try {
+      const meta = await fetchImpl(`${registry}/${encodePackageName(name)}`, timeoutMs)
+      const versions = meta && typeof meta === 'object' && meta.versions !== null && typeof meta.versions === 'object'
+        ? Object.keys(meta.versions)
+        : []
+      result = { ok: true, versions }
+    } catch (error) {
+      result = { ok: false, error: String(error?.message ?? error) }
+    }
+    cache.set(name, result)
+    return result
+  }
+}
+
+/** 批量核对：`[{name, lines}]` → `[{name, lines, published: true|false|null}]`（小并发，保序）。 */
+async function checkPublishedVersions(entries, { probe, version, concurrency = 4 } = {}) {
+  const list = Array.isArray(entries) ? entries : []
+  const width = Math.max(1, Number.isFinite(concurrency) && concurrency > 0 ? Math.floor(concurrency) : 4)
+  const out = new Array(list.length)
+  let cursor = 0
+  const worker = async () => {
+    for (;;) {
+      const index = cursor
+      cursor += 1
+      if (index >= list.length) return
+      const entry = list[index]
+      let published = null
+      try {
+        const res = await probe(entry.name)
+        if (res?.ok === true) published = Array.isArray(res.versions) ? res.versions.includes(version) : null
+      } catch { published = null }
+      out[index] = { name: entry.name, lines: Array.isArray(entry.lines) ? entry.lines : [], published }
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(width, list.length) }, () => worker()))
+  return out.filter((x) => x !== undefined)
+}
+
+export { checkPublishedVersions, encodePackageName, makeVersionProbe }

package/lib/server/infra/semver.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 
 /** 最小 semver：解析（含 prerelease/build）。 */

package/lib/server/routes/compat.js

@@ -13,6 +13,7 @@
 
 import { dirname } from 'node:path'
 import { compareFingerprint, computeFingerprint, readCompatMode, readFingerprint, readRollbackRecord, stampFingerprint, writeCompatMode } from '../domain/compat-state.js'
+import { NOTICE_MODES, detectCompat, readCompatAck, readCompatGate, writeCompatAck, writeCompatGate } from '../domain/compat.js'
 import { currentFrameworkVersion } from '../domain/framework.js'
 import { applyDependencyBackfill, planDependencyBackfill } from '../domain/manifest.js'
 import { preferredRegistries } from '../domain/sources.js'
@@ -127,4 +128,43 @@ async function routeDeclareInstalled(req, res, rc) {
   }
 }
 
-export { routeCompatMode, routeCompatStamp, routeCompatStatusGet, routeDeclareInstalled }
+/** 兼容提示：手动关闭 / 设定展示模式（2026-09-28 加法）。
+ *
+ *  背景（用户实测）：面板顶部那句「当前 DSH web 包版本 X 不在受支持的 0.1.x 系列内…」是**披露**，
+ *  但它以前**关不掉** —— 纯 `<p>`、没有关闭入口、也没有持久化。用户诉求：可以手动关。
+ *
+ *  两种入参（互斥，按字段判断）：
+ *    · `{ webAppVersion }` → 记住"这个版本我看过了"：同版本不再提示，**框架版本一变重新提示**
+ *    · `{ mode }`         → 展示模式 `always` / `once-per-version`（默认）/ `off`
+ *
+ *  ⚠ 硬约束：**只影响展示，不改 `supported`** —— 门控判定与"该不该拦"一个字都不变，
+ *    披露不能被关成"看不见的风险"。版本还会校验：只接受**当前探测到**的那一个，
+ *    避免把 ack 记到别的版本上（否则升到新版本时会被误吞）。
+ */
+async function routeCompatAck(req, res, rc) {
+  const body = rc.body ?? {}
+  if (typeof body.mode === 'string') {
+    const mode = body.mode.trim().toLowerCase()
+    if (!NOTICE_MODES.includes(mode)) {
+      sendError(res, 400, `未知的提示模式：${body.mode}（可选 ${NOTICE_MODES.join(' / ')}）`)
+      return
+    }
+    const gate = writeCompatGate({ noticeMode: mode })
+    sendJson(res, 200, { ok: true, noticeMode: gate.noticeMode, ack: readCompatAck() })
+    return
+  }
+  const version = typeof body.webAppVersion === 'string' ? body.webAppVersion.trim() : ''
+  if (version === '' || !/^\d+\.\d+\.\d+/u.test(version)) {
+    sendError(res, 400, 'webAppVersion 缺失或格式不对（形如 0.2.0-rc.1）')
+    return
+  }
+  let detected = null
+  try { detected = (await detectCompat(rc?.ctx?.baseUrl ?? 'file:///')).webAppVersion } catch {}
+  if (detected !== null && detected !== version) {
+    sendError(res, 400, `版本不匹配：当前探测到 ${detected}，请求里是 ${version}（请刷新后重试）`)
+    return
+  }
+  const ack = writeCompatAck(version)
+  sendJson(res, 200, { ok: true, ack, noticeMode: readCompatGate().noticeMode })
+}
+export { routeCompatAck, routeCompatMode, routeCompatStamp, routeCompatStatusGet, routeDeclareInstalled }

package/lib/server/routes/components.js

@@ -109,7 +109,7 @@ async function routeRepoLandConfig(req, res, rc) {
   const body = rc.body
     const dir = typeof body.dir === 'string' ? body.dir.trim() : ''
     if (dir === '' || !/^[A-Za-z]:[\\/]/.test(dir) && !/^\\\\/.test(dir)) {
-      // 0.5.28 改错：示例原本写成本机真实目录 `D:\dsh\repos`（把开发者的目录当成了通用示例）。
+      // 0.5.28 改错：示例原本写成本机真实目录（把开发者的目录当成了通用示例）。
       // 换成中性的任意绝对路径示例，并说明"任意绝对路径"——判据是形状（盘符/UNC），不是具体目录。
       sendError(res, 400, '保存路径不合法：请提供绝对路径（任意绝对路径均可，如 C:\\repos 或 \\\\server\\share\\repos）')
       return

package/lib/server/routes/framework-preflight.js

@@ -7,17 +7,20 @@
 // 「一发消息就报错、会话整体不可用」。包级适配门（peerDependencies / 版本号）看不见这类
 // 运行期契约破坏，所以必须在**升级前**单独预检、先把本地适配好再装。
 
-import { readFileSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { isFrameworkOwnedPackage } from '../domain/compat.js'
+import { classifyTargetAvailability, frameworkPackageRows, parsePatchRows } from '../domain/patch-composition-audit.js'
+import { collectPresetAudit } from '../domain/preset-audit.js'
 import { loadContractRules, summarizeContractRules } from '../domain/contract-rules.js'
 import { discoverFormatContract, summarizeContract } from '../domain/format-contract.js'
 import { applyFormatPatch, collectProducerTargets, scanProducerFiles } from '../domain/format-scan.js'
 import { currentFrameworkVersion } from '../domain/framework.js'
 import { listEntries } from '../domain/runtime.js'
 import { curlText, fetchJsonUrl } from '../infra/http.js'
+import { checkPublishedVersions, makeVersionProbe } from '../infra/registry-versions.js'
 import { sendError, sendJson } from '../infra/httpd.js'
-import { baseDirOf, dshHome, pluginRoot, profileDirOf, resolvePackageJson } from '../infra/paths.js'
+import { baseDirOf, dshHome, findPatchPath, pluginRoot, profileDirOf, resolvePackageJson } from '../infra/paths.js'
 
 const REGISTRY = 'https://registry.npmmirror.com'
 
@@ -109,6 +112,42 @@ async function routeFrameworkPreflight(req, res, rc) {
   const rules = contract?.rules ?? { producerKindRequired: false, forbiddenKinds: ['plugin'], pluginPrefix: 'plugin:', renames: {} }
   const scan = scanProducerFiles({ targets, rules, targetVersion })
 
+  // 补丁 ↔ 目标版本核对（2026-09-28 加法；真机事故：0.2.0-rc.1 移除了
+  // `@deepseek-ai/dsh-workflow-worker-thread`，补丁三处仍引用 → 升级后 `workflowEngine`
+  // 没有提供方 → `dsh-tool-workflow`/`dsh-tool-ralph` 永久 waiting → 老会话 resume 失败）。
+  // 只核对**随框架版本走**的包（`@deepseek-ai/*`）：目标版本还没装到本机，只有 registry 元数据能提前看见。
+  // 网络不可用/查询失败一律记 `unknown`，**绝不判死**。
+  let patchTarget = { checked: 0, missing: [], unknown: [], skipped: null, patchPath: null }
+  try {
+    const patchPath = findPatchPath(rc.ctx)
+    patchTarget.patchPath = patchPath
+    if (patchPath === null || !existsSync(patchPath)) {
+      patchTarget.skipped = '找不到 profile 补丁文件（cordis.patch.yml）'
+    } else {
+      const rows = parsePatchRows(readFileSync(patchPath, 'utf8'))
+      const fwRows = frameworkPackageRows(rows)
+      if (fwRows.length === 0) patchTarget.skipped = '补丁里没有随框架版本走的包（@deepseek-ai/*）'
+      else if (!networkAllowed()) patchTarget.skipped = '已跳过网络（DSH_TEST_SKIP_NETWORK=1）'
+      else {
+        const probe = makeVersionProbe({ registry: REGISTRY, fetchJson: (url, timeoutMs) => fetchJsonUrl(url, timeoutMs) })
+        const results = await checkPublishedVersions(fwRows, { probe, version: targetVersion })
+        const publishedBy = new Map(results.map((row) => [row.name, row.published]))
+        const classified = classifyTargetAvailability(fwRows, { publishedBy, targetVersion })
+        patchTarget = { ...patchTarget, checked: results.length, missing: classified.missing, unknown: classified.unknown, skipped: null }
+      }
+    }
+  } catch (error) {
+    patchTarget.skipped = '核对失败：' + String(error?.message ?? error)
+  }
+  // 预设声明行体检（2026-09-28 加法）：升级前就能看见"补丁里的声明行已陈旧/缺失"。
+  // 真机事故：预设自身被改成 v10、补丁行还指向 v1 → 老会话 resume 到错的模块，且没有任何地方会报。
+  // 只读、不阻塞：作为 presetAudit 字段随预检一起下发（blockers>0 时由面板提示先修再升）。
+  let presetAudit = null
+  try {
+    presetAudit = collectPresetAudit({ presetsRoot: join(dshHome(), '.agent-presets'), patchPath: findPatchPath(rc.ctx) })
+  } catch (error) {
+    presetAudit = { ok: false, error: String(error?.message ?? error), blockers: 0, stale: [], missing: [], orphan: [], targetMissing: [] }
+  }
   sendJson(res, 200, {
     ok: true,
     targetVersion,
@@ -122,6 +161,8 @@ async function routeFrameworkPreflight(req, res, rc) {
     rules: summarizeContractRules(loadContractRules()),
     roots: roots.map((r) => ({ root: r.root, kind: r.kind, moduleName: r.moduleName ?? null })),
     scan,
+    patchTarget,
+    presetAudit,
   })
 }
 

package/lib/server/routes/framework-upgrade.js

@@ -1,7 +1,6 @@
 // L2 · routes —— 框架升级（POST /framework-upgrade）
-// 分层 Step 8b：从 lib/index.js 的 handle() 原样搬出（只搬移未改逻辑）。
-// 注：这个 handler 661 行（内置大段 PowerShell 脚本模板），是守卫「单文件 ≤ 600 行」的受限例外（见守卫 SIZE_EXCEPTIONS）；
-// 待抽包阶段把脚本模板挪进 domain/framework-script.js 后撤销例外。
+// 分层 Step 8b：从 lib/index.js 的 handle() 原样搬出（只搬移未改逻辑）。这个 handler 内置大段
+// PowerShell 脚本模板，是守卫「单文件 ≤ 600 行」的受限例外（见 SIZE_EXCEPTIONS），待抽包阶段撤销。
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
 import { writeFile } from 'node:fs/promises'
@@ -11,7 +10,7 @@ import { tmpdir } from 'node:os'
 import { pathToFileURL } from 'node:url'
 import { createRequire } from 'node:module'
 import { readCompatMode, writeCompatMode } from '../domain/compat-state.js'
-import { FRAMEWORK_BACKUP_ROOT, backupProfileSnapshot, checkpointFrameworkTree, preflightDisableIncompatible, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, resolveFrameworkUpgradePlan, shellHostedRefusal } from '../domain/framework.js'
+import { FRAMEWORK_BACKUP_ROOT, backupProfileSnapshot, checkpointFrameworkTree, platformUpgradeRefusal, preflightDisableIncompatible, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, resolveFrameworkUpgradePlan, shellHostedRefusal } from '../domain/framework.js'
 import { fwIntegrityCheck } from '../infra/fw-integrity-check.js'
 import { CORE_PATCH_ROW_IDS } from '../domain/patch.js'
 import { migrateAgentConfigsForUpgrade } from '../domain/presets.js'
@@ -80,12 +79,15 @@ async function routeFrameworkUpgrade(req, res, rc) {
       } catch {}
     }
     // 拉元数据 → 候选版本列表 → 本次目标（helper 里同时做「用户自选版本」的白名单校验）
-    const plan = await resolveFrameworkUpgradePlan({ current, wanted: body.version, fetchJson: fetchJsonUrl })
+    const plan = await resolveFrameworkUpgradePlan({ current, wanted: body.version, fetchJson: rc.deps.fetchJson ?? fetchJsonUrl })
     const { latest, next, alpha, versions, tagDefault, registryError } = plan
     if (plan.rejected !== null) {
       sendError(res, 400, `升级目标 ${plan.rejected} 不在可选列表内（只接受比当前 ${current ?? '?'} 更新的已发布版本；降级请用「回滚到上一版」）`)
       return
     }
+    // 平台守卫（2026-09-29 改错）：本通道 = schtasks.exe + PowerShell，只有 win32 有；判据与文案见
+    // domain/framework.js#platformUpgradeRefusal。放在入参校验之后、任何副作用之前 —— 绝不假成功。
+    const platformRefusal = platformUpgradeRefusal(); if (platformRefusal !== null) { sendError(res, 501, platformRefusal.error, platformRefusal.details); return }
     const target = plan.target
     const profileDir = dirname(findPatchPath(ctx))
     // 1) 升级前打包备份现有配置（patch / profile package.json / 插件清单）
@@ -138,17 +140,16 @@ async function routeFrameworkUpgrade(req, res, rc) {
         steps.push(`另有 ${preflight.skipped.length} 行无法预判（受保护行/包信息读不到），保持启用，由升级后的启动失败隔离兜底`)
       }
     }
-    // 2) 自动升级框架：运行中的服务锁着 dsh/lib 目录（EBUSY 无法原地替换），
-    //    因此生成独立升级脚本（kill 服务 → npm 升级 → 失败回滚 → 拉起服务），后台执行。
-    //    与 /restart 同款自守护模式：端口无监听会自动拉起，不会留下"服务起不来"。
+    // 2) 自动升级框架：运行中的服务锁着 dsh/lib 目录（EBUSY 无法原地替换）→ 生成独立升级脚本
+    //    （kill 服务 → npm 升级 → 失败回滚 → 拉起服务）后台执行；与 /restart 同款自守护，不会留下"服务起不来"。
     if (hasUpdate && dshDir !== null) {
       const port = webPort(ctx)
       const nodePath = process.execPath
       const binPath = resolveDshBin()
       const npmCli = join(dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')
       // 事故教训：npm 的 lib/cli.js 是「函数模块」（module.exports = (process) => validateEngines(...)），
-      // 直跑 `node lib/cli.js` 只加载函数定义、不执行命令——立即退出 exit 0（假成功，曾导致
-      // "npm 退出码 0 但版本未更新"）。唯一正确入口是 bin/npm-cli.js（它调用 cli.js 函数）。
+      // 直跑它只加载函数定义、不执行命令——立即退出 exit 0（假成功，"npm 退出码 0 但版本未更新"）。
+      // 唯一正确入口是 bin/npm-cli.js（它调用 cli.js 函数）。
       const corepackJs = join(dirname(process.execPath), 'node_modules', 'corepack', 'dist', 'corepack.js')
       // 预检（事故教训）：corepack（pnpm 通道）/ dsh bin.js 缺失时**拒绝生成升级脚本**（不 kill 服务）——
       // 避免"kill 后升级/拉起双双失败，服务永久 down"
@@ -640,16 +641,14 @@ async function routeFrameworkUpgrade(req, res, rc) {
       setFwCheckCache(null)
       // UTF-8 BOM：powershell 5.1 按 ANSI 读无 BOM 文件，中文会乱码——加 BOM 保证解析正确。
       // 执行方式：schtasks 一次性计划任务（Task Scheduler 启动，独立于服务进程树/Job Object）——
-      // 服务进程被杀时，其子进程（execFile/detached 的 powershell）会被 Job/进程树连带杀死，
-      // 曾多次卡死在「停止服务」之后；计划任务彻底脱离，杀服务绝对影响不到升级脚本。
+      // 服务进程被杀时其子进程（execFile/detached 的 powershell）会被 Job 连带杀死，
+      // 计划任务彻底脱离，杀服务影响不到升级脚本。
       writeFile(ps1, `\uFEFF${lines}`, 'utf8').then(
         () => {
           const ps1Posix = ps1.replace(/\\/gu, '/')
-          // 无引号 /tr（重要）：Task Scheduler 对带引号命令的解析会把 Command 拆坏成
-          // `"powershell ... -File \"`（非有效可执行文件）——任务显示 Ready、/run 报 SUCCESS
-          // 但永不执行（曾导致升级/重启脚本反复"已启动"却不动作、服务不停止）。实测无引号
-          // 格式（exe 与脚本路径均无空格时）任务正常执行、脚本完整跑通。仅当脚本路径含空格
-          // 时才退回带引号格式（schtasks 引号解析在服务 execFile 上下文不可靠，此时宁可用它）。
+          // 无引号 /tr（重要）：Task Scheduler 会把带引号命令的 Command 拆坏成 `"powershell … -File \"`
+          // （非有效可执行文件）——任务显示 Ready、/run 报 SUCCESS 但永不执行（曾导致脚本反复"已启动"
+          // 却不动作）。实测无引号格式（exe 与脚本路径均无空格时）正常；仅脚本路径含空格时才退回带引号格式。
           const tr = / /.test(ps1Posix)
             ? `"powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File \\"${ps1Posix}\\""`
             : `C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File ${ps1Posix}`

package/lib/server/routes/framework.js

@@ -8,7 +8,7 @@ import { dirname, join, resolve } from 'node:path'
 import { tmpdir } from 'node:os'
 import { createRequire } from 'node:module'
 import { readCompatGate, writeCompatGate } from '../domain/compat.js'
-import { cleanupStaleFwTasks, currentFrameworkVersion, pickFrameworkTarget, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, shellHostedRefusal } from '../domain/framework.js'
+import { cleanupStaleFwTasks, currentFrameworkVersion, pickFrameworkTarget, platformUpgradeRefusal, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, shellHostedRefusal } from '../domain/framework.js'
 import { readGithubAuth } from '../domain/install.js'
 import { webPort } from '../domain/runtime.js'
 import { fetchJsonUrl } from '../infra/http.js'
@@ -32,6 +32,21 @@ function refuseWhenShellHosted(res) {
   return true
 }
 
+/**
+ * 平台守卫（2026-09-29 改错，与宿主守卫同形）：一键升级/回滚脚本整体依赖 Windows 机制 ——
+ * `schtasks.exe` 计划任务 + PowerShell + `Get-NetTCPConnection`；非 Windows 上 execFile 必然 ENOENT，
+ * 而旧实现会先写一个「脚本已启动」的状态文件、再去 exec 不存在的 powershell.exe，**最后仍回 ok:true**
+ * （用户以为在跑，实际零动作）。判据与文案见 domain/framework.js#platformUpgradeRefusal。
+ * 命中时：不写状态文件、不 spawn、不建计划任务，直接 501 + 手动升级出路。
+ * 返回 true = 已拒绝（调用方直接 return）；false = win32，原路径一字不改。
+ */
+function refuseWhenPlatformUnsupported(res) {
+  const refusal = platformUpgradeRefusal()
+  if (refusal === null) return false
+  sendError(res, 501, refusal.error, refusal.details)
+  return true
+}
+
 async function routeFrameworkUpgradeStatusGet(req, res, rc) {
   const ctx = rc.ctx
   const url = rc.url
@@ -355,6 +370,7 @@ async function routeFrameworkRollback(req, res, rc) {
       sendError(res, 409, '没有可用的框架全树回滚点（framework-rollback.json 缺失或 checkpoint 已清理）')
       return
     }
+    if (refuseWhenPlatformUnsupported(res)) return // 平台守卫（改错）：回滚脚本同样是 schtasks+PowerShell，非 win32 一律拒绝而不是假成功（放在只读状态校验之后、任何写盘/exec 之前）
     const port = webPort(ctx)
     const nodePath = process.execPath
     const taskName = `DSH-FW-Rollback-${process.pid}`
@@ -576,4 +592,4 @@ async function routeFrameworkStatusClear(req, res, rc) {
   }
   sendJson(res, 200, { ok: true, removed, status: 'idle', message: null })
 }
-export { refuseWhenShellHosted, routeFrameworkStatusClear, routeFrameworkUpgradeStatusGet, routeFrameworkRelaunch, routeFrameworkCheck, routeCompatGate, routeCheckUpdate, routeFrameworkRollback, routeRestart }
+export { refuseWhenShellHosted, refuseWhenPlatformUnsupported, routeFrameworkStatusClear, routeFrameworkUpgradeStatusGet, routeFrameworkRelaunch, routeFrameworkCheck, routeCompatGate, routeCheckUpdate, routeFrameworkRollback, routeRestart }

package/lib/server/routes/github-login.js

@@ -149,8 +149,8 @@ function shortOpenError(error) {
  * POST /plugin-console/github-open-login —— 唤起 dsh-github-login 的设备码登录窗口。
  *
  * 为什么失败也回 200（而不是 500）：这个能力是**外挂**的，装没装、装的是不是带 exe 的版本、
- * 当前 profile 有没有把它挂到 webServer 上，全都不由本插件决定（2026-09-20 实测：本机虽然装了
- * 该插件、exe 也在 D:\dsh\dsh-github-login\dist\，但当前 profile 下 GET /github-auth/status 仍是
+ * 当前 profile 有没有把它挂到 webServer 上，全都不由本插件决定（2026-09-20 实测：某个 profile 里虽然装了
+ * 该插件、exe 也在，但当前 profile 下 GET /github-auth/status 仍是
  * 404）。这些都是"这个通道现在不可用"，不是"服务端出错"：
  *   · 回 500 → 前端弹一句看不懂的报错，还看不出"该走 token 兜底"这条正路；
  *   · 回 200 + started:false + reason → 前端照原样把原因念给用户，并自动展开 token 粘贴面板。

package/lib/server/routes/index.js

@@ -11,11 +11,14 @@ import { pnpmRemove, readExtraBundleRows, runInstallJob } from '../domain/instal
 import { isProtectedModule, listEntries, webPort } from '../domain/runtime.js'
 import { DEFAULT_SEARCH } from '../domain/sources.js'
 import { runSuiteInstallJob } from '../domain/suite.js'
+import { fetchJsonUrl } from '../infra/http.js'
 import { readBody, sendError } from '../infra/httpd.js'
 import { routeAiConsent, routeAiEmpowerCancel, routeAiEmpowerList, routeAiEmpowerPlan, routeAiEmpowerRun, routeAiEmpowerStatus } from './ai.js'
 import { routeRunSuggested } from './actions.js'
 import { routeComponentAutostart, routeComponentStart, routeComponentStatus, routeComponentStop, routeComponents, routeRepoClone, routeRepoLandConfig, routeRepoList, routeRepoOpen, routeRepoRemove } from './components.js'
-import { routeCompatMode, routeCompatStamp, routeCompatStatusGet, routeDeclareInstalled } from './compat.js'
+import { routeCompatAck, routeCompatMode, routeCompatStamp, routeCompatStatusGet, routeDeclareInstalled } from './compat.js'
+import { routePatchAuditGet } from './patch-audit.js'
+import { routePresetAuditGet } from './preset-audit.js'
 import { routeFrameworkUpgrade } from './framework-upgrade.js'
 import { routeFrameworkPreflight, routeFrameworkPreflightPatch } from './framework-preflight.js'
 import { routeCheckUpdate, routeCompatGate, routeFrameworkCheck, routeFrameworkRelaunch, routeFrameworkRollback, routeFrameworkStatusClear, routeFrameworkUpgradeStatusGet, routeRestart } from './framework.js'
@@ -37,12 +40,23 @@ const ROUTES_EARLY = [
   { methods: ['GET'], path: `${ROUTE_PREFIX}/gitee-oauth-callback`, handler: routeGiteeOauthCallbackGet },
   { methods: ['GET'], path: `${ROUTE_PREFIX}/skills-installed`, handler: routeSkillsInstalledGet },  { methods: ['GET'], path: `${ROUTE_PREFIX}/framework-upgrade-status`, handler: routeFrameworkUpgradeStatusGet },
   { methods: ['GET'], path: `${ROUTE_PREFIX}/compat-status`, handler: routeCompatStatusGet },
+  // 只读体检（2026-09-30 改错：这两条**必须**住在守卫之前）。
+  // 原实现把它们登记在守卫之后的 ROUTES 表里 → GET 在守卫处就被 405 掉，永远到不了 handler。
+  // 真机现场（0.5.29 活体实例）：`GET /plugin-console/preset-audit` → 405「不支持的方法」，
+  //   `POST` 同路径 → 404「未知接口」—— 两句都由 handle() 自己发出，说明**查表根本没参与**。
+  // 判据：405 守卫 `if (method !== 'POST' && !(method === 'GET' && GET_COMPAT.has(pathname)))`
+  //   跑在 ROUTES 查表之前，只放行 POST（外加 GET_COMPAT 白名单）→
+  //   **任何声明 GET 的路由都必须登记在 ROUTES_EARLY**。该判据已固化进 tests/test-route-inventory.mjs。
+  { methods: ['GET'], path: `${ROUTE_PREFIX}/patch-audit`, handler: routePatchAuditGet },
+  { methods: ['GET'], path: `${ROUTE_PREFIX}/preset-audit`, handler: routePresetAuditGet },
   { methods: ['POST'], path: `${ROUTE_PREFIX}/framework-relaunch`, handler: routeFrameworkRelaunch },
 
 ]
 
 function routeDeps() {
-  return { runInstallJob, runSuiteInstallJob, webPort, readExtraBundleRows, detectAdoptablePending, listEntries, detectCompat, detectFrameworkUpgrade, DEFAULT_SEARCH, aiEmpowerExecute, aiEmpowerPlan, backupProfileSnapshot, currentFrameworkVersion, frameworkCompatReportFor, isProtectedModule, pnpmRemove, preflightDisableIncompatible, rowIdModuleMap }
+  // fetchJson：registry 元数据取数的注入缝（默认就是真通道）。测试要断言「非 win32 拒绝且零副作用」
+  // 时用它喂固定元数据，免得把网络与 CI 稳定性绑在一起（与其余 deps 同一种注入风格）。
+  return { runInstallJob, runSuiteInstallJob, webPort, readExtraBundleRows, detectAdoptablePending, listEntries, detectCompat, detectFrameworkUpgrade, DEFAULT_SEARCH, aiEmpowerExecute, aiEmpowerPlan, backupProfileSnapshot, currentFrameworkVersion, frameworkCompatReportFor, isProtectedModule, pnpmRemove, preflightDisableIncompatible, rowIdModuleMap, fetchJson: fetchJsonUrl }
 }
 
 async function handle(ctx, req, res) {
@@ -98,6 +112,7 @@ const ROUTES = [
   { methods: ['POST'], path: `${ROUTE_PREFIX}/framework-status-clear`, handler: routeFrameworkStatusClear },
   { methods: ['POST'], path: `${ROUTE_PREFIX}/compat-mode`, handler: routeCompatMode },
   { methods: ['POST'], path: `${ROUTE_PREFIX}/compat-stamp`, handler: routeCompatStamp },
+  { methods: ['POST'], path: `${ROUTE_PREFIX}/compat-ack`, handler: routeCompatAck },
   { methods: ['POST'], path: `${ROUTE_PREFIX}/declare-installed`, handler: routeDeclareInstalled },
   { methods: ['POST'], path: `${ROUTE_PREFIX}/framework-rollback`, handler: routeFrameworkRollback },
   { methods: ['POST'], path: `${ROUTE_PREFIX}/restart`, handler: routeRestart },