dsh-manage-session 0.2.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/README.en.md

@@ -10,6 +10,20 @@ A DSH web plugin for **session history files** and **session health checks**. It
 > Naming boundary: **this package ships no search or index features**. Search/indexing belongs to
 > `dsh-search-index`; neither side mentions or re-interprets the other's fields.
 
+## Screenshots
+
+A **Session Steward** entry sits next to Search and Settings at the bottom of the sidebar:
+
+![Sidebar entry](assets/left-sidebar.png)
+
+**Retirement Home (history files)** — the official archive set, each row carrying its size and whether the on-disk entity still exists; select rows to un-archive or purge:
+
+![Retirement Home](assets/archive.png)
+
+**Checkup** — the entry point of the four-gate checkup, which ends in a reversible prescription:
+
+![Checkup](assets/doctor.png)
+
 ## Install
 
 ```bash

package/README.ja.md

@@ -10,6 +10,20 @@
 > 命名の境界：**本パッケージは検索・インデックス機能を一切提供しません**。検索／インデックスは
 > `dsh-search-index` に属し、双方が相手のフィールドに言及したり再解釈したりすることはありません。
 
+## スクリーンショット
+
+サイドバー下部に **「会话管家」**（セッション・スチュワード）のエントリが追加され、検索・設定と並びます：
+
+![サイドバーのエントリ](assets/left-sidebar.png)
+
+**カルテ室（履歴ファイル）** — 公式アーカイブ集合の一覧。各行にサイズとディスク上の実体の有無を表示し、選択してアーカイブ解除または整理ができます：
+
+![カルテ室](assets/archive.png)
+
+**健診** — 四つのゲートによる健診の入口。スキャン後に可逆的な処方を提示します：
+
+![健診](assets/doctor.png)
+
 ## インストール
 
 ```bash

package/README.ko.md

@@ -9,6 +9,20 @@
 > 이름 경계: **이 패키지는 검색이나 인덱스 기능을 제공하지 않습니다**. 검색/인덱싱은
 > `dsh-search-index`에 속하며, 어느 쪽도 상대방의 필드를 언급하거나 재해석하지 않습니다.
 
+## 스크린샷
+
+사이드바 하단에 **「会话管家」**(세션 스튜어드) 항목이 추가되어 검색, 설정과 나란히 표시됩니다:
+
+![사이드바 항목](assets/left-sidebar.png)
+
+**기록 보관소(히스토리 파일)** — 공식 아카이브 집합 목록. 각 행에 용량과 디스크 실체 존재 여부를 표시하며, 선택하여 아카이브 해제 또는 정리를 할 수 있습니다:
+
+![기록 보관소](assets/archive.png)
+
+**점검** — 네 개의 gate 점검 입구이며, 검사 후 되돌릴 수 있는 처방을 제시합니다:
+
+![점검](assets/doctor.png)
+
 ## 설치
 
 ```bash

package/README.md

@@ -28,6 +28,20 @@ DSH Web 插件：**会话历史文件 + 会话健康检查**。
 > 命名边界：**本插件不提供搜索与索引**。搜索/独立索引属于另一片（`dsh-search-index`），
 > 两侧互不出现对方的子域字眼，也不互相解释对方字段。
 
+## 界面预览
+
+侧边栏底部新增 **「会话管家」** 入口，与搜索、设置并列：
+
+![侧边栏入口](assets/left-sidebar.png)
+
+**养老院（会话历史文件）**——官方归档集合一览，每条给出体积与磁盘实体状态；勾选后可取消归档或清理：
+
+![养老院（全部收口状态）](assets/archive.png)
+
+**体检**——四门体检的入口，扫完给出可逆处方：
+
+![体检](assets/doctor.png)
+
 ## 安装
 
 ```bash

package/dsh.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "dsh-manage-session",
   "name": "dsh-manage-session",
