@dsh-plus/lifeboat 0.3.8 → 0.3.9

package/lib/client.js

@@ -5,9 +5,11 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		//#region \0rolldown/runtime.js
+		var __create = Object.create;
 		var __defProp = Object.defineProperty;
 		var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 		var __getOwnPropNames = Object.getOwnPropertyNames;
+		var __getProtoOf = Object.getPrototypeOf;
 		var __hasOwnProp = Object.prototype.hasOwnProperty;
 		var __esmMin = (fn, res, err) => () => {
 			if (err) throw err[0];
@@ -36,19 +38,118 @@ window.__ModuleLoader__.load({
 			}
 			return to;
 		};
+		var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+			value: mod,
+			enumerable: true
+		}) : target, mod));
 		var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 		//#endregion
-		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
+		react = __toESM(react, 1);
+		let react_jsx_runtime = require("react/jsx-runtime");
+		require("@deepseek-ai/schemastery");
 		require("@deepseek-ai/dsh-client-ui-primitives");
 		//#region ../shared/src/client/fields.tsx
 		var init_fields = __esmMin((() => {}));
 		//#endregion
 		//#region ../shared/src/client/card.tsx
+		/**
+		* 配置卡片外壳与排版件：`ConfigShell`（卡片级无边框分节）、`Section`（卡片内二级
+		* 分组）、`FieldGrid`（字段排布）、`Note`（只读说明）、`ListEditor`（数组型资源
+		* 统一编辑）、`CardLoading`（取值未到达占位）。
+		*
+		* 宿主页面（`plugins.row.config` / `plugins.bundle.config` 的 page 视图）自己画
+		* 标题、图标、面包屑与页面级内边距，视图只填内容区——所以这里不再自绘带边框
+		* 卡片（会形成卡片套卡片，把移动端可用宽度逐层扣掉），也不做折叠：page 视图
+		* 本身就是表单落地页。度量对齐官方设置页（dsh-client-ui-primitives 的
+		* settings-form）：小节标题 13px/600、字段区零横向内边距、页脚非 sticky。
+		*
+		* 各插件 card.tsx 只填 children 字段区与 actions；类名前缀与样式由
+		* cardCss(prefix) 配套。
+		* @module @dsh-plus/shared/client/card
+		*/
 		var init_card = __esmMin((() => {
 			init_fields();
 		}));
 		//#endregion
