@dsh-plus/lifeboat 0.2.10 → 0.2.12

package/lib/client.js

@@ -50,28 +50,24 @@ window.__ModuleLoader__.load({
 		}));
 		//#endregion
 		//#region ../shared/src/client/fetch.ts
-		/**
-		* 同源自定义端点的最小 fetch 封装（各插件 client/api.ts 的公共收编版）。
-		* 仅同源（credentials: same-origin），错误统一抛 Error(body.error)。
-		* @module @dsh-plus/shared/client/fetch
-		*/
-		async function parse(res) {
+		async function parse(res, guard) {
 			const body = await res.json();
 			if (!res.ok) throw new Error(body.error ?? `HTTP ${res.status}`);
+			if (guard !== void 0 && !guard(body)) throw new Error(`响应结构不符合预期（${res.url}）`);
 			return body;
 		}
 		/** GET 同源 JSON 端点。 */
-		async function getJson(route) {
-			return parse(await fetch(route, { credentials: "same-origin" }));
+		async function getJson(route, guard) {
+			return parse(await fetch(route, { credentials: "same-origin" }), guard);
 		}
 		/** POST 同源 JSON 端点（body 可省略）。 */
-		async function postJson(route, body) {
+		async function postJson(route, body, guard) {
 			return parse(await fetch(route, {
 				method: "POST",
 				credentials: "same-origin",
 				headers: { "content-type": "application/json" },
-				body: body === void 0 ? void 0 : JSON.stringify(body)
-			}));
+				...body === void 0 ? {} : { body: JSON.stringify(body) }
+			}), guard);
 		}
 		var init_fetch = __esmMin((() => {}));
 		//#endregion
@@ -157,6 +153,12 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/health-tab.tsx
 		var health_tab_exports = /* @__PURE__ */ __exportAll({ mountHealthTab: () => mountHealthTab });
