dsh-manage-session 0.3.3 → 0.4.8

package/CHANGELOG.ja.md

@@ -1,5 +1,24 @@
 # 変更履歴
 
+## 0.4.8
+
+### 修正 —— ST1：変換が第一-party プロデューサー名でホストと食い違う問題
+
+- `migrateSessionSourceKind` は行ごとに `isFirstPartyLegacyProducer` を照合（ホスト
+  `dsh-session-format-v3-to-v4@0.1.7-rc.2` lib/index.js:51-84 の2表を一字一句収録、
+  実測 5+25=**30** 名）。該当行はスキップし `skippedFirstParty` で正直に報告——
+  第一-party 名はホストの改名表/同名 kind（role 敏感分岐含む）で処理されるため、
+  無条件の接頭辞付与はホストが生成しない kind を書き出し、帰属を静かに壊します。
+  第一方旧行のみのログは書き込まない。30 名対照テストとホスト公式デコーダ読み返し
+  検証を追加（161 テスト全緑）。
+
+### 強化 —— R2：purge 側が署名変換バックアップを認識
+
+- 統計とクリーンアップの両経路で `*.pre-sourcemigrate-<ts>` バックアップを認識：
+  統計は行ごとに `backupBytes`/`backupCount` を追加（`bytes` の部分集合、単列で
+  誤読防止）、クリーンアップ結果は `backupsRemoved` を追加。回帰 6 件を追加、
+  全 167 テスト。
+
 ## 0.1.0-alpha.6
 
 ### 修正 —— アイコンとラベルの間隔を詰め、狭いサイドバーで隣を潰さない

package/CHANGELOG.ko.md

@@ -1,5 +1,23 @@
 # 변경 이력
 
