@dsh-plus/lifeboat 0.2.30 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/lifeboat",
-  "version": "0.2.30",
+  "version": "0.3.1",
   "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.35"
+    "@dsh-plus/shared": "0.1.36"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",

package/src/client/health-styles.ts

@@ -12,8 +12,10 @@ export const healthCss = `
 .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}

package/src/client/health-tab.tsx

@@ -1,6 +1,6 @@
 /**
  * lifeboat 健康页：settings.plugins.tab 第三页「救生艇」。
- * - 应急翻译状态 banner（激活中显示源路由/临时路由/时间）
+ * - 官方应急副本状态卡片（路径/生成时间/覆盖 route/警告 + 应用指引）
  * - 已隔离插件卡片 + 「恢复」按钮（两段确认）
  * - journal 时间线（kind 徽标着色）
  * - dsh-plus 兄弟插件状态点（pluginInventory.list）
@@ -20,17 +20,18 @@ interface JournalEntry {
   detail: string
 }
 
-interface FallbackState {
-  active: boolean
-  originalProvider: string
-  originalModel: string
-  fallbackProvider: string
-  at: string
+interface CopyState {
+  path: string
+  exists: boolean
+  updatedAt?: number
+  routes?: number
+  warnings: string[]
+  detail?: string
 }
 
 interface StatusResponse {
   journal: JournalEntry[]
-  llmFallback: FallbackState | null
+  officialCopy?: CopyState
   quarantined: string[]
 }
 
@@ -77,16 +78,19 @@ const KIND_STYLES: Record<string, string> = {
   alert: 'dlb-kindAlert',
   quarantine: 'dlb-kindQuarantine',
   'quarantine-restore': 'dlb-kindRestore',
-  'llm-fallback': 'dlb-kindFallback',
-  'llm-fallback-revert': 'dlb-kindRestore',
+  'llm-copy-guide': 'dlb-kindFallback',
 }
 
 const 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: '恢复中…',
@@ -106,10 +110,14 @@ const zhDict = {
 
 const 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…',
@@ -128,6 +136,41 @@ const enDict = {
   restoreFailed: 'Restore failed: ',
 }
 
+/** 官方应急副本状态卡片（纯展示：路径/生成时间/覆盖 route/警告 + 应用指引）。 */
+function CopyStatusCard(props: { copy: CopyState; t(key: string): string }): ReactElement {
+  const { copy, t } = props
+  const generated =
+    copy.updatedAt === undefined
+      ? t('copyMissing')
+      : new Date(copy.updatedAt).toISOString().slice(0, 19).replace('T', ' ')
+  return (
+    <div className="dlb-copy" role="status">
+      <p className="dlb-copyTitle">{t('copyTitle')}</p>
+      <div className="dlb-kv">
+        <span>{t('copyPath')}</span>
+        <code>{copy.path}</code>
+      </div>
+      <div className="dlb-kv">
+        <span>{t('copyAt')}</span>
+        <code>{generated}</code>
+      </div>
+      {copy.routes !== undefined ? (
+        <div className="dlb-kv">
+          <span>{t('copyRoutes')}</span>
+          <code>{copy.routes}</code>
+        </div>
+      ) : null}
+      {copy.detail !== undefined ? <p className="dlb-copyWarning">{copy.detail}</p> : null}
+      {copy.warnings.map((warning) => (
+        <p className="dlb-copyWarning" key={warning}>
+          {`${t('copyWarning')}：${warning}`}
+        </p>
+      ))}
+      <p className="dlb-copyHint">{t('copyApplyHint')}</p>
+    </div>
+  )
+}
+
 function HealthTab(props: { t(key: string): string }): ReactElement {
   const { t } = props
   const [status, setStatus] = useState<StatusResponse | null>(null)
@@ -196,24 +239,8 @@ function HealthTab(props: { t(key: string): string }): ReactElement {
         </p>
       ) : null}
 
-      {status.llmFallback?.active === true ? (
-        <div className="dlb-fallback" role="status">
-          <p className="dlb-fallbackTitle">{t('fallbackActive')}</p>
-          <div className="dlb-kv">
-            <span>{t('fallbackFrom')}</span>
-            <code>
-              {status.llmFallback.originalProvider}/{status.llmFallback.originalModel}
-            </code>
-          </div>
-          <div className="dlb-kv">
-            <span>{t('fallbackTo')}</span>
-            <code>{status.llmFallback.fallbackProvider}</code>
-          </div>
-          <div className="dlb-kv">
-            <span>{t('fallbackAt')}</span>
-            <code>{status.llmFallback.at.slice(0, 19).replace('T', ' ')}</code>
-          </div>
-        </div>
+      {status.officialCopy !== undefined ? (
+        <CopyStatusCard copy={status.officialCopy} t={t} />
       ) : null}
 
       <h3 className="dlb-title">{t('quarantined')}</h3>

package/src/config.ts

@@ -17,10 +17,6 @@ export const Config = z.object({
       '隔离写入的 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(300000),
 })
 
@@ -32,13 +28,3 @@ export interface JournalEntryT {
   kind: string
   detail: string
 }
-
-/** LLM 应急翻译的持久状态（还原依据；纯类型，磁盘收窄见 state-file.ts）。 */
-export interface FallbackStateT {
-  active: boolean
-  originalProvider: string
-  originalModel: string
-  fallbackProvider: string
-  providers: string[]
-  at: string
-}

package/src/copy-guide.ts

@@ -0,0 +1,153 @@
+/**
+ * LLM 应急副本指引：默认模型的 provider 无已注册 adapter 时（典型场景：llm-pi
+ * 被隔离/加载失败），读取 @dsh-plus/llm-pi 常备的官方应急副本并告警指引应用
+ * 方式（--patch 单次启动，或并入 profile 的 cordis.patch.yml 热应用）。
+ *
+ * 只告警不写：配置面的唯一写者是 llm-pi 与用户，救生艇不碰配置文件——
+ * 旧「出错时自动改写配置」因不稳定、常无效已移除，指引把操作交还给人。
+ *
+ * 评估时机：启动宽限（兄弟插件就绪竞态）结束后一次 + 默认模型配置变化 /
+ * adapter 集变化事件；平时零开销。同一指引受 alertCooldownMs 冷却（内存态，
+ * 重启复位——告警是提示不是状态）。
+ * @module lifeboat/copy-guide
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import type {} from '@deepseek-ai/dsh-llm'
+import type {} from '@deepseek-ai/dsh-settings'
+
+import type { Alerter } from './notify.ts'
+import { type OfficialCopyStatus, readOfficialCopyStatus } from './official-copy-status.ts'
+
+/** 默认模型的 settings 命名空间（dsh 官方 agent 区）。 */
+const NS_AGENT_DEFAULT = 'agent-default-model'
+
+/** 启动宽限（ms）：llm-pi 等兄弟插件的 adapter 注册晚于 lifeboat 就绪，宽限内
+ *  不评估，避免把「还没加载」误判为「缺席」而每次重启都误发告警。 */
+export const BOOT_GRACE_MS = 60_000
+
+export interface CopyGuideDeps {
+  journal: (kind: string, detail: string) => void
+  alert: Alerter
+  /** 副本状态读取（缺省读契约路径；测试注入固定值）。 */
+  readCopy?: () => Promise<OfficialCopyStatus>
+  /** 来源 profile（告警里的应用命令；非 dsh 启动时缺省占位）。 */
+  profile: string | undefined
+  /** 同一指引告警的最小间隔毫秒数。 */
+  cooldownMs: number
+}
+
+/** 默认模型的 provider（settings describe 平面视图；未配置返回 undefined）。 */
+function defaultProvider(ctx: Context): string | undefined {
+  const value = ctx.settings.describe().find((row) => row.ns === NS_AGENT_DEFAULT)?.value
+  return (value as { provider?: unknown } | undefined)?.provider as string | undefined
+}
+
+/** 生成时间文案（副本不含时间戳，mtime 即生成时间）。 */
+function generatedText(copy: OfficialCopyStatus): string {
+  if (copy.updatedAt === undefined) return '生成时间未知'
+  return new Date(copy.updatedAt).toISOString().slice(0, 19).replace('T', ' ')
+}
+
+/** 副本指引结果（journal 措辞用）。 */
+type GuideOutcome = 'ready' | 'missing' | 'empty'
+
+/** 副本缺失：应用无从谈起，先恢复 llm-pi 侧的生成能力。 */
+function alertMissing(copy: OfficialCopyStatus, provider: string, deps: CopyGuideDeps): void {
+  deps.alert(
+    '[DSH] LLM 应急副本缺失',
+    `默认模型的 provider "${provider}" 没有已注册 adapter，且官方应急副本 ${copy.path} 不存在（dsh-plus-llm-pi 未生成或已被删除）。先恢复 dsh-plus-llm-pi 让它生成副本，或手动修复 LLM 配置。`,
+  )
+}
+
+/** 副本存在但为空：应用无效果，先修 llm-pi 配置并等待重新生成。 */
+function alertEmpty(copy: OfficialCopyStatus, provider: string, deps: CopyGuideDeps): void {
+  deps.alert(
+    '[DSH] LLM 应急副本为空',
+    `默认模型的 provider "${provider}" 没有已注册 adapter；应急副本 ${copy.path} 存在但无任何 route（llm-pi 未配置或全部不可服务），应用无效果。先修复 dsh-plus-llm-pi 配置并等待副本重新生成。`,
+  )
+}
+
+/** 就绪副本的应用指引告警。 */
+function alertReady(copy: OfficialCopyStatus, provider: string, deps: CopyGuideDeps): void {
+  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: OfficialCopyStatus, provider: string, deps: CopyGuideDeps): GuideOutcome {
+  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: GuideOutcome, routes: number): string {
+  if (outcome === 'ready') return `可应用（${routes} 个 route）`
+  if (outcome === 'missing') return '缺失'
+  return '为空'
+}
+
+/** 装配副本指引：宽限结束后及事件触发评估（并发合并、告警带冷却）。 */
+export function installCopyGuide(
+  ctx: Context,
+  deps: CopyGuideDeps,
+  graceMs: number = BOOT_GRACE_MS,
+): void {
+  const logger = ctx.logger('lifeboat')
+  const readCopy = deps.readCopy ?? (() => readOfficialCopyStatus())
+  let inFlight: Promise<void> | undefined
+  // -Infinity 而非 0：首个事件必须能越过冷却闸（mock 时钟下 Date.now() 从 0 起算）。
+  let lastAlertAt = Number.NEGATIVE_INFINITY
+  const startedAt = Date.now()
+
+  async function evaluate(): Promise<void> {
+    const provider = defaultProvider(ctx)
+    if (provider === undefined) return // 未配置默认模型：无从判定缺席
+    if (ctx.llm.listProviders().some((item) => item.id === provider)) return // LLM 正常
+    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 = (): void => {
+    if (Date.now() - startedAt < graceMs) return
+    if (inFlight !== undefined) return
+    inFlight = evaluate()
+      .catch((error: unknown) => {
+        const message = error instanceof Error ? error.message : String(error)
+        logger.warn(`副本指引评估失败: ${message}`)
+        deps.journal('llm-copy-guide-error', message)
+      })
+      .finally(() => {
+        inFlight = undefined
+      })
+  }
+
+  const bootTimer = setTimeout(run, graceMs)
+  ctx.effect(() => () => clearTimeout(bootTimer), 'lifeboat: copy guide boot timer')
+  // 只响应默认模型配置变化：journal 写自身数据，不过滤会自触发循环。
+  ctx.root.on('settings/document-updated', (ns: unknown) => {
+    if (ns === NS_AGENT_DEFAULT) run()
+  })
+  // 事件名已核对：dsh-llm 在每次 adapter 注册/注销提交点派发（module augmentation
+  // 声明随 @deepseek-ai/dsh-llm 类型导入携带，无需 as never）。
+  ctx.root.on('llm/adapters-updated', () => run())
+}

package/src/health-api.ts

@@ -1,9 +1,8 @@
 /**
  * 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
  */
 import { readFile } from 'node:fs/promises'
@@ -12,6 +11,7 @@ import type { Context } from '@deepseek-ai/cordis'
 import type {} from '@deepseek-ai/dsh-host-webserver'
 import { parseDocument } from 'yaml'
 import type { Alerter } from './notify.ts'
+import type { OfficialCopyStatus } from './official-copy-status.ts'
 import { listDisabled, type PatchEntry, removeDisable } from './patch-file.ts'
 import { isGuardedPlugin } from './quarantine.ts'
 
@@ -22,15 +22,10 @@ export interface HealthDeps {
   patchFile: string
   journal: (kind: string, detail: string) => void
   alert: Alerter
-  /** journal 文档（settings 命名空间内，最新在前的尾插列表）。 */
+  /** journal 文档（最新在前的尾插列表）。 */
   readJournal(): Array<{ at: string; kind: string; detail: string }>
-  readFallback(): {
-    active: boolean
-    originalProvider: string
-    originalModel: string
-    fallbackProvider: string
-    at: string
-  } | null
+  /** 官方应急副本状态（每次 status 请求现读，mtime 即生成时间）。 */
+  readCopy(): Promise<OfficialCopyStatus>
 }
 
 function sendJson(res: ServerResponse, status: number, body: unknown): void {
@@ -72,7 +67,7 @@ export function registerHealthApi(ctx: Context, deps: HealthDeps): void {
         const quarantined = await readQuarantined(deps.patchFile)
         sendJson(res, 200, {
           journal: deps.readJournal(),
-          llmFallback: deps.readFallback(),
+          officialCopy: await deps.readCopy(),
           quarantined,
         })
       } catch (error) {

package/src/index.ts

@@ -4,15 +4,17 @@
  * 1. 故障隔离——兄弟 dsh-plus 插件 fiber FAILED 时（host 侧直接监听，浏览器侧
  *    经哨兵回报），向 profile 用户 patch 层写入 disabled 覆盖；重启/刷新后
  *    失败插件缺席、其余正常，修复后删覆盖即恢复。
- * 2. LLM 应急翻译——默认模型 provider 无 adapter 时，把 dsh-plus-llm-pi 配置
- *    临时翻译为官方 llm-pi-ai 路由并切换默认模型，恢复后自动还原。
+ * 2. LLM 应急指引——默认模型 provider 无 adapter 时，读取 @dsh-plus/llm-pi
+ *    常备的官方应急副本（$DSH_HOME/llm-pi.official-patch.yaml）并告警指引
+ *    应用方式；只告警不写（旧「自动改写配置」不稳定、常无效，已移除）。
  * 3. 告警与 journal——一切动作记录进运行期状态文件（state-file.ts），并经
  *    notify-email 发邮件（缺席降级为日志）。
  *
  * 零 dsh-plus 内部依赖铁律：不 import 本仓库任何其他包，防止共享代码故障团灭。
+ * 应急副本经文件契约同路径消费（见 official-copy-status.ts）。
  *
- * 接线约束：inject 声明须覆盖本模块全部 ctx.<service> 直接访问（fallback-llm
- * 读 settings 命名空间与 llm.listProviders），漏掉任一即运行期
+ * 接线约束：inject 声明须覆盖本模块全部 ctx.<service> 直接访问——settings
+ * （copy-guide 读默认模型条目）与 llm（判定 provider 缺席），漏掉任一即运行期
  * "cannot get property without inject" → 插件树加载失败 → dsh boot 中止。
  * 可选事实（profileContext）经 ctx.get 读取，缺失即降级而非失败。
  * @module @dsh-plus/lifeboat
@@ -22,10 +24,11 @@ import type { Context } from '@deepseek-ai/cordis'
 // CLI 与桌面端经同一 profile-boot 提供）。纯类型导入，按开发规范仅需 devDeps。
 import type {} from '@deepseek-ai/dsh-app-boot'
 
-import { Config, type FallbackStateT, type LifeboatConfig } from './config.ts'
-import { installLlmFallback } from './fallback-llm.ts'
+import { Config, type LifeboatConfig } from './config.ts'
+import { installCopyGuide } from './copy-guide.ts'
 import { registerHealthApi } from './health-api.ts'
 import { installAlerter } from './notify.ts'
+import { readOfficialCopyStatus } from './official-copy-status.ts'
 import { createQuarantine, installHostWatch } from './quarantine.ts'
 import { registerQuarantineApi } from './quarantine-api.ts'
 import { appendJournal, loadState, type StateDoc, saveState } from './state-file.ts'
@@ -51,10 +54,10 @@ export function resolvePatchFile(ctx: Context, config: LifeboatConfig): string |
 export function apply(ctx: Context, config: LifeboatConfig): void {
   const logger = ctx.logger('lifeboat')
 
-  // 运行期状态（journal + 翻译状态）：文件持久化。加载失败降级为内存态
-  // （重启丢失 journal，但隔离/翻译功能仍在）。
+  // 运行期状态（journal）：文件持久化。加载失败降级为内存态
+  // （重启丢失 journal，但隔离/告警功能仍在）。
   const warn = (message: string): void => logger.warn(message)
-  let doc: StateDoc = { journal: [], llmFallback: null }
+  let doc: StateDoc = { journal: [] }
   void loadState().then((loaded) => {
     doc = loaded
   })
@@ -66,11 +69,19 @@ export function apply(ctx: Context, config: LifeboatConfig): void {
 
   const alert = installAlerter(ctx, journal)
 
+  // LLM 应急副本指引：只读判定 + 告警，不依赖 patch 文件，独立于隔离开关。
+  installCopyGuide(ctx, {
+    journal,
+    alert,
+    profile: ctx.get('profileContext')?.name,
+    cooldownMs: config.alertCooldownMs,
+  })
+
   if (config.enabled) {
     const patchFile = resolvePatchFile(ctx, config)
     if (patchFile === undefined) {
       // 无 profileContext 的组合树（非 dsh 启动）：不猜路径、不写任何 patch，
-      // 隔离停用但告警/journal/LLM 应急翻译照常（它们不依赖 patch 文件）。
+      // 隔离停用但告警/journal 照常。
       warn('故障隔离停用：当前组合树无 profileContext，无法定位 profile 用户 patch 层')
     } else {
       const quarantine = createQuarantine(ctx, {
@@ -87,21 +98,9 @@ export function apply(ctx: Context, config: LifeboatConfig): void {
           journal,
           alert,
           readJournal: () => doc.journal,
-          readFallback: () => doc.llmFallback,
+          readCopy: () => readOfficialCopyStatus(),
         })
       })
     }
   }
-
-  if (config.llmFallback) {
-    installLlmFallback(ctx, {
-      journal,
-      alert,
-      readState: () => doc.llmFallback,
-      writeState: async (state: FallbackStateT | null) => {
-        doc = { ...doc, llmFallback: state }
-        await saveState(doc, warn)
-      },
-    })
-  }
 }

package/src/official-copy-status.ts

@@ -0,0 +1,100 @@
+/**
+ * 官方应急副本的只读状态读取（$DSH_HOME/llm-pi.official-patch.yaml）。
+ *
+ * 文件契约与 @dsh-plus/llm-pi 同路径：对方常备副本、本包只读消费——零
+ * dsh-plus 内部依赖铁律下不 import 对方实现，路径按契约文件名同源派生。
+ * 读取一切失败都降级为结构化状态（面板展示与告警文案的输入，绝不抛出）。
+ * @module lifeboat/official-copy-status
+ */
+import { readFile, stat } from 'node:fs/promises'
+
+import { dshHomePath } from '@deepseek-ai/dsh-home-paths'
+import { parse } from 'yaml'
+
+/** 副本文件名（跨包文件契约：llm-pi 写、本包读，改名须两侧同步）。 */
+export const OFFICIAL_COPY_FILE = 'llm-pi.official-patch.yaml'
+
+/** 解析上限：超出只报存在性与时间，不读内容（面板/告警不得被大文件拖垮）。 */
+const MAX_BYTES = 2 * 1024 * 1024
+
+/** 头注释里的生成警告行前缀（llm-pi 渲染约定）。 */
+const WARNING_PREFIX = '# 警告：'
+
+export interface OfficialCopyStatus {
+  path: string
+  exists: boolean
+  /** mtime 毫秒 = 最近生成时间（副本内容不含时间戳）。 */
+  updatedAt?: number
+  /** llm-pi-ai 覆盖的 provider 数；不可解析时缺省。 */
+  routes?: number
+  /** 头注释里的生成警告。 */
+  warnings: string[]
+  /** 存在但无法解析/超限时的说明。 */
+  detail?: string
+}
+
+/** 副本契约路径（默认读取点）。 */
+export function officialCopyPath(): string {
+  return dshHomePath(OFFICIAL_COPY_FILE)
+}
+
+/** 解析副本内容（纯函数）：头注释警告 + llm-pi-ai 行的 providers 数。 */
+export function parseCopyText(
+  text: string,
+): Pick<OfficialCopyStatus, 'routes' | 'warnings' | 'detail'> {
+  const warnings = text
+    .split('\n')
+    .filter((line) => line.startsWith(WARNING_PREFIX))
+    .map((line) => line.slice(WARNING_PREFIX.length))
+  let rows: unknown
+  try {
+    rows = parse(text)
+  } catch (error) {
+    return {
+      warnings,
+      detail: `解析失败：${error instanceof Error ? error.message : String(error)}`,
+    }
+  }
+  if (!Array.isArray(rows)) return { warnings, detail: '内容不是 patch 列表' }
+  if (rows.length === 0) return { routes: 0, warnings }
+  const row = rows.find((entry) => (entry as { id?: unknown } | null)?.id === 'llm-pi-ai') as
+    | { config?: { providers?: unknown } }
+    | undefined
+  const providers = row?.config?.providers
+  if (providers === null || typeof providers !== 'object') {
+    return { warnings, detail: '缺 llm-pi-ai 配置行（副本可能只含禁用行）' }
+  }
+  return { routes: Object.keys(providers).length, warnings }
+}
+
+/** 读取副本状态；缺失/损坏/超限均降级为结构化状态，不抛出。 */
+export async function readOfficialCopyStatus(
+  path: string = officialCopyPath(),
+): Promise<OfficialCopyStatus> {
+  let size: number
+  let mtimeMs: number
+  try {
+    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: OfficialCopyStatus = {
+    path,
+    exists: true,
+    updatedAt: Math.trunc(mtimeMs),
+    warnings: [],
+  }
+  if (size > MAX_BYTES) return { ...base, detail: '文件超出解析上限，未读取内容' }
+  try {
+    const text = await readFile(path, 'utf-8')
+    return { ...base, ...parseCopyText(text) }
+  } catch (error) {
+    return {
+      ...base,
+      detail: `读取失败：${error instanceof Error ? error.message : String(error)}`,
+    }
+  }
+}