+		/** 端点应答形状守卫：三字段缺一即判非法（渲染期直接 map journal/quarantined）。 */
+		function isStatusResponse(value) {
+			if (typeof value !== "object" || value === null) return false;
+			const status = value;
+			return Array.isArray(status.journal) && Array.isArray(status.quarantined);
+		}
 		function HealthTab(props) {
 			const { t } = props;
 			const [status, setStatus] = (0, react.useState)(null);
@@ -165,7 +167,7 @@ window.__ModuleLoader__.load({
 			const [notice, setNotice] = (0, react.useState)(null);
 			const [confirming, setConfirming] = (0, react.useState)(null);
 			const load = (0, react.useCallback)(() => {
-				getJson(ROUTE_STATUS).then((data) => {
+				getJson(ROUTE_STATUS, isStatusResponse).then((data) => {
 					setStatus(data);
 					setFailed(false);
 				}).catch(() => setFailed(true));

package/lib/index.d.ts

@@ -17,7 +17,7 @@ type LifeboatConfig = Schemastery.TypeT<typeof Config>;
 //#endregion
 //#region src/index.d.ts
 declare const name = "dsh-plus-lifeboat";
-declare const inject: readonly ["settings", "llm"];
+declare const inject: readonly ['settings', 'llm'];
 declare function apply(ctx: Context, config: LifeboatConfig): void;
 //#endregion
 export { Config, apply, inject, name };

package/lib/index.js

@@ -2,7 +2,7 @@ import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
 import z from "@deepseek-ai/schemastery";
 import { copyFile, mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
 import { SettingsConflictError } from "@deepseek-ai/dsh-settings";
-import { parseDocument } from "yaml";
+import { isSeq, parseDocument } from "yaml";
 import { dirname } from "node:path";
 //#region src/config.ts
 /**
@@ -223,7 +223,7 @@ function installLlmFallback(ctx, deps, graceMs = BOOT_GRACE_MS) {
 	};
 	const bootTimer = setTimeout(run, graceMs);
 	ctx.effect(() => () => clearTimeout(bootTimer), "lifeboat: fallback boot timer");
-	ctx.on("ready", run);
+	ctx.events.on("ready", run);
 	const WATCHED_NS = /* @__PURE__ */ new Set([
 		"agent-default-model",
 		"llm-pi-ai",
@@ -350,10 +350,10 @@ async function removeDisable(patchFile, targetId) {
 		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 contents = doc.contents;
+		if (isSeq(contents)) {
+			const headComment = contents.items[0]?.commentBefore;
+			contents.items = contents.items.filter((item) => {
 				const value = item.toJS?.(doc);
 				if (value !== void 0 && typeof value === "object" && value.id === targetId && value.disabled === true) {
 					removed = true;
@@ -361,8 +361,8 @@ async function removeDisable(patchFile, targetId) {
 				}
 				return true;
 			});
-			if (removed && headComment !== void 0 && doc.contents.items.length > 0) {
-				const next = doc.contents.items[0];
+			if (removed && headComment !== void 0 && contents.items.length > 0) {
+				const next = contents.items[0];
 				if (next.commentBefore === void 0) next.commentBefore = headComment;
 			}
 		}
@@ -379,7 +379,11 @@ const FIBER_FAILED = 3;
 /** 永不隔离的条目：救生艇自身与聚合 bundle（禁了它们等于关掉整个防线/全家）。 */
 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 同字面量是本仓库约定）。 */
+/**
+* 名字是否属于可隔离的 dsh-plus 兄弟插件（entry id 与插件 name 同字面量是本仓库约定）。
+* 返回布尔而非 `name is string`：后者会把「正则不匹配」的否定分支收窄成 never，
+* 让调用方在 `||` 右侧失去 string 上的方法（health-api 已踩到）。
+*/
 function isGuardedPlugin(name) {
 	return typeof name === "string" && GUARD_RE.test(name) && !EXCLUDED.has(name);
 }
@@ -429,7 +433,8 @@ 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", fiber._error);
+		const reason = fiber._error;
+		q.quarantine(fiber.name, "host", reason);
 	});
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/lifeboat",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "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.14"
+    "@dsh-plus/shared": "0.1.16"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",

package/src/client/health-tab.tsx

@@ -8,6 +8,7 @@
  * @module lifeboat/client/health-tab
  */
 
+import type { Context } from '@deepseek-ai/cordis'
 import { getJson, postJson } from '@dsh-plus/shared/client'
 import { type ReactElement, useCallback, useEffect, useMemo, useState } from 'react'
 
@@ -33,6 +34,13 @@ interface StatusResponse {
   quarantined: string[]
 }
 
+/** 端点应答形状守卫：三字段缺一即判非法（渲染期直接 map journal/quarantined）。 */
+function isStatusResponse(value: unknown): value is StatusResponse {
+  if (typeof value !== 'object' || value === null) return false
+  const status = value as { journal?: unknown; quarantined?: unknown }
+  return Array.isArray(status.journal) && Array.isArray(status.quarantined)
+}
+
 interface InventoryRow {
   id: string
   enabled: boolean
@@ -129,7 +137,7 @@ function HealthTab(props: { t(key: string): string }): ReactElement {
   const [confirming, setConfirming] = useState<string | null>(null)
 
   const load = useCallback((): void => {
-    getJson<StatusResponse>(ROUTE_STATUS)
+    getJson<StatusResponse>(ROUTE_STATUS, isStatusResponse)
       .then((data) => {
         setStatus(data)
         setFailed(false)

package/src/fallback-llm.ts

@@ -331,10 +331,19 @@ export function installLlmFallback(
   // 覆盖后续变化；宽限内的 settings/llm 事件同样被时间闸跳过，由收尾评估兜底。
   const bootTimer = setTimeout(run, graceMs)
   ctx.effect(() => () => clearTimeout(bootTimer), 'lifeboat: fallback boot timer')
-  ctx.on('ready' as never, run)
+  // 走 events 的字符串重载而非 ctx.on：'ready' 不是平台声明的事件
+  // （cordis 4.0.2 内置仅 internal/*，dsh 0.1.5-rc.1 全树无任何声明或派发点），
+  // ctx.on 要求 keyof Events，只能靠 as never 硬塞。events.on(name: string|symbol)
+  // 是平台给动态事件名的正统入口，运行期同一事件总线、同一 fiber 归属、随 fiber
+  // 卸载自动移除（已实测）。注意：该监听目前**无生产者**，属遗留死监听，保留是
+  // 为不动运行期行为，待人工确认后决定是否删除。
+  ctx.events.on('ready', run)
   // 只响应与本判定相关的命名空间变化：journal 写自身命名空间，不过滤会自触发循环。
   const WATCHED_NS = new Set(['agent-default-model', 'llm-pi-ai', RAW_NS_LLM_PI])
-  ctx.root.on('settings/updated' as never, (ns: unknown) => {
+  // settings/updated 由 @deepseek-ai/dsh-settings 声明（本文件已导入该包），
+  // 参数类型是品牌化的 SettingsNamespace；监听器按 unknown 收，保留原有
+  // typeof 字符串防御。
+  ctx.root.on('settings/updated', (ns: unknown) => {
     if (typeof ns === 'string' && WATCHED_NS.has(ns)) run()
   })
   // 事件名已核对：0.1.2-alpha.2 的 dsh-llm 保留 'llm/adapters-updated'

package/src/patch-file.ts

@@ -17,7 +17,7 @@
  */
 import { copyFile, readFile, rename, writeFile } from 'node:fs/promises'
 
-import { parseDocument } from 'yaml'
+import { isSeq, parseDocument } from 'yaml'
 
 /** patch 文件顶层条目（松散视图：只关心 id/disabled/insert 三个键）。 */
 export interface PatchEntry {
@@ -144,12 +144,16 @@ export async function removeDisable(patchFile: string, targetId: string): Promis
     const root = doc.toJS() as unknown
     if (!Array.isArray(root)) throw new Error(`patch 文件顶层不是数组: ${patchFile}`)
     let removed = false
-    const items = doc.contents
-    if (items?.items !== undefined && Array.isArray(items.items)) {
+    // 空值/形状防御与原实现等价：上面已确认 doc.toJS() 是数组，顶层数组文档的
+    // contents 必为 YAMLSeq（标量/别名/映射节点都不满足该条）；isSeq 同时对
+    // null（空文档）与其它节点返回 false，不会让后续访问落到无 items 的节点上。
+    const contents = doc.contents
+    if (isSeq(contents)) {
       // 头注释挂在首个条目的 commentBefore 上：被移除项若为首项，注释迁移给
       // 新的首项，避免整文件头注释丢失。
-      const headComment = (items.items[0] as unknown as { commentBefore?: string })?.commentBefore
-      doc.contents.items = items.items.filter((item) => {
+      const headComment = (contents.items[0] as unknown as { commentBefore?: string })
+        ?.commentBefore
+      contents.items = contents.items.filter((item) => {
         const value = (item as unknown as { toJS?(doc: unknown): unknown }).toJS?.(doc) as
           | PatchEntry
           | undefined
@@ -164,8 +168,8 @@ export async function removeDisable(patchFile: string, targetId: string): Promis
         }
         return true
       })
-      if (removed && headComment !== undefined && doc.contents.items.length > 0) {
-        const next = doc.contents.items[0] as unknown as { commentBefore?: string }
+      if (removed && headComment !== undefined && contents.items.length > 0) {
+        const next = contents.items[0] as unknown as { commentBefore?: string }
         if (next.commentBefore === undefined) next.commentBefore = headComment
       }
     }

package/src/quarantine.ts

@@ -17,8 +17,12 @@ const EXCLUDED = new Set(['dsh-plus-lifeboat', 'dsh-plus-bundle-main'])
 
 const GUARD_RE = /^dsh-plus-[a-z0-9-]+$/
 
-/** 名字是否属于可隔离的 dsh-plus 兄弟插件（entry id 与插件 name 同字面量是本仓库约定）。 */
-export function isGuardedPlugin(name: unknown): name is string {
+/**
+ * 名字是否属于可隔离的 dsh-plus 兄弟插件（entry id 与插件 name 同字面量是本仓库约定）。
+ * 返回布尔而非 `name is string`：后者会把「正则不匹配」的否定分支收窄成 never，
+ * 让调用方在 `||` 右侧失去 string 上的方法（health-api 已踩到）。
+ */
+export function isGuardedPlugin(name: unknown): boolean {
   return typeof name === 'string' && GUARD_RE.test(name) && !EXCLUDED.has(name)
 }
 
@@ -98,9 +102,14 @@ export function createQuarantine(ctx: Context, deps: QuarantineDeps): Quarantine
  * fiber.name 对 loader 条目即插件 display name（模块导出的 name 字段）。
  */
 export function installHostWatch(ctx: Context, q: Quarantine): void {
-  ctx.root.on('internal/status', (fiber: { state: number; name: string; _error?: unknown }) => {
+  // 结构化类型只声明本函数真正读取的两个字段；Fiber 上 state 是 FiberState
+  // 字面量枚举，按 number 读取与既有 FIBER_FAILED 镜像常量比较。
+  ctx.root.on('internal/status', (fiber: { state: number; name: string }) => {
     if (fiber.state !== FIBER_FAILED) return
     if (!isGuardedPlugin(fiber.name)) return
-    void q.quarantine(fiber.name, 'host', fiber._error)
+    // cordis 把加载错误挂在 fiber._error 上：类型声明为 private（类型层不可见），
+    // 运行期确实存在，故按运行期形状读取。
+    const reason = (fiber as unknown as { _error?: unknown })._error
+    void q.quarantine(fiber.name, 'host', reason)
   })
 }