@dsh-plus/lifeboat 0.2.2 → 0.2.4

package/lib/index.js

@@ -164,12 +164,19 @@ async function writeWithRetry(write) {
 		await write();
 	}
 }
-/** 装配 LLM 应急翻译：启动后及 settings/llm 变化时评估一次（并发合并）。 */
-function installLlmFallback(ctx, deps) {
+/** 启动宽限（ms）：llm-pi 等兄弟插件的 adapter 注册晚于 lifeboat 就绪，
+*  启动竞态下立即评估会把"还没加载"误判为"缺席"——每次重启都误发
+*  「应急翻译 + 已还原」两条通知。宽限期内一律不评估，宽限结束自动评估
+*  一次，事件订阅覆盖后续变化；真故障（llm-pi 缺席）在宽限后照常告警。 */
+const BOOT_GRACE_MS = 6e4;
+/** 装配 LLM 应急翻译：启动宽限结束后及 settings/llm 变化时评估一次（并发合并）。 */
+function installLlmFallback(ctx, deps, graceMs = BOOT_GRACE_MS) {
 	const logger = ctx.logger("lifeboat");
 	const writes = ctx.settings;
 	const settingsFile = dshHomePath("settings.yaml");
 	let inFlight;
+	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;
@@ -227,6 +234,7 @@ function installLlmFallback(ctx, deps) {
 		await activate(def.provider, def.model);
 	}
 	const run = () => {
+		if (withinGrace()) return;
 		if (inFlight !== void 0) return;
 		inFlight = evaluate().catch((error) => {
 			const message = error instanceof Error ? error.message : String(error);
@@ -236,7 +244,7 @@ function installLlmFallback(ctx, deps) {
 			inFlight = void 0;
 		});
 	};
-	const bootTimer = setTimeout(run, 1e4);
+	const bootTimer = setTimeout(run, graceMs);
 	ctx.effect(() => () => clearTimeout(bootTimer), "lifeboat: fallback boot timer");
 	ctx.on("ready", run);
 	const WATCHED_NS = /* @__PURE__ */ new Set([

package/lib/style.css

@@ -1,4 +1,4 @@
-.IDEaOG_block {
+.obLtqa_block {
   --dsl-diff-radius: 12px;
   --dsl-diff-line-height: 22px;
   color: var(--dsw-alias-label-primary);
@@ -8,7 +8,7 @@
   position: relative;
 }
 
-.IDEaOG_copyButton {
+.obLtqa_copyButton {
   z-index: 1;
   color: var(--dsw-alias-label-secondary);
   cursor: pointer;
@@ -22,46 +22,46 @@
   right: 12px;
 }
 
-.IDEaOG_body {
+.obLtqa_body {
   font: var(--dsw-font-markdown-code-block);
   padding: 12px 14px;
   overflow: auto hidden;
 }
 
-.IDEaOG_line {
+.obLtqa_line {
   min-height: var(--dsl-diff-line-height);
   white-space: pre;
 }
 
-.IDEaOG_path {
+.obLtqa_path {
   color: var(--dsw-alias-label-primary);
   padding-right: 56px;
   font-weight: 600;
 }
 
-.IDEaOG_gap {
+.obLtqa_gap {
   color: var(--dsw-alias-label-tertiary);
 }
 
-.IDEaOG_del:before {
+.obLtqa_del:before {
   content: "- ";
   color: var(--dsw-alias-state-error-primary);
 }
 
-.IDEaOG_del {
+.obLtqa_del {
   color: var(--dsw-alias-state-error-primary);
 }
 
-.IDEaOG_add:before {
+.obLtqa_add:before {
   content: "+ ";
   color: var(--dsw-alias-state-success-primary);
 }
 
-.IDEaOG_add {
+.obLtqa_add {
   color: var(--dsw-alias-state-success-primary);
 }
 
-.IDEaOG_expand {
+.obLtqa_expand {
   width: 100%;
   color: var(--dsw-alias-label-tertiary);
   cursor: pointer;
@@ -73,16 +73,16 @@
   display: block;
 }
 
-.IDEaOG_expand:hover {
+.obLtqa_expand:hover {
   color: var(--dsw-alias-label-secondary);
 }
 
-.IDEaOG_footer {
+.obLtqa_footer {
   font: var(--dsw-font-markdown-code-block);
   color: var(--dsw-alias-label-tertiary);
   padding: 0 14px 12px;
 }
-.xeLGkW_block {
+.folzqq_block {
   --dsl-code-block-banner-background-color: var(--dsw-alias-markdown-code-block-banner);
   --dsl-code-block-border-radius: 12px;
   --dsl-code-block-banner-font: 11px/18px var(--dsw-font-family);
@@ -94,11 +94,11 @@
   position: relative;
 }
 
-.xeLGkW_block:not(:last-child) {
+.folzqq_block:not(:last-child) {
   margin-bottom: 11px;
 }
 
-.xeLGkW_bannerWrap {
+.folzqq_bannerWrap {
   z-index: 6;
   background-color: var(--dsw-alias-bg-base);
   border-top-left-radius: var(--dsl-code-block-border-radius);
@@ -107,7 +107,7 @@
   top: 0;
 }
 
-.xeLGkW_banner {
+.folzqq_banner {
   background: var(--dsl-code-block-banner-background-color);
   font: var(--dsl-code-block-banner-font);
   border-top-left-radius: var(--dsl-code-block-border-radius);
@@ -119,7 +119,7 @@
   display: flex;
 }
 
-.xeLGkW_infostring {
+.folzqq_infostring {
   color: var(--dsw-alias-label-primary);
   font-family: var(--ds-font-family-code);
   text-overflow: ellipsis;
@@ -130,13 +130,13 @@
   overflow: hidden;
 }
 
-.xeLGkW_action {
+.folzqq_action {
   flex-shrink: 0;
   align-items: center;
   display: flex;
 }
 
-.xeLGkW_copyButton {
+.folzqq_copyButton {
   color: inherit;
   cursor: pointer;
   font: inherit;
@@ -146,7 +146,7 @@
   padding: 0;
 }
 
-.xeLGkW_block :where(pre) {
+.folzqq_block :where(pre) {
   font: var(--dsl-code-block-content-font);
   white-space: pre-wrap;
   word-break: break-all;
@@ -158,155 +158,166 @@
   margin: 0 !important;
 }
 
-.xeLGkW_block :where(pre.xeLGkW_shiki) {
+.folzqq_block :where(pre.folzqq_shiki) {
   background: var(--dsw-alias-markdown-code-block) !important;
 }
 
-.xeLGkW_block :where(pre) code {
+.folzqq_block :where(pre) code {
   font: inherit;
   background: none;
   padding: 0;
 }
 
-.xeLGkW_plain {
+.folzqq_plain {
   color: var(--dsw-alias-label-primary);
 }
-.Ns7beW_markdown {
+.vrxa6G_markdown {
   overflow-wrap: anywhere;
   min-width: 0;
   font: var(--dsw-font-markdown-base);
   color: var(--dsw-alias-label-primary);
 }
 
-.Ns7beW_markdown strong {
+.vrxa6G_markdown strong {
   font-weight: 600;
 }
 
-.Ns7beW_markdown h1 {
+.vrxa6G_markdown h1 {
   font: var(--dsw-font-markdown-h1);
   margin: 32px 0 16px;
 }
 
-.Ns7beW_markdown h2 {
+.vrxa6G_markdown h2 {
   font: var(--dsw-font-markdown-h2);
   margin: 32px 0 16px;
 }
 
-.Ns7beW_markdown h3 {
+.vrxa6G_markdown h3 {
   font: var(--dsw-font-markdown-h3);
   margin: 32px 0 16px;
 }
 
-.Ns7beW_markdown h4 {
+.vrxa6G_markdown h4 {
   font: var(--dsw-font-markdown-h4);
   margin: 16px 0;
 }
 
-.Ns7beW_markdown :where(h5, h6) {
+.vrxa6G_markdown :where(h5, h6) {
   font: var(--dsw-font-markdown-base-strong);
   margin: 16px 0;
 }
 
-.Ns7beW_markdown :where(h1, h2, h3, h4, h5, h6) strong {
+.vrxa6G_markdown :where(h1, h2, h3, h4, h5, h6) strong {
   font-weight: inherit;
 }
 
-.Ns7beW_markdown p {
+.vrxa6G_markdown p {
   margin: 16px 0;
 }
 
-.Ns7beW_markdown :where(h4, h5, h6) + :where(ul, ol) {
+.vrxa6G_markdown :where(h4, h5, h6) + :where(ul, ol) {
   margin-top: 8px;
 }
 
-.Ns7beW_markdown :where(h4, h5, h6):has( + :where(ul, ol)) {
+.vrxa6G_markdown :where(h4, h5, h6):has( + :where(ul, ol)) {
   margin-bottom: 8px;
 }
 
-.Ns7beW_markdown a {
-  color: var(--dsw-alias-state-business-primary);
+.vrxa6G_markdown a {
+  color: var(--dsw-alias-link);
   transition: box-shadow var(--ds-transition-duration) var(--ds-ease-in-out);
   border: 2px solid #fff0;
   border-width: 2px 3px;
   margin-left: -3px;
   margin-right: -3px;
+  font-weight: 500;
   text-decoration: none;
   position: relative;
 }
 
-.Ns7beW_markdown a:hover, .Ns7beW_markdown a:focus {
-  text-decoration: underline var(--dsw-alias-state-business-primary);
+.vrxa6G_markdown a:hover, .vrxa6G_markdown a:focus {
+  text-decoration: underline dotted var(--dsw-alias-link);
+  text-underline-offset: 3px;
   outline: none;
 }
 
-.Ns7beW_markdown a:focus-visible {
+.vrxa6G_markdown a:focus-visible {
   box-shadow: 0 0 0 2px var(--dsw-alias-state-business-primary);
 }
 
-.Ns7beW_markdown :where(ul, ol) {
+.vrxa6G_linkIcon {
+  vertical-align: -.25em;
+  flex: none;
+  width: 1.1em;
+  height: 1.1em;
+  margin-right: 5px;
+}
+
+.vrxa6G_markdown :where(ul, ol) {
   margin: 16px 0;
   padding-left: 18px;
 }
 
-.Ns7beW_markdown li:not(:first-child) {
+.vrxa6G_markdown li:not(:first-child) {
   margin-top: 6px;
 }
 
-.Ns7beW_markdown li > :where(ul, ol) {
+.vrxa6G_markdown li > :where(ul, ol) {
   margin-top: 4px;
 }
 
-.Ns7beW_markdown li::marker {
+.vrxa6G_markdown li::marker {
   color: var(--dsw-alias-label-secondary);
   line-height: 24px;
 }
 
-.Ns7beW_markdown :where(ul, ol) ol {
+.vrxa6G_markdown :where(ul, ol) ol {
   padding-left: 0;
   list-style-position: inside;
 }
 
-.Ns7beW_markdown :where(ul, ol) ol li p {
+.vrxa6G_markdown :where(ul, ol) ol li p {
   display: inline;
 }
 
-.Ns7beW_markdown li > p {
+.vrxa6G_markdown li > p {
   margin: 8px 0;
 }
 
-.Ns7beW_markdown li > :first-child {
+.vrxa6G_markdown li > :first-child {
   margin-top: 0;
 }
 
-.Ns7beW_markdown li > :last-child:not(.md-code-block) {
+.vrxa6G_markdown li > :last-child:not(.md-code-block) {
   margin-bottom: 0;
 }
 
-.Ns7beW_markdown hr {
+.vrxa6G_markdown hr {
   background: var(--dsw-alias-border-l2);
   border: none;
-  height: 1px;
+  height: .5px;
   margin: 32px 0;
   display: block;
 }
 
-.Ns7beW_markdown blockquote {
+.vrxa6G_markdown blockquote {
   border-left: 2px solid var(--dsw-alias-label-caption);
   margin: 16px 0 0;
   padding-left: 14px;
 }
 
-.Ns7beW_markdown pre {
+.vrxa6G_markdown pre {
   font-family: var(--ds-font-family-code);
   margin: 16px 0;
   overflow: auto;
 }
 
-.Ns7beW_markdown :not(pre) > code {
+.vrxa6G_markdown :not(pre) > code {
   box-sizing: border-box;
   font: var(--dsw-font-markdown-code);
   font-family: var(--ds-font-family-code);
   background-color: var(--dsw-alias-markdown-inline-code);
+  border: .5px solid var(--dsw-alias-border-l1);
   border-radius: 6px;
   align-items: center;
   padding: 0 5px;
@@ -314,56 +325,56 @@
   font-size: .875em !important;
 }
 
-.Ns7beW_markdown :where(h1, h2, h3, h4, h5, h6) code {
+.vrxa6G_markdown :where(h1, h2, h3, h4, h5, h6) code {
   font: inherit;
   font-family: var(--ds-font-family-code);
 }
 
-.Ns7beW_markdown .katex-display {
+.vrxa6G_markdown .katex-display {
   max-width: 100%;
   overflow: auto hidden;
 }
 
-.Ns7beW_markdown input[type="checkbox"] {
+.vrxa6G_markdown input[type="checkbox"] {
   accent-color: var(--dsw-alias-label-secondary);
   margin: 0 8px 0 0;
 }
 
-.Ns7beW_tableScroll {
+.vrxa6G_tableScroll {
   overscroll-behavior-x: contain;
   max-width: 100%;
   overflow-x: auto;
 }
 
-.Ns7beW_tableScroll.md-table-wide {
+.vrxa6G_tableScroll.md-table-wide {
   padding-bottom: var(--dsh-scrollbar-width, 8px);
   overflow-x: hidden;
 }
 
-.Ns7beW_tableScroll.md-table-wide:hover, .Ns7beW_tableScroll.md-table-wide:focus-visible {
+.vrxa6G_tableScroll.md-table-wide:hover, .vrxa6G_tableScroll.md-table-wide:focus-visible {
   padding-bottom: 0;
   overflow-x: auto;
 }
 
-.Ns7beW_tableScroll:focus-visible {
+.vrxa6G_tableScroll:focus-visible {
   box-shadow: 0 0 0 2px var(--dsw-alias-state-business-primary);
   outline: none;
 }
 
-.Ns7beW_tableScroll table {
+.vrxa6G_tableScroll table {
   border-collapse: collapse;
   width: max-content;
   max-width: max-content;
 }
 
-.Ns7beW_tableFill table {
+.vrxa6G_tableFill table {
   width: 100%;
   max-width: none;
 }
 
-.Ns7beW_tableScroll th {
+.vrxa6G_tableScroll th {
   text-align: start;
-  border-bottom: 1px solid var(--dsw-alias-border-l3);
+  border-bottom: .5px solid var(--dsw-alias-border-l3);
   font: var(--dsw-font-markdown-table-head);
   border-top: none;
   min-width: 100px;
@@ -371,40 +382,40 @@
   padding: 10px 16px;
 }
 
-.Ns7beW_tableScroll td {
-  border-bottom: 1px solid var(--dsw-alias-border-l2);
+.vrxa6G_tableScroll td {
+  border-bottom: .5px solid var(--dsw-alias-border-l2);
   font: var(--dsw-font-markdown-table);
   min-width: 100px;
   max-width: min(30vw, 320px);
   padding: 10px 16px;
 }
 
-.Ns7beW_tableScroll th:first-child, .Ns7beW_tableScroll td:first-child {
+.vrxa6G_tableScroll th:first-child, .vrxa6G_tableScroll td:first-child {
   padding-left: 0;
 }
 
-.Ns7beW_tableScroll td:last-child {
+.vrxa6G_tableScroll td:last-child {
   padding-right: 0;
 }
 
-.Ns7beW_tableScroll table code {
+.vrxa6G_tableScroll table code {
   font-size: 11px;
 }
 
-.Ns7beW_markdown > :first-child, .Ns7beW_markdown p:first-child {
+.vrxa6G_markdown > :first-child, .vrxa6G_markdown p:first-child {
   margin-top: 0 !important;
 }
 
-.Ns7beW_markdown > :last-child, .Ns7beW_markdown p:last-child {
+.vrxa6G_markdown > :last-child, .vrxa6G_markdown p:last-child {
   margin-bottom: 0 !important;
 }
 
-.Ns7beW_imageAlt {
+.vrxa6G_imageAlt {
   color: var(--dsw-alias-label-tertiary);
   font-style: italic;
 }
 
-.Ns7beW_image {
+.vrxa6G_image {
   background: var(--dsw-alias-bg-base);
   object-fit: contain;
   border-radius: 8px;
@@ -415,19 +426,20 @@
   display: block;
 }
 
-.Ns7beW_fileMention {
+.vrxa6G_fileMention {
   font: inherit;
-  color: var(--dsw-alias-state-business-primary);
+  color: var(--dsw-alias-link);
   cursor: pointer;
   background: none;
   border: none;
   margin: 0;
   padding: 0;
+  font-weight: 500;
   text-decoration: none;
 }
 
-.Ns7beW_fileMention:hover, .Ns7beW_fileMention:focus {
-  text-decoration: underline var(--dsw-alias-state-business-primary);
+.vrxa6G_fileMention:hover, .vrxa6G_fileMention:focus {
+  text-decoration: underline dotted var(--dsw-alias-link);
   text-underline-offset: 3px;
   outline: none;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/lifeboat",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "dsh-plus service plugin: 故障救生艇——兄弟插件崩溃时自动隔离（写用户 patch 层禁用），llm-pi 缺席时把其配置临时翻译为官方 llm-pi-ai 路由，恢复后自动还原",
   "type": "module",
   "main": "lib/index.js",
@@ -31,21 +31,21 @@
   },
   "dependencies": {
     "yaml": "^2.9.0",
-    "@dsh-plus/shared": "0.1.8"
+    "@dsh-plus/shared": "0.1.9"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-home-paths": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.3-alpha.2",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-home-paths": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "0.1.3-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.3-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.1.3-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.3-alpha.2",
     "@deepseek-ai/schemastery": "3.18.2",
     "@types/node": "26.4.0",
     "@types/react": "~18.3.31",

package/src/fallback-llm.ts

@@ -211,13 +211,25 @@ export interface FallbackDeps {
   writeState(state: FallbackStateT | null): Promise<void>
 }
 
-/** 装配 LLM 应急翻译：启动后及 settings/llm 变化时评估一次（并发合并）。 */
-export function installLlmFallback(ctx: Context, deps: FallbackDeps): void {
+/** 启动宽限（ms）：llm-pi 等兄弟插件的 adapter 注册晚于 lifeboat 就绪，
+ *  启动竞态下立即评估会把"还没加载"误判为"缺席"——每次重启都误发
+ *  「应急翻译 + 已还原」两条通知。宽限期内一律不评估，宽限结束自动评估
+ *  一次，事件订阅覆盖后续变化；真故障（llm-pi 缺席）在宽限后照常告警。 */
+export const BOOT_GRACE_MS = 60_000
+
+/** 装配 LLM 应急翻译：启动宽限结束后及 settings/llm 变化时评估一次（并发合并）。 */
+export function installLlmFallback(
+  ctx: Context,
+  deps: FallbackDeps,
+  graceMs: number = BOOT_GRACE_MS,
+): void {
   const logger = ctx.logger('lifeboat')
   const settings = ctx.settings as SettingsProvider
   const writes = settings as unknown as SettingsWrite
   const settingsFile = dshHomePath('settings.yaml')
   let inFlight: Promise<void> | undefined
+  const startedAt = Date.now()
+  const withinGrace = (): boolean => Date.now() - startedAt < graceMs
 
   const listProviderIds = (): Set<string> => new Set(ctx.llm.listProviders().map((p) => p.id))
 
@@ -300,6 +312,7 @@ export function installLlmFallback(ctx: Context, deps: FallbackDeps): void {
   }
 
   const run = (): void => {
+    if (withinGrace()) return
     if (inFlight !== undefined) return
     inFlight = evaluate()
       .catch((error: unknown) => {
@@ -312,9 +325,11 @@ export function installLlmFallback(ctx: Context, deps: FallbackDeps): void {
       })
   }
 
-  // 首次评估延迟到启动收尾：lifeboat 首位加载时兄弟插件的 adapter 尚未注册，
-  // 立刻评估会把"还没加载"误判为"缺席"。事件订阅覆盖后续变化。
-  const bootTimer = setTimeout(run, 10_000)
+  // 首次评估延迟到启动宽限结束：lifeboat 首位加载时兄弟插件的 adapter 尚未
+  // 注册（llm-pi 就绪可能远超 10s），提前评估会把"还没加载"误判为"缺席"
+  // （每次重启都误发应急翻译 + 还原通知）。宽限结束评估一次，事件订阅
+  // 覆盖后续变化；宽限内的 settings/llm 事件同样被时间闸跳过，由收尾评估兜底。
+  const bootTimer = setTimeout(run, graceMs)
   ctx.effect(() => () => clearTimeout(bootTimer), 'lifeboat: fallback boot timer')
   ctx.on('ready' as never, run)
   // 只响应与本判定相关的命名空间变化：journal 写自身命名空间，不过滤会自触发循环。