-  "version": "0.2.3",
+  "version": "0.4.1",
   "description": {
-    "en": "Session Steward: 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": "会话管家：浏览并批量清理官方会话归档集合，并对会话做四门体检，最终给出可逆、先备份的处方。不改写会话日志。"
+    "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 专线）：浏览并批量清理官方会话归档集合，并对会话做四门体检，最终给出可逆、先备份的处方。不改写会话日志。"
   },
   "homepage": "https://github.com/drscrewdriver/dsh-manage-session",
   "repository": {
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": ">=0.1.2-rc.1 <0.1.3-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": "体检",
@@ -64,15 +65,18 @@ window.__ModuleLoader__.load({
 			"health.scanning": "体检中…",
 			"health.progress": "{done}/{total} · 已用 {sec}s",
 			"health.empty": "未发现异常会话。",
-			"health.clean": "四门全绿。",
+			"health.clean": "全部检查通过。",
 			"health.level.ok": "正常",
 			"health.level.warn": "注意",
 			"health.level.skipped": "未检查",
 			"health.level.fail": "异常",
+			"health.priority.high": "优先",
+			"health.gate.generation": "代次产物",
 			"health.gate.log-integrity": "日志完整性",
 			"health.gate.projection-cache": "投影缓存",
 			"health.gate.lossless-json": "无损 JSON",
 			"health.gate.cold-read": "可接续性",
+			"health.gate.source-kind": "插件署名",
 			"health.attribution": "归属",
 			"health.field": "字段",
 			"health.unknownOwner": "归属未知",
@@ -81,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 后重折叠）",
@@ -109,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",
@@ -142,15 +152,18 @@ window.__ModuleLoader__.load({
 			"health.scanning": "Running…",
 			"health.progress": "{done}/{total} · {sec}s elapsed",
 			"health.empty": "No problem session found.",
-			"health.clean": "All four gates are green.",
+			"health.clean": "All checks passed.",
 			"health.level.ok": "ok",
 			"health.level.warn": "warn",
 			"health.level.skipped": "Not checked",
 			"health.level.fail": "fail",
+			"health.priority.high": "Priority",
+			"health.gate.generation": "Generation artifact",
 			"health.gate.log-integrity": "Log integrity",
 			"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",
@@ -159,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)",
@@ -192,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) {
@@ -265,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 = [];
@@ -669,16 +684,18 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/health-panel.tsx
 		/**
-		* 体检面板：体检（四门）→ 处方（命令清单）→ 出院（可逆处置 + before/after 对照）。
+		* 体检面板：体检（五门）→ 处方（命令清单）→ 出院（可逆处置 + before/after 对照）。
 		*
 		* 三态流转完全由 host 侧报告驱动，客户端只做展示与触发；重型动作都在 host，
 		* 渲染周期内不发同步重活。
 		*/
 		const GATE_LABEL = {
+			"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"
+			"cold-read": "health.gate.cold-read",
+			"source-kind": "health.gate.source-kind"
 		};
 		const LEVEL_LABEL = {
 			ok: "health.level.ok",
@@ -728,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 表示尚未拿到分母）。 */
@@ -783,6 +803,7 @@ window.__ModuleLoader__.load({
 				setError(null);
 				setDetail(null);
 				setDischarge(null);
+				setMigrateNote(null);
 				setFindings(null);
 				setCacheInfo(null);
 				setProgress({
@@ -851,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);
@@ -881,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", {
@@ -1004,6 +1048,10 @@ window.__ModuleLoader__.load({
 							key: "lv",
 							className: `dss_levelPill dss_level_${item.level}`
 						}, translate(t, LEVEL_LABEL[item.level])),
+						item.priority === "high" && (0, react.createElement)("span", {
+							key: "p",
+							className: "dss_meta"
+						}, translate(t, "health.priority.high")),
 						(0, react.createElement)("span", {
 							key: "id",
 							className: "dss_meta dss_uuid"
@@ -1043,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",
@@ -1218,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%}
@@ -1310,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");
@@ -1319,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) {