@dsh-plus/lifeboat 0.1.3 → 0.1.5

package/lib/index.js

@@ -3,18 +3,18 @@ import { SettingsConflictError, settingsNamespace } from "@deepseek-ai/dsh-setti
 import z from "@deepseek-ai/schemastery";
 import { copyFile, readFile, rename, writeFile } from "node:fs/promises";
 import { parseDocument } from "yaml";
-
-//#region src/ns.ts
-/**
-* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-* @module lifeboat/ns
-*/
-const SETTINGS_NS$1 = "dsh-plus-lifeboat";
-
 //#endregion
 //#region src/config.ts
+/**
+* 配置与 journal 单一事实源。
+* - 行级 Config（cordis 组合层）：救生艇自身行为开关，dev/prod patch 层可覆盖。
+* - settings 命名空间 dsh-plus-lifeboat：运行期 journal 与 LLM 应急翻译状态，
+*   经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml，重启后可据此还原。
+* schema 刻意宽松：lifeboat 是最后防线，自身命名空间的数据问题绝不能让它起不来。
+* @module lifeboat/config
+*/
 /** settings 命名空间（品牌化后供 settings 服务注册/读写）。 */
-const SETTINGS_NS = settingsNamespace(SETTINGS_NS$1);
+const SETTINGS_NS = settingsNamespace("dsh-plus-lifeboat");
 /** 行级配置：全部有默认值，正常部署零配置。 */
 const Config = z.object({
 	enabled: z.boolean().description("故障隔离总开关").default(true),
@@ -42,18 +42,27 @@ const JournalSchema = z.object({
 	journal: z.array(JournalEntry).description("救生艇操作日志（最新在尾，封顶 50 条）").default([]),
 	llmFallback: z.union([FallbackState, z.const(null)]).description("LLM 应急翻译状态；null 表示未处于降级").default(null)
 });
-
 //#endregion
 //#region src/fallback-llm.ts
+/**
+* LLM 应急翻译：默认模型路由的 provider 无已注册 adapter 时（典型场景：llm-pi
+* 被隔离/加载失败），把 settings.yaml 里 dsh-plus-llm-pi 的 provider 配置翻译为
+* 官方 llm-pi-ai 命名空间的原生格式（键加 -fb 后缀避开 DUPLICATE_ADAPTER 冲突），
+* 默认模型指到翻译路由；源 provider 恢复健康后按 journal 自动还原。
+*
+* 为什么读原始 settings.yaml 而不是 settings 服务：插件被禁用后其命名空间随之
+* 注销，服务层读不到——但数据仍在文件里（只读，不修改）。
+* 降级语义：翻译只覆盖官方物化的字段子集，dsh-plus 扩展的全量 compat 丢弃；
+* 协议推断是启发式（显式 api > 路由名 > 模型继承源 > openai-completions 兜底）。
+* @module lifeboat/fallback-llm
+*/
 const NS_PI_AI = settingsNamespace("llm-pi-ai");
 const NS_AGENT_DEFAULT = settingsNamespace("agent-default-model");
 const RAW_NS_LLM_PI = "dsh-plus-llm-pi";
-/** 翻译路由键后缀：与源路由错开，避免 llm-pi 恢复瞬间撞 DUPLICATE_ADAPTER。 */
-const FALLBACK_SUFFIX = "-fb";
 /** 官方配置路径物化的 compat 子集（其余字段降级期丢弃）。 */
 const COMPAT_WHITELIST = ["thinkingFormat", "supportsReasoningEffort"];
 /** 官方 reasoning 词表（ModelThinkingLevel 的保守子集），不在其中的值丢弃。 */
-const REASONING_LEVELS = new Set([
+const REASONING_LEVELS = /* @__PURE__ */ new Set([
 	"off",
 	"minimal",
 	"low",
@@ -120,12 +129,13 @@ function translateProvider(routeKey, raw) {
 /** 整表翻译：键加 -fb 后缀（纯函数）。 */
 function translateProviders(providers) {
 	const out = {};
-	for (const [key, raw] of Object.entries(providers)) out[`${key}${FALLBACK_SUFFIX}`] = translateProvider(key, raw);
+	for (const [key, raw] of Object.entries(providers)) out[`${key}-fb`] = translateProvider(key, raw);
 	return out;
 }
 /** 读 settings.yaml 原始文档的指定段落（只读；文件/段落缺失返回 undefined）。 */
 async function readRawSection(settingsFile, ns) {
-	const section = parseDocument(await readFile(settingsFile, "utf-8")).toJS()[ns];
+	const text = await readFile(settingsFile, "utf-8");
+	const section = parseDocument(text).toJS()[ns];
 	if (typeof section !== "object" || section === null) return void 0;
 	return section;
 }
@@ -154,7 +164,7 @@ function installLlmFallback(ctx, deps) {
 			return;
 		}
 		const translated = translateProviders(providers);
-		const fbProvider = `${provider}${FALLBACK_SUFFIX}`;
+		const fbProvider = `${provider}-fb`;
 		await writeWithRetry(() => writes.update(NS_PI_AI, { providers: translated }));
 		await writeWithRetry(() => writes.update(NS_AGENT_DEFAULT, {
 			provider: fbProvider,
@@ -210,7 +220,7 @@ function installLlmFallback(ctx, deps) {
 	const bootTimer = setTimeout(run, 1e4);
 	ctx.effect(() => () => clearTimeout(bootTimer), "lifeboat: fallback boot timer");
 	ctx.on("ready", run);
-	const WATCHED_NS = new Set([
+	const WATCHED_NS = /* @__PURE__ */ new Set([
 		"agent-default-model",
 		"llm-pi-ai",
 		RAW_NS_LLM_PI
@@ -220,42 +230,15 @@ function installLlmFallback(ctx, deps) {
 	});
 	ctx.root.on("llm/adapters-updated", run);
 }
-
 //#endregion
-//#region src/notify.ts
+//#region src/patch-file.ts
 /**
-* 装配告警出口。返回同步派单函数：内部异步发送，失败只记日志。
-* notify-email 出现时升级为邮件；全程 journal 兜底可溯。
+* profile 用户 patch 文件（cordis.patch.yml）的安全写入。
+* 官方预留的逃生门：用户层支持 id 定向 disabled，覆盖 bundle 层 insert。
+* 写入纪律：先备份、幂等（已禁用跳过）、原子落盘（tmp + rename），失败抛错由调用方告警，
+* 绝不写半个文件、绝不改动既有条目内容。
+* @module lifeboat/patch-file
 */
-function installAlerter(ctx, journal) {
-	const logger = ctx.logger("lifeboat");
-	let mailer;
-	ctx.inject(["notifyEmail"], (mailCtx) => {
-		mailer = mailCtx.notifyEmail;
-		return () => {
-			mailer = void 0;
-		};
-	});
-	return (subject, text) => {
-		journal("alert", `${subject} | ${text}`);
-		const active = mailer;
-		if (!active?.sendNotice) {
-			logger.warn(`${subject} —— ${text}`);
-			return;
-		}
-		active.sendNotice({
-			subject,
-			text
-		}).then((result) => {
-			if (!result.ok) logger.warn(`邮件告警投递失败: ${result.detail}`);
-		}, (error) => {
-			logger.warn(`邮件告警异常: ${error instanceof Error ? error.message : String(error)}`);
-		});
-	};
-}
-
-//#endregion
-//#region src/patch-file.ts
 /** 条目（含 insert 子列表）中是否已有针对 targetId 的 disabled 覆盖。 */
 function hasDisable(entries, targetId) {
 	for (const entry of entries) {
@@ -269,7 +252,8 @@ function hasDisable(entries, targetId) {
 * @throws 文件不可读/顶层不是数组/落盘失败——调用方负责告警。
 */
 async function appendDisable(patchFile, targetId) {
-	const doc = parseDocument(await readFile(patchFile, "utf-8"));
+	const text = await readFile(patchFile, "utf-8");
+	const doc = parseDocument(text);
 	const root = doc.toJS();
 	if (!Array.isArray(root)) throw new Error(`patch 文件顶层不是数组: ${patchFile}`);
 	if (hasDisable(root, targetId)) return false;
@@ -283,42 +267,92 @@ async function appendDisable(patchFile, targetId) {
 	await rename(tmp, patchFile);
 	return true;
 }
-
+/** 顶层条目中已禁用的 id 列表（不含 insert 子列表；用户层 disabled 语义只在顶层）。 */
+function listDisabled(entries) {
+	const out = [];
+	for (const entry of entries) if (typeof entry.id === "string" && entry.disabled === true) out.push(entry.id);
+	return out;
+}
+/**
+* 从 patch 文件移除针对 targetId 的禁用覆盖（恢复插件）；返回是否实际写入。
+* 只移除「id 定向且 disabled: true」的行，其余内容（注释经 yaml 文档保留、
+* 其他条目）原样不动；无该覆盖时幂等返回 false。
+* @throws 文件不可读/顶层不是数组/落盘失败——调用方负责告警。
+*/
+async function removeDisable(patchFile, targetId) {
+	const text = await readFile(patchFile, "utf-8");
+	const doc = parseDocument(text);
+	const root = doc.toJS();
+	if (!Array.isArray(root)) throw new Error(`patch 文件顶层不是数组: ${patchFile}`);
+	let removed = false;
+	const items = doc.contents;
+	if (items?.items !== void 0 && Array.isArray(items.items)) {
+		const headComment = items.items[0]?.commentBefore;
+		doc.contents.items = items.items.filter((item) => {
+			const value = item.toJS?.(doc);
+			if (value !== void 0 && typeof value === "object" && value.id === targetId && value.disabled === true) {
+				removed = true;
+				return false;
+			}
+			return true;
+		});
+		if (removed && headComment !== void 0 && doc.contents.items.length > 0) {
+			const next = doc.contents.items[0];
+			if (next.commentBefore === void 0) next.commentBefore = headComment;
+		}
+	}
+	if (!removed) return false;
+	await copyFile(patchFile, `${patchFile}.lifeboat.bak`);
+	const tmp = `${patchFile}.lifeboat.tmp`;
+	await writeFile(tmp, doc.toString(), "utf-8");
+	await rename(tmp, patchFile);
+	return true;
+}
 //#endregion
 //#region src/quarantine.ts
 /** Runtime mirror: FiberState 是 cordis 跨包 const enum（官方 dsh-host-plugin-inventory 同款做法）。 */
 const FIBER_FAILED = 3;
 /** 永不隔离的条目：救生艇自身与聚合 bundle（禁了它们等于关掉整个防线/全家）。 */
-const EXCLUDED = new Set(["dsh-plus-lifeboat", "dsh-plus-bundle-main"]);
+const EXCLUDED = /* @__PURE__ */ new Set(["dsh-plus-lifeboat", "dsh-plus-bundle-main"]);
 const GUARD_RE = /^dsh-plus-[a-z0-9-]+$/;
 /** 名字是否属于可隔离的 dsh-plus 兄弟插件（entry id 与插件 name 同字面量是本仓库约定）。 */
-function isGuardedPlugin(name$1) {
-	return typeof name$1 === "string" && GUARD_RE.test(name$1) && !EXCLUDED.has(name$1);
+function isGuardedPlugin(name) {
+	return typeof name === "string" && GUARD_RE.test(name) && !EXCLUDED.has(name);
+}
+/** 告警/journal 里的失败原因摘录上限，防长堆栈淹没通知渠道。 */
+const REASON_CAP = 500;
+/** 提取 fiber 失败原因的短文本（无则空串）；cordis 把错误挂在 fiber._error。 */
+function reasonText(reason) {
+	if (reason === void 0 || reason === null) return "";
+	const text = reason instanceof Error ? reason.stack ?? reason.message : String(reason);
+	return text.length > REASON_CAP ? `${text.slice(0, REASON_CAP)}…` : text;
 }
 /** 装配隔离执行器（纯逻辑，可测）。 */
 function createQuarantine(ctx, deps) {
 	const logger = ctx.logger("lifeboat");
 	const lastAlertAt = /* @__PURE__ */ new Map();
 	const inFlight = /* @__PURE__ */ new Set();
-	async function quarantine(name$1, origin) {
-		if (!isGuardedPlugin(name$1)) return;
-		if (inFlight.has(name$1)) return;
-		inFlight.add(name$1);
+	async function quarantine(name, origin, reason) {
+		if (!isGuardedPlugin(name)) return;
+		if (inFlight.has(name)) return;
+		inFlight.add(name);
+		const reasonBlock = reasonText(reason);
+		const reasonSuffix = reasonBlock === "" ? "" : `\n失败原因：\n${reasonBlock}`;
 		try {
-			const written = await appendDisable(deps.patchFile, name$1);
-			deps.journal("quarantine", `${name$1}（来源 ${origin}，${written ? "已写入禁用" : "已存在禁用"}）`);
+			const written = await appendDisable(deps.patchFile, name);
+			deps.journal("quarantine", `${name}（来源 ${origin}，${written ? "已写入禁用" : "已存在禁用"}）${reasonSuffix}`);
 			const now = Date.now();
-			if (now - (lastAlertAt.get(name$1) ?? 0) >= deps.alertCooldownMs) {
-				lastAlertAt.set(name$1, now);
-				deps.alert(`[DSH] 插件 ${name$1} 加载失败，已自动隔离`, `检测到插件 ${name$1} 的 fiber 进入 FAILED（来源：${origin}）。\n已向 ${deps.patchFile} 写入 disabled 覆盖，重启/刷新后该插件不再加载，其余插件不受影响。\n修复后删除该条覆盖即可恢复。`);
+			if (now - (lastAlertAt.get(name) ?? 0) >= deps.alertCooldownMs) {
+				lastAlertAt.set(name, now);
+				deps.alert(`[DSH] 插件 ${name} 加载失败，已自动隔离`, `检测到插件 ${name} 的 fiber 进入 FAILED（来源：${origin}）。\n已向 ${deps.patchFile} 写入 disabled 覆盖，重启/刷新后该插件不再加载，其余插件不受影响。\n修复后删除该条覆盖即可恢复。${reasonSuffix}`);
 			}
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
-			logger.warn(`隔离 ${name$1} 失败: ${message}`);
-			deps.journal("quarantine-error", `${name$1}: ${message}`);
-			deps.alert(`[DSH] 插件 ${name$1} 加载失败，自动隔离未果`, `隔离写入失败：${message}\n请手动在 patch 层禁用该插件。`);
+			logger.warn(`隔离 ${name} 失败: ${message}`);
+			deps.journal("quarantine-error", `${name}: ${message}`);
+			deps.alert(`[DSH] 插件 ${name} 加载失败，自动隔离未果`, `隔离写入失败：${message}\n请手动在 patch 层禁用该插件。`);
 		} finally {
-			inFlight.delete(name$1);
+			inFlight.delete(name);
 		}
 	}
 	return { quarantine };
@@ -331,10 +365,125 @@ function installHostWatch(ctx, q) {
 	ctx.root.on("internal/status", (fiber) => {
 		if (fiber.state !== FIBER_FAILED) return;
 		if (!isGuardedPlugin(fiber.name)) return;
-		q.quarantine(fiber.name, "host");
+		q.quarantine(fiber.name, "host", fiber._error);
+	});
+}
+//#endregion
+//#region src/health-api.ts
+/**
+* lifeboat 健康面板 host 接收面：
+* - GET  /dsh-plus/lifeboat/status  → journal + 翻译状态 + 当前用户 patch 层已禁用的 dsh-plus 插件
+* - POST /dsh-plus/lifeboat/restore {name} → removeDisable + journal + 告警
+* rc8 用户 patch 层热应用：恢复无需重启，watchUserPatches 即时重载。
+* @module lifeboat/health-api
+*/
+const ROUTE_STATUS = "/dsh-plus/lifeboat/status";
+const ROUTE_RESTORE = "/dsh-plus/lifeboat/restore";
+function sendJson$1(res, status, body) {
+	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+	res.end(JSON.stringify(body));
+}
+function readBody$1(req) {
+	return new Promise((resolve, reject) => {
+		const chunks = [];
+		req.on("data", (chunk) => chunks.push(chunk));
+		req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+		req.on("error", reject);
+	});
+}
+/** 解析用户 patch 层中已被禁用且属于 dsh-plus 兄弟域的插件名。 */
+async function readQuarantined(patchFile) {
+	let text;
+	try {
+		text = await readFile(patchFile, "utf-8");
+	} catch {
+		return [];
+	}
+	const root = parseDocument(text).toJS();
+	if (!Array.isArray(root)) return [];
+	return listDisabled(root).filter((id) => isGuardedPlugin(id) || id.startsWith("dsh-plus-"));
+}
+/** 注册健康面板路由（webServer 缺席时由调用方保证不调用）。 */
+function registerHealthApi(ctx, deps) {
+	const logger = ctx.logger("lifeboat");
+	ctx.webServer.register({
+		kind: "prefix",
+		path: ROUTE_STATUS,
+		handler: async (_req, res) => {
+			try {
+				const quarantined = await readQuarantined(deps.patchFile);
+				sendJson$1(res, 200, {
+					journal: deps.readJournal(),
+					llmFallback: deps.readFallback(),
+					quarantined
+				});
+			} catch (error) {
+				logger.warn(`status endpoint failed: ${error instanceof Error ? error.message : String(error)}`);
+				sendJson$1(res, 500, { error: "internal" });
+			}
+		}
+	});
+	ctx.webServer.register({
+		kind: "prefix",
+		path: ROUTE_RESTORE,
+		handler: async (req, res) => {
+			try {
+				if (req.method !== "POST") {
+					sendJson$1(res, 405, { error: "POST only" });
+					return;
+				}
+				const body = JSON.parse(await readBody$1(req));
+				if (typeof body.name !== "string" || !body.name.startsWith("dsh-plus-")) {
+					sendJson$1(res, 400, { error: "invalid-name" });
+					return;
+				}
+				const written = await removeDisable(deps.patchFile, body.name);
+				deps.journal("quarantine-restore", written ? `${body.name}：已移除用户 patch 层的禁用覆盖（热应用即时恢复）` : `${body.name}：无需恢复（patch 层无禁用覆盖）`);
+				deps.alert("[DSH] 插件恢复", `插件 ${body.name} 的隔离已解除（移除 patch 层禁用覆盖）。${written ? "rc8 热应用即时生效，无需重启。" : "patch 层本无覆盖，可能已被手动恢复。"}`);
+				sendJson$1(res, 200, {
+					ok: true,
+					written
+				});
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				logger.warn(`restore endpoint failed: ${message}`);
+				sendJson$1(res, 500, { error: message });
+			}
+		}
 	});
 }
-
+//#endregion
+//#region src/notify.ts
+/**
+* 装配告警出口。返回同步派单函数：内部异步发送，失败只记日志。
+* notify-email 出现时升级为邮件；全程 journal 兜底可溯。
+*/
+function installAlerter(ctx, journal) {
+	const logger = ctx.logger("lifeboat");
+	let mailer;
+	ctx.inject(["notifyEmail"], (mailCtx) => {
+		mailer = mailCtx.notifyEmail;
+		return () => {
+			mailer = void 0;
+		};
+	});
+	return (subject, text) => {
+		journal("alert", `${subject} | ${text}`);
+		const active = mailer;
+		if (!active?.sendNotice) {
+			logger.warn(`${subject} —— ${text}`);
+			return;
+		}
+		active.sendNotice({
+			subject,
+			text
+		}).then((result) => {
+			if (!result.ok) logger.warn(`邮件告警投递失败: ${result.detail}`);
+		}, (error) => {
+			logger.warn(`邮件告警异常: ${error instanceof Error ? error.message : String(error)}`);
+		});
+	};
+}
 //#endregion
 //#region src/quarantine-api.ts
 const ROUTE = "/dsh-plus/lifeboat/quarantine";
@@ -378,13 +527,10 @@ function registerQuarantineApi(ctx, q) {
 		}
 	});
 }
-
 //#endregion
 //#region src/index.ts
 const name = "dsh-plus-lifeboat";
 const inject = ["settings", "llm"];
-/** journal 上限：只留最近 50 条，防长期运行膨胀。 */
-const JOURNAL_CAP = 50;
 function apply(ctx, config) {
 	const logger = ctx.logger("lifeboat");
 	let doc = {
@@ -406,7 +552,7 @@ function apply(ctx, config) {
 				at: (/* @__PURE__ */ new Date()).toISOString(),
 				kind,
 				detail
-			}].slice(-JOURNAL_CAP)
+			}].slice(-50)
 		};
 		persist?.({ journal: doc.journal }).catch((error) => {
 			logger.warn(`journal 持久化失败: ${error instanceof Error ? error.message : String(error)}`);
@@ -414,8 +560,9 @@ function apply(ctx, config) {
 	};
 	const alert = installAlerter(ctx, journal);
 	if (config.enabled) {
+		const patchFile = config.patchFile.length > 0 ? config.patchFile : dshHomePath("profiles", "web", "cordis.patch.yml");
 		const quarantine = createQuarantine(ctx, {
-			patchFile: config.patchFile.length > 0 ? config.patchFile : dshHomePath("profiles", "web", "cordis.patch.yml"),
+			patchFile,
 			alertCooldownMs: config.alertCooldownMs,
 			journal,
 			alert
@@ -423,6 +570,13 @@ function apply(ctx, config) {
 		installHostWatch(ctx, quarantine);
 		ctx.inject(["webServer"], (webCtx) => {
 			registerQuarantineApi(webCtx, quarantine);
+			registerHealthApi(webCtx, {
+				patchFile,
+				journal,
+				alert,
+				readJournal: () => doc.journal,
+				readFallback: () => doc.llmFallback
+			});
 		});
 	}
 	if (config.llmFallback) installLlmFallback(ctx, {
@@ -438,6 +592,5 @@ function apply(ctx, config) {
 		}
 	});
 }
-
 //#endregion
-export { Config, apply, inject, name };
+export { Config, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/lifeboat",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "dsh-plus service plugin: 故障救生艇——兄弟插件崩溃时自动隔离（写用户 patch 层禁用），llm-pi 缺席时把其配置临时翻译为官方 llm-pi-ai 路由，恢复后自动还原",
   "type": "module",
   "main": "lib/index.js",
@@ -22,12 +22,16 @@
   ],
   "dsh": {
     "client": {
-      "inject": [],
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale"
+      ],
       "platform": "web"
     }
   },
   "dependencies": {
-    "yaml": "^2.6.0"
+    "yaml": "^2.6.0",
+    "@dsh-plus/shared": "0.1.3"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -38,11 +42,14 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/dsh-home-paths": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
-    "@deepseek-ai/schemastery": "3.18.1"
+    "@deepseek-ai/dsh-home-paths": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@types/node": "26.2.0"
   },
   "publishConfig": {
     "access": "public"

package/src/client/client.ts

@@ -5,12 +5,18 @@
  *
  * 零依赖铁律：不 import 任何包（含 cordis/shared），FiberState.FAILED 以字面量
  * 3 镜像一个道理（官方 dsh-host-plugin-inventory 同款做法）；任何异常止步自身。
+ *
+ * 健康页挂载在 mountHealthTab（./health-tab.ts，react 系依赖隔离在独立模块）：
+ * 哨兵 try/catch 之外先行注册，UI 故障不拖垮哨兵。
  * @module @dsh-plus/lifeboat/client
  */
 import type { Context } from '@deepseek-ai/cordis'
 
 export const name = 'dsh-plus-lifeboat'
 
+/** 健康页需要的 cordis 服务 key（哨兵段只用 root ctx 原生面，不依赖这些）。 */
+export const inject = ['slots', 'locale'] as const
+
 /** Runtime mirror: FiberState 是 cordis 跨包 const enum（FAILED = 3，cordis 4.0.1）。 */
 const FIBER_FAILED = 3
 
@@ -20,6 +26,7 @@ const EXCLUDED = new Set(['dsh-plus-lifeboat', 'dsh-plus-bundle-main'])
 const GUARD_RE = /^dsh-plus-[a-z0-9-]+$/
 
 export function apply(ctx: Context): void {
+  // ── 哨兵（零依赖，先于一切 UI）────────────────────────────────
   try {
     const reported = new Set<string>()
     ctx.root.on('internal/status', (fiber: { state: number; name: string }) => {
@@ -42,4 +49,14 @@ export function apply(ctx: Context): void {
   } catch {
     // apply 自身同理。
   }
+
+  // ── 健康页（UI 故障不拖垮哨兵；react 系依赖隔离在独立模块）────
+  try {
+    const health = (require as (id: string) => { mountHealthTab(ctx: Context): void })(
+      './health-tab.js',
+    )
+    health.mountHealthTab(ctx)
+  } catch {
+    // 健康页缺席不影响哨兵；上游插槽失配时优雅缺席（reload/降级原则同 web-files）。
+  }
 }

package/src/client/health-styles.ts

@@ -0,0 +1,53 @@
+/**
+ * 健康页样式：视觉对齐官方设置页（--dsw-alias-*），响应式同套件约定
+ * （≤767px 堆叠、44px 热区）。
+ * @module lifeboat/client/health-styles
+ */
+import { injectCardStyle } from '@dsh-plus/shared/client'
+
+export const PLUGIN_ID = '@dsh-plus/lifeboat'
+
+export const healthCss = `
+.dlb-tab{display:flex;flex-direction:column;gap:14px;min-width:0}
+.dlb-empty{color:var(--dsw-alias-label-tertiary);font-size:13px;margin:4px 0}
+.dlb-title{color:var(--dsw-alias-label-secondary);font-size:13px;font-weight:600;margin:10px 0 0}
+.dlb-notice{color:var(--dsw-alias-label-secondary);font-size:12px;margin:0}
+.dlb-fallback{border:1px solid var(--dsw-alias-label-warning,#e0a03c);border-radius:10px;padding:10px 12px;display:flex;flex-direction:column;gap:6px;background:var(--dsw-alias-bg-layer-3)}
+.dlb-fallbackTitle{color:var(--dsw-alias-label-warning,#e0a03c);font-size:13px;font-weight:600;margin:0}
+.dlb-kv{display:flex;align-items:center;gap:8px;font-size:12px;flex-wrap:wrap}
+.dlb-kv span{color:var(--dsw-alias-label-tertiary);flex:none}
+.dlb-kv code{color:var(--dsw-alias-label-primary);font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;word-break:break-all}
+.dlb-cards{display:flex;flex-direction:column;gap:8px}
+.dlb-quarantineCard{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:10px 12px;display:flex;align-items:center;gap:10px;flex-wrap:wrap;background:var(--dsw-alias-bg-layer-3)}
+.dlb-pluginName{color:var(--dsw-alias-label-primary);font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:13px;font-weight:600;flex:1;min-width:0;word-break:break-all}
+.dlb-confirm{display:flex;align-items:center;gap:8px;flex-wrap:wrap;flex-basis:100%}
+.dlb-confirmText{color:var(--dsw-alias-label-secondary);font-size:12px;flex:1;min-width:160px;line-height:1.5}
+.dlb-btn{appearance:none;font:inherit;cursor:pointer;border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5;flex:none}
+.dlb-btnGhost{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}
+.dlb-btnGhost:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}
+.dlb-btnPrimary{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}
+.dlb-btn:disabled{opacity:.4;cursor:default}
+.dlb-journal{display:flex;flex-direction:column;gap:10px}
+.dlb-journalDay{display:flex;flex-direction:column;gap:2px}
+.dlb-dayLabel{color:var(--dsw-alias-label-tertiary);font-size:11px;font-weight:600;margin-bottom:2px}
+.dlb-entry{display:flex;align-items:baseline;gap:8px;font-size:12px;line-height:1.6;flex-wrap:wrap}
+.dlb-kind{flex:none;border-radius:999px;padding:0 8px;font-size:10px;font-weight:600;line-height:17px;white-space:nowrap}
+.dlb-kindInfo{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
+.dlb-kindAlert{background:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-bg-base)}
+.dlb-kindQuarantine{background:var(--dsw-alias-label-warning,#e0a03c);color:var(--dsw-alias-bg-base)}
+.dlb-kindRestore{background:var(--dsw-alias-state-success,#3d9a50);color:var(--dsw-alias-bg-base)}
+.dlb-kindFallback{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
+.dlb-entryAt{color:var(--dsw-alias-label-tertiary);flex:none;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:11px}
+.dlb-entryDetail{color:var(--dsw-alias-label-primary);min-width:0;word-break:break-word;white-space:pre-wrap;flex:1;flex-basis:320px}
+@media (max-width:767px){
+.dlb-btn{min-height:44px}
+.dlb-quarantineCard{flex-direction:column;align-items:stretch}
+.dlb-confirm{flex-direction:column;align-items:stretch}
+.dlb-entryDetail{flex-basis:100%}
+}
+`
+
+/** 幂等注入健康页样式标签。 */
+export function injectHealthStyle(): HTMLStyleElement | null {
+  return injectCardStyle(PLUGIN_ID, healthCss)
+}