dsh-input-traffic 0.7.0 → 0.7.4

package/CHANGELOG.md

@@ -2,16 +2,37 @@
 
 所有重要变更与 bug 修复记录于此。版本遵循语义化版本（`dsh plugin --profile web add dsh-input-traffic` 安装）。
 
-## 0.5.5 — 2026-09-30
-
-### 修复：队列行改读 inbox 投影（真实宿主渲染修复，实测 0.1.7-rc.2）
-
-- 真实宿主的排队行不在会话快照上：组件改从 useProjection('inbox') 读取（next-turn=排队/绿档，next-step=插话/黄档），与官方 QueueDock 同源。此前读取的 s.queue 为类型镜像自造字段，行渲染必崩并回退官方队列。
-- queueMutable 与官方判定对齐：continuable 子代理上下文同样可操作（此前整块操作按钮会在子代理会话中消失）。
-- 移除真机上失效的「打回输入框」按钮（setDraft 为未文档化面）；黄色档位是唯一插话入口。
-- 行文本改由 content 块派生（textOf，对齐官方 textOf/previewOf），修复行预览空白。
-- 三色档位圆点固定字面量配色：自定义皮肤（如 ui-skin-maid-atelier）重定义 warn 别名 token 会把黄点洗成不可见。
-- CSS 压制官方 QueueDock 容器（仅崩溃回退态的可见性兜底）；修复 verify-assembly 陈旧断言（settingsScope → configForms）。
+## 0.7.3 — 2026-10-08
+
+### 新增：settings 数据桥（T20-b，perm-gate 5260fe6 泛化形移植）
+
+- 老线（≤0.1.5）上 client settings 句柄永不 resolve（settingsScope 死路），家族卡
+  降级「设置服务不可用」、busyEnter 钉值静默失效。node 半区从 no-op 转正：loader
+  `inject=['webServer']` + `settings` 子注入挂活引用，暴露
+  `/api/ui-conversation/settings/{describe,mutate}`；client 半区 BridgeDocHandle
+  双轨（原生句柄优先、桥兜底），钉值在原生缺席时由桥首拉 ready 后补发一次。
+  前提实证：0.1.0 宿主 settings 服务全款具备 describe/mutate/redactSecrets 面，
+  最老线无需兜底。五格验收：四条桥线卡片真数据、0.1.7 原生无回归、桥写回落盘。
+- 顺修 family-card 条件 hook（useSyncExternalStore 无条件调用；降级快照走模块级
+  常量）。
+
+### 0.7.1 / 0.7.2 未单独发版（tgz 直铺五格），随本版一并进 npm
+
+- 0.7.0：15rc 枚举单版本线（六 peer × 15 rc 全存在），latest + 四线 tag 收敛（已发）。
+- 0.7.1：`dsh-family.tab` 注册提顶层 + scopeRef 活引用（≤0.1.5 家族节贡献卡缺席修复）。
+- 0.7.2：settings waist 回调按 cordis 契约从 scope 对象按名读服务（裸服务调用 =
+  每代 TypeError、纤维暗死，busyEnter 钉值因此从未生效）。
+
+## 0.5.5 — 2026-09-30
+
+### 修复：队列行改读 inbox 投影（真实宿主渲染修复，实测 0.1.7-rc.2）
+
+- 真实宿主的排队行不在会话快照上：组件改从 useProjection('inbox') 读取（next-turn=排队/绿档，next-step=插话/黄档），与官方 QueueDock 同源。此前读取的 s.queue 为类型镜像自造字段，行渲染必崩并回退官方队列。
+- queueMutable 与官方判定对齐：continuable 子代理上下文同样可操作（此前整块操作按钮会在子代理会话中消失）。
+- 移除真机上失效的「打回输入框」按钮（setDraft 为未文档化面）；黄色档位是唯一插话入口。
+- 行文本改由 content 块派生（textOf，对齐官方 textOf/previewOf），修复行预览空白。
+- 三色档位圆点固定字面量配色：自定义皮肤（如 ui-skin-maid-atelier）重定义 warn 别名 token 会把黄点洗成不可见。
+- CSS 压制官方 QueueDock 容器（仅崩溃回退态的可见性兜底）；修复 verify-assembly 陈旧断言（settingsScope → configForms）。
 ## 0.5.4 — 2026-09-29
 
 ### 修复：0.1.7 线 devDeps 基线对齐 + dock 图标渲染崩溃

