@noob-stupid/dsh-plugin-console 0.5.32 → 0.5.34

package/lib/server/domain/settings-api-scan.js

@@ -0,0 +1,266 @@
+// L1 · domain —— settings-api-scan.js（「已删除 dsh-settings API」源码扫描；0.5.33 改错时从 compat.js 搬出）
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
+//
+// 为什么单独成模块：判据从"源码里出现过这个名字"改成"这个名字**真的从
+// `@deepseek-ai/dsh-settings` 绑定进来**"——要先剥注释/字符串字面量，再解析 import/require 的
+// 绑定子句，逻辑比原先的按行子串匹配长得多，而 compat.js 已经 544 行（守卫上限 600）。
+// 搬移保持对外契约不变：`REMOVED_SETTINGS_SYMBOLS` / `referencesRemovedSymbol` /
+// `scanSettingsApiUsage` 三个名字照旧由 compat.js 导出。
+//
+// ── 0.5.33 改错（真机误报，证据充分）────────────────────────────────────────────────
+// 现症：`dshmarket` 被判 `check:'fail'`（= 「源码仍引用 0.1.2 起已删除的 dsh-settings API」），
+// 于是**框架升级预扫会把这个好插件自动禁用**。逐条核对它的三处命中：
+//   · dshmarket/lib/settings.js:45 / :53 / :73 —— 全在**注释**里；
+//   · dshmarket/lib/routes.js:3136 `settingsNamespace: settingsNamespaceState(),` —— 一个
+//     **HTTP 载荷对象的属性名**（值是自己的局部函数 `settingsNamespaceState`，与本包无关）；
+//   · 该包对 `@deepseek-ai/dsh-settings` 的 **import 零命中**（它早已把那两个 helper 内联）。
+// 旧判据（`text.includes(sym)` → v0.3.35 换成标识符边界 + 排除局部定义）挡不住这两类：
+// 注释里的名字与对象键上的名字都不是"引用"，但它们都在**代码行**上、也不是本地定义。
+//
+// 新判据（更严格，不放宽任何真引用）：
+//   ① 先掩掉注释、字符串/模板字面量、正则字面量（等长空格替换，保留换行与列偏移）；
+//      唯一保留的是**模块说明符字符串**（`from 'x'` / `require('x')` / `import('x')`），
+//      否则没法知道某个绑定来自哪个包。
+//   ② 只在**真的对这个包**的 import/require 绑定子句里取名字：
+//      `import { settingsNamespace } from '@deepseek-ai/dsh-settings'`、
+//      `import settingsNamespace from …`、`import * as s from …` 后的 `s.settingsNamespace`、
+//      `const { settingsNamespace } = require('@deepseek-ai/dsh-settings')`、
+//      `const { installSettingsSection } = await import('@deepseek-ai/dsh-settings')`。
+//   ③ 对象键、局部同名函数、别的模块的同名导入、注释与字符串里的名字 —— 一律不算。
+
+import { readdirSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+/** 0.1.2-rc.1 起被官方删除的 dsh-settings API（命中即"实际不兼容"）。 */
+const REMOVED_SETTINGS_SYMBOLS = ['settingsNamespace', 'installSettingsSection']
+
+/**
+ * **判据版本戳**（0.5.34 加法）：判据一变就必须改这个字符串。
+ *
+ * 为什么需要它（真机背景 2026-10-01）：`compat-pending.json` 里的结论是"当时的判据"写下的，
+ * 但面板把它当**事实**一直展示：`dshmarket` 记录里压着
+ * `check:"fail"` + `checkNote:"源码仍引用 0.1.2 起已删除的 dsh-settings API…"` ——
+ * 那是 0.5.33 收紧判据**之前**的误报结论（真机复核：现在 0 命中），
+ * 于是面板持续显示"实际不兼容，启用会让整个服务启动崩溃"，把用户永久钉在「待适配」。
+ * 有了版本戳，"这条结论是哪一版判据算的"就可以被后续读取代发判读 → 过期即重算（见 compat-verdict.js）。
+ *
+ *   v1 = 0.3.35 的「标识符边界 + 排除局部定义」（挡不住注释里的名字与对象键上的名字）
+ *   v2 = 0.5.33 的「真的从 `@deepseek-ai/dsh-settings` 绑定进来」（本文件实现）
+ */
+const SCAN_CRITERIA_VERSION = 'dsh-settings-scan/2'
+
+/** 这些 API 原本来自哪个包（只有真的从它绑定进来的名字才算引用）。 */
+const SETTINGS_MODULE = '@deepseek-ai/dsh-settings'
+
+const SPECIFIER_RE = `['"]${SETTINGS_MODULE.replace(/[/\\^$*+?.()|[\]{}]/gu, '\\$&')}['"]`
+
+/**
+ * 把注释、字符串/模板字面量、正则字面量掩成**等长空格**（换行/回车保留，行号与列偏移不变）。
+ * `keepSpecifier` 为真时保留"模块说明符"字符串的原样内容（`from 'x'` / `require('x')` / `import('x')`）。
+ *
+ * 这是**掩码**而不是删除：后续判据仍然按整份源码做正则，位置对得上才好排查。
+ */
+function maskLiterals(text, keepSpecifier) {
+  const src = String(text ?? '')
+  const out = src.split('')
+  const blank = (from, to) => {
+    for (let k = from; k < to; k += 1) if (out[k] !== '\n' && out[k] !== '\r') out[k] = ' '
+  }
+  const isWordChar = (ch) => ch !== undefined && /[A-Za-z0-9_$]/u.test(ch)
+  const wordBefore = (index) => {
+    let j = index
+    while (j > 0 && (src[j - 1] === ' ' || src[j - 1] === '\t')) j -= 1
+    let k = j
+    while (k > 0 && isWordChar(src[k - 1])) k -= 1
+    return src.slice(k, j)
+  }
+  const prevMeaningful = (index) => {
+    for (let k = index - 1; k >= 0; k -= 1) {
+      const ch = src[k]
+      if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r') continue
+      return ch
+    }
+    return ''
+  }
+  /** 当前位置若是 `word(` 的第一个实参，返回 `word`（用于 require(...) / import(...) 的说明符判定）。 */
+  const callWordBefore = (index) => {
+    let k = index - 1
+    while (k >= 0 && (src[k] === ' ' || src[k] === '\t')) k -= 1
+    if (k < 0 || src[k] !== '(') return ''
+    k -= 1
+    while (k >= 0 && (src[k] === ' ' || src[k] === '\t')) k -= 1
+    const end = k + 1
+    while (k >= 0 && isWordChar(src[k])) k -= 1
+    return src.slice(k + 1, end)
+  }
+  // 正则字面量的判定沿用仓库既有启发式（tests/test-architecture-guard.mjs 的 stripCode 同款）：
+  // 前一个有效字符说明这里不可能是除法，或者前一个词是 return/typeof 这类关键字。
+  const REGEX_PREV = new Set(['(', ',', '=', ':', '[', '!', '&', '|', '?', '{', '}', ';', '\n', ''])
+  const REGEX_KEYWORDS = new Set(['return', 'typeof', 'case', 'in', 'of', 'do', 'else', 'void', 'delete', 'new', 'instanceof', 'yield', 'await'])
+  let i = 0
+  while (i < src.length) {
+    const c = src[i]
+    const n = src[i + 1]
+    if (c === '/' && n === '/') {
+      const end = src.indexOf('\n', i)
+      const to = end < 0 ? src.length : end
+      blank(i, to)
+      i = to
+      continue
+    }
+    if (c === '/' && n === '*') {
+      const end = src.indexOf('*/', i + 2)
+      const to = end < 0 ? src.length : end + 2
+      blank(i, to)
+      i = to
+      continue
+    }
+    if (c === "'" || c === '"' || c === '`') {
+      let j = i + 1
+      while (j < src.length && src[j] !== c) {
+        if (src[j] === '\\') j += 1
+        j += 1
+      }
+      const end = j < src.length ? j + 1 : src.length
+      // 说明符字符串保留：紧跟在 `from` 之后，或作为 require(...) / import(...) 的第一个实参。
+      const asCallArgument = /^(?:require|import)$/u.test(callWordBefore(i))
+      const isSpecifier = keepSpecifier === true && c !== '`' && (wordBefore(i) === 'from' || asCallArgument)
+      if (!isSpecifier) blank(i + 1, end - 1)
+      i = end
+      continue
+    }
+    if (c === '/') {
+      const pm = prevMeaningful(i)
+      if (REGEX_PREV.has(pm) || REGEX_KEYWORDS.has(wordBefore(i))) {
+        let j = i + 1
+        let inClass = false
+        while (j < src.length) {
+          const ch = src[j]
+          if (ch === '\\') { j += 2; continue }
+          if (ch === '[') inClass = true
+          else if (ch === ']') inClass = false
+          else if (ch === '/' && !inClass) { j += 1; break }
+          else if (ch === '\n') break
+          j += 1
+        }
+        blank(i, j)
+        i = j
+        continue
+      }
+    }
+    i += 1
+  }
+  return out.join('')
+}
+
+/** 从一个绑定子句里取出**被导入的名字**（`a as b` 取 `a`；默认导入取它自己；`*` 交给命名空间那条路）。 */
+function importedNamesOf(clause) {
+  const names = new Set()
+  const text = String(clause ?? '')
+  const brace = text.match(/\{([^}]*)\}/u)
+  if (brace !== null) {
+    for (const part of brace[1].split(',')) {
+      const seg = part.trim()
+      if (seg === '') continue
+      const imported = seg.split(/\s+as\s+/u)[0].trim()
+      if (/^[A-Za-z_$][\w$]*$/u.test(imported)) names.add(imported)
+    }
+  }
+  const rest = brace === null ? text : text.replace(brace[0], ' ')
+  for (const seg of rest.split(',')) {
+    const t = seg.trim()
+    if (t === '' || t === '*' || /\s/u.test(t)) continue
+    if (/^[A-Za-z_$][\w$]*$/u.test(t)) names.add(t)
+  }
+  return names
+}
+
+/**
+ * 从源码里取出「真的从 `@deepseek-ai/dsh-settings` 绑定进来的名字」。
+ * 返回 `{ named, namespaces }`：`named` 是直接绑定的符号，`namespaces` 是包级命名空间
+ * （`import * as s` / `const s = require(…)`），它们的成员访问 `s.settingsNamespace` 也算引用。
+ */
+function settingsApiBindings(text) {
+  // 掩码只做一次：注释/字符串/正则变空格，模块说明符字符串保留 —— 判据据此认包。
+  const code = maskLiterals(text, true)
+  const named = new Set()
+  const namespaces = new Set()
+  // ① ESM 命名空间导入：`import * as s from '<mod>'`
+  for (const m of code.matchAll(new RegExp(`\\bimport\\s*\\*\\s*as\\s+([A-Za-z_$][\\w$]*)\\s+from\\s*${SPECIFIER_RE}`, 'gu'))) {
+    namespaces.add(m[1])
+  }
+  // ② ESM 具名/默认导入：`import { a, b as c } from '<mod>'` / `import d from '<mod>'`
+  //    子句里不允许再出现 import/from，长度封顶 2000 —— 挡住"跨到上一条 import 语句"的假匹配。
+  for (const m of code.matchAll(new RegExp(`\\bimport\\s+(?!\\*)((?:(?!\\bimport\\b|\\bfrom\\b)[\\s\\S]){0,2000}?)\\s+from\\s*${SPECIFIER_RE}`, 'gu'))) {
+    for (const name of importedNamesOf(m[1])) named.add(name)
+  }
+  // ③ CJS / 动态导入的解构绑定：`const { a } = require('<mod>')` / `= await import('<mod>')`
+  const callRe = `(?:require|import)\\s*\\(\\s*${SPECIFIER_RE}\\s*\\)`
+  for (const m of code.matchAll(new RegExp(`(?:const|let|var)\\s*\\{([^}]*)\\}\\s*=\\s*(?:await\\s+)?${callRe}`, 'gu'))) {
+    for (const name of importedNamesOf(`{${m[1]}}`)) named.add(name)
+  }
+  // ④ CJS / 动态导入的命名空间绑定：`const s = require('<mod>')`
+  for (const m of code.matchAll(new RegExp(`(?:const|let|var)\\s+([A-Za-z_$][\\w$]*)\\s*=\\s*(?:await\\s+)?${callRe}`, 'gu'))) {
+    namespaces.add(m[1])
+  }
+  return { named, namespaces }
+}
+
+/** 命中的已删除符号列表（空数组 = 干净）。判据见文件头：只有真绑定/真成员访问才算。 */
+function settingsApiReferences(text) {
+  const { named, namespaces } = settingsApiBindings(text)
+  const found = []
+  for (const sym of REMOVED_SETTINGS_SYMBOLS) {
+    if (named.has(sym)) { found.push(sym); continue }
+    for (const ns of namespaces) {
+      if (new RegExp(`(?<![\\w$.])${ns}\\s*\\.\\s*${sym}(?![\\w$])`, 'u').test(maskLiterals(text, true))) { found.push(sym); break }
+    }
+  }
+  return found
+}
+
+/** 源码是否**引用**了某个已删除符号（对外契约不变；判据已收紧到"真绑定/真成员访问"）。 */
+function referencesRemovedSymbol(text, sym) {
+  return settingsApiReferences(text).includes(sym)
+}
+
+/**
+ * 扫描已安装包源码，检测对已删除的 dsh-settings API 的引用。
+ *
+ * 2026-09-04 教训：0.1.2-rc.1 起 settingsNamespace / installSettingsSection 已删除，
+ * 静态声明检查判 pass 是假通过；真实兼容性只有模块 import 时见分晓，而 loader 单行失败
+ * = 整个服务启动崩溃。
+ *
+ * 扫描预算（未改）：限深 3 层、上限 120 个文件、单文件读前 400KB。
+ */
+function scanSettingsApiUsage(pkgDir) {
+  const found = []
+  const seen = new Set()
+  const walk = (dir, depth) => {
+    if (depth > 3) return
+    let entries = []
+    try { entries = readdirSync(dir, { withFileTypes: true }) } catch { return }
+    for (const entry of entries) {
+      const full = join(dir, entry.name)
+      if (entry.isDirectory()) {
+        if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue
+        walk(full, depth + 1)
+        continue
+      }
+      if (!entry.isFile() || !/\.(?:js|mjs|cjs)$/u.test(entry.name)) continue
+      if (seen.has(full)) continue
+      seen.add(full)
+      if (seen.size > 120) return
+      try {
+        const text = readFileSync(full, 'utf8').slice(0, 400000)
+        for (const sym of settingsApiReferences(text)) {
+          if (!found.includes(sym)) found.push(sym)
+        }
+      } catch {}
+    }
+  }
+  walk(pkgDir, 0)
+  return found
+}
+
+export { REMOVED_SETTINGS_SYMBOLS, SCAN_CRITERIA_VERSION, SETTINGS_MODULE, maskLiterals, settingsApiBindings, settingsApiReferences, referencesRemovedSymbol, scanSettingsApiUsage }

