dsh-manage-session 0.3.3 → 0.5.1

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: 'generation' | '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 }
@@ -171,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

package/src/client/index.ts

@@ -2,8 +2,8 @@
  * 会话管家客户端半身：样式、字典、侧边栏入口（dsh-manage-session）与设置卡。
  *
  * 侧边栏入口点击后打开「养老院 / 体检」双页签对话框；两个页签的可见性由配置开关决定，
- * 关掉的子域不渲染页签，也不留空壳。开关读取走 settingsScope 的订阅快照，
- * 写通道只有设置卡（显式控件）。
+ * 关掉的子域不渲染页签，也不留空壳。开关读取走 configForms（0.1.7，entry id 键）/
+ * 旧宿主设置服务的订阅快照；配置写入由 volatile 字段自动生成的设置表单承担。
  */
 import type { Context } from 'cordis'
 import { createElement, useState, useSyncExternalStore, type ReactElement } from 'react'
@@ -13,8 +13,8 @@ import {
   STEWARD_SETTINGS_NAMESPACE,
   type StewardConfig,
 } from '../config.ts'
-import { StewardSettingsCard, type StewardCardScope } from './card.tsx'
-import { en, translate, zh, type LocaleKey } from './locales.ts'
+import { StewardCardScope, StewardSettingsCard, type CardTranslate } from './card.tsx'
+import { de, en, es, fr, it, ru, translate, zh, type LocaleKey } from './locales.ts'
 import { StewardFooter, StewardPanel, TAB_HEALTH, TAB_HISTORY } from './panel.tsx'
 
 export { STEWARD_ENTRY_ID, STEWARD_SETTINGS_NAMESPACE, TAB_HEALTH, TAB_HISTORY }
@@ -27,18 +27,29 @@ export const NS = 'dsh-manage-session'
 interface StewardSlotsService {
   inject(name: string, callback: () => unknown, label?: string): void
   register(config: Record<string, unknown>, component: unknown): unknown
+  entries(name: string): Array<{ options: { id?: string; order?: number; label?: unknown } }>
+  getVersion(name: string): number
+  subscribe(name: string, listener: () => void): () => void
 }
 
 /** locale 服务面。 */
 interface StewardLocaleService {
-  register(ns: string, dictionaries: { zh: unknown; en: unknown }): () => void
+  register(
+    ns: string,
+    dictionaries: { zh: unknown; en: unknown; fr?: unknown; de?: unknown; it?: unknown; ru?: unknown; es?: unknown },
+  ): () => void
 }
 
-/** settingsScope 服务面。 */
+/** 旧宿主设置服务面（0.1.7 前的回退路径，结构化镜像）。 */
 interface StewardSettingsScope {
   bind<U>(input: { namespace: string }): (StewardCardScope & { getSnapshot(): { value: U | undefined } }) | undefined
 }
 
+/** configForms 服务面（0.1.7：以 profile entry id 取句柄）。 */
+interface StewardConfigForms {
+  get<U>(entryId: string): StewardCardScope & { getSnapshot(): { value: U | undefined } }
+}
+
 /** 客户端插件声明的注入面。 */
 export const inject = ['slots']
 
