@dsh-plus/lifeboat 0.1.6 → 0.1.7

package/lib/index.js

@@ -61,6 +61,16 @@ const NS_AGENT_DEFAULT = settingsNamespace("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",
@@ -112,8 +122,14 @@ function translateProvider(routeKey, raw) {
 	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) if (raw.compat[key] !== void 0) compat[key] = raw.compat[key];
+		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;
 	}
 	if (Array.isArray(raw.models) && raw.models.length > 0) out.models = raw.models.map((m) => {
@@ -139,14 +155,12 @@ async function readRawSection(settingsFile, ns) {
 	if (typeof section !== "object" || section === null) return void 0;
 	return section;
 }
-/** 写 settings 带一次冲突重试（用户同时改配置时不抢，放弃并告警）。
-*  冲突判定双条件：instanceof 覆盖同版本副本；error.code 覆盖跨版本副本
-*  （插件自带 rc.7 依赖与 host rc.8 抛错时 instanceof 为 false）。 */
+/** 写 settings 带一次冲突重试（用户同时改配置时不抢，放弃并告警）。 */
 async function writeWithRetry(write) {
 	try {
 		await write();
 	} catch (error) {
-		if (!(error instanceof SettingsConflictError || typeof error === "object" && error !== null && error.code === "SETTINGS_CONFLICT")) throw error;
+		if (!(error instanceof SettingsConflictError)) throw error;
 		await write();
 	}
 }
@@ -165,11 +179,16 @@ function installLlmFallback(ctx, deps) {
 		}
 		const translated = translateProviders(providers);
 		const fbProvider = `${provider}-fb`;
-		await writeWithRetry(() => writes.update(NS_PI_AI, { providers: translated }));
-		await writeWithRetry(() => writes.update(NS_AGENT_DEFAULT, {
-			provider: fbProvider,
-			model
-		}));
+		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,
@@ -375,6 +394,7 @@ function installHostWatch(ctx, q) {
 * - GET  /dsh-plus/lifeboat/status  → journal + 翻译状态 + 当前用户 patch 层已禁用的 dsh-plus 插件
 * - POST /dsh-plus/lifeboat/restore {name} → removeDisable + journal + 告警
 * rc8 用户 patch 层热应用：恢复无需重启，watchUserPatches 即时重载。
+* （0.1.2-alpha.1 基线：用户 patch 层热应用机制保留，行为不变。）
 * @module lifeboat/health-api
 */
 const ROUTE_STATUS = "/dsh-plus/lifeboat/status";
@@ -439,7 +459,7 @@ function registerHealthApi(ctx, deps) {
 				}
 				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 层本无覆盖，可能已被手动恢复。"}`);
+				deps.alert("[DSH] 插件恢复", `插件 ${body.name} 的隔离已解除（移除 patch 层禁用覆盖）。${written ? "patch 层热应用即时生效，无需重启。" : "patch 层本无覆盖，可能已被手动恢复。"}`);
 				sendJson$1(res, 200, {
 					ok: true,
 					written

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/lifeboat",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "dsh-plus service plugin: 故障救生艇——兄弟插件崩溃时自动隔离（写用户 patch 层禁用），llm-pi 缺席时把其配置临时翻译为官方 llm-pi-ai 路由，恢复后自动还原",
   "type": "module",
   "main": "lib/index.js",
@@ -23,29 +23,29 @@
   "dsh": {
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-locale"
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-renderer"
       ],
       "platform": "web"
     }
   },
   "dependencies": {
     "yaml": "^2.6.0",
-    "@dsh-plus/shared": "0.1.5"
+    "@dsh-plus/shared": "0.1.6"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-home-paths": "^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/dsh-home-paths": "^0.1.2-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.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/dsh-home-paths": "0.1.2-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.1",
     "@deepseek-ai/schemastery": "3.18.1",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",

package/src/fallback-llm.ts

@@ -35,6 +35,17 @@ export const FALLBACK_SUFFIX = '-fb'
 /** 官方配置路径物化的 compat 子集（其余字段降级期丢弃）。 */
 const COMPAT_WHITELIST = ['thinkingFormat', 'supportsReasoningEffort'] as const
 
+/**
+ * master 官方 llm-pi-ai 的 COMPAT_GATES（llm-pi-ai/src/catalog.ts）：每个 compat
+ * 字段按协议门控，写时经 assertOfferedCompatFields 拒绝不适配字段——thinkingFormat /
+ * supportsReasoningEffort 仅 openai-completions 提供。翻译按推断 api 过滤，避免
+ * 整段 compat 写入被官方校验拒绝。
+ */
+const COMPAT_OFFER_APIS: Readonly<Record<string, ReadonlySet<string>>> = {
+  thinkingFormat: new Set(['openai-completions']),
+  supportsReasoningEffort: new Set(['openai-completions']),
+}
+
 /** 官方 reasoning 词表（ModelThinkingLevel 的保守子集），不在其中的值丢弃。 */
 const REASONING_LEVELS = new Set(['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'])
 
@@ -124,9 +135,15 @@ export function translateProvider(routeKey: string, raw: RawProvider): Translate
   if (Array.isArray(raw.defaultInput) && raw.defaultInput.length > 0)
     out.defaultInput = raw.defaultInput
   if (raw.compat !== undefined) {
+    const api = inferApi(routeKey, raw)
     const compat: Record<string, unknown> = {}
     for (const key of COMPAT_WHITELIST) {
-      if (raw.compat[key] !== undefined) compat[key] = raw.compat[key]
+      const value = raw.compat[key]
+      // 空值同样丢弃：官方写时拒绝 valueless 键（catalog.ts assertOfferedCompatFields）
+      if (value === undefined || value === null) continue
+      // 按推断 api 门控：仅写入该协议 offer 的字段，其余丢弃（官方写时拒绝不适配字段）
+      if (!COMPAT_OFFER_APIS[key]?.has(api)) continue
+      compat[key] = value
     }
     if (Object.keys(compat).length > 0) out.compat = compat
   }
@@ -178,19 +195,12 @@ interface SettingsWrite {
   ): Promise<void>
 }
 
-/** 写 settings 带一次冲突重试（用户同时改配置时不抢，放弃并告警）。
- *  冲突判定双条件：instanceof 覆盖同版本副本；error.code 覆盖跨版本副本
- *  （插件自带 rc.7 依赖与 host rc.8 抛错时 instanceof 为 false）。 */
+/** 写 settings 带一次冲突重试（用户同时改配置时不抢，放弃并告警）。 */
 async function writeWithRetry(write: () => Promise<void>): Promise<void> {
   try {
     await write()
   } catch (error) {
-    const conflict =
-      error instanceof SettingsConflictError ||
-      (typeof error === 'object' &&
-        error !== null &&
-        (error as { code?: unknown }).code === 'SETTINGS_CONFLICT')
-    if (!conflict) throw error
+    if (!(error instanceof SettingsConflictError)) throw error
     await write()
   }
 }
@@ -225,8 +235,16 @@ export function installLlmFallback(ctx: Context, deps: FallbackDeps): void {
     }
     const translated = translateProviders(providers)
     const fbProvider = `${provider}${FALLBACK_SUFFIX}`
-    await writeWithRetry(() => writes.update(NS_PI_AI, { providers: translated }))
-    await writeWithRetry(() => writes.update(NS_AGENT_DEFAULT, { provider: fbProvider, model }))
+    try {
+      // 官方 llm-pi-ai 的 installSettingsSection 注册了 validate（assertServiceable），
+      // 写时拒绝不适配的翻译结果；update 无 expectedRevision 本就无条件写，不做冲突
+      // 重试——失败一律分类为「翻译失败」。
+      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,
@@ -306,5 +324,9 @@ export function installLlmFallback(ctx: Context, deps: FallbackDeps): void {
   ctx.root.on('settings/updated' as never, (ns: unknown) => {
     if (typeof ns === 'string' && WATCHED_NS.has(ns)) run()
   })
-  ctx.root.on('llm/adapters-updated' as never, run)
+  // 事件名已核对：master 0.1.2-alpha.1 的 dsh-llm 保留 'llm/adapters-updated'
+  // （packages/llm/llm/src/types.ts:23 module augmentation，index.ts:344 于每次
+  // adapter 注册/注销提交点 dispatch）；@deepseek-ai/dsh-llm 的类型导入已携带该
+  // 声明，无需 as never。
+  ctx.root.on('llm/adapters-updated', run)
 }

package/src/health-api.ts

@@ -3,6 +3,7 @@
  * - GET  /dsh-plus/lifeboat/status  → journal + 翻译状态 + 当前用户 patch 层已禁用的 dsh-plus 插件
  * - POST /dsh-plus/lifeboat/restore {name} → removeDisable + journal + 告警
  * rc8 用户 patch 层热应用：恢复无需重启，watchUserPatches 即时重载。
+ * （0.1.2-alpha.1 基线：用户 patch 层热应用机制保留，行为不变。）
  * @module lifeboat/health-api
  */
 import { readFile } from 'node:fs/promises'
@@ -106,7 +107,7 @@ export function registerHealthApi(ctx: Context, deps: HealthDeps): void {
         deps.alert(
           '[DSH] 插件恢复',
           `插件 ${body.name} 的隔离已解除（移除 patch 层禁用覆盖）。${
-            written ? 'rc8 热应用即时生效，无需重启。' : 'patch 层本无覆盖，可能已被手动恢复。'
+            written ? 'patch 层热应用即时生效，无需重启。' : 'patch 层本无覆盖，可能已被手动恢复。'
           }`,
         )
         sendJson(res, 200, { ok: true, written })