package/README.en.md

@@ -52,7 +52,7 @@ A cordis client plugin assembled via the `dsh plugin` command and a bundle patch
 > **Suggested pairing for now**: use it together with a **reminder** plugin (e.g. [dsh-notify](https://github.com/zhengjy01/dsh-notify), desktop notifications when it is time to freeze/resume) and a **billing/usage** plugin (e.g. [dsh-deepseek-usage](https://github.com/yyb16yyb-hub/dsh-deepseek-usage), [dsh-cost-tracker](https://github.com/yflmq001/dsh-cost-tracker), [dsh-billing-balance](https://github.com/YZz-S/dsh-billing-balance), to verify actual spend around a freeze) — a "remind → freeze → resume off-peak → verify" saving loop.
 
 <!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
-- **Supported DSH hosts:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (15 rc releases across lines 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+- **Supported DSH hosts:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` `0.2.1-rc.1` (16 rc releases across lines 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 / 0.2.1)
 - **Runtime-verified:** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2` — evidence in `.compat-results/`
 <!-- host-compat:end -->
 

package/README.ja.md

@@ -35,7 +35,7 @@
 > **推奨セットアップ**：**リマインダー**プラグイン（[dsh-notify](https://github.com/zhengjy01/dsh-notify) など、凍結/再開のタイミングをデスクトップ通知）と**課金統計**プラグイン（[dsh-deepseek-usage](https://github.com/yyb16yyb-hub/dsh-deepseek-usage)、[dsh-cost-tracker](https://github.com/yflmq001/dsh-cost-tracker)、[dsh-billing-balance](https://github.com/YZz-S/dsh-billing-balance) など、凍結前後の実際の支出を確認）を組み合わせ、「リマインド → 凍結 → オフピーク再開 → 精算」の節約ループを実現します。
 
 <!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
-- **対応する DSH ホスト:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2`（0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 の 15 rc）
+- **対応する DSH ホスト:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` `0.2.1-rc.1`（0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 / 0.2.1 の 16 rc）
 - **ランタイム検証済み:** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2`（証跡は `.compat-results/`）
 <!-- host-compat:end -->
 

package/README.ko.md

@@ -35,7 +35,7 @@
 > **권장 구성**: **알림** 플러그인([dsh-notify](https://github.com/zhengjy01/dsh-notify), 동결/재개 시점 데스크톱 알림)과 **과금 통계** 플러그인([dsh-deepseek-usage](https://github.com/yyb16yyb-hub/dsh-deepseek-usage), [dsh-cost-tracker](https://github.com/yflmq001/dsh-cost-tracker), [dsh-billing-balance](https://github.com/YZz-S/dsh-billing-balance), 동결 전후 실제 지출 확인)을 함께 사용하여 "알림 → 동결 → 오피크 재개 → 정산" 절약 루ープ를 실현합니다.
 
 <!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
-- **지원하는 DSH 호스트:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 라인의 15개 rc)
+- **지원하는 DSH 호스트:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` `0.2.1-rc.1` (0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 / 0.2.1 라인의 16개 rc)
 - **런타임 검증됨:** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2` (증적은 `.compat-results/`)
 <!-- host-compat:end -->
 

package/README.md

@@ -57,7 +57,7 @@
 > **目前建议搭配**：配合**一般提醒**插件（如 [dsh-notify](https://github.com/zhengjy01/dsh-notify)，到点桌面提醒「该冻结/该恢复」）与**计费统计**插件（如 [dsh-deepseek-usage](https://github.com/yyb16yyb-hub/dsh-deepseek-usage)、[dsh-cost-tracker](https://github.com/yflmq001/dsh-cost-tracker)、[dsh-billing-balance](https://github.com/YZz-S/dsh-billing-balance)，核对冻结前后的实际花费），形成「提醒 → 冻结 → 错峰恢复 → 对账」的省钱闭环。
 
 <!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
-- **支持的 DSH 宿主：** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2`（覆盖 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 六条线共 15 个 rc）
+- **支持的 DSH 宿主：** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` `0.2.1-rc.1`（覆盖 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 / 0.2.1 共 7 条线 16 个 rc）
 - **运行时已验证：** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2`（证据见 `.compat-results/`）
 <!-- host-compat:end -->
 

package/dsh.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "dsh-external/dsh-input-traffic",
-  "version": "0.7.0",
+  "version": "0.7.4",
   "main": "./lib/index.js",
   "description": "Busy-time input queue: three-tier planning, drag-to-reorder, interject/interrupt, batch clear, session freeze.",
   "engines": {
-    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1"
   },
   "contributes": {
     "tools": [],

package/lib/client.js

@@ -600,42 +600,42 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var steer_queue_dock_module_css_default = {
-			"dock": "FNESVa_dock",
-			"list": "FNESVa_list",
-			"toolbar": "FNESVa_toolbar",
+			"action": "FNESVa_action",
 			"actions": "FNESVa_actions",
+			"badge": "FNESVa_badge",
 			"badgeLabel": "FNESVa_badgeLabel",
-			"editor": "FNESVa_editor",
+			"badgeLater": "FNESVa_badgeLater",
+			"badgeNext": "FNESVa_badgeNext",
+			"badgeNow": "FNESVa_badgeNow",
+			"chevron": "FNESVa_chevron",
+			"clear": "FNESVa_clear",
+			"clearCancel": "FNESVa_clearCancel",
+			"clearConfirm": "FNESVa_clearConfirm",
+			"clearLabel": "FNESVa_clearLabel",
 			"count": "FNESVa_count",
-			"header": "FNESVa_header",
+			"dock": "FNESVa_dock",
+			"dot": "FNESVa_dot",
+			"editor": "FNESVa_editor",
+			"freeze": "FNESVa_freeze",
 			"frozenBanner": "FNESVa_frozenBanner",
-			"clearCancel": "FNESVa_clearCancel",
-			"rowDragOver": "FNESVa_rowDragOver",
-			"steeringList": "FNESVa_steeringList",
-			"clear": "FNESVa_clear",
-			"action": "FNESVa_action",
-			"frozenRow": "FNESVa_frozenRow",
+			"frozenList": "FNESVa_frozenList",
 			"frozenMark": "FNESVa_frozenMark",
-			"plan": "FNESVa_plan",
-			"toolbarActions": "FNESVa_toolbarActions",
-			"freeze": "FNESVa_freeze",
+			"frozenRow": "FNESVa_frozenRow",
+			"header": "FNESVa_header",
 			"lead": "FNESVa_lead",
+			"list": "FNESVa_list",
+			"panel": "FNESVa_panel",
+			"plan": "FNESVa_plan",
 			"preview": "FNESVa_preview",
-			"badgeLater": "FNESVa_badgeLater",
-			"tierNow": "FNESVa_tierNow",
 			"row": "FNESVa_row",
-			"panel": "FNESVa_panel",
-			"badgeNow": "FNESVa_badgeNow",
-			"dot": "FNESVa_dot",
-			"tierLater": "FNESVa_tierLater",
-			"badgeNext": "FNESVa_badgeNext",
+			"rowDragOver": "FNESVa_rowDragOver",
+			"steeringList": "FNESVa_steeringList",
 			"tier": "FNESVa_tier",
+			"tierLater": "FNESVa_tierLater",
 			"tierNext": "FNESVa_tierNext",
-			"chevron": "FNESVa_chevron",
-			"badge": "FNESVa_badge",
-			"frozenList": "FNESVa_frozenList",
-			"clearLabel": "FNESVa_clearLabel",
-			"clearConfirm": "FNESVa_clearConfirm"
+			"tierNow": "FNESVa_tierNow",
+			"toolbar": "FNESVa_toolbar",
+			"toolbarActions": "FNESVa_toolbarActions"
 		};
 		//#endregion
 		//#region src/client/steer-queue-dock.tsx
@@ -1722,9 +1722,23 @@ window.__ModuleLoader__.load({
 			fontSize: 12,
 			lineHeight: 1.5
 		};
+		/** 无 scope 时的降级快照（模块级常量：useSyncExternalStore 要求稳定引用）。 */
+		const DEGRADED_SNAPSHOT = {
+			status: "unavailable",
+			value: void 0,
+			writable: false
+		};
 		function InputTrafficFamilyCard({ scope, t }) {
-			const pinned = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot()).value?.busyEnter ?? "queue";
+			const snapshot = (0, react.useSyncExternalStore)((listener) => scope?.subscribe(listener) ?? (() => {}), () => scope?.getSnapshot() ?? DEGRADED_SNAPSHOT);
 			const tr = (key) => t ? t(key) : FALLBACK_ZH[key] ?? key;
+			if (!scope) return (0, react.createElement)("div", { style: {
+				display: "grid",
+				gap: 6
+			} }, (0, react.createElement)("p", { style: {
+				...dim,
+				margin: 0
+			} }, `${tr("family.desc")}（当前宿主设置服务不可用 — 只读）`));
+			const pinned = snapshot.value?.busyEnter ?? "queue";
 			return (0, react.createElement)("div", { style: {
 				display: "grid",
 				gap: 6
@@ -1745,6 +1759,107 @@ window.__ModuleLoader__.load({
 			return null;
 		}
 		//#endregion
+		//#region src/client/bridge-scope.ts
+		/** Must match src/bridge.ts bridgeRoutesFor character for character. */
+		function bridgeRoutesFor(ns) {
+			return {
+				describe: `/api/${ns}/settings/describe`,
+				mutate: `/api/${ns}/settings/mutate`
+			};
+		}
+		var BridgeDocHandle = class {
+			snapshot = {
+				status: "pending",
+				value: void 0,
+				writable: true
+			};
+			listeners = /* @__PURE__ */ new Set();
+			revision;
+			inflight;
+			routes;
+			constructor(ns) {
+				this.routes = bridgeRoutesFor(ns);
+				this.refresh();
+			}
+			/** The bridge transport is shape-agnostic; the ns payload narrows at this boundary. */
+			getSnapshot() {
+				return this.snapshot;
+			}
+			subscribe(listener) {
+				this.listeners.add(listener);
+				return () => {
+					this.listeners.delete(listener);
+				};
+			}
+			async set(field, value) {
+				await this.mutate([{
+					op: "set",
+					path: [field],
+					value
+				}]);
+			}
+			notify() {
+				for (const l of [...this.listeners]) l();
+			}
+			async request(path, body) {
+				const response = await fetch(path, {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify(body ?? {})
+				});
+				if (!response.ok) throw new Error(`bridge ${path} HTTP ${response.status}`);
+				return await response.json();
+			}
+			async refresh() {
+				if (this.inflight !== void 0) return this.inflight;
+				this.inflight = (async () => {
+					try {
+						const body = await this.request(this.routes.describe);
+						if (body.ok && body.value?.descriptor !== void 0) {
+							const d = body.value.descriptor;
+							this.revision = typeof d.revision === "number" ? d.revision : void 0;
+							this.snapshot = {
+								status: "ready",
+								value: d.value,
+								writable: body.value.writable !== false
+							};
+						} else this.snapshot = {
+							status: "error",
+							value: void 0,
+							writable: false
+						};
+					} catch {
+						this.snapshot = {
+							status: "error",
+							value: void 0,
+							writable: false
+						};
+					} finally {
+						this.inflight = void 0;
+					}
+					this.notify();
+				})();
+				return this.inflight;
+			}
+			async mutate(ops) {
+				const body = await this.request(this.routes.mutate, {
+					ops,
+					expectedRevision: this.revision
+				});
+				if (body.ok && body.value?.descriptor !== void 0) {
+					const d = body.value.descriptor;
+					this.revision = typeof d.revision === "number" ? d.revision : void 0;
+					this.snapshot = {
+						status: "ready",
+						value: d.value,
+						writable: this.snapshot.writable
+					};
+				} else if (body.code === "settings-conflict") await this.refresh();
+				else throw new Error(`bridge mutate failed: ${body.code ?? "unknown"} ${body.message ?? ""}`);
+				this.notify();
+			}
+		};
+		//#endregion
 		//#region src/client/compat.ts
 		/**
 		* Pin the busy-Enter field through whichever durable-settings service this
@@ -1755,15 +1870,20 @@ window.__ModuleLoader__.load({
 		* as the family tab's slot-inject when the family holder is absent).
 		*/
 		function registerSettingsFaces(ctx, deps) {
-			ctx.inject(["configForms"], (configForms) => {
-				const scope = configForms.get(deps.namespace);
-				scope.set(deps.field, deps.value);
-				deps.onScope(scope);
+			const scopeInject = ctx.inject;
+			scopeInject(["configForms"], (scope) => {
+				const forms = scope.configForms;
+				if (forms === void 0) return;
+				const handle = forms.get(deps.namespace);
+				handle.set(deps.field, deps.value);
+				deps.onScope(handle);
 			});
-			ctx.inject(["settingsScope"], (settingsScope) => {
-				const scope = settingsScope.bind({ namespace: deps.namespace });
-				scope.set(deps.field, deps.value);
-				deps.onScope(scope);
+			scopeInject(["settingsScope"], (scope) => {
+				const settingsScope = scope.settingsScope;
+				if (settingsScope === void 0) return;
+				const handle = settingsScope.bind({ namespace: deps.namespace });
+				handle.set(deps.field, deps.value);
+				deps.onScope(handle);
 			});
 		}
 		/**
@@ -1779,6 +1899,139 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/family-host.ts
+		/**
+		* 家族容器兜底接管（family host backstop）。
+		*
+		* 为什么需要：本插件把设置卡挂在 `dsh-family.tab` 上，而那个子席位由**别的插件**
+		* （thinking-levels / session-guard / session-steward / dsh-mcp-registry）声明。
+		* 宿主的规则是「注册未声明的槽直接抛」，且声明全局唯一、先到先得——所以只要那几家
+		* 全部让位或声明失败，本插件的设置面就整轮启动不可见，而且**不报任何错**
+		* （inject 工厂在槽未声明时压根不跑）。
+		*
+		* 本模块把"看不见"变成"自己上位"：延迟到分级时刻检查**自己的 tab 工厂有没有被跑过**
+		* ——那是插件侧唯一合法的「有人声明了吗」探针（宿主只在声明成立后才执行工厂）。
+		* 没跑过 → 自己注册一个通用容器，声明子席位，按账本渲染所有贡献卡（含自己的）。
+		*
+		* declare-or-withdraw：声明子席位失败（别人已持有）时**绝不**退回不带 children 的
+		* 裸注册——残废容器会占住导航行、让后来者按「已有 dsh-family」集体退场，
+		* 这正是 2026-10-14 家族面板丢失的成因。
+		*/
+		/** 家族节固定 id 与子席位 key（与 thinking-levels 的声明严格一致）。 */
+		const FAMILY_SECTION_ID = "dsh-family";
+		const FAMILY_CHILD_KEY = "dsh-family.tab";
+		/** 派生而非硬编码：改 rank 表就自动改时刻。 */
+		const FAMILY_CLAIM_DELAY_MS = 1100;
+		/** 接管行的遮蔽优先级：必须大于任何正牌 owner（TL 无=0、guard=10），
+		* 这样 owner 一旦上位就自然遮蔽本兜底行（宿主规则：同 cell 最低者渲染）。 */
+		const FAMILY_HOST_PRIORITY = 50;
+		const NO_TABS = [];
+		/** 通用容器渲染：按 order 依次画出账本里每张贡献卡，不含任何"本插件特例"。 */
+		function FamilyHostSection(props) {
+			const raw = props.hooks?.tabs;
+			const [polled, setPolled] = (0, react.useState)(() => raw?.getSnapshot() ?? NO_TABS);
+			(0, react.useEffect)(() => {
+				if (props.useTabs !== void 0 || raw === void 0) return;
+				return raw.subscribe(() => setPolled(raw.getSnapshot()));
+			});
+			const tabs = props.useTabs !== void 0 ? props.useTabs((value) => value) : polled;
+			return (0, react.createElement)("div", { style: {
+				display: "grid",
+				gap: "12px"
+			} }, tabs.map((row) => (0, react.createElement)("div", { key: row.id }, props.renderSlot ? props.renderSlot(FAMILY_CHILD_KEY, {}, {
+				only: row.id,
+				fallback: null
+			}) : props.renderContributor?.(row.id) ?? null)));
+		}
+		/** 取条目上的具名面（宿主条目是结构化对象，这里只做安全读取）。 */
+		function face(entry, key) {
+			if (entry === null || typeof entry !== "object") return void 0;
+			return entry[key];
+		}
+		/** 条目的 options 收窄（宿主侧是结构化对象，缺失时当空对象读）。 */
+		function optionsOf(entry) {
+			const raw = face(entry, "options");
+			return raw !== null && typeof raw === "object" ? raw : {};
+		}
+		/** 把账本条目投影成标题行：label 可能是函数，抛错退化成 id，绝不带崩整节。 */
+		function projectLedger(slots) {
+			return slots.entries(FAMILY_CHILD_KEY).map((rawEntry) => {
+				const options = rawEntry.options ?? {};
+				const id = String(options["id"] ?? "");
+				const rawLabel = options["label"];
+				let label = id;
+				if (typeof rawLabel === "function") try {
+					label = String(rawLabel() ?? id);
+				} catch {
+					label = id;
+				}
+				else if (typeof rawLabel === "string") label = rawLabel;
+				return {
+					id,
+					order: Number(options["order"] ?? 0),
+					label
+				};
+			}).sort((a, b) => a.order - b.order);
+		}
+		/**
+		* 若到点仍无人声明子席位，则自己接管容器。
+		* @param slots - 客户端槽门面。
+		* @param isHeld - 探针：本插件的 tab 工厂是否已被执行（= 有人声明了子席位）。
+		* @param label - 导航标题；家族共享节的标题，不是本插件名。
+		* @param log - console 前缀（带插件名）。
+		* @returns 取消定时器与撤销接管注册的 disposer。
+		*/
+		function claimFamilyHostIfOrphaned(slots, isHeld, label, log) {
+			let disposeClaim;
+			let claimed = false;
+			const timer = setTimeout(() => {
+				if (isHeld()) return;
+				const ledger = {
+					getSnapshot: () => projectLedger(slots),
+					subscribe: (listener) => slots.subscribe ? slots.subscribe(FAMILY_CHILD_KEY, listener) : () => void 0
+				};
+				/** ≤0.1.5 壳没有 renderSlot：从账本条目现挂组件，失败一律 null。 */
+				const renderContributor = (id) => {
+					try {
+						const entry = slots.entries(FAMILY_CHILD_KEY).find((candidate) => String(optionsOf(candidate)["id"] ?? "") === id);
+						const component = entry ? face(entry, "component") : void 0;
+						const inject = entry ? face(entry, "inject") : void 0;
+						if (typeof component !== "function") return null;
+						const injected = typeof inject === "function" ? inject() : {};
+						return (0, react.createElement)(component, injected ?? {});
+					} catch {
+						return null;
+					}
+				};
+				try {
+					const dispose = slots.register({
+						name: "settings.section",
+						id: FAMILY_SECTION_ID,
+						order: 40,
+						priority: FAMILY_HOST_PRIORITY,
+						label,
+						inject: () => ({
+							hooks: { tabs: ledger },
+							renderContributor
+						}),
+						children: { [FAMILY_CHILD_KEY]: {
+							kind: "list",
+							scope: "root"
+						} }
+					}, FamilyHostSection);
+					if (typeof dispose === "function") disposeClaim = dispose;
+					claimed = true;
+					console.warn(`${log} family container unclaimed — took it over (children declared)`);
+				} catch (error) {
+					console.warn(`${log} family claim lost — withdrawing (${error instanceof Error ? error.message : String(error)})`);
+				}
+			}, FAMILY_CLAIM_DELAY_MS);
+			return () => {
+				clearTimeout(timer);
+				if (claimed) disposeClaim?.();
+			};
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/** Durable conversation settings namespace owned by ui-conversation. */
 		const CONVERSATION_SETTINGS_NAMESPACE = "ui-conversation";
@@ -1831,19 +2084,38 @@ window.__ModuleLoader__.load({
 		function apply(ctx) {
 			ctx.effect(() => ctx.locale.register(NS, dictionaries), "dsh-input-traffic: dictionaries");
 			const tFamily = ctx.locale.bind(NS);
+			const familyScopeRef = {};
+			const bridgeScope = new BridgeDocHandle(CONVERSATION_SETTINGS_NAMESPACE);
+			let nativeScopeResolved = false;
+			let bridgePinned = false;
+			bridgeScope.subscribe(() => {
+				if (bridgePinned || nativeScopeResolved) return;
+				if (bridgeScope.getSnapshot().status !== "ready") return;
+				bridgePinned = true;
+				bridgeScope.set(BUSY_ENTER_FIELD, "queue").catch((e) => {
+					console.warn("[dsh-input-traffic] bridge busyEnter pin failed:", e);
+				});
+			});
+			let familyTabHeld = false;
+			ctx.slots.inject("dsh-family.tab", () => {
+				familyTabHeld = true;
+				return ctx.slots.register({
+					name: "dsh-family.tab",
+					id: "input-traffic",
+					order: 50,
+					label: () => tFamily("family.title"),
+					locale: NS,
+					inject: () => ({ scope: familyScopeRef.scope ?? bridgeScope })
+				}, InputTrafficFamilyCard);
+			});
+			ctx.effect(() => claimFamilyHostIfOrphaned(ctx.slots, () => familyTabHeld, () => "起子插件设置", "[dsh-input-traffic]"), "dsh-input-traffic: family host backstop");
 			registerSettingsFaces(ctx, {
 				namespace: CONVERSATION_SETTINGS_NAMESPACE,
 				field: BUSY_ENTER_FIELD,
 				value: "queue",
 				onScope: (scope) => {
-					ctx.slots.inject("dsh-family.tab", () => ctx.slots.register({
-						name: "dsh-family.tab",
-						id: "input-traffic",
-						order: 50,
-						label: () => tFamily("family.title"),
-						locale: NS,
-						inject: () => ({ scope })
-					}, InputTrafficFamilyCard));
+					familyScopeRef.scope = scope;
+					nativeScopeResolved = true;
 				}
 			});
 			ctx.slots.inject("conversation.input.dock", () => ctx.slots.register({