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

package/README.md

@@ -4,12 +4,44 @@
 
 ---
 
-<img width="1170" height="609" alt="image" src="https://github.com/user-attachments/assets/b802d606-14ba-4151-9956-ff642ed12b0a" />
-
 # DSH Plugin Gating Hub (dsh-plugin-gating-hub)
 
 *Renamed from `dsh-plugin-hub` — old URLs redirect.*
 
+**Framework-upgrade safety and plugin-version gating for DSH.** A failed upgrade rolls back.
+A framework changed by **any** update channel is still guarded. A version the host cannot
+take is refused, not installed.
+
+**Install (npm, one line)**
+
+```sh
+dsh plugin --profile web add @noob-stupid/dsh-plugin-console
+```
+
+Then restart the dsh service → refresh the page → **Settings → Plugins → Plugin Console**.
+
+![Upgrade safety panel, expanded in place](docs/images/upgrade-safety-panel.png)
+
+**Three hard guarantees**
+
+- 🛡️ **Contract pre-check → rollback point → auto-rollback.** A data-driven **contract pre-check**
+  runs first (message contract / dependency API / config schema / removed API / loader contract);
+  then config backup + a full-tree **rollback point**. A failed install or relaunch **auto-rolls
+  the tree back**, a 「roll back to previous」 button restores the last version, and plugins the
+  new framework cannot load are **auto-disabled** — version check catches fake success, 15-min
+  timeout + stall detection.
+- 👁️ **Even when another update channel changes the framework.** An **environment fingerprint**
+  catches changes made by the official desktop updater or a manual `pnpm`: it auto-runs a
+  **read-only pre-flight**, and disables a row **only with hard evidence** (package unresolvable /
+  `file://` target gone / named in a boot-failure log). `@deepseek-ai/*` and **protected / core
+  rows are never auto-disabled**; each auto-disable writes a one-command recovery record.
+- 🔒 **Plugin install & upgrade gating.** Version/declaration gate (`dsh.engines.framework` /
+  `engines.dsh` / `@deepseek-ai/*` ranges, built-in zero-dependency semver), a **repo-size gate**
+  on source channels, and explicit handling of **non-registry sources** — a bare version is
+  written back only once the registry really resolves it, otherwise the package is materialized
+  as `link:`. Install scripts are never auto-authorized, and pnpm's supply-chain gate is never
+  bypassed.
+
 [![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 [![GitHub stars](https://img.shields.io/github/stars/Noob-stupid/dsh-plugin-gating-hub?style=flat-square&logo=github)](https://github.com/Noob-stupid/dsh-plugin-gating-hub/stargazers)
@@ -22,13 +54,11 @@
 [![GitHub Release](https://img.shields.io/github/v/release/Noob-stupid/dsh-plugin-gating-hub?style=flat-square)](https://github.com/Noob-stupid/dsh-plugin-gating-hub/releases)[![dsh.so security](https://www.dsh.so/badge/dsh-plugin-hub.svg)](https://www.dsh.so/artifact/dsh-plugin-hub)
 [![dsh.so install](https://www.dsh.so/badge/install/dsh-plugin-hub.svg)](https://www.dsh.so/artifact/dsh-plugin-hub)
 
-> **Framework upgrade safety & plugin version gating for DeepSeek Harness (DSH)**: one-click
-> framework upgrade with **auto-rollback on failure** → **one-click rollback to the previous
-> version** after an upgrade → plugins the new framework cannot load are **auto-disabled** →
-> the **plugin upgrade gate** refuses a version the host can't take.
-> A **built-in multi-source plugin market & index** (500+ plugins / 300+ skills, zero GitHub
-> API calls) rides on top as the **discovery layer** — and **every source is swappable**: install
-> source (incl. a private intranet registry), search source (URL template + headers), index source
+<img width="1170" height="609" alt="DSH Plugin Gating Hub" src="https://github.com/user-attachments/assets/b802d606-14ba-4151-9956-ff642ed12b0a" />
+
+> **Discovery layer on top**: a **built-in multi-source plugin market & index** (500+ plugins /
+> 300+ skills, zero GitHub API calls) — and **every source is swappable**: install source
+> (incl. a private intranet registry), search source (URL template + headers), index source
 > (self-hosted intranet index), Git source (incl. a local `file://` bare repo), so plugins can be
 > installed on an **intranet-only or fully offline** machine.
 
@@ -385,7 +415,7 @@ Verification matrix, raw logs and the one framework-side caveat (`0.1.2-rc.1` sh
 
 ---
 
-##帮助
+## Help & Ecosystem
 
 - **Panel missing**: restart dsh → refresh → Settings → Plugins → Plugin Console.
 - **Toggle does nothing**: infrastructure rows are "Protected" (by design); normal toggles

package/README.zh.md

@@ -4,15 +4,41 @@
 
 ---
 
-<img width="1170" height="609" alt="image" src="https://github.com/user-attachments/assets/b802d606-14ba-4151-9956-ff642ed12b0a" />
-
 # DSH 插件门控中心（dsh-plugin-gating-hub）
 
 *原名 `dsh-plugin-hub`，已改名；旧链接 301 跳转有效。*
 
-> **DSH 框架升级安全与插件升级门控**：一键框架升级（**失败自动回滚**）→ 升级后**一键回滚到
-> 上一版** → 新框架带不动的插件**自动禁用** → **插件升级门控**按版本/声明拒绝装不上的插件版本。
-> **内置多源插件市场与自定义索引**（500+ 插件 / 300+ 技能，零 GitHub API 调用）作为**发现层**——
+**DSH 的框架升级安全 + 插件升级门控。** 升级失败自动回滚。**别的通道**改了框架也照样守门。
+宿主带不动的插件版本直接拒绝，不会装上。
+
+**安装（npm，一行）**
+
+```sh
+dsh plugin --profile web add @noob-stupid/dsh-plugin-console
+```
+
+然后重启 dsh 服务 → 刷新页面 → **设置 → 插件 → 插件控制台**。
+
+![「升级安全」面板（就地展开）](docs/images/upgrade-safety-panel.png)
+
+**三条最硬的能力**
+
+- 🛡️ **升级前契约预检 → 回滚点 → 失败自动回滚。** 先跑数据化的**契约预检**（消息契约 /
+  依赖 API / 配置 schema / 被删 API / 装载器契约），再做配置备份 + 全树**回滚点**；
+  安装或拉起失败即**全树自动回滚**，升级成功后还有「回滚到上一版」按钮，
+  新框架带不动的插件**自动禁用** —— 版本校验防假成功，15 分钟硬超时 + 卡死检测。
+- 👁️ **别的更新通道改了框架，也守门。** **环境指纹**能发现官方桌面端更新器或手动 `pnpm`
+  造成的框架变更：变化即自动跑一次**只读预检**，且**有确证证据才**禁用某行
+  （包确证解析不到 / `file://` 目标确实不存在 / 启动失败日志点名）；`@deepseek-ai/*`（框架自带）
+  与**受保护 / 核心行永不禁用**，每次自动禁用都留一条可读的恢复命令。
+- 🔒 **插件安装与升级门控。** 版本/声明门控（`dsh.engines.framework` / `engines.dsh` /
+  `@deepseek-ai/*` 范围，内置零依赖 semver）+ 源码通道的**体积门禁** + **非 registry 来源**的
+  显式处理（只有在 registry 真能解析到该版本时才写回裸版本号，否则物化成 `link:`）；
+  安装脚本**绝不自动放行**，pnpm 的供应链闸**绝不绕过**。
+
+<img width="1170" height="609" alt="DSH 插件门控中心" src="https://github.com/user-attachments/assets/b802d606-14ba-4151-9956-ff642ed12b0a" />
+
+> **上层还带一个发现层**：**内置多源插件市场与自定义索引**（500+ 插件 / 300+ 技能，零 GitHub API 调用）——
 > 而且**每一条源都能换成你自己的**：安装源（含内网私有 registry）、搜索源（URL 模板 + 请求头）、
 > 索引源（内网自建索引）、Git 源（含 `file://` 本地裸仓库），**纯内网 / 断网也能装插件**。
 

package/lib/client.js

@@ -256,7 +256,6 @@ window.__ModuleLoader__.load({
 			unloading: "卸载中",
 			toggledOn: "已请求启用",
 			toggledOff: "已请求停用",
-			failed: "操作失败",
 			view: "查看",
 			install: "添加并启用",
 			installing: "正在安装…",
@@ -527,7 +526,6 @@ window.__ModuleLoader__.load({
 			sourcesUpdated: "软件源已更新",
 			sourceOf: "源：",
 			searchSourceTitle: "点击切换搜索源（GitHub / Gitee / 自定义）",
-			recentFailures: "最近安装失败",
 			installedAt: "已安装",
 			checkUpdate: "检测更新",
 			checkingUpdate: "检测中…",
@@ -810,7 +808,6 @@ window.__ModuleLoader__.load({
 			unloading: "Unloading",
 			toggledOn: "Enable requested",
 			toggledOff: "Disable requested",
-			failed: "Operation failed",
 			view: "Inspect",
 			install: "Add & enable",
 			installing: "Installing…",
@@ -1077,7 +1074,6 @@ window.__ModuleLoader__.load({
 			sourcesUpdated: "Sources updated",
 			sourceOf: "Source: ",
 			searchSourceTitle: "Click to switch search source (GitHub / Gitee / custom)",
-			recentFailures: "Recent install failures",
 			installedAt: "Installed",
 			checkUpdate: "Check update",
 			checkingUpdate: "Checking…",
@@ -1229,6 +1225,18 @@ window.__ModuleLoader__.load({
 		function phaseLabel(phase, t) {
 			return phase === null ? t("unobserved") : t(PHASE_KEYS[phase]);
 		}
+		// 0.5.33 改错 ①-2：「已适配，立即解锁」按钮的门控判据 —— 必须与同一卡片正文用的是**同一个**判据。
+		// 现症：按钮只判 pendingCompat === true，不判 entry.adoptable → 正文按 adoptable 说"不适配"，
+		// 按钮按 pendingCompat 说"已适配"，自相矛盾；点下去 POST /adapt-unlock 必得 409（适配校验 fail），
+		// 补丁与行状态零变化 ⇒ 用户观感"点了没反应"。
+		// 现在只有**真的检测到已适配**（adoptable 是服务端 detectAdoptablePending 给出的对象）才出按钮；
+		// 其余情况不给这个承诺，原因照旧由正文那行（pendingCompatHint + checkNote）如实展示。
+		function canAdaptUnlock(entry) {
+			return entry !== null && entry !== undefined
+				&& entry.pendingCompat === true
+				&& entry.adoptable !== null && entry.adoptable !== undefined
+				&& typeof entry.adoptable === "object";
+		}
 		async function call(path, body) {
 			const response = await fetch(path, body === undefined
 				? {}
@@ -1273,7 +1281,7 @@ window.__ModuleLoader__.load({
 			if (reload) setMessage(t("restarting"));
 			call("/plugin-console/restart", {}).then(
 				() => { if (reload) window.setTimeout(() => window.location.reload(), 12000); },
-				(error) => { setMessage(error !== null && typeof error.message === "string" && error.message !== "" ? error.message : t("failed")); },
+				(error) => { setMessage(error !== null && typeof error.message === "string" && error.message !== "" ? error.message : t("safetySwitchFailed")); },
 			);
 		}
 		/** 超时类错误附上可操作提示（网络黑洞期的最常见表现）。 */
@@ -1718,7 +1726,7 @@ window.__ModuleLoader__.load({
 				setFwClearing(true);
 				call("/plugin-console/framework-status-clear", {}).then(
 					() => { setFrameworkStatus({ status: "idle", message: null }); setFwStatusDismissed(true); setMessage(t("fwRecordCleared")); },
-					(error) => { setMessage(t("failed") + "：" + friendlyGithubError(error).message); },
+					(error) => { setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message); },
 				).finally(() => setFwClearing(false));
 			};
 			const fwStatusRefresh = () => {
@@ -1736,7 +1744,7 @@ window.__ModuleLoader__.load({
 				setFwCheckBusy(true);
 				call("/plugin-console/framework-check", refresh === true ? { refresh: true } : {}).then(
 					(data) => { setFwCheckBusy(false); if (data && data.ok === true) setFwCheck(data); },
-					(error) => { setFwCheckBusy(false); setMessage(t("failed") + "：" + friendlyGithubError(error).message); },
+					(error) => { setFwCheckBusy(false); setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message); },
 				);
 			};
 			// 升级前契约预检：先只读预检（抓目标版本会话格式契约 + 扫本地生产方），
@@ -1753,7 +1761,7 @@ window.__ModuleLoader__.load({
 						setFwPreflightBusy(false);
 						setFwPreflight((prev) => (apply === true ? { report: (prev && prev.report) ?? null, patch: data } : { report: data, patch: null }));
 					},
-					(error) => { setFwPreflightBusy(false); setMessage(t("failed") + "：" + friendlyGithubError(error).message); },
+					(error) => { setFwPreflightBusy(false); setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message); },
 				);
 			};
 			const fwShortPath = (p) => String(p ?? "").replace(/\\/gu, "/").split("/").slice(-3).join("/");
@@ -1766,7 +1774,7 @@ window.__ModuleLoader__.load({
 						setFrameworkStatus({ status: "rollback", message: t("frameworkRollbackDone").replace("{from}", String(data?.from ?? "?")) });
 						pollFrameworkStatus();
 					},
-					(error) => { setFrameworkUpgrading(false); setMessage(t("failed") + "：" + friendlyGithubError(error).message); },
+					(error) => { setFrameworkUpgrading(false); setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message); },
 				);
 			};
 			// 回滚按钮可用性：已经处在「回滚目标版本」时不再提供回滚（点了等于恢复现状）。
@@ -2013,10 +2021,10 @@ window.__ModuleLoader__.load({
 						setAiJob({ jobId: data.jobId, source, status: "running", stage: "planning" });
 						aiPoll(data.jobId);
 					}
-					else { setAiRunning(false); setMessage(t("failed") + "：" + (data?.error ?? "未知")); }
+					else { setAiRunning(false); setMessage(t("safetySwitchFailed") + "：" + (data?.error ?? "未知")); }
 				} catch (error) {
 					setAiRunning(false);
-					setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+					setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 				}
 			}
 			async function aiRun() {
@@ -2035,7 +2043,7 @@ window.__ModuleLoader__.load({
 					aiPoll(aiJob.jobId);
 				} catch (error) {
 					setAiRunning(false);
-					setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+					setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 				}
 			}
 			async function aiCancel() {
@@ -2056,7 +2064,7 @@ window.__ModuleLoader__.load({
 					const data = await call("/plugin-console/component/" + action, { id });
 					setMessage(t("compActionDone").replace("{action}", t(action === "start" ? "compStart" : "compStop")).replace("{name}", data?.name ?? id));
 				} catch (error) {
-					setMessage(t("failed") + "：" + error.message);
+					setMessage(t("safetySwitchFailed") + "：" + error.message);
 				}
 				setCompBusy(null);
 				refreshComps();
@@ -2069,7 +2077,7 @@ window.__ModuleLoader__.load({
 						setMessage(data.running ? (data.healthy ? t("compHealthy") : t("compUnhealthy")) + "：" + (data.name ?? id) : t("compStopped") + "：" + (data.name ?? id));
 					}
 				} catch (error) {
-					setMessage(t("failed") + "：" + error.message);
+					setMessage(t("safetySwitchFailed") + "：" + error.message);
 				}
 				setCompBusy(null);
 				refreshComps();
@@ -2088,7 +2096,7 @@ window.__ModuleLoader__.load({
 					await call("/plugin-console/component/autostart", { id, enabled: on });
 					setMessage((on ? "✔ 已开启自启动：" : "已关闭自启动：") + id);
 				} catch (error) {
-					setMessage(t("failed") + "：" + error.message);
+					setMessage(t("safetySwitchFailed") + "：" + error.message);
 				}
 				setCompBusy(null);
 				refreshComps();
@@ -2500,7 +2508,7 @@ window.__ModuleLoader__.load({
 							setRiskyConfirm({ entryId: entry.entryId, moduleName: details.moduleName ?? entry.moduleName ?? null, frameworkVersion: details.frameworkVersion ?? null, checkNote: details.checkNote ?? null });
 							return;
 						}
-						setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+						setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 					},
 				).finally(() => setBusy(null));
 			};
@@ -2513,7 +2521,7 @@ window.__ModuleLoader__.load({
 							: prev));
 						setMessage(t("compatGateSaved"));
 					},
-					(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+					(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 				);
 			};
 			const levenshtein = (a, b) => {
@@ -2704,7 +2712,7 @@ window.__ModuleLoader__.load({
 						},
 						(error) => {
 							setLoadingMore(false);
-							setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+							setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 						},
 					);
 					return;
@@ -2728,7 +2736,7 @@ window.__ModuleLoader__.load({
 						},
 						(error) => {
 							setLoadingMore(false);
-							setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+							setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 						},
 					);
 					return;
@@ -2746,7 +2754,7 @@ window.__ModuleLoader__.load({
 						},
 						(error) => {
 							setLoadingMore(false);
-							setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+							setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 						},
 					);
 					return;
@@ -2784,7 +2792,7 @@ window.__ModuleLoader__.load({
 						},
 						(error) => {
 							setLoadingMore(false);
-							setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+							setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 						},
 					),
 				);
@@ -2953,7 +2961,7 @@ window.__ModuleLoader__.load({
 										window.setTimeout(() => window.location.reload(), 2500);
 									}
 								} else {
-									setMessage(t("failed") + "：" + (data.error ?? "未知错误") + diagMessage(data));
+									setMessage(t("safetySwitchFailed") + "：" + (data.error ?? "未知错误") + diagMessage(data));
 								}
 								setInstalling(null);
 								setTimeout(refresh, 1500);
@@ -2966,8 +2974,8 @@ window.__ModuleLoader__.load({
 			/** 本地 AI 兜底授权：调用模型 API 产生费用，必须用户明确同意。 */
 			const aiConsent = (jobId, approved) => {
 				call("/plugin-console/ai-consent", { jobId, approved }).then(
-					() => { if (!approved) setMessage(t("failed") + "：已取消本地 AI 兜底（不会调用模型 API）"); },
-					(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+					() => { if (!approved) setMessage(t("safetySwitchFailed") + "：已取消本地 AI 兜底（不会调用模型 API）"); },
+					(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 				);
 			};
 			/** 安装进度文案：服务端 progress{channel,phase,index,total,name,done} → 一行人话。
@@ -3127,7 +3135,7 @@ window.__ModuleLoader__.load({
 				// clientId 打码回显（如 abc12345…）：用户未修改时原样传回服务端，服务端识别打码标记保留原配置
 				const idValue = giteeClientId.trim();
 				if (!idValue || !giteeClientSecret.trim()) {
-					setMessage(t("failed") + "：client_id / client_secret 不能为空");
+					setMessage(t("safetySwitchFailed") + "：client_id / client_secret 不能为空");
 					return;
 				}
 				if (idValue.endsWith("…")) {
@@ -3139,7 +3147,7 @@ window.__ModuleLoader__.load({
 			const startGiteeOauth = () => {
 				call("/plugin-console/gitee-oauth-url").then(
 					(data) => { if (data && data.url) window.open(data.url, "_blank", "noopener"); },
-					(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+					(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 				);
 			};
 			const sourcesAction = (payload, done) => {
@@ -3151,12 +3159,12 @@ window.__ModuleLoader__.load({
 						setMessage(t("sourcesUpdated"));
 						if (done) done();
 					},
-					(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+					(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 				).finally(() => setSourcesBusy(false));
 			};
 			const addSource = () => {
 				if (!isAllowedSourceUrl(sourceUrl.trim())) {
-					setMessage(t("failed") + "：" + t("invalidSourceUrl"));
+					setMessage(t("safetySwitchFailed") + "：" + t("invalidSourceUrl"));
 					return;
 				}
 				sourcesAction({ action: "add", name: sourceName.trim(), url: sourceUrl.trim() }, () => { setSourceName(""); setSourceUrl(""); });
@@ -3166,7 +3174,7 @@ window.__ModuleLoader__.load({
 				setRegScan({ status: "scanning" });
 				call("/plugin-console/registry-scan", {}).then(
 					(data) => setRegScan({ status: "ready", results: Array.isArray(data.results) ? data.results : [], scannedAt: typeof data.scannedAt === "number" ? data.scannedAt : null }),
-					(error) => { setRegScan(null); setMessage(t("failed") + "：" + friendlyGithubError(error).message); },
+					(error) => { setRegScan(null); setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message); },
 				);
 			};
 			// 扫描结果派生视图：每条源的命中结果 + 可达计数 + 最新版本来自哪个源
@@ -3190,7 +3198,7 @@ window.__ModuleLoader__.load({
 			};
 			const addIndexSource = () => {
 				if (!isAllowedSourceUrl(indexSourceUrl.trim())) {
-					setMessage(t("failed") + "：" + t("invalidSourceUrl"));
+					setMessage(t("safetySwitchFailed") + "：" + t("invalidSourceUrl"));
 					return;
 				}
 				sourcesAction({ action: "add-index", name: indexSourceName.trim(), url: indexSourceUrl.trim() }, () => { setIndexSourceName(""); setIndexSourceUrl(""); });
@@ -3213,11 +3221,11 @@ window.__ModuleLoader__.load({
 			const addGitSource = () => {
 				const tpl = gitSourceUrl.trim();
 				if (!tpl.includes("{owner}") || !tpl.includes("{repo}")) {
-					setMessage(t("failed") + "：" + t("gitUrlPlaceholder"));
+					setMessage(t("safetySwitchFailed") + "：" + t("gitUrlPlaceholder"));
 					return;
 				}
 				if (!isAllowedSourceUrl(tpl)) {
-					setMessage(t("failed") + "：" + t("invalidSourceUrl"));
+					setMessage(t("safetySwitchFailed") + "：" + t("invalidSourceUrl"));
 					return;
 				}
 				sourcesAction({ action: "add-git", name: gitSourceName.trim(), urlTemplate: tpl }, () => { setGitSourceName(""); setGitSourceUrl(""); });
@@ -3241,7 +3249,7 @@ window.__ModuleLoader__.load({
 			};
 			const addSearchSource = () => {
 				if (!isAllowedSourceUrl(searchSourceUrl.trim()) || !searchSourceUrl.includes("{q}")) {
-					setMessage(t("failed") + "：" + t("invalidSearchUrl"));
+					setMessage(t("safetySwitchFailed") + "：" + t("invalidSearchUrl"));
 					return;
 				}
 				// 解析请求头：每行 "名称: 值"
@@ -3281,7 +3289,7 @@ window.__ModuleLoader__.load({
 						}
 					},
 					(error) => {
-						setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+						setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 						setInstalling(null);
 					},
 				);
@@ -3353,7 +3361,7 @@ window.__ModuleLoader__.load({
 					},
 					(error) => {
 						setTogglingSkill(null);
-						setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+						setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 					},
 				);
 			};
@@ -3404,7 +3412,7 @@ window.__ModuleLoader__.load({
 					(error) => {
 						setFrameworkUpgrading(false);
 						setConfirmFrameworkUpgrade(false);
-						setMessage(t("failed") + "：" + friendlyGithubError(error).message);
+						setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message);
 					},
 				);
 			};
@@ -3416,7 +3424,7 @@ window.__ModuleLoader__.load({
 						setConfirmSkillDelete(null);
 						setInstalledSkills((prev) => prev.filter((s) => s.name !== name));
 					},
-					(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+					(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 				);
 			};
 			const installedQueryNorm = installedQuery.trim().toLowerCase();
@@ -3470,7 +3478,7 @@ window.__ModuleLoader__.load({
 								el("p", { className: styles.status }, t("loadingDetails")));
 						} else if (details.status === "error") {
 							detailPanel = el("div", { className: styles.detail },
-								el("p", { className: styles.status, "data-error": "true" }, t("failed") + "：" + details.error.message));
+								el("p", { className: styles.status, "data-error": "true" }, t("safetySwitchFailed") + "：" + details.error.message));
 						} else {
 							const meta = details.data.meta;
 							const readme = details.data.readme;
@@ -3499,7 +3507,7 @@ window.__ModuleLoader__.load({
 										title: t("aiEmpowerTitle"),
 										onClick: () => openAiFor(String(entry.moduleName ?? entry.repo ?? "")),
 									}, t("aiEmpowerLabel")),
-									entry.pendingCompat === true
+									canAdaptUnlock(entry)
 										? el("button", {
 											type: "button",
 											className: styles.toggle,
@@ -3514,7 +3522,7 @@ window.__ModuleLoader__.load({
 														setMessage(t("adaptUnlockDone"));
 														window.setTimeout(() => window.location.reload(), 1200);
 													},
-													(error) => { setAdaptUnlocking(null); setMessage(t("failed") + "：" + friendlyGithubError(error).message); },
+													(error) => { setAdaptUnlocking(null); setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message); },
 												);
 											},
 										}, adaptUnlocking === entry.entryId ? t("loadingPhase") : t("adaptUnlockBtn"))
@@ -3586,6 +3594,13 @@ window.__ModuleLoader__.load({
 								phaseLabel(entry.fiberPhase, t)),
 							el("code", null, entry.entryId),
 						),
+						// 0.5.33 加法 ①-4：框架 peer 预检**否决**的本地复算结果（服务端 entries[].veto）。
+						// 框架只在内存里禁用、原因只打 stderr —— 这里把它补出来。复用**既有行**内的
+						// status 短句位（不新增常驻面板行），出路放悬浮提示（复用既有 title 位置）。
+						entry.veto && entry.veto.reason
+							? el("p", { className: styles.status, "data-pending": "true", title: entry.veto.hint ?? undefined },
+								entry.veto.reason)
+							: null,
 						el("div", { className: styles.rowTop, style: { justifyContent: "space-between" } },
 							el("div", { className: styles.rowTop },
 								el("button", {
@@ -3623,7 +3638,7 @@ window.__ModuleLoader__.load({
 															setTimeout(refresh, 1500);
 														}
 													},
-													(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+													(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 												).finally(() => setDeleteBusy(null));
 											} else {
 												setConfirmDeleteRowId(entry.entryId);
@@ -3679,7 +3694,7 @@ window.__ModuleLoader__.load({
 										setFamilyCheck((prev) => ({ ...prev, [root]: { latest: d?.latest ?? null, installed } }));
 										setMessage(t("familyUpdate") + "：" + root + " " + (d?.latest ?? "?") + (d?.migrate && d.migrate.compatible ? " → " + d.migrate.to + " v" + d.migrate.latest : "") + (d?.error ? "（" + d.error + "）" : ""));
 									},
-									(e) => setMessage(t("failed") + "：" + friendlyGithubError(e).message),
+									(e) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(e).message),
 								);
 							},
 						}, t("familyCheckUpdate")),
@@ -3706,7 +3721,7 @@ window.__ModuleLoader__.load({
 										setMessage(t("familyUnlockAllDone") + "：" + unlockedCount + " 行" + (Array.isArray(d?.kept) && d.kept.length > 0 ? "；保留 " + d.kept.length + " 行（未通过校验）" : ""));
 										window.setTimeout(() => window.location.reload(), 1500);
 									},
-									(e) => setMessage(t("failed") + "：" + friendlyGithubError(e).message),
+									(e) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(e).message),
 								);
 							},
 						}, t("familyUnlockAll")))
@@ -3765,7 +3780,7 @@ window.__ModuleLoader__.load({
 													: t("pendingRestartNote") + "：" + (data?.packageName ?? "") + (data?.uninstallError ? "（包卸载警告：" + data.uninstallError + "）" : ""));
 												refresh();
 											},
-											(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+											(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 										).finally(() => setDeleteBusy(null));
 									} else {
 										setConfirmDeleteRowId(job.jobId);
@@ -4388,7 +4403,7 @@ window.__ModuleLoader__.load({
 									? el("div", { className: styles.rowTop },
 										el("p", { className: styles.message, style: { flex: 1, minWidth: 0, wordBreak: "break-all" } }, t("repoLandDone") + repoLandResult.path),
 										el("button", { type: "button", className: styles.toggle, onClick: repoLandOpenFolder }, t("repoLandOpenFolder")))
-									: el("p", { className: styles.message, "data-error": "true" }, t("failed") + "：" + (repoLandResult.error ?? "?")))
+									: el("p", { className: styles.message, "data-error": "true" }, t("safetySwitchFailed") + "：" + (repoLandResult.error ?? "?")))
 								: null,
 							el("strong", { className: styles.name }, t("repoLandList") + "（" + repoLanded.length + "）"),
 							repoLanded.length === 0
@@ -4415,7 +4430,7 @@ window.__ModuleLoader__.load({
 						onClick: () => {
 							call("/plugin-console/framework-relaunch", {}).then(
 								(data) => { if (data && data.ok === true) setMessage(t("relaunchDone")); },
-								(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+								(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 							);
 						},
 					}, t("relaunchBtn"))
@@ -4432,7 +4447,7 @@ window.__ModuleLoader__.load({
 									const keptNote = keptCount > 0 ? "；保留在用插件 " + keptCount + " 个" : "";
 									if (data && data.ok === true) setMessage(t("cleanResiduals") + "：" + (data.count === 0 ? "无残余" : "已清理 " + data.count + " 项") + keptNote);
 								},
-								(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+								(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 							);
 						},
 					}, "🧹 " + t("cleanResiduals")),
@@ -4472,10 +4487,10 @@ window.__ModuleLoader__.load({
                   setMessage(t("cfDone").replace("{renamed}", String(renamed)).replace("{linked}", String(relinked)).replace("{removed}", String(removed)).replace("{mb}", String(freed))
                     + (failed > 0 ? "；" + t("cfFailed").replace("{n}", String(failed)) : ""));
                 },
-                (error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+                (error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
               );
             },
-            (error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+            (error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
           );
         },
       }, "🧰 " + t("cleanFrameworkResiduals")),
@@ -4559,10 +4574,10 @@ const lockWarn = data.lockUpdated === false && typeof data.lockNote === "string"
 setMessage((data.note ?? "已更新") + (lockWarn === "" ? "" : "。" + lockWarn) + "，正在重启生效…");
 restartServiceViaServer(setMessage, { reload: false });
 } else {
-setMessage(t("failed") + "：" + (data?.reason ?? "未知"));
+setMessage(t("safetySwitchFailed") + "：" + (data?.reason ?? "未知"));
 }
 },
-(error) => setMessage(t("failed") + "：" + friendlyGithubError(error).message),
+(error) => setMessage(t("safetySwitchFailed") + "：" + friendlyGithubError(error).message),
 );
 }
 }, "⬇ " + t("hubUpdateAvailable") + " v" + selfUpdate.latest) : null,
@@ -5146,7 +5161,7 @@ setMessage(t("failed") + "：" + (data?.reason ?? "未知"));
 								? el("p", { className: styles.status }, t("loading"))
 								: sourcesData.error !== undefined
 									? el("div", null,
-										el("p", { className: styles.status }, t("failed") + "：" + sourcesData.error),
+										el("p", { className: styles.status }, t("safetySwitchFailed") + "：" + sourcesData.error),
 										el("button", { type: "button", className: styles.toggle, onClick: () => { setSourcesData(null); openSources(); } }, t("retry")))
 									: el("div", { className: styles.accWrap },
 									accSection("registries", t("sourcesBtn"), [
@@ -5704,6 +5719,9 @@ setMessage(t("failed") + "：" + (data?.reason ?? "未知"));
 		// 仅测试用导出（tests/test-plugin-actions.mjs 的离线渲染断言：用假 React 真渲染这个组件，
 		// 断言"有/无 suggestedAction、执行中、成功、失败、中英切换"五种情形的 DOM 结构）。
 		exports.SuggestedActionBox = SuggestedActionBox;
+		// 仅测试用导出（tests/test-adapt-unlock-gate.mjs ①-2：断言「已适配，立即解锁」按钮的门控判据，
+		// 以及它必须与卡片正文用同一个判据）。
+		exports.canAdaptUnlock = canAdaptUnlock;
 		return module.exports;
 	}
 });

package/lib/server/domain/compat.js

@@ -1,7 +1,7 @@
 // L1 · domain —— compat.js（框架兼容判定与适配门：设置 API 扫描 / 兼容门读写 / 待适配记录 / 隔离记录合并的前置部分 / 启动失败分析；分层 Step 6 从 lib/index.js 搬出，只搬移未改逻辑。注：detectCompat 等吃运行上下文的留到 Step 8）
 // 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
-import { readFileSync, writeFileSync, readdirSync, mkdirSync, realpathSync } from 'node:fs'
+import { readFileSync, writeFileSync, mkdirSync, realpathSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { spawn } from 'node:child_process'
 import { dirname, join, sep, resolve } from 'node:path'
@@ -13,6 +13,9 @@ import { listEntries } from './runtime.js'
 import { fetchJsonUrl } from '../infra/http.js'
 import { dshHome, findPatchPath, pluginRoot, profileDirOf, resolvePackageJson } from '../infra/paths.js'
 import { semverRangeMatch, semverRangeMatchLoose } from '../infra/semver.js'
+// 0.5.33 改错：已删除 API 的源码扫描搬进独立 domain 模块（判据收紧为"真的从 dsh-settings 绑定进来"）。
+// 这三个名字继续由本模块导出，对外契约不变。
+import { REMOVED_SETTINGS_SYMBOLS, referencesRemovedSymbol, scanSettingsApiUsage } from './settings-api-scan.js'
 
 /** Cordis Fiber 状态映射（与 dsh-host-plugin-inventory 一致）。 */
 const FIBER_STATE = { PENDING: 0, LOADING: 1, ACTIVE: 2, FAILED: 3, DISPOSED: 4, UNLOADING: 5 }
@@ -26,63 +29,6 @@ const FIBER_PHASE = {
   [FIBER_STATE.UNLOADING]: 'unloading',
 }
 
-/**
- * 扫描已安装包源码，检测对已删除的 dsh-settings API 的引用
- * （2026-09-04 教训：0.1.2-rc.1 起 settingsNamespace / installSettingsSection 已删除，
- * 静态声明检查判 pass 是假通过；真实兼容性只有模块 import 时见分晓，而 loader 单行失败
- * = 整个服务启动崩溃）。返回命中的符号列表，空数组 = 干净。
- */
-const REMOVED_SETTINGS_SYMBOLS = ['settingsNamespace', 'installSettingsSection']
-
-/** 源码是否**引用**了已删除符号——而不是「恰好包含同名前缀的其它标识符」或「自己定义的同名局部函数」。
- *  v0.3.35 修复（真机演练抓到的误伤）：原先用 `text.includes('settingsNamespace')` 子串匹配，
- *  而框架自带的 @deepseek-ai/dsh-api-settings-controller 里有个 `settingsNamespaceRequestSchema`，
- *  于是框架自己的 settings 控制器被判「引用已删除 API」→ 升级预扫会把它自动禁用（砍掉框架功能）。
- *  现在要求标识符边界，且排除「本地 const/let/var/function/class 定义且同行没有 dsh-settings 引用」。 */
-function referencesRemovedSymbol(text, sym) {
-  const re = new RegExp(`(?<![A-Za-z0-9_$])${sym}(?![A-Za-z0-9_$])`, 'u')
-  for (const line of text.split(/\r?\n/u)) {
-    const m = re.exec(line)
-    if (m === null) continue
-    const before = line.slice(0, m.index)
-    const localDefinition = /(?:^|[^\w$])(?:const|let|var|function|class|async\s+function)\s*$/u.test(before)
-    if (localDefinition && !/dsh-settings/u.test(line)) continue
-    return true
-  }
-  return false
-}
-
-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 REMOVED_SETTINGS_SYMBOLS) {
-          if (found.includes(sym)) continue
-          if (referencesRemovedSymbol(text, sym)) found.push(sym)
-        }
-      } catch {}
-    }
-  }
-  walk(pkgDir, 0)
-  return found
-}
-
 /** 包是否由框架自带（解析到 profile 目录之外，如 npx/pnpm 缓存里的 @deepseek-ai/*）。
  *  v0.3.35：这类行随框架一起发布，禁用**不是**正确处置（正确处置是回滚框架），
  *  而且一旦判定有误就会把框架功能砍掉——所以升级预扫永不自动禁用它们。 */

package/lib/server/domain/peer-veto.js

@@ -0,0 +1,103 @@
+// L1 · domain —— peer-veto.js（框架 peer 预检「否决」的**本地复算**；0.5.33 加法，诊断缺口 D-⑧）
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
+//
+// ── 要解决什么 ────────────────────────────────────────────────────────────────────
+// 真机症状：「补丁里明明写着启用（或压根没写 disabled）、运行时却没挂载（fiberPhase === null），
+// 面板上一个字都不说为什么」。真实机制（框架侧，不是我们的 bug）：
+//   `@deepseek-ai/dsh-app-boot/lib/index.js`
+//     · `evaluatePluginCompatibility(manifest, exemptions, runtimeVersion)`（:286-313）
+//       —— 只看 **peerDependencies**，只看 `@deepseek-ai/dsh` / `@deepseek-ai/dsh-*`，
+//          `workspace:^|~|*` 视为「等于当前运行时」，其余按 semver（includePrerelease）判；
+//     · `preflight()`（:2063-2109）—— 判不满足就在**内存里** `row.disabled = true`（**不写用户补丁**），
+//       原因只 `process.stderr.write` 一行。
+//   本机典型现场：profile 顶层压着 `@deepseek-ai/dsh-schedule@0.0.1-rc.3` 残影，它的 peer 写
+//   `@deepseek-ai/dsh-agent@^0.0.1-rc.3` 等 7 项 → 对运行中的 0.2.0-rc.2 **必然不满足** → 启动即被否决，
+//   而补丁尾部还是 `- id: schedule / disabled: false`，面板只显示「未挂载」。
+//
+// ── 本模块做什么（**加法**：不改任何既有判据与开关，只补一句原因 + 一条出路）────────────
+// 在同一判据下本地复算一遍：读该行**实际解析到的包** manifest 的 peerDependencies × 当前框架版本。
+// 判定不满足 → 给短句原因 + 出路；包解析不到 → **另给**「包不存在」原因（两者绝不混为一谈）。
+//
+// ── 保守性（宁可不说，不可错说）────────────────────────────────────────────────
+// 框架用的是 node-semver 的 `{ includePrerelease: true }`；仓库既有的 semver 工具里，
+// `semverRangeMatchLoose` 与它最接近但**偏宽松**（把它当"满足"的少数情形，框架可能判不满足）。
+// 这里**故意用宽松的那一支**：只有连宽松读法都不满足时才说话 —— 与 ①-1「不误报」同一纪律。
+// 代价是可能漏报少数否决（表现回退成"什么都不显示"，不会错说原因）。
+
+import { readFileSync } from 'node:fs'
+import { resolvePackageJson } from '../infra/paths.js'
+import { semverRangeMatchLoose } from '../infra/semver.js'
+
+/** 框架预检只看这个前缀的 peer（与 dsh-app-boot 的 `name !== '@deepseek-ai/dsh' && !name.startsWith('@deepseek-ai/dsh-')` 对齐）。 */
+const PEER_PREFIX = '@deepseek-ai/dsh'
+
+/** `workspace:^` / `workspace:~` / `workspace:*` 在框架里等价于「当前运行时版本」→ 永远满足。 */
+const WORKSPACE_RANGES = new Set(['workspace:^', 'workspace:~', 'workspace:*'])
+
+/**
+ * 纯判据：返回**不满足**的 peer 列表（空数组 = 没有相关 peer 声明，或全部满足）。
+ * 与 `dsh-app-boot` 的 `evaluatePluginCompatibility` 逐条对齐（见文件头）。
+ */
+function unsatisfiedPeers(manifest, runtimeVersion) {
+  if (manifest === null || typeof manifest !== 'object') return []
+  if (!Object.hasOwn(manifest, 'peerDependencies')) return []
+  const deps = manifest.peerDependencies
+  if (deps === null || typeof deps !== 'object' || Array.isArray(deps)) return []
+  if (typeof runtimeVersion !== 'string' || runtimeVersion === '') return []
+  const out = []
+  for (const [name, range] of Object.entries(deps)) {
+    if (name !== PEER_PREFIX && !name.startsWith(`${PEER_PREFIX}-`)) continue
+    if (typeof range !== 'string') { out.push({ name, range: String(range) }); continue }
+    const requirement = WORKSPACE_RANGES.has(range) ? runtimeVersion : range
+    if (requirement.trim() === '' || !semverRangeMatchLoose(runtimeVersion, requirement)) out.push({ name, range })
+  }
+  return out
+}
+
+/** 短句化的「需要什么」：一项给全名，多项给首项 + 总数（面板一行放得下）。 */
+function describePeers(peers) {
+  const first = `${peers[0].name}@${peers[0].range}`
+  return peers.length === 1 ? first : `${first} 等 ${peers.length} 项`
+}
+
+/**
+ * 行级复算（IO 可注入，便于离线断言）。
+ *
+ * 入参：`{ moduleName, profileDir, frameworkVersion }`
+ * 返回：`null`（无话可说）｜`{ kind:'peers'|'missing', reason, hint }`
+ *   · `kind:'peers'`   —— 本地复算判定 peer 不满足（大概率就是框架否决它的原因）
+ *   · `kind:'missing'` —— 包解析不到 / 清单读不出来（**另一种原因**，措辞与出路都不同）
+ */
+function peerVetoFor({ moduleName, profileDir, frameworkVersion, deps = {} } = {}) {
+  const { resolvePkg = resolvePackageJson, readText = (p) => readFileSync(p, 'utf8') } = deps
+  if (typeof moduleName !== 'string' || moduleName === '' || moduleName.startsWith('cordis:')) return null
+  if (typeof profileDir !== 'string' || profileDir === '') return null
+  if (typeof frameworkVersion !== 'string' || frameworkVersion === '') return null
+  let pkgPath = null
+  try { pkgPath = resolvePkg(moduleName, profileDir) } catch { pkgPath = null }
+  if (pkgPath === null) {
+    return {
+      kind: 'missing',
+      reason: `被框架否决：包不存在（${moduleName} 在本 profile 解析不到）`,
+      hint: `出路：这一行指向的包已经不在本 profile 里（升级/卸载后的残留行）——重装或更新该插件即可；确实不需要它时，在补丁里删掉或禁用它。`,
+    }
+  }
+  let manifest = null
+  try { manifest = JSON.parse(readText(pkgPath)) } catch { manifest = null }
+  if (manifest === null || typeof manifest !== 'object') {
+    return {
+      kind: 'missing',
+      reason: `被框架否决：包清单读不出来（${moduleName}）`,
+      hint: '出路：重装该插件——package.json 读不出来时框架自己也无法校验它，只能按最坏情况跳过挂载。',
+    }
+  }
+  const peers = unsatisfiedPeers(manifest, frameworkVersion)
+  if (peers.length === 0) return null
+  return {
+    kind: 'peers',
+    reason: `被框架否决：peer 不满足（需要 ${describePeers(peers)}，当前 ${frameworkVersion}）`,
+    hint: `出路：把 ${moduleName} 更新到兼容当前框架的版本（首选）；若它是升级后残留的旧包，从 profile 里清掉；要保留这个精确版本，就得用框架的精确版本豁免（dsh plugin allow-version / 插件管理器 → profile 的 compatibility.json）。`,
+  }
+}
+
+export { PEER_PREFIX, WORKSPACE_RANGES, unsatisfiedPeers, peerVetoFor }

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

@@ -0,0 +1,251 @@
+// 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']
+
+/** 这些 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, SETTINGS_MODULE, maskLiterals, settingsApiBindings, settingsApiReferences, referencesRemovedSymbol, scanSettingsApiUsage }

package/lib/server/routes/plugins.js

@@ -327,7 +327,9 @@ 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：文案必须写清「为什么不行 + 出路」——旧文案只有一句"适配校验未通过"，
+      // 用户在界面上根本不知道下一步该做什么（而按钮此前又只在 adoptable 时出现，容易变成对不上的承诺）。
+      sendError(res, 409, `适配校验未通过：${String(check.reason ?? '适配校验未通过')}。出路：先点「检测更新」把它更新到兼容当前框架 ${fwVer} 的版本（更新完成会自动重跑源码扫描，通过即解锁）；若它已不再需要，可在补丁里删掉/禁用这一行。本次未改动补丁与适配门清单。`)
       return
     }
     await removeDisableBlock(patchPath, rowId)

package/lib/server/routes/state.js

@@ -5,7 +5,8 @@ import { readFileSync, existsSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { detectAdoptablePending, detectCompat, gatingSummary, readCompatGate, readCompatPending } 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,6 +47,7 @@ async function routeStateGet(req, res, rc) {
       setPatchHealReport(patchHeal)
     }
     const extraRows = await readExtraBundleRows(dirname(patchPath))
+    const profileDir = dirname(patchPath)
     const compatPending = readCompatPending()
     const compatPendingRows = new Set((compatPending?.pending ?? []).filter((p) => (p.status ?? 'pending') === 'pending').map((p) => p.rowId))
     // 兼容门总开关 + 自动检测（只提示不自动开）
@@ -58,11 +60,21 @@ 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 }
+      }
       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 +82,11 @@ 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,
         // 自动检测结果（只提示，不自动开）：该待适配行现在是否已适配（插件已更新 + 扫描通过）
         adoptable: adoptable.get(entry.rowId) ?? null,
+        // 框架 peer 预检的本地复算结果（null = 无话可说；只在这类行上下发，不新增常驻面板行）
+        veto,
       }
     })
     const compat = await detectCompat(ctx.baseUrl ?? 'file:///')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.5.32",
+  "version": "0.5.33",
   "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",