+		//#region ../shared/src/client/code-validate.ts
+		/**
+		* 配置源码编辑的模式校验：用宿主 `describe` 回传的 schema JSON 在浏览器本地
+		* 重建同一套 schemastery 校验（库 23KB 纯 JS，随 client bundle 打苞——浏览器端
+		* 没有宿主实例，不存在跨实例符号身份问题，见 docs/reference/官方机制参照.md
+		* 「客户端平台」）。
+		*
+		* 校验与宿主写入路径同源：`new Schema(json)` 后按同一份 volatile 投影调用，
+		* 因此本地拦下的错误与宿主 `settings/rejected` 的判据一致。
+		* @module @dsh-plus/shared/client/code-validate
+		*/
+		var init_code_validate = __esmMin((() => {}));
+		//#endregion
+		//#region ../shared/src/client/styles.ts
+		/**
+		* 幂等注入样式标签（官方 data-plugin-css 约定）；返回新标签，
+		* 已存在或环境无 document 时返回 null（调用方 effect 卸载用）。
+		*/
+		function injectCardStyle(pluginId, css) {
+			if (typeof document === "undefined") return null;
+			const tagId = `${pluginId}/card.css`;
+			if (document.querySelector(`style[data-plugin-css=${JSON.stringify(tagId)}]`) !== null) return null;
+			const tag = document.createElement("style");
+			tag.dataset.plugin = pluginId;
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+			return tag;
+		}
+		var init_styles = __esmMin((() => {}));
+		//#endregion
+		//#region ../shared/src/client/code-section.ts
+		/**
+		* 配置源码编辑节（自动追加到每张插件配置卡片页）。
+		*
+		* 形态：无边框分节，与 ConfigShell/Section 的小节度量一致；文档＝宿主 `describe` 回传的
+		* volatile 投影（JSON，两空格缩进），校验＝本地 JSON 语法 + schemastery 模式，
+		* 写回＝官方 `settings.mutate` 路径 ops（密钥字段不进文档，也不会被写坏）。
+		*
+		* 本文件刻意不写 JSX：`@dsh-plus/shared` 的 client 纯逻辑测试用 `node --test`
+		* 直跑 .ts（Node 原生类型擦除不支持 JSX），而 `config-slots.ts` 会被测试导入，
+		* 因此这条导入链上的模块一律用 `createElement`。React 只经默认导入取用
+		* （react 是 CJS，Node ESM 下具名导入不保证可解析）。
+		* @module @dsh-plus/shared/client/code-section
+		*/
+		var h$1, useEffect$3, useMemo$2, useState$3, useSyncExternalStore$1;
+		var init_code_section = __esmMin((() => {
+			init_code_validate();
+			({createElement: h$1, useEffect: useEffect$3, useMemo: useMemo$2, useState: useState$3, useSyncExternalStore: useSyncExternalStore$1} = react.default);
+		}));
+		//#endregion
+		//#region ../shared/src/client/config-slots.ts
+		/**
+		* 配置卡片的槽位注册助手（目标宿主：dsh 0.2.1-alpha.2）。
+		*
+		* 官方插件页（`dsh-client-ui-plugin-manager`）为第三方配置视图声明两个 keyed 槽位：
+		* - `plugins.row.config`（key = `<bundle 包名>#<row id>`）：bundle 详情页对应行出现
+		*   「配置」入口，行配置页渲染 `view: 'summary'`（一行简介）与 `view: 'page'`
+		*   （带保存控件的表单）；
+		* - `plugins.bundle.config`（key = 包名）：包详情页本体配置，仅渲染 `view: 'page'`。
+		*
+		* 页面自己画标题、图标、面包屑与页面级内边距（`detailSections` 内无边框容器），
+		* 故 page 视图输出无边框分节（见 card.tsx），summary 视图只返回一行文本。
+		* 旧 `settings.plugin.item` 槽位已随官方插件页迁移删除，不再注册。
+		*
+		* **源码编辑节自动追加**：注册时把插件组件包一层，page 视图在原卡片之后追加
+		* `ConfigCodeSection`（复用同一份 scope/api），summary 视图原样透传。因此「只要
+		* 插件存在可配置项」就有源码编辑入口，插件侧零接线；命名空间没有 volatile 字段时
+		* 它本身不出现在 describe 视图里，该节自然显示为不可用。
+		*
+		* @module @dsh-plus/shared/client/config-slots
+		*/
+		var h, Fragment;
+		var init_config_slots = __esmMin((() => {
+			init_code_section();
+			({createElement: h, Fragment} = react.default);
+		}));
+		//#endregion
 		//#region ../shared/src/client/credentials.tsx
 		/**
 		* 凭据面（共享件）：官方 settings-controller 的 `remote.credentials` 命名空间
@@ -103,27 +204,12 @@ window.__ModuleLoader__.load({
 		//#region ../shared/src/client/icons.tsx
 		var init_icons = __esmMin((() => {}));
 		//#endregion
-		//#region ../shared/src/client/styles.ts
-		/**
-		* 幂等注入样式标签（官方 data-plugin-css 约定）；返回新标签，
-		* 已存在或环境无 document 时返回 null（调用方 effect 卸载用）。
-		*/
-		function injectCardStyle(pluginId, css) {
-			if (typeof document === "undefined") return null;
-			const tagId = `${pluginId}/card.css`;
-			if (document.querySelector(`style[data-plugin-css=${JSON.stringify(tagId)}]`) !== null) return null;
-			const tag = document.createElement("style");
-			tag.dataset.plugin = pluginId;
-			tag.dataset.pluginCss = tagId;
-			tag.textContent = css;
-			document.head.appendChild(tag);
-			return tag;
-		}
-		var init_styles = __esmMin((() => {}));
-		//#endregion
 		//#region ../shared/src/client/index.ts
 		var init_client = __esmMin((() => {
 			init_card();
+			init_code_section();
+			init_code_validate();
+			init_config_slots();
 			init_credentials();
 			init_draft();
 			init_fetch();

package/lib/index.d.ts

@@ -3,11 +3,9 @@ import { Context } from "@deepseek-ai/cordis";
 //#region src/config.d.ts
 /** 行级配置：全部有默认值，正常部署零配置。 */
 declare const Config: z<Schemastery.ObjectS<NoInfer<{
-  enabled: z<boolean, boolean, "defined">;
   patchFile: z<string, string, "defined">;
   alertCooldownMs: z<number, number, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
-  enabled: z<boolean, boolean, "defined">;
   patchFile: z<string, string, "defined">;
   alertCooldownMs: z<number, number, "defined">;
 }>>, "plain">;

package/lib/index.js

@@ -1,8 +1,9 @@
 import z from "@deepseek-ai/schemastery";
 import { copyFile, readFile, stat } from "node:fs/promises";
-import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
+import { pluginDataPath } from "@dsh-plus/shared";
 import { isSeq, parse, parseDocument } from "yaml";
 import { writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
+import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
 //#region src/config.ts
 /**
 * 配置单一事实源。
@@ -13,29 +14,30 @@ 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(""),
 	alertCooldownMs: z.natural().description("同一插件重复告警的最小间隔毫秒数").default(3e5)
 });
 //#endregion
 //#region src/official-copy-status.ts
 /**
-* 官方应急副本的只读状态读取（$DSH_HOME/llm-pi.official-patch.yaml）。
+* 官方应急副本的只读状态读取（$DSH_HOME/dsh-plus/llm-pi/official-patch.yaml）。
 *
 * 文件契约与 @dsh-plus/llm-pi 同路径：对方常备副本、本包只读消费——零
-* dsh-plus 内部依赖铁律下不 import 对方实现，路径按契约文件名同源派生。
+* dsh-plus 内部依赖铁律下不 import 对方实现，路径按插件数据目录规范同源派生。
 * 读取一切失败都降级为结构化状态（面板展示与告警文案的输入，绝不抛出）。
 * @module lifeboat/official-copy-status
 */
-/** 副本文件名（跨包文件契约：llm-pi 写、本包读，改名须两侧同步）。 */
-const OFFICIAL_COPY_FILE = "llm-pi.official-patch.yaml";
+/** 副本所在插件（跨包文件契约：llm-pi 写、本包读，改名须两侧同步）。 */
+const OFFICIAL_COPY_PLUGIN = "llm-pi";
+/** 副本文件名（同上，两侧同步）。 */
+const OFFICIAL_COPY_FILE = "official-patch.yaml";
 /** 解析上限：超出只报存在性与时间，不读内容（面板/告警不得被大文件拖垮）。 */
 const MAX_BYTES$1 = 2097152;
 /** 头注释里的生成警告行前缀（llm-pi 渲染约定）。 */
 const WARNING_PREFIX = "# 警告：";
 /** 副本契约路径（默认读取点）。 */
 function officialCopyPath() {
-	return dshHomePath(OFFICIAL_COPY_FILE);
+	return pluginDataPath(OFFICIAL_COPY_PLUGIN, OFFICIAL_COPY_FILE);
 }
 /** 解析副本内容（纯函数）：头注释警告 + llm-pi-ai 行的 providers 数。 */
 function parseCopyText(text) {
@@ -654,29 +656,28 @@ function apply(ctx, config) {
 		profile: ctx.get("profileContext")?.name,
 		cooldownMs: config.alertCooldownMs
 	});
-	if (config.enabled) {
-		const patchFile = resolvePatchFile(ctx, config);
-		if (patchFile === void 0) warn("故障隔离停用：当前组合树无 profileContext，无法定位 profile 用户 patch 层");
-		else {
-			const quarantine = createQuarantine(ctx, {
-				patchFile,
-				alertCooldownMs: config.alertCooldownMs,
-				journal,
-				alert
-			});
-			installHostWatch(ctx, quarantine);
-			ctx.inject(["webServer"], (webCtx) => {
-				registerQuarantineApi(webCtx, quarantine);
-				registerHealthApi(webCtx, {
-					patchFile,
-					journal,
-					alert,
-					readJournal: () => doc.journal,
-					readCopy: () => readOfficialCopyStatus()
-				});
-			});
-		}
+	const patchFile = resolvePatchFile(ctx, config);
+	if (patchFile === void 0) {
+		warn("故障隔离停用：当前组合树无 profileContext，无法定位 profile 用户 patch 层");
+		return;
 	}
+	const quarantine = createQuarantine(ctx, {
+		patchFile,
+		alertCooldownMs: config.alertCooldownMs,
+		journal,
+		alert
+	});
+	installHostWatch(ctx, quarantine);
+	ctx.inject(["webServer"], (webCtx) => {
+		registerQuarantineApi(webCtx, quarantine);
+		registerHealthApi(webCtx, {
+			patchFile,
+			journal,
+			alert,
+			readJournal: () => doc.journal,
+			readCopy: () => readOfficialCopyStatus()
+		});
+	});
 }
 //#endregion
 export { Config, apply, inject, name, resolvePatchFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/lifeboat",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "dsh-plus service plugin: 故障救生艇——兄弟插件崩溃时自动隔离（写用户 patch 层禁用），llm-pi 缺席时把其配置临时翻译为官方 llm-pi-ai 路由，恢复后自动还原",
   "type": "module",
   "main": "lib/index.js",
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "yaml": "^2.9.0",
-    "@dsh-plus/shared": "0.1.43"
+    "@dsh-plus/shared": "0.1.44"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",

package/src/config.ts

@@ -10,7 +10,6 @@ import z from '@deepseek-ai/schemastery'
 
 /** 行级配置：全部有默认值，正常部署零配置。 */
 export const Config = z.object({
-  enabled: z.boolean().description('故障隔离总开关').default(true),
   patchFile: z
     .string()
     .description(

package/src/index.ts

@@ -77,30 +77,30 @@ export function apply(ctx: Context, config: LifeboatConfig): void {
     cooldownMs: config.alertCooldownMs,
   })
 
-  if (config.enabled) {
-    const patchFile = resolvePatchFile(ctx, config)
-    if (patchFile === undefined) {
-      // 无 profileContext 的组合树（非 dsh 启动）：不猜路径、不写任何 patch，
-      // 隔离停用但告警/journal 照常。
-      warn('故障隔离停用：当前组合树无 profileContext，无法定位 profile 用户 patch 层')
-    } else {
-      const quarantine = createQuarantine(ctx, {
-        patchFile,
-        alertCooldownMs: config.alertCooldownMs,
-        journal,
-        alert,
-      })
-      installHostWatch(ctx, quarantine)
-      ctx.inject(['webServer'], (webCtx) => {
-        registerQuarantineApi(webCtx, quarantine)
-        registerHealthApi(webCtx, {
-          patchFile,
-          journal,
-          alert,
-          readJournal: () => doc.journal,
-          readCopy: () => readOfficialCopyStatus(),
-        })
-      })
-    }
+  // 故障隔离是常驻能力：整行开关由 Loader 的 profile patch `disabled` 提供，
+  // 插件内部不再持有第二套总开关（见 docs/repo/插件存储规范.md）。
+  const patchFile = resolvePatchFile(ctx, config)
+  if (patchFile === undefined) {
+    // 无 profileContext 的组合树（非 dsh 启动）：不猜路径、不写任何 patch，
+    // 隔离停用但告警/journal 照常。
+    warn('故障隔离停用：当前组合树无 profileContext，无法定位 profile 用户 patch 层')
+    return
   }
+  const quarantine = createQuarantine(ctx, {
+    patchFile,
+    alertCooldownMs: config.alertCooldownMs,
+    journal,
+    alert,
+  })
+  installHostWatch(ctx, quarantine)
+  ctx.inject(['webServer'], (webCtx) => {
+    registerQuarantineApi(webCtx, quarantine)
+    registerHealthApi(webCtx, {
+      patchFile,
+      journal,
+      alert,
+      readJournal: () => doc.journal,
+      readCopy: () => readOfficialCopyStatus(),
+    })
+  })
 }

package/src/official-copy-status.ts

@@ -1,18 +1,19 @@
 /**
- * 官方应急副本的只读状态读取（$DSH_HOME/llm-pi.official-patch.yaml）。
+ * 官方应急副本的只读状态读取（$DSH_HOME/dsh-plus/llm-pi/official-patch.yaml）。
  *
  * 文件契约与 @dsh-plus/llm-pi 同路径：对方常备副本、本包只读消费——零
- * dsh-plus 内部依赖铁律下不 import 对方实现，路径按契约文件名同源派生。
+ * dsh-plus 内部依赖铁律下不 import 对方实现，路径按插件数据目录规范同源派生。
  * 读取一切失败都降级为结构化状态（面板展示与告警文案的输入，绝不抛出）。
  * @module lifeboat/official-copy-status
  */
 import { readFile, stat } from 'node:fs/promises'
-
-import { dshHomePath } from '@deepseek-ai/dsh-home-paths'
+import { pluginDataPath } from '@dsh-plus/shared'
 import { parse } from 'yaml'
 
-/** 副本文件名（跨包文件契约：llm-pi 写、本包读，改名须两侧同步）。 */
-export const OFFICIAL_COPY_FILE = 'llm-pi.official-patch.yaml'
+/** 副本所在插件（跨包文件契约：llm-pi 写、本包读，改名须两侧同步）。 */
+const OFFICIAL_COPY_PLUGIN = 'llm-pi'
+/** 副本文件名（同上，两侧同步）。 */
+export const OFFICIAL_COPY_FILE = 'official-patch.yaml'
 
 /** 解析上限：超出只报存在性与时间，不读内容（面板/告警不得被大文件拖垮）。 */
 const MAX_BYTES = 2 * 1024 * 1024
@@ -35,7 +36,7 @@ export interface OfficialCopyStatus {
 
 /** 副本契约路径（默认读取点）。 */
 export function officialCopyPath(): string {
-  return dshHomePath(OFFICIAL_COPY_FILE)
+  return pluginDataPath(OFFICIAL_COPY_PLUGIN, OFFICIAL_COPY_FILE)
 }
 
 /** 解析副本内容（纯函数）：头注释警告 + llm-pi-ai 行的 providers 数。 */