dsh-input-traffic 0.7.0 → 0.7.3

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/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-external/dsh-input-traffic",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "main": "./lib/index.js",
   "description": "Busy-time input queue: three-tier planning, drag-to-reorder, interject/interrupt, batch clear, session freeze.",
   "engines": {

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",
+			"badgeLabel": "FNESVa_badgeLabel",
 			"list": "FNESVa_list",
-			"toolbar": "FNESVa_toolbar",
+			"clearConfirm": "FNESVa_clearConfirm",
+			"freeze": "FNESVa_freeze",
+			"row": "FNESVa_row",
+			"header": "FNESVa_header",
+			"preview": "FNESVa_preview",
+			"tierNow": "FNESVa_tierNow",
+			"frozenRow": "FNESVa_frozenRow",
+			"clear": "FNESVa_clear",
+			"clearLabel": "FNESVa_clearLabel",
+			"tier": "FNESVa_tier",
+			"tierNext": "FNESVa_tierNext",
+			"tierLater": "FNESVa_tierLater",
+			"badge": "FNESVa_badge",
+			"panel": "FNESVa_panel",
 			"actions": "FNESVa_actions",
-			"badgeLabel": "FNESVa_badgeLabel",
+			"chevron": "FNESVa_chevron",
+			"toolbar": "FNESVa_toolbar",
 			"editor": "FNESVa_editor",
-			"count": "FNESVa_count",
-			"header": "FNESVa_header",
-			"frozenBanner": "FNESVa_frozenBanner",
-			"clearCancel": "FNESVa_clearCancel",
 			"rowDragOver": "FNESVa_rowDragOver",
+			"frozenBanner": "FNESVa_frozenBanner",
+			"toolbarActions": "FNESVa_toolbarActions",
+			"frozenList": "FNESVa_frozenList",
+			"frozenMark": "FNESVa_frozenMark",
+			"badgeNow": "FNESVa_badgeNow",
+			"badgeLater": "FNESVa_badgeLater",
 			"steeringList": "FNESVa_steeringList",
-			"clear": "FNESVa_clear",
+			"lead": "FNESVa_lead",
+			"dock": "FNESVa_dock",
 			"action": "FNESVa_action",
-			"frozenRow": "FNESVa_frozenRow",
-			"frozenMark": "FNESVa_frozenMark",
 			"plan": "FNESVa_plan",
-			"toolbarActions": "FNESVa_toolbarActions",
-			"freeze": "FNESVa_freeze",
-			"lead": "FNESVa_lead",
-			"preview": "FNESVa_preview",
-			"badgeLater": "FNESVa_badgeLater",
-			"tierNow": "FNESVa_tierNow",
-			"row": "FNESVa_row",
-			"panel": "FNESVa_panel",
-			"badgeNow": "FNESVa_badgeNow",
 			"dot": "FNESVa_dot",
-			"tierLater": "FNESVa_tierLater",
+			"count": "FNESVa_count",
 			"badgeNext": "FNESVa_badgeNext",
-			"tier": "FNESVa_tier",
-			"tierNext": "FNESVa_tierNext",
-			"chevron": "FNESVa_chevron",
-			"badge": "FNESVa_badge",
-			"frozenList": "FNESVa_frozenList",
-			"clearLabel": "FNESVa_clearLabel",
-			"clearConfirm": "FNESVa_clearConfirm"
+			"clearCancel": "FNESVa_clearCancel"
 		};
 		//#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);
 			});
 		}
 		/**
@@ -1831,19 +1951,33 @@ 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);
+				});
+			});
+			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: familyScopeRef.scope ?? bridgeScope })
+			}, InputTrafficFamilyCard));
 			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({