@dsh-plus/lifeboat 0.2.30 → 0.3.1

package/lib/client.js

@@ -130,8 +130,10 @@ window.__ModuleLoader__.load({
 .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-copy{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:10px 12px;display:flex;flex-direction:column;gap:6px;background:var(--dsw-alias-bg-layer-3)}
+.dlb-copyTitle{color:var(--dsw-alias-label-secondary);font-size:13px;font-weight:600;margin:0}
+.dlb-copyWarning{color:var(--dsw-alias-label-warning,#e0a03c);font-size:12px;margin:0}
+.dlb-copyHint{color:var(--dsw-alias-label-tertiary);font-size:12px;margin:0;line-height:1.6}
 .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}
@@ -174,6 +176,45 @@ window.__ModuleLoader__.load({
 			const status = value;
 			return Array.isArray(status.journal) && Array.isArray(status.quarantined);
 		}
+		/** 官方应急副本状态卡片（纯展示：路径/生成时间/覆盖 route/警告 + 应用指引）。 */
+		function CopyStatusCard(props) {
+			const { copy, t } = props;
+			const generated = copy.updatedAt === void 0 ? t("copyMissing") : new Date(copy.updatedAt).toISOString().slice(0, 19).replace("T", " ");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "dlb-copy",
+				role: "status",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dlb-copyTitle",
+						children: t("copyTitle")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dlb-kv",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("copyPath") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: copy.path })]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dlb-kv",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("copyAt") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: generated })]
+					}),
+					copy.routes !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dlb-kv",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("copyRoutes") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: copy.routes })]
+					}) : null,
+					copy.detail !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dlb-copyWarning",
+						children: copy.detail
+					}) : null,
+					copy.warnings.map((warning) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dlb-copyWarning",
+						children: `${t("copyWarning")}：${warning}`
+					}, warning)),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dlb-copyHint",
+						children: t("copyApplyHint")
+					})
+				]
+			});
+		}
 		function HealthTab(props) {
 			const { t } = props;
 			const [status, setStatus] = (0, react.useState)(null);
@@ -231,31 +272,9 @@ window.__ModuleLoader__.load({
 						role: "status",
 						children: notice
 					}) : null,
-					status.llmFallback?.active === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "dlb-fallback",
-						role: "status",
-						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: "dlb-fallbackTitle",
-								children: t("fallbackActive")
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "dlb-kv",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("fallbackFrom") }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("code", { children: [
-									status.llmFallback.originalProvider,
-									"/",
-									status.llmFallback.originalModel
-								] })]
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "dlb-kv",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("fallbackTo") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: status.llmFallback.fallbackProvider })]
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "dlb-kv",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("fallbackAt") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: status.llmFallback.at.slice(0, 19).replace("T", " ") })]
-							})
-						]
+					status.officialCopy !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopyStatusCard, {
+						copy: status.officialCopy,
+						t
 					}) : null,
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 						className: "dlb-title",
@@ -369,15 +388,17 @@ window.__ModuleLoader__.load({
 				alert: "dlb-kindAlert",
 				quarantine: "dlb-kindQuarantine",
 				"quarantine-restore": "dlb-kindRestore",
-				"llm-fallback": "dlb-kindFallback",
-				"llm-fallback-revert": "dlb-kindRestore"
+				"llm-copy-guide": "dlb-kindFallback"
 			};
 			zhDict = {
 				tab: "救生艇",
-				fallbackActive: "LLM 应急翻译进行中",
-				fallbackFrom: "源路由",
-				fallbackTo: "临时路由",
-				fallbackAt: "启用时间",
+				copyTitle: "官方应急 LLM 副本",
+				copyPath: "副本路径",
+				copyAt: "生成时间",
+				copyRoutes: "覆盖 route",
+				copyMissing: "未生成",
+				copyWarning: "警告",
+				copyApplyHint: "应用：dsh <profile> --patch 上述路径（重启/重载生效），或把副本条目并入当前 profile 的 cordis.patch.yml（热应用）。应用即禁用 dsh-plus-llm-pi 并切换 llm-pi-ai 配置；回退只需移除 --patch/并入条目。",
 				quarantined: "已隔离插件",
 				restore: "恢复",
 				restoring: "恢复中…",
@@ -396,10 +417,13 @@ window.__ModuleLoader__.load({
 			};
 			enDict = {
 				tab: "Lifeboat",
-				fallbackActive: "LLM emergency translation active",
-				fallbackFrom: "Source route",
-				fallbackTo: "Fallback route",
-				fallbackAt: "Since",
+				copyTitle: "Official emergency LLM copy",
+				copyPath: "Path",
+				copyAt: "Generated",
+				copyRoutes: "Routes",
+				copyMissing: "not generated",
+				copyWarning: "Warning",
+				copyApplyHint: "Apply: dsh <profile> --patch <path above> (restart/reload), or merge the rows into this profile's cordis.patch.yml (hot-applied). Applying disables dsh-plus-llm-pi and switches llm-pi-ai; revert by removing the --patch flag/rows.",
 				quarantined: "Quarantined plugins",
 				restore: "Restore",
 				restoring: "Restoring…",

package/lib/index.d.ts

@@ -5,12 +5,10 @@ import { Context } from "@deepseek-ai/cordis";
 declare const Config: z<Schemastery.ObjectS<NoInfer<{
   enabled: z<boolean, boolean, "defined">;
   patchFile: z<string, string, "defined">;
-  llmFallback: z<boolean, boolean, "defined">;
   alertCooldownMs: z<number, number, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
   enabled: z<boolean, boolean, "defined">;
   patchFile: z<string, string, "defined">;
-  llmFallback: z<boolean, boolean, "defined">;
   alertCooldownMs: z<number, number, "defined">;
 }>>, "plain">;
 type LifeboatConfig = Schemastery.TypeT<typeof Config>;

package/lib/index.js

@@ -1,8 +1,7 @@
 import z from "@deepseek-ai/schemastery";
 import { copyFile, readFile, stat } from "node:fs/promises";
 import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
-import { SettingsConflictError } from "@deepseek-ai/dsh-settings";
-import { isSeq, parseDocument } from "yaml";
+import { isSeq, parse, parseDocument } from "yaml";
 import { writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 //#region src/config.ts
 /**
@@ -16,223 +15,184 @@ import { writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 const Config = z.object({
 	enabled: z.boolean().description("故障隔离总开关").default(true),
 	patchFile: z.string().description("隔离写入的 profile 用户 patch 文件绝对路径；留空自动取当前 profile 的 cordis.patch.yml（profileContext.patchPath，CLI 与桌面端 desktop profile 同源）").default(""),
-	llmFallback: z.boolean().description("llm-pi 缺席时自动翻译其配置到官方 llm-pi-ai 并切换默认模型").default(true),
 	alertCooldownMs: z.natural().description("同一插件重复告警的最小间隔毫秒数").default(3e5)
 });
 //#endregion
-//#region src/fallback-llm.ts
+//#region src/official-copy-status.ts
 /**
-* LLM 应急翻译：默认模型路由的 provider 无已注册 adapter 时（典型场景：llm-pi
-* 被隔离/加载失败），把 settings.yaml 里 dsh-plus-llm-pi 的 provider 配置翻译为
-* 官方 llm-pi-ai 命名空间的原生格式（键加 -fb 后缀避开 DUPLICATE_ADAPTER 冲突），
-* 默认模型指到翻译路由；源 provider 恢复健康后按 journal 自动还原。
+* 官方应急副本的只读状态读取（$DSH_HOME/llm-pi.official-patch.yaml）。
 *
-* 为什么读原始 settings.yaml 而不是 settings 服务：插件被禁用后其命名空间随之
-* 注销，服务层读不到——但数据仍在文件里（只读，不修改）。
-* 降级语义：翻译只覆盖官方物化的字段子集，dsh-plus 扩展的全量 compat 丢弃；
-* 协议推断是启发式（显式 api > 路由名 > 模型继承源 > openai-completions 兜底）。
-* @module lifeboat/fallback-llm
+* 文件契约与 @dsh-plus/llm-pi 同路径：对方常备副本、本包只读消费——零
+* dsh-plus 内部依赖铁律下不 import 对方实现，路径按契约文件名同源派生。
+* 读取一切失败都降级为结构化状态（面板展示与告警文案的输入，绝不抛出）。
+* @module lifeboat/official-copy-status
 */
-const NS_PI_AI = "llm-pi-ai";
-const NS_AGENT_DEFAULT = "agent-default-model";
-const RAW_NS_LLM_PI = "dsh-plus-llm-pi";
-/** 官方配置路径物化的 compat 子集（其余字段降级期丢弃）。 */
-const COMPAT_WHITELIST = ["thinkingFormat", "supportsReasoningEffort"];
-/**
-* master 官方 llm-pi-ai 的 COMPAT_GATES（llm-pi-ai/src/catalog.ts）：每个 compat
-* 字段按协议门控，写时经 assertOfferedCompatFields 拒绝不适配字段——thinkingFormat /
-* supportsReasoningEffort 仅 openai-completions 提供。翻译按推断 api 过滤，避免
-* 整段 compat 写入被官方校验拒绝。
-*/
-const COMPAT_OFFER_APIS = {
-	thinkingFormat: /* @__PURE__ */ new Set(["openai-completions"]),
-	supportsReasoningEffort: /* @__PURE__ */ new Set(["openai-completions"])
-};
-/** 官方 reasoning 词表（ModelThinkingLevel 的保守子集），不在其中的值丢弃。 */
-const REASONING_LEVELS = /* @__PURE__ */ new Set([
-	"off",
-	"minimal",
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max"
-]);
-/** 模型继承源（extends 的 provider 前缀）→ 协议的已知映射。 */
-const EXTENDS_PROTOCOL = {
-	anthropic: "anthropic-messages",
-	"kimi-coding": "anthropic-messages",
-	deepseek: "openai-completions",
-	openai: "openai-completions"
-};
-/** 路由名里的协议线索。 */
-const ROUTE_PROTOCOL = {
-	chat: "openai-completions",
-	completions: "openai-completions",
-	response: "openai-responses",
-	responses: "openai-responses",
-	anthropic: "anthropic-messages",
-	claude: "anthropic-messages"
-};
-/**
-* 推断路由协议：显式 api > 路由名线索 > 首个模型的继承源 > openai-completions。
-* 兜底选 openai-completions 因为多数网关提供 OpenAI 兼容面；推错时告警里注明。
-*/
-function inferApi(routeKey, provider) {
-	if (typeof provider.api === "string" && provider.api.length > 0) return provider.api;
-	const routeHint = ROUTE_PROTOCOL[routeKey.toLowerCase()];
-	if (routeHint !== void 0) return routeHint;
-	const source = (provider.models?.find((m) => typeof m.extends === "string")?.extends)?.split("/")[0];
-	if (source !== void 0 && EXTENDS_PROTOCOL[source] !== void 0) return EXTENDS_PROTOCOL[source];
-	return "openai-completions";
-}
-/** 单个 provider 翻译（纯函数）。 */
-function translateProvider(routeKey, raw) {
-	const out = {
-		displayName: `${raw.displayName ?? routeKey} [fallback]`,
-		api: inferApi(routeKey, raw)
-	};
-	if (raw.apiKeyEnv !== void 0) out.apiKeyEnv = raw.apiKeyEnv;
-	if (raw.baseURL !== void 0) out.baseURL = raw.baseURL;
-	if (raw.headers !== void 0) out.headers = raw.headers;
-	if (raw.reasoning !== void 0 && REASONING_LEVELS.has(raw.reasoning)) out.reasoning = raw.reasoning;
-	if (raw.thinkingBudgets !== void 0) out.thinkingBudgets = raw.thinkingBudgets;
-	if (Array.isArray(raw.defaultInput) && raw.defaultInput.length > 0) out.defaultInput = raw.defaultInput;
-	if (raw.compat !== void 0) {
-		const api = inferApi(routeKey, raw);
-		const compat = {};
-		for (const key of COMPAT_WHITELIST) {
-			const value = raw.compat[key];
-			if (value === void 0 || value === null) continue;
-			if (!COMPAT_OFFER_APIS[key]?.has(api)) continue;
-			compat[key] = value;
-		}
-		if (Object.keys(compat).length > 0) out.compat = compat;
+/** 副本文件名（跨包文件契约：llm-pi 写、本包读，改名须两侧同步）。 */
+const OFFICIAL_COPY_FILE = "llm-pi.official-patch.yaml";
+/** 解析上限：超出只报存在性与时间，不读内容（面板/告警不得被大文件拖垮）。 */
+const MAX_BYTES$1 = 2097152;
+/** 头注释里的生成警告行前缀（llm-pi 渲染约定）。 */
+const WARNING_PREFIX = "# 警告：";
+/** 副本契约路径（默认读取点）。 */
+function officialCopyPath() {
+	return dshHomePath(OFFICIAL_COPY_FILE);
+}
+/** 解析副本内容（纯函数）：头注释警告 + llm-pi-ai 行的 providers 数。 */
+function parseCopyText(text) {
+	const warnings = text.split("\n").filter((line) => line.startsWith(WARNING_PREFIX)).map((line) => line.slice(5));
+	let rows;
+	try {
+		rows = parse(text);
+	} catch (error) {
+		return {
+			warnings,
+			detail: `解析失败：${error instanceof Error ? error.message : String(error)}`
+		};
 	}
-	if (Array.isArray(raw.models) && raw.models.length > 0) out.models = raw.models.map((m) => {
-		const model = { id: m.id };
-		if (m.name !== void 0) model.name = m.name;
-		if (m.contextWindow !== void 0) model.contextWindow = m.contextWindow;
-		if (m.maxTokens !== void 0) model.maxTokens = m.maxTokens;
-		if (Array.isArray(m.input) && m.input.length > 0) model.input = m.input;
-		return model;
-	});
-	return out;
-}
-/** 整表翻译：键加 -fb 后缀（纯函数）。 */
-function translateProviders(providers) {
-	const out = {};
-	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 text = await readFile(settingsFile, "utf-8");
-	const section = parseDocument(text).toJS()[ns];
-	if (typeof section !== "object" || section === null) return void 0;
-	return section;
+	if (!Array.isArray(rows)) return {
+		warnings,
+		detail: "内容不是 patch 列表"
+	};
+	if (rows.length === 0) return {
+		routes: 0,
+		warnings
+	};
+	const providers = rows.find((entry) => entry?.id === "llm-pi-ai")?.config?.providers;
+	if (providers === null || typeof providers !== "object") return {
+		warnings,
+		detail: "缺 llm-pi-ai 配置行（副本可能只含禁用行）"
+	};
+	return {
+		routes: Object.keys(providers).length,
+		warnings
+	};
 }
-/** 写 settings 带一次冲突重试（用户同时改配置时不抢，放弃并告警）。 */
-async function writeWithRetry(write) {
+/** 读取副本状态；缺失/损坏/超限均降级为结构化状态，不抛出。 */
+async function readOfficialCopyStatus(path = officialCopyPath()) {
+	let size;
+	let mtimeMs;
 	try {
-		await write();
+		const info = await stat(path);
+		if (!info.isFile()) return {
+			path,
+			exists: false,
+			warnings: []
+		};
+		size = info.size;
+		mtimeMs = info.mtimeMs;
+	} catch {
+		return {
+			path,
+			exists: false,
+			warnings: []
+		};
+	}
+	const base = {
+		path,
+		exists: true,
+		updatedAt: Math.trunc(mtimeMs),
+		warnings: []
+	};
+	if (size > MAX_BYTES$1) return {
+		...base,
+		detail: "文件超出解析上限，未读取内容"
+	};
+	try {
+		const text = await readFile(path, "utf-8");
+		return {
+			...base,
+			...parseCopyText(text)
+		};
 	} catch (error) {
-		if (!(error instanceof SettingsConflictError)) throw error;
-		await write();
+		return {
+			...base,
+			detail: `读取失败：${error instanceof Error ? error.message : String(error)}`
+		};
 	}
 }
-/** 启动宽限（ms）：llm-pi 等兄弟插件的 adapter 注册晚于 lifeboat 就绪，
-*  启动竞态下立即评估会把"还没加载"误判为"缺席"——每次重启都误发
-*  「应急翻译 + 已还原」两条通知。宽限期内一律不评估，宽限结束自动评估
-*  一次，事件订阅覆盖后续变化；真故障（llm-pi 缺席）在宽限后照常告警。 */
+//#endregion
+//#region src/copy-guide.ts
+/** 默认模型的 settings 命名空间（dsh 官方 agent 区）。 */
+const NS_AGENT_DEFAULT = "agent-default-model";
+/** 启动宽限（ms）：llm-pi 等兄弟插件的 adapter 注册晚于 lifeboat 就绪，宽限内
+*  不评估，避免把「还没加载」误判为「缺席」而每次重启都误发告警。 */
 const BOOT_GRACE_MS = 6e4;
-/** 装配 LLM 应急翻译：启动宽限结束后及 settings/llm 变化时评估一次（并发合并）。 */
-function installLlmFallback(ctx, deps, graceMs = BOOT_GRACE_MS) {
+/** 默认模型的 provider（settings describe 平面视图；未配置返回 undefined）。 */
+function defaultProvider(ctx) {
+	return (ctx.settings.describe().find((row) => row.ns === NS_AGENT_DEFAULT)?.value)?.provider;
+}
+/** 生成时间文案（副本不含时间戳，mtime 即生成时间）。 */
+function generatedText(copy) {
+	if (copy.updatedAt === void 0) return "生成时间未知";
+	return new Date(copy.updatedAt).toISOString().slice(0, 19).replace("T", " ");
+}
+/** 副本缺失：应用无从谈起，先恢复 llm-pi 侧的生成能力。 */
+function alertMissing(copy, provider, deps) {
+	deps.alert("[DSH] LLM 应急副本缺失", `默认模型的 provider "${provider}" 没有已注册 adapter，且官方应急副本 ${copy.path} 不存在（dsh-plus-llm-pi 未生成或已被删除）。先恢复 dsh-plus-llm-pi 让它生成副本，或手动修复 LLM 配置。`);
+}
+/** 副本存在但为空：应用无效果，先修 llm-pi 配置并等待重新生成。 */
+function alertEmpty(copy, provider, deps) {
+	deps.alert("[DSH] LLM 应急副本为空", `默认模型的 provider "${provider}" 没有已注册 adapter；应急副本 ${copy.path} 存在但无任何 route（llm-pi 未配置或全部不可服务），应用无效果。先修复 dsh-plus-llm-pi 配置并等待副本重新生成。`);
+}
+/** 就绪副本的应用指引告警。 */
+function alertReady(copy, provider, deps) {
+	const profile = deps.profile ?? "<profile>";
+	const warnings = copy.warnings.length > 0 ? ` 生成警告：${copy.warnings.join("；")}` : "";
+	deps.alert("[DSH] LLM 应急副本可应用", `默认模型的 provider "${provider}" 没有已注册 adapter（llm-pi 缺席/故障？）。官方应急副本已就绪：${copy.path}（${generatedText(copy)}，${copy.routes ?? 0} 个 route）。应用（重启/重载生效）：dsh ${profile} --patch ${copy.path}；或把副本条目并入该 profile 的 cordis.patch.yml（web 热应用）。应用即切换：副本禁用 dsh-plus-llm-pi 并替换 llm-pi-ai 配置；回退只需移除 --patch 参数或并入的条目。${warnings}`);
+}
+/** 分派指引：按副本形态发出对应告警并返回结果。 */
+function guide(copy, provider, deps) {
+	if (!copy.exists) {
+		alertMissing(copy, provider, deps);
+		return "missing";
+	}
+	if ((copy.routes ?? 0) === 0) {
+		alertEmpty(copy, provider, deps);
+		return "empty";
+	}
+	alertReady(copy, provider, deps);
+	return "ready";
+}
+/** journal 措辞。 */
+function outcomeText(outcome, routes) {
+	if (outcome === "ready") return `可应用（${routes} 个 route）`;
+	if (outcome === "missing") return "缺失";
+	return "为空";
+}
+/** 装配副本指引：宽限结束后及事件触发评估（并发合并、告警带冷却）。 */
+function installCopyGuide(ctx, deps, graceMs = BOOT_GRACE_MS) {
 	const logger = ctx.logger("lifeboat");
-	const writes = ctx.settings;
-	const settingsFile = dshHomePath("settings.yaml");
+	const readCopy = deps.readCopy ?? (() => readOfficialCopyStatus());
 	let inFlight;
+	let lastAlertAt = Number.NEGATIVE_INFINITY;
 	const startedAt = Date.now();
-	const withinGrace = () => Date.now() - startedAt < graceMs;
-	const listProviderIds = () => new Set(ctx.llm.listProviders().map((p) => p.id));
-	async function activate(provider, model) {
-		const providers = (await readRawSection(settingsFile, RAW_NS_LLM_PI).catch(() => void 0))?.providers;
-		if (providers === void 0 || providers[provider] === void 0) {
-			deps.alert("[DSH] 默认模型不可用且无配置可翻译", `默认模型的 provider "${provider}" 没有已注册 adapter，且 ${RAW_NS_LLM_PI} 配置中找不到对应条目，无法应急翻译。请手动修复。`);
-			return;
-		}
-		const translated = translateProviders(providers);
-		const fbProvider = `${provider}-fb`;
-		try {
-			await writes.update(NS_PI_AI, { providers: translated });
-			await writes.update(NS_AGENT_DEFAULT, {
-				provider: fbProvider,
-				model
-			});
-		} catch (error) {
-			const message = error instanceof Error ? error.message : String(error);
-			throw new Error(`翻译失败（官方 llm-pi-ai 拒绝写入翻译后的配置）: ${message}`);
-		}
-		await deps.writeState({
-			active: true,
-			originalProvider: provider,
-			originalModel: model,
-			fallbackProvider: fbProvider,
-			providers: Object.keys(translated),
-			at: (/* @__PURE__ */ new Date()).toISOString()
-		});
-		deps.journal("llm-fallback", `默认模型切换到 ${fbProvider}/${model}（翻译 ${Object.keys(translated).length} 个 provider）`);
-		deps.alert("[DSH] LLM 配置已应急翻译", `默认模型的 provider "${provider}" 不可用（llm-pi 缺席？），已把 ${RAW_NS_LLM_PI} 配置翻译为官方 llm-pi-ai 路由（-fb 后缀）并切换默认模型为 ${fbProvider}/${model}。源插件恢复后将自动还原。`);
-	}
-	async function revert(state) {
-		const ops = state.providers.map((key) => ({
-			op: "unset",
-			path: ["providers", key]
-		}));
-		await writeWithRetry(() => writes.mutate(NS_PI_AI, ops));
-		await writeWithRetry(() => writes.update(NS_AGENT_DEFAULT, {
-			provider: state.originalProvider,
-			model: state.originalModel
-		}));
-		await deps.writeState(null);
-		deps.journal("llm-fallback-revert", `默认模型还原为 ${state.originalProvider}/${state.originalModel}`);
-		deps.alert("[DSH] LLM 应急翻译已还原", `provider "${state.originalProvider}" 恢复健康，默认模型已还原，临时翻译路由已清除。`);
-	}
 	async function evaluate() {
-		const state = deps.readState();
-		const ids = listProviderIds();
-		if (state?.active) {
-			if (ids.has(state.originalProvider)) await revert(state);
-			return;
-		}
-		const def = ctx.settings.describe().find((row) => row.ns === NS_AGENT_DEFAULT)?.value;
-		if (def?.provider === void 0 || def.model === void 0) return;
-		if (ids.has(def.provider)) return;
-		await activate(def.provider, def.model);
+		const provider = defaultProvider(ctx);
+		if (provider === void 0) return;
+		if (ctx.llm.listProviders().some((item) => item.id === provider)) return;
+		if (Date.now() - lastAlertAt < deps.cooldownMs) return;
+		const copy = await readCopy();
+		lastAlertAt = Date.now();
+		const outcome = guide(copy, provider, deps);
+		deps.journal("llm-copy-guide", `默认模型 provider "${provider}" 缺席；副本${outcomeText(outcome, copy.routes ?? 0)}`);
 	}
 	const run = () => {
-		if (withinGrace()) return;
+		if (Date.now() - startedAt < graceMs) return;
 		if (inFlight !== void 0) return;
 		inFlight = evaluate().catch((error) => {
 			const message = error instanceof Error ? error.message : String(error);
-			logger.warn(`llm fallback 评估失败: ${message}`);
-			deps.journal("llm-fallback-error", message);
+			logger.warn(`副本指引评估失败: ${message}`);
+			deps.journal("llm-copy-guide-error", message);
 		}).finally(() => {
 			inFlight = void 0;
 		});
 	};
 	const bootTimer = setTimeout(run, graceMs);
-	ctx.effect(() => () => clearTimeout(bootTimer), "lifeboat: fallback boot timer");
-	ctx.events.on("ready", run);
-	const WATCHED_NS = /* @__PURE__ */ new Set([
-		"agent-default-model",
-		"llm-pi-ai",
-		RAW_NS_LLM_PI
-	]);
+	ctx.effect(() => () => clearTimeout(bootTimer), "lifeboat: copy guide boot timer");
 	ctx.root.on("settings/document-updated", (ns) => {
-		if (typeof ns === "string" && WATCHED_NS.has(ns)) run();
+		if (ns === NS_AGENT_DEFAULT) run();
 	});
-	ctx.root.on("llm/adapters-updated", run);
+	ctx.root.on("llm/adapters-updated", () => run());
 }
 //#endregion
 //#region src/patch-file.ts
@@ -443,10 +403,9 @@ function installHostWatch(ctx, q) {
 //#region src/health-api.ts
 /**
 * lifeboat 健康面板 host 接收面：
-* - GET  /dsh-plus/lifeboat/status  → journal + 翻译状态 + 当前用户 patch 层已禁用的 dsh-plus 插件
+* - GET  /dsh-plus/lifeboat/status  → journal + 应急副本状态 + 当前用户 patch 层已禁用的 dsh-plus 插件
 * - POST /dsh-plus/lifeboat/restore {name} → removeDisable + journal + 告警
 * rc8 用户 patch 层热应用：恢复无需重启，watchUserPatches 即时重载。
-* （0.1.2-alpha.2 基线复核：用户 patch 层热应用机制保留，行为不变。）
 * @module lifeboat/health-api
 */
 const ROUTE_STATUS = "/dsh-plus/lifeboat/status";
@@ -486,7 +445,7 @@ function registerHealthApi(ctx, deps) {
 				const quarantined = await readQuarantined(deps.patchFile);
 				sendJson$1(res, 200, {
 					journal: deps.readJournal(),
-					llmFallback: deps.readFallback(),
+					officialCopy: await deps.readCopy(),
 					quarantined
 				});
 			} catch (error) {
@@ -602,9 +561,9 @@ function registerQuarantineApi(ctx, q) {
 //#endregion
 //#region src/state-file.ts
 /**
-* journal 与 LLM 应急翻译状态的文件持久化（$DSH_HOME/dsh-plus/lifeboat/state.json）。
+* journal 的文件持久化（$DSH_HOME/dsh-plus/lifeboat/state.json）。
 *
-* 存储规范：运行期状态属非配置数据，不进 settings.yaml；本模块自带实现，
+* 存储规范：运行期状态属非配置数据，不进 settings 用户层；本模块自带实现，
 * 维持零 dsh-plus 内部依赖铁律（不 import @dsh-plus/shared）。
 * schema 刻意宽松：lifeboat 是最后防线，自身数据问题绝不能让它起不来。
 * @module lifeboat/state-file
@@ -624,46 +583,20 @@ function asEntry(value) {
 		detail: String(record["detail"] ?? "")
 	};
 }
-/** 未知输入收窄为合法翻译状态。 */
-function asFallback(value) {
-	if (typeof value !== "object" || value === null) return null;
-	const record = value;
-	if (typeof record["active"] !== "boolean") return null;
-	return {
-		active: record["active"],
-		originalProvider: String(record["originalProvider"] ?? ""),
-		originalModel: String(record["originalModel"] ?? ""),
-		fallbackProvider: String(record["fallbackProvider"] ?? ""),
-		providers: Array.isArray(record["providers"]) ? record["providers"].map((item) => String(item)) : [],
-		at: String(record["at"] ?? "")
-	};
-}
 /** 未知输入收窄为完整状态文档；任何缺省回落到空文档。 */
 function normalizeState(raw) {
-	if (typeof raw !== "object" || raw === null) return {
-		journal: [],
-		llmFallback: null
-	};
+	if (typeof raw !== "object" || raw === null) return { journal: [] };
 	const record = raw;
-	return {
-		journal: (Array.isArray(record["journal"]) ? record["journal"].map(asEntry).filter((entry) => entry !== null) : []).slice(-50),
-		llmFallback: asFallback(record["llmFallback"])
-	};
+	return { journal: (Array.isArray(record["journal"]) ? record["journal"].map(asEntry).filter((entry) => entry !== null) : []).slice(-50) };
 }
 /** 读取状态文件；缺失/损坏/超限时返回空文档（最后防线不得因自身数据起不来）。 */
 async function loadState() {
 	try {
 		const info = await stat(STATE_FILE);
-		if (!info.isFile() || info.size > MAX_BYTES) return {
-			journal: [],
-			llmFallback: null
-		};
+		if (!info.isFile() || info.size > MAX_BYTES) return { journal: [] };
 		return normalizeState(JSON.parse(await readFile(STATE_FILE, "utf-8")));
 	} catch {
-		return {
-			journal: [],
-			llmFallback: null
-		};
+		return { journal: [] };
 	}
 }
 /**
@@ -706,10 +639,7 @@ function resolvePatchFile(ctx, config) {
 function apply(ctx, config) {
 	const logger = ctx.logger("lifeboat");
 	const warn = (message) => logger.warn(message);
-	let doc = {
-		journal: [],
-		llmFallback: null
-	};
+	let doc = { journal: [] };
 	loadState().then((loaded) => {
 		doc = loaded;
 	});
@@ -718,6 +648,12 @@ function apply(ctx, config) {
 		saveState(doc, warn);
 	};
 	const alert = installAlerter(ctx, journal);
+	installCopyGuide(ctx, {
+		journal,
+		alert,
+		profile: ctx.get("profileContext")?.name,
+		cooldownMs: config.alertCooldownMs
+	});
 	if (config.enabled) {
 		const patchFile = resolvePatchFile(ctx, config);
 		if (patchFile === void 0) warn("故障隔离停用：当前组合树无 profileContext，无法定位 profile 用户 patch 层");
@@ -736,23 +672,11 @@ function apply(ctx, config) {
 					journal,
 					alert,
 					readJournal: () => doc.journal,
-					readFallback: () => doc.llmFallback
+					readCopy: () => readOfficialCopyStatus()
 				});
 			});
 		}
 	}
-	if (config.llmFallback) installLlmFallback(ctx, {
-		journal,
-		alert,
-		readState: () => doc.llmFallback,
-		writeState: async (state) => {
-			doc = {
-				...doc,
-				llmFallback: state
-			};
-			await saveState(doc, warn);
-		}
-	});
 }
 //#endregion
 export { Config, apply, inject, name, resolvePatchFile };