@noob-stupid/dsh-plugin-console 0.5.54 → 0.5.55

package/lib/client.js

@@ -120,6 +120,7 @@ window.__ModuleLoader__.load({
 			skippedBundlesTitle: "被框架跳过的 bundle（{n} 个）—— 它们装了但整层没被装载，所以插件列表里看不到；鼠标悬停看每一项的出路",
 			hostedNoChannel: "本实例由桌面端外壳托管：框架升级与回滚请走桌面端（此处不可用）",
 			linksTitle: "开发式链接（link）：共 {n} 个，自足 {ready} 个 —— ✓ 自足 · · 缺东西（悬停看原因）",
+			healthSummary: "需要处理 {n} 类问题",
 			linksFailed: "开发式链接清单读取失败",
 			actionReconcileLabel: "重建 pnpm-lock.yaml",
 			actionRun: "执行",
@@ -713,6 +714,7 @@ window.__ModuleLoader__.load({
 			skippedBundlesTitle: "{n} bundle(s) skipped by the framework - installed but never loaded, which is why they are absent from the plugin list; hover an item for the way out",
 			hostedNoChannel: "Hosted by the desktop shell: use the desktop app for framework upgrade and rollback (unavailable here)",
 			linksTitle: "Dev links (link:): {n} total, {ready} self-sufficient - checkmark = ready, dot = something missing (hover for why)",
+			healthSummary: "{n} issue type(s) need attention",
 			linksFailed: "Failed to read the dev-link inventory",
 			actionReconcileLabel: "Rebuild pnpm-lock.yaml",
 			actionRun: "Run",
@@ -4587,6 +4589,15 @@ window.__ModuleLoader__.load({
 							}, t("compatNoticeDismiss")),
 						)
 					: null,
+				// ★ 0.5.55 加法：**一行健康摘要** —— 面板有 176 个按钮、信息散在六处，
+				// 过去没有任何地方能回答"整体健康吗、该先处理哪件"。这里把服务端已折好的
+				// 分项计数摆在最上面（不新增判据、不新增 IO：全部来自 /state 已有的块）。
+				state.status === "ready" && state.data.health && state.data.health.issues > 0
+					&& Array.isArray(state.data.health.items)
+					? el("p", { className: styles.message, "data-error": "true", style: { marginTop: "8px", marginBottom: "0" } },
+							fill(t("healthSummary"), [["n", String(state.data.health.issues)]]) + "："
+							+ state.data.health.items.map((x) => x.label + " " + String(x.count)).join(" · "))
+					: null,
 				// ★ 0.5.53 加法（真机 2026-10-15）：**被框架整层跳过的 bundle**。
 				//   为什么必须放在这里（不是列表里）：被跳过的 bundle **不产生任何 loader 行**，
 				//   所以在插件列表里根本没有位置可挂 —— 用户看到的是"我明明有，却不显示"。

package/lib/server/domain/install-health.js

@@ -0,0 +1,64 @@
+// L1 · domain —— 安装健康摘要（0.5.55 加法）
+//
+// 为什么需要（审计结论 + 用户 2026-10-15「优化到你能做到的最好」）：
+//   面板有 176 个按钮、3 个区块，信息散在「兼容门控 / peer 否决 / 持久化 / 依赖锁 / 框架残留 / 闭包预检」
+//   六处。用户打开面板时**没有一个地方能回答**："我这套安装现在整体健康吗？有哪几件事需要我处理？"
+//   于是该点的找不到、不该点的全在眼前 —— 这不是功能不足，是**入口缺失**。
+//
+// 本模块刻意**只做折叠、不新增判据**：
+//   输入全部是 /state 里**已经算好**的东西（否决行、被跳过的 bundle、待适配行、补丁自愈结果），
+//   输出一句话摘要 + 分项计数。**不读盘、不联网、不 spawn** —— 因此可以放进 /state 的返回里，
+//   不带来任何额外 IO 成本。
+//
+// 判据口径（与各自真源保持一致，别在这里另立标准）：
+//   · veto         ← entries[].veto（domain/peer-veto.js 的结论）
+//   · skippedBundle← skippedBundles（domain/bundle-veto.js 的结论；只在 reliable 时计入）
+//   · pendingCompat← compatPending.pending（兼容门控的待适配行）
+//   · patchHeal    ← patchHeal.uncertain / autoDisabled（补丁自愈的遗留项）
+//
+// 分层：L1 domain —— 纯函数，收已解开的数组/对象（因此**不 import 任何其它模块**）。
+
+/** 严重度：blocker 会让人"看不到/用不了"，warn 只是"有风险"。 */
+const SEVERITY = { blocker: 'blocker', warn: 'warn' }
+
+/**
+ * 把已算好的各块折叠成一份健康摘要。
+ *
+ * @param {object} p
+ * @param {Array} [p.entries] /state 的 entries（含 veto）
+ * @param {{items?: Array, reliable?: boolean}} [p.skippedBundles] bundle 级否决结果
+ * @param {Array} [p.pendingCompat] 待适配行
+ * @param {Array} [p.patchUncertain] 补丁自愈里"说不准"的行 id
+ * @returns {{ issues: number, items: Array<{kind: string, severity: string, count: number, label: string}> }}
+ */
+function buildInstallHealth(input = {}) {
+  // 体检模块自己不能崩：null / undefined / 非对象一律当空输入（tests/test-install-health.mjs ⑥ 钉住）
+  const src = input !== null && typeof input === 'object' ? input : {}
+  const list = Array.isArray(src.entries) ? src.entries : []
+  const skippedBundles = src.skippedBundles ?? null
+  const pendingCompat = Array.isArray(src.pendingCompat) ? src.pendingCompat : []
+  const patchUncertain = Array.isArray(src.patchUncertain) ? src.patchUncertain : []
+  const items = []
+
+  // ① bundle 级：被框架**整层跳过** —— 最严重，因为它在列表里连位置都没有（用户看不到）
+  const skipped = skippedBundles !== null && skippedBundles !== undefined && skippedBundles.reliable === true && Array.isArray(skippedBundles.items)
+    ? skippedBundles.items.length
+    : 0
+  if (skipped > 0) items.push({ kind: 'skipped-bundle', severity: SEVERITY.blocker, count: skipped, label: '被框架跳过的 bundle（装了但没装载，列表里看不到）' })
+
+  // ② 行级：被 peer 否决（可见但未加载）
+  const vetoed = list.filter((e) => e !== null && e !== undefined && e.veto !== null && e.veto !== undefined)
+  if (vetoed.length > 0) items.push({ kind: 'vetoed', severity: SEVERITY.blocker, count: vetoed.length, label: '被框架否决的插件行（未加载）' })
+
+  // ③ 待适配（兼容门控挂着的行）
+  const pending = Array.isArray(pendingCompat) ? pendingCompat.length : 0
+  if (pending > 0) items.push({ kind: 'pending-compat', severity: SEVERITY.warn, count: pending, label: '待适配确认的行' })
+
+  // ④ 补丁自愈里"说不准"的行（工具改过但无法确认是否它想要的）
+  const uncertain = Array.isArray(patchUncertain) ? patchUncertain.length : 0
+  if (uncertain > 0) items.push({ kind: 'patch-uncertain', severity: SEVERITY.warn, count: uncertain, label: '补丁自愈无法确认的行' })
+
+  return { issues: items.length, items }
+}
+
+export { SEVERITY, buildInstallHealth }

package/lib/server/routes/state.js

@@ -10,6 +10,7 @@ import { peerVetoFor } from '../domain/peer-veto.js'
 import { readExtraBundleRows } from '../domain/install-job.js'
 import { bundleVetoList } from '../domain/bundle-veto.js'
 import { buildLinkInventory } from '../domain/link-inventory.js'
+import { buildInstallHealth } from '../domain/install-health.js'
 import { readBundlesSync } from '../domain/persist.js'
 import { failedJobEvidence } from '../domain/install-verify.js'
 import { installJobView, readGithubAuth } from '../domain/install.js'
@@ -157,7 +158,18 @@ async function routeStateGet(req, res, rc) {
       const shape = detectHostShape()
       host = { hosted: shape.hosted === true, kind: shape.kind, notice: shape.hosted === true ? shape.notice : null }
     } catch {}
-    sendJson(res, 200, { ok: true, entries, skippedBundles, host, 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 })) })
+    // ★ 0.5.55 加法：把已经算好的各块**折成一行健康摘要**（不新增 IO、不新增判据）。
+    //   面板 176 个按钮、信息散在六处，用户没有一个地方能回答"整体健康吗、我该先处理哪件"。
+    let health = { issues: 0, items: [] }
+    try {
+      health = buildInstallHealth({
+        entries,
+        skippedBundles,
+        pendingCompat: compatPending?.pending ?? [],
+        patchUncertain: patchHeal === null ? [] : (patchHeal.uncertain ?? []),
+      })
+    } catch {}
+    sendJson(res, 200, { ok: true, entries, skippedBundles, host, health, 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.54",
+  "version": "0.5.55",
   "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",