+## 0.4.8
+
+### 수정 —— ST1：변환이 제1자 프로듀서명에서 호스트와 불일치
+
+- `migrateSessionSourceKind`는 행마다 `isFirstPartyLegacyProducer`를 조회(호스트
+  `dsh-session-format-v3-to-v4@0.1.7-rc.2` lib/index.js:51-84의 두 표를 그대로 수록,
+  실측 5+25=**30**명). 해당 행은 건너뛰고 `skippedFirstParty`로 정직하게 보고——
+  제1자명은 호스트의 개명표/동명 kind(role 민감 분기 포함)으로 처리되므로 무조건
+  접두사를 붙이면 호스트가 생성하지 않는 kind를 기록해 귀속이 조용히 손상됩니다.
+  제1자 구형 행만 있는 로그는 기록하지 않음. 30명 대조 테스트와 호스트 공식
+  디코더 재독 단언 추가(161 테스트 전부 통과).
+
+### 강화 —— R2：purge 측 서명 변환 백업 인식
+
+- 통계와 정리 양 경로에서 `*.pre-sourcemigrate-<ts>` 백업을 인식: 통계는 행마다
+  `backupBytes`/`backupCount` 추가(`bytes`의 부분집합, 단열로 오독 방지),
+  정리 결과에 `backupsRemoved` 추가. 회귀 6건 추가, 전체 167 테스트.
+
 ## 0.1.0-alpha.6
 
 ### 수정 — 아이콘과 레이블 간격 축소, 좁은 사이드바에서 이웃을 밀어내지 않음

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.4.8
+
+### 修复 —— ST1：转换对第一方生产者名与宿主分叉
+
+- `migrateSessionSourceKind` 逐行查 `isFirstPartyLegacyProducer`（两张表逐字照录宿主
+  `dsh-session-format-v3-to-v4@0.1.7-rc.2` lib/index.js:51-84，实测 5+25=**30** 个第一方名），
+  命中即跳过该行并以 `skippedFirstParty` 如实上报——第一方名走宿主改名表/同名裸 kind
+  （含 role 敏感分支），无条件加前缀会写出宿主永不产出的 kind，静默损坏归因。
+  只含第一方旧行时不写盘。新增 30 名对照测试与宿主官方解码器读回断言（161 测试全绿）。
+
+### 加固 —— R2：purge 侧识别署名转换备份
+
+- 归档统计与清理两路识别 `*.pre-sourcemigrate-<ts>` 备份（后缀常量
+  `SOURCE_MIGRATE_BACKUP_SUFFIX` 已在 0.4.7 导出，本次接线）：
+  - **统计**：`locateSessionUsage` / `session-history-list` 每行新增 `backupBytes` /
+    `backupCount`——备份是 `bytes` 的子集，单列出来免得被当作日志体积误读；
+  - **清理**：`session-history-purge` 结果新增 `backupsRemoved`（整目录删除本就连带
+    备份，此处置个数让「备份一并处置」如实上报，不再是黑箱）。
+- 新增 6 条回归（后缀判定、统计单列、如实 0、清理上报、连带保留、列表带出），全套 167 测试。
+
+## 0.4.7
+
+### 新增 —— 插件署名格式体检门（source-kind）与旧署名转换
+
+- **背景**：宿主 0.1.7-rc.1 起（会话格式 v4）拒绝裸 `source: { kind: 'plugin', plugin }` 署名
+  （SessionFormatError，整轮失败）；genui 之外的未适配插件（session-guard、prime-memory 等）
+  已按清单修写路径，但存量日志里由它们写入的旧署名行仍在——未适配插件的读回判断会失配。
+- **检测（只读）**：体检新增第 6 门 `source-kind`，按日志 header 的格式代次分线：
+  - **版本依赖表**（详见 `src/host/health/source-kind.ts` 头注）：v1/v2 早期线（未考证）与
+    v3（0.1.6 时代，待考证）旧行合法、不动（宿主 v3→v4 迁移负责）；**v4（≥0.1.7-rc.1）拒绝
+    旧署名**，观测到即 warn。
+  - v4 之前的版本线记 ok 不抬档——不越权处理宿主迁移契约内的数据（防过度操作）。
+- **转换（显式触发）**：新增 API `session-health-source-migrate` 与体检面板「转换旧署名」按钮
+  （仅 source-kind 门 warn 时出现）。把 `{ kind: 'plugin', plugin: N }` 改写为
+  `{ kind: 'plugin:N' }`（删除 plugin 字段），其余字节原样保留。
+- **红线三闸**：只动 source 署名字段；改前整文件备份（`*.pre-sourcemigrate-<ts>`，可回退）；
+  完整性不合格（撕裂尾帧/解码失败/seq 缺口）或 header.version < 4 时拒绝执行。这是
+  「禁止改写会话日志」红线的唯一显式例外，经用户逐会话触发。
+- genui 不在掌控范围，本插件不做也不会替它转换（其历史行转换后由其读回判断自行失配与否自负）。
+
 ## 0.1.0-alpha.6
 
 ### 修复 —— 图标与文案间距收紧；窄栏下不再挤掉邻居

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-manage-session",
   "name": "dsh-manage-session",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": {
     "en": "Session Steward (DSH 0.1.5 line): browse and bulk-prune the official session archive set, and run a four-gate session health checkup that ends in a reversible, backup-first prescription. Never rewrites session logs.",
     "zh": "会话管家（DSH 0.1.5 专线）：浏览并批量清理官方会话归档集合，并对会话做四门体检，最终给出可逆、先备份的处方。不改写会话日志。"
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": ">=0.1.5-rc.1 <0.1.6-0"
+    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
   },
   "components": {
     "host": "lib/index.js",

package/lib/client.js

@@ -31,6 +31,7 @@ window.__ModuleLoader__.load({
 			"card.health.desc": "体检 → 处方 → 出院。关闭后不注册体检接口、不渲染该页签。",
 			"card.readonly": "当前会话无法修改设置（只读挂载）。",
 			"card.unavailable": "设置服务不可用，无法读取配置。",
+			"family.title": "起子插件设置",
 			"panel.title": "会话管家",
 			"panel.tab.history": "养老院",
 			"panel.tab.health": "体检",
@@ -75,6 +76,7 @@ window.__ModuleLoader__.load({
 			"health.gate.projection-cache": "投影缓存",
 			"health.gate.lossless-json": "无损 JSON",
 			"health.gate.cold-read": "可接续性",
+			"health.gate.source-kind": "插件署名",
 			"health.attribution": "归属",
 			"health.field": "字段",
 			"health.unknownOwner": "归属未知",
@@ -83,6 +85,11 @@ window.__ModuleLoader__.load({
 			"health.phase.discharge": "③ 出院",
 			"health.repair": "执行可逆处置",
 			"health.repairing": "处置中…",
+			"health.sourceMigrate": "转换旧署名",
+			"health.sourceMigrating": "转换中…",
+			"health.sourceMigrated": "已转换 {n} 行旧署名（备份：{backup}）",
+			"health.sourceMigrateNone": "没有需要转换的旧署名行",
+			"health.sourceMigrateFail": "转换失败：{error}",
 			"health.before": "处置前",
 			"health.after": "处置后",
 			"health.quarantined": "已隔离投影缓存记录（重启 DSH 后重折叠）",
@@ -111,6 +118,7 @@ window.__ModuleLoader__.load({
 			"card.health.desc": "Checkup → Prescription → Discharge. When off, health routes and the tab are gone.",
 			"card.readonly": "This session cannot edit settings (read-only mount).",
 			"card.unavailable": "Settings service unavailable; configuration cannot be read.",
+			"family.title": "Screwdriver plugin settings",
 			"panel.title": "Session Steward",
 			"panel.tab.history": "Retirement Home",
 			"panel.tab.health": "Checkup",
@@ -155,6 +163,7 @@ window.__ModuleLoader__.load({
 			"health.gate.projection-cache": "Projection cache",
 			"health.gate.lossless-json": "Lossless JSON",
 			"health.gate.cold-read": "Continuability",
+			"health.gate.source-kind": "Plugin signature",
 			"health.attribution": "Owner",
 			"health.field": "Field",
 			"health.unknownOwner": "owner unknown",
@@ -163,6 +172,11 @@ window.__ModuleLoader__.load({
 			"health.phase.discharge": "3) Discharge",
 			"health.repair": "Apply reversible repair",
 			"health.repairing": "Repairing…",
+			"health.sourceMigrate": "Migrate legacy signatures",
+			"health.sourceMigrating": "Migrating…",
+			"health.sourceMigrated": "Migrated {n} legacy signature rows (backup: {backup})",
+			"health.sourceMigrateNone": "No legacy signature rows to migrate",
+			"health.sourceMigrateFail": "Migration failed: {error}",
 			"health.before": "Before",
 			"health.after": "After",
 			"health.quarantined": "Projection cache quarantined (refolds after a DSH restart)",
@@ -196,17 +210,14 @@ window.__ModuleLoader__.load({
 		/**
 		* 设置卡（插件配置行）：一个可折叠抽屉 —— 会话历史文件 / 健康检查。
 		*
-		* **chrome 必须自己渲染**：DSH 的「插件」设置分区（`dsh-client-ui-settings-plugins`）
-		* 只做一件事——按 settings 命名空间分发 `settings.plugin.item`：
+		* **chrome 必须自己渲染**：宿主不为贡献卡提供任何外壳，标题、说明、
+		* 展开/收起全归插件自己所有。早期版本只渲染裸行，与同分区其它插件
+		* 的抽屉形态不一致，还让 `card.title` / `card.desc` 成为死文案。
 		*
-		*     renderSlot('settings.plugin.item', {}, { entryKey: ns })
-		*
-		* 它**不提供任何外壳**。所以卡片的标题、说明、展开/收起全归插件自己所有
-		* （同分区里 search-index 等卡片都是这个形态）。早期版本只渲染了裸行，
-		* 结果既与分区内其它插件的抽屉形态不一致，又让 `card.title` / `card.desc`
-		* 变成定义了却没人渲染的死文案。
-		*
-		* 读写走 settingsScope 的显式 `set`（用户在控件上的直接操作，非隐式提交）。
+		* 读写走 configForms（`configForms.get(STEWARD_ENTRY_ID)`，以本插件 entry 为键；
+		* 旧宿主回退 settingsScope 绑定）的显式 `set`。0.1.7 起本卡挂在插件族共用
+		* 设置节（`dsh-family.tab`，dsh-thinking-levels 顶级「起子插件设置」节声明）里，
+		* 与同节其它抽屉一样默认展开。
 		*/
 		/** 一行设置项。 */
 		function Row(props) {
@@ -269,10 +280,10 @@ window.__ModuleLoader__.load({
 				strokeLinejoin: "round"
 			}))]);
 		}
-		/** 插件设置卡主体（抽屉）。默认收起，与「插件」分区内其它卡片一致。 */
+		/** 插件设置卡主体（抽屉）。默认展开，family 设置节内直接呈现完整面板。 */
 		function StewardSettingsCard({ t, scope }) {
 			const snapshot = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot());
-			const [open, setOpen] = (0, react.useState)(false);
+			const [open, setOpen] = (0, react.useState)(true);
 			const value = snapshot.value ?? {};
 			const writable = snapshot.writable;
 			const rows = [];
@@ -683,7 +694,8 @@ window.__ModuleLoader__.load({
 			"log-integrity": "health.gate.log-integrity",
 			"projection-cache": "health.gate.projection-cache",
 			"lossless-json": "health.gate.lossless-json",
-			"cold-read": "health.gate.cold-read"
+			"cold-read": "health.gate.cold-read",
+			"source-kind": "health.gate.source-kind"
 		};
 		const LEVEL_LABEL = {
 			ok: "health.level.ok",
@@ -733,6 +745,9 @@ window.__ModuleLoader__.load({
 			const [error, setError] = (0, react.useState)(null);
 			const [detail, setDetail] = (0, react.useState)(null);
 			const [repairing, setRepairing] = (0, react.useState)(false);
+			const [migrating, setMigrating] = (0, react.useState)(false);
+			/** 署名转换结果提示（一次性；点击转换或返回列表时清除）。 */
+			const [migrateNote, setMigrateNote] = (0, react.useState)(null);
 			const [discharge, setDischarge] = (0, react.useState)(null);
 			const [copied, setCopied] = (0, react.useState)(null);
 			/** 分批扫描进度：done = 已访问会话数，total = 语料总数（0 表示尚未拿到分母）。 */
@@ -788,6 +803,7 @@ window.__ModuleLoader__.load({
 				setError(null);
 				setDetail(null);
 				setDischarge(null);
+				setMigrateNote(null);
 				setFindings(null);
 				setCacheInfo(null);
 				setProgress({
@@ -856,6 +872,7 @@ window.__ModuleLoader__.load({
 			const openDetail = (sessionId) => {
 				setError(null);
 				setDischarge(null);
+				setMigrateNote(null);
 				callHostAny("session-health-session", { sessionId }, 12e4).then((res) => {
 					if (res.ok === true) {
 						setDetail(res);
@@ -886,6 +903,28 @@ window.__ModuleLoader__.load({
 					setCopied(text);
 				} catch {}
 			};
+			const runSourceMigrate = (sessionId) => {
+				setMigrating(true);
+				setError(null);
+				setMigrateNote(null);
+				callHostAny("session-health-source-migrate", { sessionId }, 12e4).then((res) => {
+					if (res.after !== void 0) {
+						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) => setError(String(err instanceof Error ? err.message : err))).finally(() => setMigrating(false));
+			};
 			const report = detail?.report ?? discharge?.after;
 			const lines = [];
 			lines.push((0, react.createElement)("div", {
@@ -1052,6 +1091,25 @@ window.__ModuleLoader__.load({
 					className: "dss_spinner",
 					"aria-hidden": "true"
 				}) : null, (0, react.createElement)("span", { key: "tx" }, repairing ? translate(t, "health.repairing") : translate(t, "health.repair"))])]));
+				if (report.gates.some((gate) => gate.id === "source-kind" && gate.level === "warn")) lines.push((0, react.createElement)("div", {
+					key: "migrate",
+					className: "dss_phaseRow"
+				}, [(0, react.createElement)("button", {
+					key: "m",
+					type: "button",
+					className: "dss_actBtn",
+					disabled: migrating,
+					onClick: () => {
+						runSourceMigrate(report.sessionId);
+					}
+				}, [migrating ? (0, react.createElement)("span", {
+					key: "sp",
+					className: "dss_spinner",
+					"aria-hidden": "true"
+				}) : null, (0, react.createElement)("span", { key: "tx" }, migrating ? translate(t, "health.sourceMigrating") : translate(t, "health.sourceMigrate"))]), migrateNote !== null && (0, react.createElement)("span", {
+					key: "note",
+					className: "dss_status"
+				}, migrateNote)]));
 				const prescriptions = detail?.prescriptions ?? discharge?.prescriptions ?? [];
 				if (prescriptions.length > 0) lines.push((0, react.createElement)("div", {
 					key: "cmds",
@@ -1227,8 +1285,16 @@ window.__ModuleLoader__.load({
 			const style = document.createElement("style");
 			style.id = id;
 			style.textContent = `
+/* 侧栏 footer 槽位公约（2026-09-26）：一行多入口（第三方 dsh-context 等）会互相
+   挤占 —— 宿主 .footerActions 是 nowrap flex 行。这里允许容器换行，并把本插件
+   入口钉成独占一整行（flex-basis:100%）；其余入口（含第三方）自然落到后续行，
+   各行内部自行布局，谁也不挤谁。类名用 [class*=] 中段匹配：宿主是 CSS Module
+   哈希类名（实测形如 hHd-Xa_footerActions —— <hash>_<name>，哈希在前），
+   中段跨版本稳定。 */
+[class*="footerActions"]{flex-wrap:wrap;row-gap:2px;height:auto;min-height:0}
+/* 宽栏：独占一整行、放弃主动收缩（flex-shrink:0），行内居中；收起轨道回落自然宽度。 */
 .dss_entryWrap{flex:0 1 auto;display:inline-flex;align-items:center;min-width:0}
-.dss_entryWrapWide{margin-left:6px}
+.dss_entryWrapWide{flex:0 0 100%;width:100%;justify-content:center;margin-left:0}
 .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_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%}
@@ -1319,7 +1385,7 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* 客户端插件主体。
-		* @param ctx - 客户端上下文（slots、可选 locale / settingsScope）。
+		* @param ctx - 客户端上下文（slots、可选 locale / configForms）。
 		*/
 		function apply(ctx) {
 			ctx.effect(() => injectStyles(), "dsh-manage-session: stylesheet");
@@ -1328,33 +1394,101 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "dsh-manage-session: dictionaries");
-			const bound = ctx.get("settingsScope")?.bind({ namespace: STEWARD_SETTINGS_NAMESPACE });
+			const configForms = ctx.get("configForms");
+			const legacySettings = ctx.get("settingsScope");
+			const bound = configForms?.get("dsh-manage-session") ?? legacySettings?.bind({ namespace: "session-steward" });
 			const slots = ctx.get("slots");
 			if (slots === void 0) return;
 			slots.inject("sidebar.footer.action", () => slots.register({
 				name: "sidebar.footer.action",
 				id: STEWARD_ENTRY_ID,
-				order: 12
+				order: 6
 			}, (props) => (0, react.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 !== void 0 ? NS : void 0,
-				inject: () => ({ scope: bound ?? {
-					getSnapshot: () => ({
-						status: "ready",
-						value: DEFAULT_CONFIG,
-						revision: void 0,
-						writable: false
-					}),
-					subscribe: () => () => {},
-					set: async () => {}
-				} })
-			}, StewardSettingsCard), "dsh-manage-session: plugin settings card");
+			slots.inject("dsh-family.tab", () => slots.register({
+				name: "dsh-family.tab",
+				id: STEWARD_ENTRY_ID,
+				order: 40,
+				label: () => translate(locale?.bind?.(NS), "card.title"),
+				locale: NS
+			}, (props) => (0, react.createElement)(StewardSettingsCard, {
+				scope: bound,
+				t: props.t
+			})), "dsh-manage-session: family settings tab");
+			const familyTabsHooks = makeFamilyTabsHooks(slots);
+			ctx.effect(() => {
+				let claimed;
+				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?.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();
+				};
+			}, "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) {
+			let version = -1;
+			let tabs = [];
+			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() ?? 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) => slots.subscribe(FAMILY_CHILD_KEY, listener)
+			};
+		}
+		/**
+		* 家族节接管组件（fallback host section）：纯通用渲染 —— 把 `dsh-family.tab`
+		* 账本里的每张贡献卡（含本插件自己的，接管时本插件也声明了该子席位）按
+		* order 依次 renderSlot；各卡本身是默认展开的抽屉，整节即一页抽屉。
+		*/
+		function StewardFamilySection(props) {
+			const tabs = (0, react.useSyncExternalStore)(props.hooks.tabs.subscribe, props.hooks.tabs.getSnapshot);
+			return (0, react.createElement)("div", { style: {
+				display: "grid",
+				gap: "12px"
+			} }, ...tabs.map((row) => (0, react.createElement)("div", { key: row.id }, props.renderSlot(FAMILY_CHILD_KEY, {}, {
+				only: row.id,
+				fallback: null
+			}))));
 		}
 		/** 入口按钮：持有面板开关；两个页签的可见性来自配置快照。 */
 		function StewardEntry(props) {

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+import z from "@deepseek-ai/schemastery";
 //#region node_modules/cosmokit/lib/index.d.ts
 type Dict<T = any, K extends string | symbol = string> = { [key in K]: T; };
 type Promisify<T> = Promise<T extends Promise<infer S> ? S : T>;
@@ -734,7 +735,7 @@ interface GateAttribution {
 }
 /** 一个 gate 的结果。 */
 interface GateResult {
-  id: 'generation' | 'log-integrity' | 'projection-cache' | 'lossless-json' | 'cold-read';
+  id: 'generation' | 'log-integrity' | 'projection-cache' | 'lossless-json' | 'cold-read' | 'source-kind';
   level: GateLevel;
   evidence: string;
   attribution?: GateAttribution;
@@ -883,6 +884,8 @@ interface StewardHistoryRow {
   bytes: number;
   /** 投影缓存占用字节数。 */
   cacheBytes: number;
+  /** 署名转换备份（`*.pre-sourcemigrate-<ts>`）占用字节数——`bytes` 的子集，单列防误读为日志体积。 */
+  backupBytes: number;
 }
 /** 列表结果。 */
 interface StewardHistoryListResult {
@@ -944,13 +947,30 @@ interface StewardSessionUsage {
   sessionId: string;
   /** 转录目录绝对路径（不存在时缺省）。 */
   dir?: string;
-  /** 转录目录占用字节数。 */
+  /** 转录目录占用字节数（**含**署名转换备份；备份单列在 `backupBytes`）。 */
   bytes: number;
+  /**
+   * 署名转换备份（`*.pre-sourcemigrate-<ts>`，见 `SOURCE_MIGRATE_BACKUP_SUFFIX`）
+   * 占用字节数 —— 是 `bytes` 的子集，单列出来免得被当作日志体积误读。
+   */
+  backupBytes: number;
+  /** 备份文件个数。 */
+  backupCount: number;
   /** 投影缓存文件绝对路径（不存在时缺省）。 */
   cacheFile?: string;
   /** 投影缓存占用字节数。 */
   cacheBytes: number;
 }
+/** 是否署名转换备份文件（`*.pre-sourcemigrate-<ts>`）。 */
+declare function isSourceMigrateBackupName(name: string): boolean;
+/**
+ * 列出一个转录目录里的署名转换备份（只扫顶层：备份与日志同目录落盘）。
+ * @returns 备份绝对路径与合计字节数；目录不存在时为空。
+ */
+declare function backupFilesIn(dir: string): {
+  files: string[];
+  bytes: number;
+};
 /** 转录根目录（`<dshHome>/sessions`）。 */
 declare function sessionsRootFor(dshHome: string): string;
 /**
@@ -996,8 +1016,10 @@ interface StewardHistoryPurgeResult {
   ok: boolean;
   /** 成功清理的会话数。 */
   purged?: number;
-  /** 释放的字节数（转录 + 投影缓存）。 */
+  /** 释放的字节数（转录 + 投影缓存；含随目录删除的署名转换备份）。 */
   freedBytes?: number;
+  /** 一并删除的署名转换备份（`*.pre-sourcemigrate-<ts>`）个数。 */
+  backupsRemoved?: number;
   /** 逐条失败原因；不阻断其余条目。 */
   failures?: {
     sessionId: string;
@@ -1022,6 +1044,88 @@ interface StewardPurgeOptions {
  */
 declare function purgeHistory(payload: unknown, log?: (msg: string) => void, options?: StewardPurgeOptions): StewardHistoryPurgeResult;
 //#endregion
+//#region src/host/health/source-kind.d.ts
+/** v4 线起点的宿主版本（会话格式 v4 引入 producer-owned source kind）。 */
+declare const V4_HOST_MIN = "0.1.7-rc.1";
+/** 一份日志里的旧署名事实。 */
+interface SourceKindFacts {
+  /** 旧署名事件总数。 */
+  legacyCount: number;
+  /** 按生产者插件名统计。 */
+  byPlugin: Record<string, number>;
+  /** 命中样例（seq + 插件名），最多 5 条，供证据展示。 */
+  examples: {
+    seq: number;
+    plugin: string;
+  }[];
+  /** 日志 header 的格式代次（无从读取时 undefined）。 */
+  headerVersion?: number;
+}
+/** 从解码后的日志提取旧署名事实（只读）。 */
+declare function readSourceKindFacts(log: SessionLogRead): SourceKindFacts;
+/**
+ * gate 5：插件署名格式（v4 线要求 producer-owned kind）。
+ *
+ * 档位判据（有据才抬档）：
+ * - header.version ≥ 4 且观测到旧署名行 → `warn`：v4 校验拒绝这种署名；存量行让
+ *   未适配插件的读回判断（`kind === 'plugin' && plugin === name`）失配，转换可消除；
+ * - header.version < 4 → `ok`：v3 及更早线旧行合法，宿主迁移负责，**不动**（防过度操作）；
+ * - header.version 无从读取 → `skipped`：无从判定该走哪条版本线。
+ * @param facts - 旧署名事实；undefined 表示未提供（无日志）。
+ */
+declare function gateSourceKind(facts: SourceKindFacts | undefined): {
+  id: 'source-kind';
+  level: GateLevel;
+  evidence: string;
+  detail?: Record<string, unknown>;
+};
+/** 转换结果。 */
+interface SourceKindMigrationOutcome {
+  ok: boolean;
+  sessionId: string;
+  /** 被改写的日志路径。 */
+  path: string;
+  /** 备份路径（改写前的完整副本；ok 且 changed 时必有）。 */
+  backup?: string;
+  /** 改写的行数。 */
+  changedRows?: number;
+  /** 按生产者插件名统计的改写行数。 */
+  byPlugin?: Record<string, number>;
+  /**
+   * 按生产者名统计的**跳过**行数（第一方名，宿主迁移职权，见
+   * `isFirstPartyLegacyProducer`）。跳过是如实上报，不是静默丢弃。
+   */
+  skippedFirstParty?: Record<string, number>;
+  error?: string;
+}
+/**
+ * 从旧署名对象构造新署名：`{ kind: 'plugin', plugin: name, …rest }` → `{ kind: 'plugin:name', …rest }`。
+ * 非 legacy（缺 plugin 字段 / kind 不符）返回 undefined，调用方跳过该行。
+ *
+ * ⚠️ 只对**第三方**生产者名成立（第四轮审计 ST1）：宿主 `producerKind`
+ * （dsh-session-format-v3-to-v4@0.1.7-rc.2 lib/index.js:88-96）对第一方名走改名表
+ * 或同名裸 kind，本函数无条件加前缀会对那 30 个名字写出宿主永不产出的 kind。
+ * 第一方名由 `FIRST_PARTY_RENAMED_PRODUCERS` / `FIRST_PARTY_SAME_NAME_PRODUCERS`
+ * 判定，`migrateSessionSourceKind` 命中即跳过并如实上报（宿主迁移职权，不代转换）。
+ */
+declare function migrateLegacySource(source: unknown): Record<string, unknown> | undefined;
+/**
+ * 转换一个会话日志里的旧署名行（v4 线专用；先备份，只动署名字段）。
+ *
+ * 执行闸（任一不满足即拒绝，不写盘）：
+ * 1. 日志可整体解码且无完整性问题（撕裂尾帧 / 解码失败 / seq 缺口）；
+ * 2. header.version ≥ 4（v3 及更早的旧行按契约由宿主迁移，不动）；
+ * 3. 确有旧署名行（没有则空手而归，不做无谓重压缩）。
+ * @param sessionId - 会话 id（用于结果标注）。
+ * @param logPath - 当前代日志路径（必须 .zstd 结尾）。
+ * @param log - 已解码的日志（复用体检结果，闸 1/2 在其上判定）。
+ * @param dshHome - DSH home（备份不依赖它，参数保留与其它处置一致的面）。
+ * @param now - 时间源（备份后缀，测试可控）。
+ */
+declare function migrateSessionSourceKind(sessionId: string, logPath: string, log: SessionLogRead, dshHome?: string, now?: () => number): SourceKindMigrationOutcome;
+/** 备份文件的后缀约定（purge/清理工具可据此识别并一并处置）。 */
+declare const SOURCE_MIGRATE_BACKUP_SUFFIX = ".pre-sourcemigrate-";
+//#endregion
 //#region src/host/health/lossless.d.ts
 /**
  * 无损 JSON 判定 —— 本次事故的核心 gate 判据。
@@ -1228,6 +1332,16 @@ declare function scanSessions(options: {
 //#region src/index.d.ts
 /** 本插件声明的宿主服务（与 toggle 相同的注入面）。 */
 declare const inject: string[];
+/** 运行时配置 schema（与 src/config.ts 的形状保持一致）。0.1.7：volatile 字段即设置表单。 */
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+  enabled: z<boolean, boolean, "volatile-defined">;
+  historyFiles: z<boolean, boolean, "volatile-defined">;
+  healthCheck: z<boolean, boolean, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  enabled: z<boolean, boolean, "volatile-defined">;
+  historyFiles: z<boolean, boolean, "volatile-defined">;
+  healthCheck: z<boolean, boolean, "volatile-defined">;
+}>>, "plain">;
 /** 运行时依赖。 */
 interface StewardRuntime {
   config: () => Required<StewardConfig>;
@@ -1255,7 +1369,7 @@ interface StewardRuntime {
  * prune = 取消归档状态（可逆，会话回到侧边栏）；purge = 清理归档文件（不可逆，真删实体）。
  */
 declare const HISTORY_METHODS: readonly ["session-history-list", "session-history-prune", "session-history-purge"];
-declare const HEALTH_METHODS: readonly ["session-health-status", "session-health-scan", "session-health-session", "session-health-repair"];
+declare const HEALTH_METHODS: readonly ["session-health-status", "session-health-scan", "session-health-session", "session-health-repair", "session-health-source-migrate"];
 /** 依据开关判定某方法是否启用。 */
 declare function methodEnabled(method: string, config: Required<StewardConfig>): boolean;
 /**
@@ -1266,9 +1380,10 @@ declare function methodEnabled(method: string, config: Required<StewardConfig>):
  */
 declare function handleMethod(method: string, payload: unknown, runtime: StewardRuntime): Promise<unknown>;
 /**
- * 插件主体：注册设置命名空间、装配运行时、挂载 fenced 路由。
- * @param ctx - host 插件上下文（webServer / webRuntime / 可选 settings、sessionQuery、sessions、sessionProjections）。
+ * 插件主体：装配运行时、挂载 fenced 路由。
+ * @param ctx - host 插件上下文（webServer / webRuntime / 可选 sessionQuery、sessions、sessionProjections）。
+ * @param config - 组合条目（0.1.7：`.volatile()` 字段为 live ref）。
  */
-declare function apply(ctx: Context): void;
+declare function apply(ctx: Context, config?: Partial<StewardConfig>): void;
 //#endregion
-export { DEFAULT_CONFIG, type DiscoveredSession, type GenerationArtifact, HEALTH_METHODS, HISTORY_METHODS, HealthCache, type HealthCacheEntry, type LogArtifact, type LogCompression, type RepairAssessment, type RepairVerdict, STEWARD_API_PREFIX, STEWARD_SETTINGS_NAMESPACE, type SessionGenerations, type SessionPriority, type StewardConfig, StewardRuntime, apply, assessRepair, buildProjectionOwnerIndex, buildSessionReport, classifyGenerationFilename, countCorpus, createAttributor, decodeSessionLogBytes, decodeSessionLogFile, dirSize, discoverSessions, editWorkspaceDocument, findSession, findSessionLog, firstLosslessViolation, gateColdRead, gateGeneration, gateLogIntegrity, gateLosslessJson, gateProjectionCache, generationLogFilename, handleMethod, indexSessionDirs, inject, isLossless, isMigrationStagingFilename, isSafeChild, latestArtifactMtime, listHistory, locateSessionUsage, methodEnabled, parseGenerationLogFilename, prescribe, projCacheRootFor, pruneArchiveFile, pruneHistory, purgeHistory, quarantineProjectionCache, readArchiveSet, readProjectionCache, readSessionGenerations, readTailFacts, scanSessions, scanZstdFrames, sessionPriority, sessionsRootFor };
+export { Config, DEFAULT_CONFIG, type DiscoveredSession, type GenerationArtifact, HEALTH_METHODS, HISTORY_METHODS, HealthCache, type HealthCacheEntry, type LogArtifact, type LogCompression, type RepairAssessment, type RepairVerdict, SOURCE_MIGRATE_BACKUP_SUFFIX, STEWARD_API_PREFIX, STEWARD_SETTINGS_NAMESPACE, type SessionGenerations, type SessionPriority, type StewardConfig, StewardRuntime, V4_HOST_MIN, apply, assessRepair, backupFilesIn, buildProjectionOwnerIndex, buildSessionReport, classifyGenerationFilename, countCorpus, createAttributor, decodeSessionLogBytes, decodeSessionLogFile, dirSize, discoverSessions, editWorkspaceDocument, findSession, findSessionLog, firstLosslessViolation, gateColdRead, gateGeneration, gateLogIntegrity, gateLosslessJson, gateProjectionCache, gateSourceKind, generationLogFilename, handleMethod, indexSessionDirs, inject, isLossless, isMigrationStagingFilename, isSafeChild, isSourceMigrateBackupName, latestArtifactMtime, listHistory, locateSessionUsage, methodEnabled, migrateLegacySource, migrateSessionSourceKind, parseGenerationLogFilename, prescribe, projCacheRootFor, pruneArchiveFile, pruneHistory, purgeHistory, quarantineProjectionCache, readArchiveSet, readProjectionCache, readSessionGenerations, readSourceKindFacts, readTailFacts, scanSessions, scanZstdFrames, sessionPriority, sessionsRootFor };