package/lib/server/routes/plugins.js

@@ -4,7 +4,7 @@
 import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { createRequire } from 'node:module'
-import { checkPluginFrameworkCompat, probePluginImport, readCompatPending, rowIdModuleMap, writeCompatPending } from '../domain/compat.js'
+import { checkPluginFrameworkCompat, probePluginImport, readCompatPendingWithVerdicts, rowIdModuleMap, writeCompatPending } from '../domain/compat.js'
 import { cleanFrameworkBackups, cleanFrameworkTopLevel, readRollbackReferenced, reportFrameworkEntities, resolveFrameworkLayout } from '../domain/framework-cleanup.js'
 import { currentFrameworkVersion } from '../domain/framework.js'
 import { pnpmRemove } from '../domain/install-job.js'
@@ -78,7 +78,8 @@ async function routeToggle(req, res, rc) {
       // 前端弹风险提示确认框；带 confirmRisky:true 才放行）。
       // 注意下面还有一条**硬**门禁：启用前的 import 冒烟检查——那条是事实性崩溃（模块根本加载不了），
       // 不允许覆盖（否则下次启动必崩，与「服务永不崩」冲突）。
-      const compatPending = readCompatPending()
+      // 0.5.34：走**读取代发**（判据戳落后的结论先用当前判据复核/回写）⇒ 判定依据是最新的；软禁闸门本身一个字没放宽
+      const compatPending = readCompatPendingWithVerdicts({ baseDir: dirname(findPatchPath(ctx)) }).pending
       const pend = (compatPending?.pending ?? []).find((p) => p.rowId === rowId && (p.status ?? 'pending') === 'pending')
       if (pend) {
         if (body.confirmRisky !== true) {
@@ -97,9 +98,9 @@ async function routeToggle(req, res, rc) {
           return
         }
         try {
-          const next = readCompatPending()
-          const rec = (next?.pending ?? []).find((p) => p.rowId === rowId)
-          if (rec) { rec.riskyApprovedAt = Date.now(); writeCompatPending(next) }
+          // 复核（读取代发）已经作用在 compatPending 上，直接用同一份对象写回，避免重复读+重复扫描
+          const rec = (compatPending?.pending ?? []).find((p) => p.rowId === rowId)
+          if (rec) { rec.riskyApprovedAt = Date.now(); writeCompatPending(compatPending) }
         } catch {}
       }
     }
@@ -126,7 +127,7 @@ async function routeToggle(req, res, rc) {
     // 用户实测就是这样（5 行）。check / checkNote / riskyApprovedAt 一律保留供事后查。
     if (enabled) {
       try {
-        const list = readCompatPending()
+        const list = readCompatPendingWithVerdicts({ baseDir: dirname(findPatchPath(ctx)) }).pending
         const meta = rowIdModuleMap(ctx).get(rowId) ?? null
         if (list !== null && markPendingAdopted(list, rowId, 'manual-enable', meta)) {
           list.updatedAt = new Date().toISOString()
@@ -304,14 +305,14 @@ async function routeAdaptUnlock(req, res, rc) {
       sendError(res, 400, 'rowId 无效')
       return
     }
-    const pending = readCompatPending()
+    const patchPath = findPatchPath(ctx)
+    const profileDir = dirname(patchPath)
+    const { pending, verdicts } = readCompatPendingWithVerdicts({ baseDir: profileDir }) // 0.5.34：读取代发
     const entry = (pending?.pending ?? []).find((p) => p.rowId === rowId && (p.status ?? 'pending') === 'pending')
     if (entry === undefined) {
       sendError(res, 404, '该行不在适配门待适配清单中（或已解锁）')
       return
     }
-    const patchPath = findPatchPath(ctx)
-    const profileDir = dirname(patchPath)
     let pkg = null
     let pkgDir = null
     let version = null
@@ -327,9 +328,13 @@ async function routeAdaptUnlock(req, res, rc) {
     const fwVer = typeof pending.frameworkVersion === 'string' ? pending.frameworkVersion : '?'
     const check = pkg !== null ? checkPluginFrameworkCompat(pkg, fwVer, pkgDir) : { decision: 'unknown', reason: '无法读取包信息' }
     if (check.decision === 'fail') {
-      sendError(res, 409, `适配校验未通过：${check.reason}`)
+      // 0.5.33 改错 ①-2：文案必须写清「为什么不行 + 出路」（旧文案只有一句"适配校验未通过"，用户不知道下一步
+      // 该做什么）；0.5.34：真不兼容的行**一个字都不放宽** —— 仍然 409、仍然零改动（补丁与清单逐字节不变）。
+      sendError(res, 409, `适配校验未通过：${String(check.reason ?? '适配校验未通过')}。出路：先点「检测更新」把它更新到兼容当前框架 ${fwVer} 的版本（更新完成会自动重跑源码扫描，通过即解锁）；若它已不再需要，可在补丁里删掉/禁用这一行。本次未改动补丁与适配门清单。`)
       return
     }
+    // 可解锁的两种来路（判据都不放松）：① 真的更新过（版本变化）② 旧判据的 fail 已被当前判据撤回
+    const view = verdicts.get(rowId) ?? null, rescinded = view?.rescinded === true, changed = version !== null && version !== entry.version
     await removeDisableBlock(patchPath, rowId)
     entry.status = 'adopted'
     entry.adoptedAt = Date.now()
@@ -337,8 +342,9 @@ async function routeAdaptUnlock(req, res, rc) {
     entry.adoptedFramework = fwVer
     entry.check = check.decision
     entry.checkNote = check.reason ?? null
+    entry.adoptedBasis = changed ? 'version-changed' : (rescinded ? 'verdict-rescinded' : 'scan-pass')
     writeCompatPending(pending)
-    sendJson(res, 200, { ok: true, rowId, adopted: true, check: check.decision, note: check.reason ?? null })
+    sendJson(res, 200, { ok: true, rowId, adopted: true, check: check.decision, note: check.reason ?? null, basis: entry.adoptedBasis, previousVerdict: rescinded ? (view?.previous?.decision ?? 'fail') : null, evidence: rescinded ? (view?.evidence ?? null) : null })
     return
 }
 
@@ -355,7 +361,7 @@ async function routeAdaptUnlockAll(req, res, rc) {
       sendError(res, 400, 'root 无效')
       return
     }
-    const pending = readCompatPending()
+    const pending = readCompatPendingWithVerdicts({ baseDir: dirname(findPatchPath(ctx)) }).pending
     const patchPath = findPatchPath(ctx)
     const profileDir = dirname(patchPath)
     // v0.3.45：匹配规则改成「moduleName 前缀 **或** 属主行集合」——
@@ -523,6 +529,13 @@ async function routeCleanResiduals(req, res, rc) {
     extra.dryRun = dryRun
   }
   const payload = { ok: failed.length === 0, removed, kept, failed, count: removed.length, ...extra }
+    // 0.5.34 加法：框架档的**硬闸**结果必须如实浮到面板层（旧行为：改名了却没重建链接，只在 JSON 里留一行）
+    const fw = extra.framework
+    if (fw && (fw.ok === false || fw.verify?.ok === false)) {
+      const rb = (fw.rolledBack ?? []).length > 0 ? `；已回滚 ${fw.rolledBack.length} 条（${fw.rolledBack.map((r) => `${r.name}:${r.reason}`).join('、')}）` : ''
+      sendJson(res, 200, { ...payload, ok: false, error: `${fw.verify?.ok === false ? `框架可解析性验证未通过（${fw.verify.error ?? '未知'}）` : `有 ${fw.failed.length} 条没能安全落地`}${rb}；详情见 framework 字段。` })
+      return
+    }
     if (failed.length > 0) {
       const detail = failed.slice(0, 3).map((f) => `${f.name}（${f.error ?? '未知原因'}）`).join('；')
       const keptNote = kept.length > 0 ? `；已在用插件 ${kept.length} 个（保留不删）` : ''

package/lib/server/routes/state.js

@@ -3,9 +3,10 @@
 
 import { readFileSync, existsSync } from 'node:fs'
 import { dirname, join } from 'node:path'
-import { detectAdoptablePending, detectCompat, gatingSummary, readCompatGate, readCompatPending } from '../domain/compat.js'
+import { detectAdoptablePending, detectCompat, gatingSummary, readCompatGate, readCompatPendingWithVerdicts } from '../domain/compat.js'
 import { compUiUrl, findComponents } from '../domain/components.js'
-import { detectFrameworkUpgrade } from '../domain/framework.js'
+import { currentFrameworkVersion, detectFrameworkUpgrade } from '../domain/framework.js'
+import { peerVetoFor } from '../domain/peer-veto.js'
 import { readExtraBundleRows } from '../domain/install-job.js'
 import { installJobView, readGithubAuth } from '../domain/install.js'
 import { readPluginDetails } from '../domain/market.js'
@@ -46,7 +47,12 @@ async function routeStateGet(req, res, rc) {
       setPatchHealReport(patchHeal)
     }
     const extraRows = await readExtraBundleRows(dirname(patchPath))
-    const compatPending = readCompatPending()
+    const profileDir = dirname(patchPath)
+    // 0.5.34 加法（**读取代发**）：给 profileDir ⇒ 判据戳落后的记录用当前判据只读重算，
+    // 结论变了才回写（幂等：结论不变**零写盘**）。真不兼容的重算仍 fail，一个字都不动。
+    const pendingState = readCompatPendingWithVerdicts({ baseDir: profileDir })
+    const compatPending = pendingState.pending
+    const compatVerdicts = pendingState.verdicts
     const compatPendingRows = new Set((compatPending?.pending ?? []).filter((p) => (p.status ?? 'pending') === 'pending').map((p) => p.rowId))
     // 兼容门总开关 + 自动检测（只提示不自动开）
     const compatGate = readCompatGate()
@@ -58,11 +64,22 @@ async function routeStateGet(req, res, rc) {
         rollbackRec = { from: rr.from ?? null, to: rr.to ?? null, at: rr.at ?? null, applicable: true }
       }
     } catch {}
+    // 0.5.33 加法 D-⑧（诊断缺口）：**补丁要求启用、运行时却没挂载**（fiberPhase === null）的行，
+    // 本地复算框架启动时的 peer 预检，补出短句原因 + 出路。框架那一侧只在**内存里**把
+    // row.disabled 置 true（不写用户补丁）、原因只 process.stderr.write —— 面板此前一个字都看不出。
+    // 判据与 dsh-app-boot 的 evaluatePluginCompatibility / preflight 对齐（见 domain/peer-veto.js）。
+    const vetoFrameworkVersion = currentFrameworkVersion(ctx)
     const entries = listEntries(ctx).map((entry) => {
       const meta = entryPkgMeta(entry.moduleName, ctx.baseUrl ?? 'file:///', profileDirOf(ctx))
+      const disabledByPatch = patch.disables.includes(entry.rowId)
+      let veto = null
+      if (!disabledByPatch && entry.fiberPhase === null && vetoFrameworkVersion !== null) {
+        try { veto = peerVetoFor({ moduleName: entry.moduleName, profileDir, frameworkVersion: vetoFrameworkVersion }) } catch { veto = null }
+      }
+      const verdict = compatVerdicts.get(entry.rowId) ?? null
       return {
         ...entry,
-        userDisabled: patch.disables.includes(entry.rowId),
+        userDisabled: disabledByPatch,
         userForced: patch.forced.includes(entry.rowId),
         extra: patch.inserts.includes(entry.rowId) || extraRows.has(entry.moduleName) || extraRows.has(entry.rowId),
         installDate: meta?.installDate ?? null,
@@ -70,9 +87,17 @@ async function routeStateGet(req, res, rc) {
         repository: meta?.repository ?? null,
         // v0.3.45：只有"补丁里此刻确实还禁着它"的行才显示【待适配】——
         // 记录与开关脱节时（用户手动启用过 / 补丁块被清掉）不能继续挂着「待适配」误导人
-        pendingCompat: compatPendingRows.has(entry.rowId) && patch.disables.includes(entry.rowId),
+        pendingCompat: compatPendingRows.has(entry.rowId) && disabledByPatch,
+        // 0.5.34 加法：记录的 `fail` 若已被**当前判据**撤回（旧误报），面板据此不再说「待适配」，
+        // 改说「判据已撤回·可解锁」并给一键解锁入口（判据本身一个字都没放宽：真 fail 仍 fail）
+        compatRescinded: compatPendingRows.has(entry.rowId) && verdict?.rescinded === true,
+        // 结论视图：当前判据下的结论 + 是否过期/撤回/复核不了（面板要如实展示，不许把旧结论当事实）
+        compatVerdict: verdict,
         // 自动检测结果（只提示，不自动开）：该待适配行现在是否已适配（插件已更新 + 扫描通过）
+        // 或**旧判据的误报已被撤回**（0.5.34：不再要求"版本变化"，否则用户被永久钉住）
         adoptable: adoptable.get(entry.rowId) ?? null,
+        // 框架 peer 预检的本地复算结果（null = 无话可说；只在这类行上下发，不新增常驻面板行）
+        veto,
       }
     })
     const compat = await detectCompat(ctx.baseUrl ?? 'file:///')
@@ -97,7 +122,7 @@ async function routeStateGet(req, res, rc) {
       const selfPkg = JSON.parse(readFileSync(join(pluginRoot(), 'package.json'), 'utf8'))
       selfVersion = typeof selfPkg.version === 'string' ? selfPkg.version : null
     } catch {}
-    sendJson(res, 200, { ok: true, entries, patchPath, compat, installJobs: jobs, recentFailures, pendingRestart, github: { loggedIn: auth.loggedIn, login: auth.login }, patch: { disables: patch.disables, forced: patch.forced, inserts: patch.inserts }, framework, patchHeal: patchHeal === null ? null : { healed: patchHeal.healed ?? [], autoDisabled: patchHeal.autoDisabled ?? [], healedAt: patchHeal.healedAt ?? 0, written: patchHeal.written === true, writeError: patchHeal.writeError ?? null, skippedFrameworkOwned: (patchHeal.skipped ?? []).map((s) => s.id ?? null), uncertain: (patchHeal.uncertain ?? []).map((u) => u.id ?? null) }, gating: gatingSummary(ctx, compatPending, entries), compatPending: compatPending === null ? null : { frameworkVersion: compatPending.frameworkVersion ?? null, upgradeFrom: compatPending.upgradeFrom ?? null, pending: (compatPending.pending ?? []).filter((p) => (p.status ?? 'pending') === 'pending').map((p) => ({ rowId: p.rowId, moduleName: p.moduleName, version: p.version ?? null, checkNote: p.checkNote ?? null, check: p.check ?? null, riskyApprovedAt: p.riskyApprovedAt ?? null, adoptable: adoptable.get(p.rowId) ?? null })) }, compatGate, rollback: rollbackRec, selfVersion, components: findComponents().map((c) => ({ id: c.id, name: c.name, kind: c.kind ?? 'server', pid: c.pid ?? null, port: c.port ?? null, healthUrl: c.healthUrl ?? null, uiUrl: compUiUrl(c), autoStart: c.autoStart === true })) })
+    sendJson(res, 200, { ok: true, entries, patchPath, compat, installJobs: jobs, recentFailures, pendingRestart, github: { loggedIn: auth.loggedIn, login: auth.login }, patch: { disables: patch.disables, forced: patch.forced, inserts: patch.inserts }, framework, patchHeal: patchHeal === null ? null : { healed: patchHeal.healed ?? [], autoDisabled: patchHeal.autoDisabled ?? [], healedAt: patchHeal.healedAt ?? 0, written: patchHeal.written === true, writeError: patchHeal.writeError ?? null, skippedFrameworkOwned: (patchHeal.skipped ?? []).map((s) => s.id ?? null), uncertain: (patchHeal.uncertain ?? []).map((u) => u.id ?? null) }, gating: gatingSummary(ctx, compatPending, entries, compatVerdicts), compatPending: compatPending === null ? null : { frameworkVersion: compatPending.frameworkVersion ?? null, upgradeFrom: compatPending.upgradeFrom ?? null, pending: (compatPending.pending ?? []).filter((p) => (p.status ?? 'pending') === 'pending').map((p) => ({ rowId: p.rowId, moduleName: p.moduleName, version: p.version ?? null, checkNote: p.checkNote ?? null, check: p.check ?? null, riskyApprovedAt: p.riskyApprovedAt ?? null, adoptable: adoptable.get(p.rowId) ?? null, verdict: compatVerdicts.get(p.rowId) ?? null })), verdictRefresh: pendingState.refresh === null ? null : { version: pendingState.refresh.version ?? null, updated: pendingState.refresh.updated ?? [], unchanged: pendingState.refresh.unchanged ?? [], unresolved: pendingState.refresh.unresolved ?? [], wrote: pendingState.refresh.wrote === true, writeError: pendingState.refresh.writeError ?? null } }, compatGate, rollback: rollbackRec, selfVersion, components: findComponents().map((c) => ({ id: c.id, name: c.name, kind: c.kind ?? 'server', pid: c.pid ?? null, port: c.port ?? null, healthUrl: c.healthUrl ?? null, uiUrl: compUiUrl(c), autoStart: c.autoStart === true })) })
     return
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.5.32",
+  "version": "0.5.34",
   "description": "DSH 框架升级安全与插件升级门控：一键升级、失败自动回滚、升级后回滚上版、旧插件不适配自动禁用；内置多源插件市场为发现层，插件源全部可自定义，可指向公司内网私有源 / 私有索引 / 本地 Git 仓库，纯内网离线可用 | Framework upgrade safety & plugin version gating for DSH, with a customizable multi-source plugin market: point every source at internal mirrors or a local file:// repo for intranet-only, offline installs.",
   "repository": {
     "type": "git",