@noob-stupid/dsh-plugin-console 0.3.67 → 0.4.1

package/lib/client.js

@@ -276,7 +276,7 @@ window.__ModuleLoader__.load({
 			aiFallbackLabel: "AI 兜底",
 			aiEmpowerLabel: "AI 赋能",
 			aiEmpowerTitle: "AI 赋能：读文档自动规划并部署组件；识别到服务器类组件后自动加启动/停止按钮",
-			aiEmpowerSrcTitle: "输入要部署的组件（npm 包名或 GitHub 仓库，如 Noob-stupid/dsh-plugin-hub 或 @noob-stupid/dsh-plugin-console）",
+			aiEmpowerSrcTitle: "输入要部署的组件（npm 包名或 GitHub 仓库，如 Noob-stupid/dsh-plugin-gating-hub 或 @noob-stupid/dsh-plugin-console）",
 			aiEmpowerPlanTitle: "AI 赋能部署计划",
 			aiEmpowerType: "类型",
 			aiEmpowerTypeMapping: { "pure-plugin": "纯插件", "service": "服务器组件", "config-only": "仅配置" },
@@ -475,6 +475,20 @@ window.__ModuleLoader__.load({
 			frameworkUpgradeTarget: "升级目标",
 			frameworkUpgradePick: "选择要升级到的版本（列出所有比当前新的版本，含预发布；latest 为稳定版）",
 			frameworkUpgradeMore: "展开全部可选版本（{n}）",
+			// 升级前契约预检（2026-09-24 事故：v4 消息格式变更让运行期生产方全部失效）
+			fwPreflightBtn: "升级预检",
+			fwPreflightTitle: "升级前契约预检：抓目标版本的会话格式契约（迁移边），扫描 agent-presets 与已装插件里的旧形状消息来源；可一键适配并自动备份（.bak-preflight-*）",
+			fwPreflightRunning: "预检中…",
+			fwPreflightClean: "预检通过：本地生产方没有会触发格式校验的旧写法",
+			fwPreflightFound: "预检发现 {n} 处必须适配（另有 {m} 处提示）",
+			fwPreflightContract: "会话格式契约：{summary}",
+			fwPreflightNoContract: "契约未知：{err}（已降级为内置规则扫描）",
+			fwPreflightPatch: "一键适配（自动备份）",
+			fwPreflightApplyConfirm: "将修改本地文件（每个文件自动备份为 .bak-preflight-*），继续？",
+			fwPreflightPatched: "已适配 {n} 处，备份 {b} 个文件",
+			fwPreflightRemaining: "适配后仍有 {n} 处需人工处理（预检不会自动改）",
+			fwPreflightNeedManual: "需人工处理：{why}",
+			fwPreflightScanned: "已扫描 {n} 个生产方文件（预设 + 插件）",
 			frameworkUpgradeFold: "收起版本列表",
 			frameworkUpgradeChannelStable: "稳定版",
 			frameworkUpgradeChannelPre: "预发布",
@@ -887,6 +901,20 @@ window.__ModuleLoader__.load({
 			frameworkUpgradeTarget: "Upgrade target",
 			frameworkUpgradePick: "Pick a version to upgrade to (every version newer than the current one, pre-releases included; latest = stable channel)",
 			frameworkUpgradeMore: "Show all available versions ({n})",
+			// Pre-upgrade contract preflight (2026-09-24 incident: v4 message-format change broke every runtime producer)
+			fwPreflightBtn: "Pre-upgrade preflight",
+			fwPreflightTitle: "Pre-upgrade contract preflight: fetch the target session-format contract (migration edges) and scan agent-presets + installed plugins for legacy message sources; one click adapts with .bak-preflight-* backups",
+			fwPreflightRunning: "Preflighting…",
+			fwPreflightClean: "Preflight passed: no legacy producer shape that would fail format validation",
+			fwPreflightFound: "Preflight found {n} blockers to adapt ({m} advisories)",
+			fwPreflightContract: "Session-format contract: {summary}",
+			fwPreflightNoContract: "Contract unknown: {err} (degraded to built-in rules)",
+			fwPreflightPatch: "Adapt now (auto backup)",
+			fwPreflightApplyConfirm: "This will modify local files (each backed up as .bak-preflight-*). Continue?",
+			fwPreflightPatched: "Adapted {n} spot(s), backed up {b} file(s)",
+			fwPreflightRemaining: "{n} spot(s) still need manual work (preflight never auto-fixes those)",
+			fwPreflightNeedManual: "Needs manual work: {why}",
+			fwPreflightScanned: "Scanned {n} producer file(s) (presets + plugins)",
 			frameworkUpgradeFold: "Collapse version list",
 			frameworkUpgradeChannelStable: "stable",
 			frameworkUpgradeChannelPre: "pre-release",
@@ -1392,6 +1420,10 @@ window.__ModuleLoader__.load({
 				? fwSelectedVersion
 				: (fwCheck && fwCheck.tagDefault) || (fwCheck && fwCheck.target) || (fwVersions[0] ? fwVersions[0].version : null);
 			const fwChannelLabel = (v) => (v && v.isLatest === true ? t("frameworkUpgradeChannelStable") + " · latest" : (v && typeof v.channel === "string" && v.channel !== "" ? t("frameworkUpgradeChannelPre") + " · " + v.channel : t("frameworkUpgradeChannelPre")));
+			// 升级前契约预检（Step 1+2）：report=只读预检结论，patch=一键适配结果；两者分开放，
+			// 免得把「扫描结论」和「已经改过什么」混成一团（用户要能分辨「该不该升级」与「改了什么」）
+			const [fwPreflightBusy, setFwPreflightBusy] = react.useState(false);
+			const [fwPreflight, setFwPreflight] = react.useState(null);
 			// 面板里的状态刷新：**无视**「终态已关闭」标记——卡片可以被永久关掉，面板必须永远能查到真相
 			const fwStatusRefresh = () => {
 				call("/plugin-console/framework-upgrade-status").then(
@@ -1411,6 +1443,24 @@ window.__ModuleLoader__.load({
 					(error) => { setFwCheckBusy(false); setMessage(t("failed") + "：" + friendlyGithubError(error).message); },
 				);
 			};
+			// 升级前契约预检：先只读预检（抓目标版本会话格式契约 + 扫本地生产方），
+			// 再按需一键适配（服务端逐文件备份 .bak-preflight-*，名单外文件一律拒绝写入）。
+			// 为什么必须独立于「框架升级」按钮：包级适配门看不到运行期契约破坏（2026-09-24 事故）。
+			const fwPreflightRun = (apply) => {
+				const targetVersion = fwSelected ?? fwCheck?.target ?? null;
+				if (apply === true && !window.confirm(t("fwPreflightApplyConfirm"))) return;
+				setFwPreflightBusy(true);
+				const path = apply === true ? "/plugin-console/framework-preflight-patch" : "/plugin-console/framework-preflight";
+				const payload = apply === true ? { targetVersion, mode: "apply" } : { targetVersion };
+				call(path, payload).then(
+					(data) => {
+						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); },
+				);
+			};
+			const fwShortPath = (p) => String(p ?? "").replace(/\\/gu, "/").split("/").slice(-3).join("/");
 			const doFrameworkRollback = () => {
 				setFrameworkUpgrading(true);
 				call("/plugin-console/framework-rollback", {}).then(
@@ -2832,7 +2882,9 @@ window.__ModuleLoader__.load({
 					return;
 				}
 				if ((item.subpackagePath || item.npmPackage === true) && typeof item.packageName === "string" && item.packageName !== "") {
-					// monorepo 子包：搜索结果带 packageName，按 npm 包名安装
+					// monorepo 子包 / npm 包名命中：搜索结果带 packageName，按 npm 包名安装
+					//（npm 包名反查命中的条目没有 subpackagePath，只有 packageName + npmPackage，
+					//  不改这一行就会退化成"按仓库装"，装到的不是用户输入的那个包 —— 2026-09-20）
 					startJob(item.fullName, item.packageName, item.source ?? "github");
 					return;
 				}
@@ -3663,8 +3715,47 @@ window.__ModuleLoader__.load({
 										: null,
 									frameworkStatus.message ? el("p", { className: styles.status, "data-error": frameworkStatus.status === "failed" ? "true" : undefined }, frameworkStatus.message) : null)
 								: el("p", { className: styles.status }, t("fwPanelNoRecord")),
+							// ③.0 升级预检报告（只读结论 + 一键适配结果）——放在升级按钮之前，
+							// 让「先预检、再升级」成为默认路径
+							fwPreflight !== null
+								? el("div", { style: { flexDirection: "column", gap: 6, display: "flex", border: "1px solid var(--dsw-alias-border-l2)", borderRadius: 8, padding: 8 } },
+									el("strong", { className: styles.name },
+										t("fwPreflightBtn")
+										+ (fwPreflight.report?.scan ? "（" + t("fwPreflightScanned").replace("{n}", String(fwPreflight.report.scan.filesScanned)) + "）" : "")),
+									fwPreflight.report === null || fwPreflight.report === undefined
+										? null
+										: (fwPreflight.report.contract !== null && fwPreflight.report.contract !== undefined
+											? el("p", { className: styles.status }, t("fwPreflightContract").replace("{summary}", String(fwPreflight.report.contractSummary ?? "")))
+											: el("p", { className: styles.message, "data-warn": "true" }, t("fwPreflightNoContract").replace("{err}", String(fwPreflight.report.contractError ?? "?")))),
+									fwPreflight.report === null || fwPreflight.report === undefined
+										? null
+										: (fwPreflight.report.scan.ok === true
+											? el("p", { className: styles.status }, "✓ " + t("fwPreflightClean"))
+											: el("p", { className: styles.message, "data-error": "true" }, t("fwPreflightFound").replace("{n}", String(fwPreflight.report.scan.blockers)).replace("{m}", String(fwPreflight.report.scan.warnings)))),
+									fwPreflight.report === null || fwPreflight.report === undefined
+										? null
+										: el("div", { style: { flexDirection: "column", gap: 2, display: "flex", maxHeight: 160, overflowY: "auto" } },
+											(fwPreflight.report.scan.findings ?? []).slice(0, 10).map((f, idx) => el("p", { key: idx, className: styles.status },
+												"• " + fwShortPath(f.file) + ":" + f.line + " — " + f.rule
+												+ (f.fixable === true ? "" : "（" + t("fwPreflightNeedManual").replace("{why}", String(f.reason ?? f.note ?? "?")) + "）")
+												+ (f.after ? "  →  " + f.after : "")))),
+									fwPreflight.patch !== null && fwPreflight.patch !== undefined
+										? el("p", { className: styles.status, "data-pending": "true" },
+											t("fwPreflightPatched").replace("{n}", String((fwPreflight.patch.changes ?? []).length)).replace("{b}", String((fwPreflight.patch.backups ?? []).length)))
+										: null,
+									fwPreflight.patch !== null && fwPreflight.patch !== undefined && (fwPreflight.patch.remaining?.blockers ?? 0) > 0
+										? el("p", { className: styles.message, "data-warn": "true" }, t("fwPreflightRemaining").replace("{n}", String(fwPreflight.patch.remaining.blockers)))
+										: null,
+									el("div", { className: styles.rowTop },
+										fwPreflight.report !== null && fwPreflight.report !== undefined && fwPreflight.report.scan.blockers > 0
+											? el("button", { type: "button", className: styles.toggle, disabled: fwPreflightBusy, onClick: () => fwPreflightRun(true) }, t("fwPreflightPatch"))
+											: null,
+										el("button", { type: "button", className: styles.toggle, disabled: fwPreflightBusy, onClick: () => fwPreflightRun(false) }, fwPreflightBusy ? t("fwPreflightRunning") : t("fwPreflightBtn")),
+										el("button", { type: "button", className: styles.toggle, onClick: () => setFwPreflight(null) }, t("closeModal"))))
+								: null,
 							// ③ 操作：升级（两步确认）/ 回滚 / 重启 / 重新检查
 							el("div", { className: styles.rowTop, style: { flexWrap: "wrap" } },
+								el("button", { type: "button", className: styles.toggle, disabled: fwPreflightBusy, title: t("fwPreflightTitle"), onClick: () => fwPreflightRun(false) }, fwPreflightBusy ? t("fwPreflightRunning") : t("fwPreflightBtn")),
 								fwCheck?.target
 									? (fwConfirmPanel
 										? el("div", { style: { flexDirection: "column", gap: 8, display: "flex", flexBasis: "100%" } },
@@ -3716,34 +3807,36 @@ window.__ModuleLoader__.load({
 								el("p", { className: styles.message }, t("compatGateHint")),
 								el("p", { className: styles.status, "data-pending": gatePendingCount > 0 ? "true" : undefined },
 									gatePendingCount > 0 ? t("gatePendingInfo").replace("{n}", String(gatePendingCount)) : t("gatePendingNone")),
-								// 明细清单（2026-09-24 用户要求：面板要能看到是哪些插件，有列表数据）
-								gateRows !== null && gateRows.pendingCount + gateRows.adoptedCount > 0
-									? el("div", { style: { flexDirection: "column", gap: 6, display: "flex" } },
-										el("strong", { className: styles.name }, t("gateListPending").replace("{n}", String(gateRows.pendingCount))),
-										gateRows.pending.length === 0
-											? el("p", { className: styles.status }, t("gatePendingNone"))
-											: null,
-										(gateShowAll ? gateRows.pending : gateRows.pending.slice(0, 8)).map((r) => el("div", {
-											key: "p-" + String(r.rowId),
-											style: { flexDirection: "column", gap: 2, display: "flex", padding: "4px 0" },
-										},
-											el("span", { className: styles.name }, (r.enabled === false ? "⛔ " : "• ") + String(r.name) + (r.version ? "  v" + r.version : "")),
-											el("span", { className: styles.status }, t("gateRowReason").replace("{reason}", String(r.note ?? "—"))),
-											el("span", { className: styles.status },
-												(r.source === "boot-quarantine" ? t("gateRowFromBoot") : t("gateRowFromUpgrade"))
-												+ (r.forcedAt ? t("gateRowAt").replace("{t}", gateTime(r.forcedAt)) : "")
-												+ (r.adoptable ? t("gateRowAdoptable") : "")))),
-										gateRows.pendingCount > 8
-											? el("button", { type: "button", className: styles.toggle, onClick: () => setGateShowAll((v) => !v) },
-												gateShowAll ? t("gateListFold") : t("gateListMore").replace("{n}", String(gateRows.pendingCount)))
-											: null,
-										gateRows.adoptedCount > 0
-											? el("div", { style: { flexDirection: "column", gap: 2, display: "flex" } },
-												el("strong", { className: styles.name }, t("gateListAdopted").replace("{n}", String(gateRows.adoptedCount))),
-												gateRows.adopted.slice(0, 8).map((r) => el("span", { key: "a-" + String(r.rowId), className: styles.status },
-													"✓ " + String(r.name) + (r.version ? "  v" + r.version : "") + (r.adoptedAt ? "  · " + gateTime(r.adoptedAt) : ""))))
-											: null)
-									: null)))
+        							el("p", { className: styles.status, "data-pending": gatePendingCount > 0 ? "true" : undefined },
+								gatePendingCount > 0 ? t("gatePendingInfo").replace("{n}", String(gatePendingCount)) : t("gatePendingNone")),
+							// 明细清单（2026-09-24 用户要求：面板要能看到是哪些插件，有列表数据）
+							gateRows !== null && gateRows.pendingCount + gateRows.adoptedCount > 0
+								? el("div", { style: { flexDirection: "column", gap: 6, display: "flex" } },
+									el("strong", { className: styles.name }, t("gateListPending").replace("{n}", String(gateRows.pendingCount))),
+									gateRows.pending.length === 0
+										? el("p", { className: styles.status }, t("gatePendingNone"))
+										: null,
+									(gateShowAll ? gateRows.pending : gateRows.pending.slice(0, 8)).map((r) => el("div", {
+										key: "p-" + String(r.rowId),
+										style: { flexDirection: "column", gap: 2, display: "flex", padding: "4px 0" },
+									},
+										el("span", { className: styles.name }, (r.enabled === false ? "⛔ " : "• ") + String(r.name) + (r.version ? "  v" + r.version : "")),
+										el("span", { className: styles.status }, t("gateRowReason").replace("{reason}", String(r.note ?? "—"))),
+										el("span", { className: styles.status },
+											(r.source === "boot-quarantine" ? t("gateRowFromBoot") : t("gateRowFromUpgrade"))
+											+ (r.forcedAt ? t("gateRowAt").replace("{t}", gateTime(r.forcedAt)) : "")
+											+ (r.adoptable ? t("gateRowAdoptable") : "")))),
+									gateRows.pendingCount > 8
+										? el("button", { type: "button", className: styles.toggle, onClick: () => setGateShowAll((v) => !v) },
+											gateShowAll ? t("gateListFold") : t("gateListMore").replace("{n}", String(gateRows.pendingCount)))
+										: null,
+									gateRows.adoptedCount > 0
+										? el("div", { style: { flexDirection: "column", gap: 2, display: "flex" } },
+											el("strong", { className: styles.name }, t("gateListAdopted").replace("{n}", String(gateRows.adoptedCount))),
+											gateRows.adopted.slice(0, 8).map((r) => el("span", { key: "a-" + String(r.rowId), className: styles.status },
+												"✓ " + String(r.name) + (r.version ? "  v" + r.version : "") + (r.adoptedAt ? "  · " + gateTime(r.adoptedAt) : ""))))
+										: null)
+								: null)))
 					: null,
 				aiOpen
 					? el("div", { className: styles.modalBackdrop },
@@ -3860,7 +3953,9 @@ window.__ModuleLoader__.load({
 							setMessage(t("cleanResiduals") + "…");
 							call("/plugin-console/clean-residuals", {}).then(
 								(data) => {
-									if (data && data.ok === true) setMessage(t("cleanResiduals") + "：" + (data.count === 0 ? "无残余" : "已清理 " + data.count + " 项"));
+									const keptCount = Array.isArray(data && data.kept) ? data.kept.length : 0;
+									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),
 							);