dsh-manage-session 0.2.3 → 0.4.8

package/src/client/health-panel.tsx

@@ -1,5 +1,5 @@
 /**
- * 体检面板：体检（四门）→ 处方（命令清单）→ 出院（可逆处置 + before/after 对照）。
+ * 体检面板：体检（五门）→ 处方（命令清单）→ 出院（可逆处置 + before/after 对照）。
  *
  * 三态流转完全由 host 侧报告驱动，客户端只做展示与触发；重型动作都在 host，
  * 渲染周期内不发同步重活。
@@ -12,6 +12,7 @@ import {
   type HealthReport,
   type HealthScanResponse,
   type HealthSessionResponse,
+  type SourceMigrateResponse,
 } from './host-api.ts'
 import { translate, type LocaleKey } from './locales.ts'
 
@@ -19,10 +20,12 @@ import { translate, type LocaleKey } from './locales.ts'
 export type PanelTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
 
 const GATE_LABEL: Record<HealthGate['id'], LocaleKey> = {
+  'generation': 'health.gate.generation',
   'log-integrity': 'health.gate.log-integrity',
   'projection-cache': 'health.gate.projection-cache',
   'lossless-json': 'health.gate.lossless-json',
   'cold-read': 'health.gate.cold-read',
+  'source-kind': 'health.gate.source-kind',
 }
 
 const LEVEL_LABEL = {
@@ -64,6 +67,9 @@ export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () =>
   const [error, setError] = useState<string | null>(null)
   const [detail, setDetail] = useState<HealthSessionResponse | null>(null)
   const [repairing, setRepairing] = useState(false)
+  const [migrating, setMigrating] = useState(false)
+  /** 署名转换结果提示（一次性；点击转换或返回列表时清除）。 */
+  const [migrateNote, setMigrateNote] = useState<string | null>(null)
   const [discharge, setDischarge] = useState<HealthRepairResponse | null>(null)
   const [copied, setCopied] = useState<string | null>(null)
   /** 分批扫描进度：done = 已访问会话数，total = 语料总数（0 表示尚未拿到分母）。 */
@@ -118,6 +124,7 @@ export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () =>
     setError(null)
     setDetail(null)
     setDischarge(null)
+    setMigrateNote(null)
     setFindings(null)
     setCacheInfo(null)
     setProgress({ done: 0, total: 0 })