@@ -58,9 +69,31 @@ function injectStyles(): () => void {
   const style = document.createElement('style')
   style.id = id
   style.textContent = `
+/* 侧栏 footer 槽位公约（2026-09-26；2026-10-01 收紧行距并强制居中）：一行多
+   入口（第三方 dsh-context 等）会互相挤占 —— 宿主 .footerActions 是 nowrap
+   flex 行。这里允许容器换行，并把本插件入口钉成独占一整行（flex-basis:100%）；
+   其余入口（含第三方）自然落到后续行，各行内部自行布局，谁也不挤谁。
+   justify-content:center 让行内所有入口（含不占满行的）统一居中；row-gap:0
+   配合入口自身 32px 高度压缩纵向占位。类名用 [class*=] 中段匹配：宿主是 CSS
+   Module 哈希类名（实测形如 hHd-Xa_footerActions —— <hash>_<name>，哈希在前），
+   中段跨版本稳定。 */
+[class*="footerActions"]{flex-wrap:wrap;justify-content:center;row-gap:0;height:auto;min-height:0}
+/* —— 第三方矫正：dsh-context「上下文洞察」入口（2026-10-01）——
+   .lc-ov-entry 按"独占整行"设计（width:calc(100% + 4px)、无 justify-content、
+   42px 高、不对称 padding），与本槽位公约（每个入口独占一行、行内居中、32px）
+   冲突，表现为文字靠左、纵向松散。这里按公约强制矫正；:not() 排除收起轨道的
+   36px 圆钮形态。lc-ov-* 是 dsh-context 源码硬编码类名（非构建哈希），跨版本
+   稳定（实测 0.56.1 / 0.60.0 规则一致）。两个自有插件各自携带同一矫正块：
+   任一被禁用时矫正仍生效。 */
+.lc-ov-entry:not(.lc-ov-entry-rail){width:auto!important;flex:0 0 100%!important;min-width:0!important;justify-content:center!important;height:32px!important;margin:0!important;padding:0 10px!important}
+.lc-ov-entry-label{flex:0 1 auto!important}
+/* 宽栏：独占一整行、放弃主动收缩（flex-shrink:0），行内居中；收起轨道回落自然宽度。 */
 .dss_entryWrap{flex:0 1 auto;display:inline-flex;align-items:center;min-width:0}
-.dss_entryWrapWide{margin-left:6px}
-.dss_footerEntry{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;gap:4px;height:42px;padding:0 10px 0 8px;border:none;border-radius:12px;background:transparent;cursor:pointer;color:var(--dsw-alias-label-primary);font-family:inherit;font-size:14px;line-height:22px;white-space:nowrap;overflow:hidden;transition:background-color 160ms ease-out,color 160ms ease-out}
+.dss_entryWrapWide{flex:0 0 100%;width:100%;justify-content:center;margin-left:0}
+/* 高度 32px（内容 22px 行高 + 上下各 5px）：宿主默认 42px 的上下裕度在多行
+   堆叠后过于松散；左右内边距对称（10px/10px），否则整行居中时按钮内容会因
+   不对称 padding 向左偏 1px。 */
+.dss_footerEntry{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;gap:4px;height:32px;padding:0 10px;border:none;border-radius:12px;background:transparent;cursor:pointer;color:var(--dsw-alias-label-primary);font-family:inherit;font-size:14px;line-height:22px;white-space:nowrap;overflow:hidden;transition:background-color 160ms ease-out,color 160ms ease-out}
 .dss_footerEntry:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}
 .dss_footerEntryRail{width:28px;height:28px;padding:0;gap:0;border-radius:50%}
 .dss_footerIcon{flex:none;font-size:15px;line-height:1}
@@ -149,46 +182,133 @@ function injectStyles(): () => void {
 
 /**
  * 客户端插件主体。
- * @param ctx - 客户端上下文（slots、可选 locale / settingsScope）。
+ * @param ctx - 客户端上下文（slots、可选 locale / configForms）。
  */
 export function apply(ctx: Context): void {
   ctx.effect(() => injectStyles(), 'dsh-manage-session: stylesheet')
 
   const locale = ctx.get('locale') as StewardLocaleService | undefined
   if (locale !== undefined && typeof locale.register === 'function') {
-    ctx.effect(() => locale.register(NS, { zh, en }), 'dsh-manage-session: dictionaries')
+    ctx.effect(() => locale.register(NS, { zh, en, fr, de, it, ru, es }), 'dsh-manage-session: dictionaries')
   }
 
-  const settingsScope = ctx.get('settingsScope') as StewardSettingsScope | undefined
-  const bound = settingsScope?.bind<StewardConfig>({ namespace: STEWARD_SETTINGS_NAMESPACE })
+  // 0.1.7：configForms 以 entry id 取句柄；旧宿主回退到按命名空间绑定。
+  const configForms = ctx.get('configForms') as StewardConfigForms | undefined
+  const legacySettings = ctx.get('settingsScope') as StewardSettingsScope | undefined
+  const bound = configForms?.get<StewardConfig>(STEWARD_ENTRY_ID)
+    ?? legacySettings?.bind<StewardConfig>({ namespace: STEWARD_SETTINGS_NAMESPACE })
 
   const slots = ctx.get('slots') as StewardSlotsService | undefined
   if (slots === undefined) return
 
   // 侧边栏入口：一个按钮，打开「养老院 / 体检」双页签面板。
   slots.inject('sidebar.footer.action', () => slots.register(
-    { name: 'sidebar.footer.action', id: STEWARD_ENTRY_ID, order: 12 },
+    { name: 'sidebar.footer.action', id: STEWARD_ENTRY_ID, order: 6 },
     (props: StewardFooterProps) => createElement(StewardEntry, { ...props, scope: bound }),
   ), 'dsh-manage-session: sidebar footer entry')
 
-  slots.inject('settings.plugin.item', () => slots.register({
-    name: 'settings.plugin.item',
-    id: STEWARD_SETTINGS_NAMESPACE,
-    key: STEWARD_SETTINGS_NAMESPACE,
-    locale: locale !== undefined ? NS : undefined,
-    inject: () => ({
-      scope: bound ?? {
-        getSnapshot: () => ({
-          status: 'ready' as const,
-          value: DEFAULT_CONFIG,
-          revision: undefined,
-          writable: false,
-        }),
-        subscribe: () => () => {},
-        set: async () => {},
-      },
+  // 插件族共用设置 tab（dsh-thinking-levels 的顶级「起子插件设置」节声明该子
+  // 席位）。thinking-levels 缺席时本 inject 静默等待，不阻塞客户端半。
+  slots.inject('dsh-family.tab', () => slots.register(
+    {
+      name: 'dsh-family.tab',
+      id: STEWARD_ENTRY_ID,
+      order: 40,
+      // 账本 label：读期求值，跟随当前 locale（translate 内建 zh/en 兜底）。
+      label: () => translate((locale as { bind?: (n: string) => CardTranslate } | undefined)?.bind?.(NS), 'card.title'),
+      locale: NS,
+    },
+    (props: { t?: CardTranslate }) => createElement(StewardSettingsCard, {
+      scope: bound as StewardCardScope,
+      t: props.t,
     }),
-  }, StewardSettingsCard), 'dsh-manage-session: plugin settings card')
+  ), 'dsh-manage-session: family settings tab')
+
+  // 家族节宿主选举（次优先级）：宿主 dsh-thinking-levels 缺席时顶上「起子插件
+  // 设置」节。下载量排名 session-steward(1090) 低于 session-guard(1522) → 宽限期
+  // 更长，guard 先尝试接管；guard 也缺席时本插件按同一 id `dsh-family` 接管，
+  // 声明同一个 dsh-family.tab 子席位并通用渲染全部贡献卡。与 guard 的并发竞争
+  // 由 ui-slots 同 id 重复注册抛错仲裁，先到者胜、后到者放弃。
+  const familyTabsHooks = makeFamilyTabsHooks(slots)
+  ctx.effect(() => {
+    let claimed: unknown
+    const timer = setTimeout(() => {
+      if (slots.entries('settings.section').some(e => e.options.id === FAMILY_SECTION_ID)) return
+      try {
+        claimed = slots.register({
+          name: 'settings.section',
+          id: FAMILY_SECTION_ID,
+          order: 40,
+          label: () => translate((locale as { bind?: (n: string) => CardTranslate } | undefined)?.bind?.(NS), 'family.title'),
+          locale: NS,
+          inject: () => ({ hooks: { tabs: familyTabsHooks } }),
+          children: { [FAMILY_CHILD_KEY]: { kind: 'list', scope: 'root' } },
+        }, StewardFamilySection)
+      } catch {
+        // 并发接管竞争落败（或设置壳未声明席位）：胜出方的节服务整个家族。
+      }
+    }, FAMILY_HOST_GRACE_MS)
+    return () => { clearTimeout(timer); if (typeof claimed === 'function') (claimed as () => void)() }
+  }, 'dsh-manage-session: family fallback host')
+}
+
+/** 家族节固定 id（与 thinking-levels / guard 的注册严格一致）。 */
+const FAMILY_SECTION_ID = 'dsh-family'
+/** 家族子席位 key（与 thinking-levels 的声明严格一致）。 */
+const FAMILY_CHILD_KEY = 'dsh-family.tab'
+/** 接管宽限期：guard 2000ms 先试，本插件 2600ms 兜底。 */
+const FAMILY_HOST_GRACE_MS = 2600
+
+/** 接管节的账本投影 hooks（与 thinking-levels 的 FamilySectionInjected 同形；locale 变更也触发重渲染）。 */
+function makeFamilyTabsHooks(slots: StewardSlotsService): {
+  getSnapshot: () => readonly FamilyTabEntry[]
+  subscribe: (listener: () => void) => () => void
+} {
+  let version = -1
+  let tabs: readonly FamilyTabEntry[] = []
+  return {
+    getSnapshot: () => {
+      const next = slots.getVersion(FAMILY_CHILD_KEY)
+      if (next !== version) {
+        version = next
+        tabs = slots.entries(FAMILY_CHILD_KEY)
+          .map(entry => ({
+            id: entry.options.id ?? '',
+            order: entry.options.order ?? 0,
+            label: typeof entry.options.label === 'function'
+              ? (() => { try { return String((entry.options.label as () => unknown)() ?? entry.options.id ?? '') } catch { return String(entry.options.id ?? '') } })()
+              : String(entry.options.label ?? entry.options.id ?? ''),
+          }))
+          .sort((a, b) => a.order - b.order)
+      }
+      return tabs
+    },
+    subscribe: (listener: () => void) => slots.subscribe(FAMILY_CHILD_KEY, listener),
+  }
+}
+
+/** 账本条目（id/order/label，label 已解析为字符串）。 */
+interface FamilyTabEntry {
+  id: string
+  order: number
+  label: string
+}
+
+/**
+ * 家族节接管组件（fallback host section）：纯通用渲染 —— 把 `dsh-family.tab`
+ * 账本里的每张贡献卡（含本插件自己的，接管时本插件也声明了该子席位）按
+ * order 依次 renderSlot；各卡本身是默认展开的抽屉，整节即一页抽屉。
+ */
+function StewardFamilySection(props: {
+  renderSlot: (key: string, owner?: object, opts?: { only?: string; fallback?: unknown }) => unknown
+  hooks: { tabs: { getSnapshot: () => readonly FamilyTabEntry[]; subscribe: (listener: () => void) => () => void } }
+}): ReactElement {
+  const tabs = useSyncExternalStore(props.hooks.tabs.subscribe, props.hooks.tabs.getSnapshot)
+  return createElement('div', { style: { display: 'grid', gap: '12px' } },
+    ...tabs.map(row => createElement('div', { key: row.id },
+      props.renderSlot(FAMILY_CHILD_KEY, {}, { only: row.id, fallback: null }) as ReactElement,
+    )),
+  )
 }
 
 /** 入口按钮：持有面板开关；两个页签的可见性来自配置快照。 */