@@ -189,6 +196,7 @@ export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () =>
   const openDetail = (sessionId: string): void => {
     setError(null)
     setDischarge(null)
+    setMigrateNote(null)
     void callHostAny<HealthSessionResponse>('session-health-session', { sessionId }, 120_000)
       .then((res) => {
         if (res.ok === true) {
@@ -225,6 +233,31 @@ export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () =>
     } catch { /* 剪贴板不可用时仍然展示命令 */ }
   }
 
+  // 署名转换：仅当 source-kind 门报 warn（v4 日志里观测到旧署名行）时出现。
+  // 成败都回写最新报告；结果提示一次性展示，避免残留误导。
+  const runSourceMigrate = (sessionId: string): void => {
+    setMigrating(true)
+    setError(null)
+    setMigrateNote(null)
+    void callHostAny<SourceMigrateResponse>('session-health-source-migrate', { sessionId }, 120_000)
+      .then((res) => {
+        if (res.after !== undefined) {
+          setDetail({ ok: true, report: res.after, prescriptions: detail?.prescriptions ?? [] })
+          reconcileRow(res.after)
+        }
+        const changed = res.outcome?.changedRows ?? 0
+        if (res.ok === true && changed > 0) {
+          setMigrateNote(translate(t, 'health.sourceMigrated', { n: changed, backup: res.outcome?.backup ?? '' }))
+        } else if (res.ok === true) {
+          setMigrateNote(translate(t, 'health.sourceMigrateNone'))
+        } else {
+          setMigrateNote(translate(t, 'health.sourceMigrateFail', { error: res.outcome?.error ?? res.error ?? '未知原因' }))
+        }
+      })
+      .catch((err: unknown) => setError(String(err instanceof Error ? err.message : err)))
+      .finally(() => setMigrating(false))
+  }
+
   const report = detail?.report ?? discharge?.after
   const lines: (ReactElement | null)[] = []
 
@@ -315,6 +348,9 @@ export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () =>
           .join(' · ')
         return createElement('li', { key: item.sessionId, className: 'dss_row' }, [
           createElement('span', { key: 'lv', className: `dss_levelPill dss_level_${item.level}` }, translate(t, LEVEL_LABEL[item.level])),
+          // 优先级徽标：这些会话的当前代是从迁移暂存（TMP）发布出来的，即本插件
+          // 此前读错产物或完全发现不了的那批。列表按优先级排，再标一次让排序可解释。
+          item.priority === 'high' && createElement('span', { key: 'p', className: 'dss_meta' }, translate(t, 'health.priority.high')),
           createElement('span', { key: 'id', className: 'dss_meta dss_uuid' }, item.sessionId),
           reasons !== '' && createElement('span', { key: 'why', className: 'dss_why' }, reasons),
           createElement('button', {
@@ -344,6 +380,25 @@ export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () =>
         createElement('span', { key: 'tx' }, repairing ? translate(t, 'health.repairing') : translate(t, 'health.repair')),
       ]),
     ]))
+    // 署名转换按钮：只在 source-kind 门报 warn（v4 日志里观测到旧署名行）时出现，
+    // 不随常规处置出现——v3 及更早版本线的旧行由宿主迁移负责，不该一键误触。
+    if (report.gates.some(gate => gate.id === 'source-kind' && gate.level === 'warn')) {
+      lines.push(createElement('div', { key: 'migrate', className: 'dss_phaseRow' }, [
+        createElement('button', {
+          key: 'm',
+          type: 'button',
+          className: 'dss_actBtn',
+          disabled: migrating,
+          onClick: () => { runSourceMigrate(report.sessionId) },
+        }, [
+          migrating ? createElement('span', { key: 'sp', className: 'dss_spinner', 'aria-hidden': 'true' }) : null,
+          createElement('span', { key: 'tx' }, migrating
+            ? translate(t, 'health.sourceMigrating')
+            : translate(t, 'health.sourceMigrate')),
+        ]),
+        migrateNote !== null && createElement('span', { key: 'note', className: 'dss_status' }, migrateNote),
+      ]))
+    }
     const prescriptions = detail?.prescriptions ?? discharge?.prescriptions ?? []
     if (prescriptions.length > 0) {
       lines.push(createElement('div', { key: 'cmds', className: 'dss_cmdBlock' }, [

package/src/client/host-api.ts

@@ -73,6 +73,8 @@ export interface HistoryRow {
   bytes: number
   /** 投影缓存占用字节数。 */
   cacheBytes: number
+  /** 署名转换备份占用字节数（`bytes` 的子集，单列防误读）。 */
+  backupBytes: number
 }
 
 /** 历史文件列表响应。 */
@@ -91,6 +93,8 @@ export interface HistoryPurgeResponse {
   ok: boolean
   purged?: number
   freedBytes?: number
+  /** 一并删除的署名转换备份个数。 */
+  backupsRemoved?: number
   failures?: { sessionId: string; reason: string }[]
   requiresRestart?: boolean
   error?: string
@@ -98,7 +102,7 @@ export interface HistoryPurgeResponse {
 
 /** 一个 gate 的结果（与 host 侧 GateResult 对齐）。 */
 export interface HealthGate {
-  id: 'log-integrity' | 'projection-cache' | 'lossless-json' | 'cold-read'
+  id: 'generation' | 'log-integrity' | 'projection-cache' | 'lossless-json' | 'cold-read' | 'source-kind'
   level: 'ok' | 'warn' | 'fail' | 'skipped'
   evidence: string
   attribution?: { projection?: string; package?: string; field?: string }
@@ -110,6 +114,11 @@ export interface HealthReport {
   sessionId: string
   /** 总判：聚合时 `skipped` 不抬升（见 host 侧 buildSessionReport）。 */
   level: 'ok' | 'warn' | 'fail'
+  /**
+   * 处置优先级（见 host 侧 generation.ts）：`high` = 当前代是从迁移暂存（TMP）发布出来的。
+   * 与 `level` 正交：优先级答「先看谁」，档位答「要不要处置」。
+   */
+  priority?: 'high' | 'normal'
   gates: HealthGate[]
   generatedAt: number
 }
@@ -166,6 +175,15 @@ export interface HealthRepairResponse {
   error?: string
 }
 
+/** 署名转换（session-health-source-migrate）响应。 */
+export interface SourceMigrateResponse {
+  ok: boolean
+  outcome?: { ok: boolean; path: string; backup?: string; changedRows?: number; byPlugin?: Record<string, number>; error?: string }
+  /** 转换后的最新体检报告（无论成败都给出，便于面板对照）。 */
+  after?: HealthReport
+  error?: string
+}
+
 /** 状态响应。 */
 export interface HealthStatusResponse {
   ok: boolean