dsh-background-by-model 0.4.1 → 0.4.2

package/lib/client.js

@@ -25,9 +25,11 @@ window.__ModuleLoader__.load({
 			pageInterface: "界面",
 			pageModelBg: "模型背景",
 			pageProfile: "配置",
+			pageHostCheck: "宿主自检",
 			descInterface: "为主界面的各个区域单独调节透明度与模糊，营造空间层次感。这里的设置对所有模型生效",
 			descModelBg: "每条规则 = 一个匹配串 + 一套背景外观。切换模型时，从上往下找第一条匹配串出现在模型名里的规则；都没中就使用第 1 条",
 			descProfile: "把当前全部规则连同图片导出备份，或从文件一键恢复",
+			descHostCheck: "逐条检查本插件依赖的宿主接口在这个 dsh 版本上是否还在：会话与模型服务、它着色的界面元素、以及被重新发出的设计令牌。红色那一行就是坏掉的地方",
 			uiTitle: "主界面",
 			uiOpacity: "透明度",
 			uiBlur: "模糊度",
@@ -121,7 +123,32 @@ window.__ModuleLoader__.load({
 			toastExportDone: "配置文件已开始下载",
 			importDone: "已导入配置",
 			importFail: "导入失败，文件格式不正确",
-			footerTag: "按模型换背景插件"
+			footerTag: "按模型换背景插件",
+			hostAllOk: "这个 dsh 版本上一切正常",
+			hostPartial: "有东西坏掉了",
+			hostBroken: "插件依赖的接口全都不见了",
+			hostUnknown: "还读不到结果",
+			hostSummary: "{pass} 项正常 · {fail} 项失效 · {skip} 项当前无法观察",
+			hostRunning: "检查中…",
+			hostRerun: "重新检查",
+			hostCopy: "复制诊断报告",
+			hostCopied: "诊断报告已复制",
+			hostCopyFail: "复制失败，浏览器拒绝了剪贴板访问",
+			hostPass: "正常",
+			hostFail: "失效",
+			hostNa: "未观察",
+			hostInfo: "仅记录",
+			hostPlugin: "插件",
+			hostPluginFloor: "要求 dsh",
+			hostDiskScan: "安装文件",
+			hostUnreadable: "未读到",
+			hostModel: "当前模型",
+			hostModelNone: "未检测到",
+			hostExpectedIn: "应该还在",
+			hostUsedBy: "本插件读取处",
+			hostBelowFloor: "当前 dsh 版本低于本插件声明的下限，宿主可能已经拒绝加载它。升级 dsh，或用 dsh plugin allow-version 明确放行。",
+			hostDiskFailures: "有 {n} 条契约在安装目录里已经找不到对应的宿主代码 —— 说明它们被改名或删掉了，而不是这次没观察到。",
+			hostHint: "灰色的「未观察」不是故障：设置弹窗打开时看不到对话页，没开过文件时右侧栏也不在 DOM 里。想让它变绿，把对应界面打开再看一次。"
 		};
 		const en = {
 			nav: "Model background",
@@ -130,9 +157,11 @@ window.__ModuleLoader__.load({
 			pageInterface: "Interface",
 			pageModelBg: "Model background",
 			pageProfile: "Profile",
+			pageHostCheck: "Host check",
 			descInterface: "Tune opacity and blur per surface to build depth. These settings are global and apply to every model",
 			descModelBg: "Each rule is a match string plus one look. On a model switch the list is scanned top-down for the first match string contained in the model name; if nothing hits, rule 1 is used",
 			descProfile: "Back up every rule together with its image, or restore one from a file",
+			descHostCheck: "Checks every host interface this plugin depends on against the dsh build you are running: the session and model services, the elements it paints, and the design tokens it re-emits. The red line is what broke",
 			uiTitle: "Interface",
 			uiOpacity: "Opacity",
 			uiBlur: "Blur",
@@ -226,7 +255,32 @@ window.__ModuleLoader__.load({
 			toastExportDone: "Export started",
 			importDone: "Profile imported",
 			importFail: "Import failed — invalid file",
-			footerTag: "Per-model wallpaper plugin"
+			footerTag: "Per-model wallpaper plugin",
+			hostAllOk: "Everything holds on this dsh build",
+			hostPartial: "Something broke",
+			hostBroken: "None of the interfaces this plugin needs are there",
+			hostUnknown: "No result yet",
+			hostSummary: "{pass} ok · {fail} broken · {skip} not observable right now",
+			hostRunning: "Checking…",
+			hostRerun: "Check again",
+			hostCopy: "Copy diagnostics",
+			hostCopied: "Diagnostics copied",
+			hostCopyFail: "Copy failed — the browser denied clipboard access",
+			hostPass: "ok",
+			hostFail: "broken",
+			hostNa: "n/a",
+			hostInfo: "note",
+			hostPlugin: "Plugin",
+			hostPluginFloor: "needs dsh",
+			hostDiskScan: "Installed files",
+			hostUnreadable: "unreadable",
+			hostModel: "Current model",
+			hostModelNone: "not detected",
+			hostExpectedIn: "Should still be in",
+			hostUsedBy: "Read by",
+			hostBelowFloor: "This dsh is older than the floor this plugin declares, so the host may already refuse to load it. Update dsh, or grant it explicitly with dsh plugin allow-version.",
+			hostDiskFailures: "{n} contract(s) can no longer be found in the installed host code — they were renamed or removed, this is not just \"not observable right now\".",
+			hostHint: "A grey \"n/a\" is not a failure: the conversation view is off screen while the settings dialog is open, and the right panel is not in the DOM until a file has been opened. Open that surface and check again to turn it green."
 		};
 		//#endregion
 		//#region src/schema.ts
@@ -687,6 +741,21 @@ window.__ModuleLoader__.load({
 			const parts = [d.provider, d.model].filter((s) => typeof s === "string" && s !== "");
 			return parts.length > 0 ? parts.join(" ") : null;
 		}
+		/**
+		* The installed-host half of the self-check: the host version and whether the
+		* packages on disk still contain every literal the plugin depends on.
+		*
+		* Returns null when the node half does not answer (an older build of this plugin
+		* still mounted, a host without the RPC channel); the panel then shows the live
+		* probe alone rather than claiming the disk scan passed.
+		*/
+		async function readHostScan(lang) {
+			const data = await rpcCall("hostCheck", { lang });
+			if (data === null || typeof data !== "object") return null;
+			const d = data;
+			if (!Array.isArray(d.results)) return null;
+			return data;
+		}
 		//#endregion
 		//#region src/client/utils/color.ts
 		function hsvToHsl(h, s, v) {
@@ -2098,6 +2167,1193 @@ window.__ModuleLoader__.load({
 				release();
 			};
 		}
+		//#endregion
+		//#region src/host-contracts.ts
+		const SIDEBAR_RIGHT = "dsh-client-ui-sidebar-right";
+		/**
+		* The contract table.
+		*
+		* Ordered by group and then by how visible a break is: the model hop first (the
+		* plugin's whole purpose), then the surfaces it paints, then the tokens it
+		* re-emits, then the regions it decorates.
+		*/
+		const HOST_CONTRACTS = [
+			{
+				id: "sessions.list",
+				group: "model",
+				kind: "host-service",
+				criticality: "core",
+				since: "0.1.7",
+				label: {
+					en: "Session list service",
+					zh: "会话列表服务"
+				},
+				symptom: {
+					en: "no session id can be read, so the background is stuck on rule 1 and never follows the model",
+					zh: "读不到会话 id，背景会一直停在规则 1，不再跟着模型切换"
+				},
+				target: "sessions.list",
+				checks: [
+					{
+						kind: "service",
+						id: "sessions"
+					},
+					{
+						kind: "path",
+						service: "sessions",
+						path: "list",
+						expect: "observable"
+					},
+					{
+						kind: "path",
+						service: "sessions",
+						path: "list.getSnapshot",
+						expect: "function"
+					}
+				],
+				sources: [{
+					path: "dsh-api-session-controller/lib/client.js",
+					literal: "retainedBy"
+				}],
+				usedBy: "src/client/modelbg.ts"
+			},
+			{
+				id: "sessions.list.current",
+				group: "model",
+				kind: "host-service",
+				criticality: "label",
+				since: "<=0.1.6",
+				label: {
+					en: "Session list: legacy current id",
+					zh: "会话列表：旧版 current 字段"
+				},
+				symptom: {
+					en: "harmless on its own — the 0.1.7 hops below take over",
+					zh: "本身无害 —— 0.1.7 上由下面的兜底路径接管"
+				},
+				target: "list.current",
+				checks: [],
+				sources: [{
+					path: "dsh-api-session-controller/lib/client.js",
+					literal: "retainedBy"
+				}],
+				usedBy: "src/client/modelbg.ts"
+			},
+			{
+				id: "sessions.retainedBy.mainView",
+				group: "model",
+				kind: "host-service",
+				criticality: "label",
+				since: "0.1.7",
+				label: {
+					en: "Main-view retention on the session row",
+					zh: "会话行的主视图占用标记"
+				},
+				symptom: {
+					en: "while uiSession is not mounted yet, no session id can be derived",
+					zh: "uiSession 尚未挂载时推导不出会话 id"
+				},
+				target: "byId[].retainedBy.mainView",
+				checks: [],
+				sources: [{
+					path: "dsh-api-session-controller/lib/client.js",
+					literal: "retainedBy"
+				}],
+				usedBy: "src/client/modelbg.ts"
+			},
+			{
+				id: "uiSession.current",
+				group: "model",
+				kind: "host-service",
+				criticality: "core",
+				since: "0.1.7",
+				label: {
+					en: "uiSession service (main view session)",
+					zh: "uiSession 服务（主视图会话）"
+				},
+				symptom: {
+					en: "the session id can only be guessed from the list retention",
+					zh: "会话 id 只能退回用列表占用标记去猜"
+				},
+				target: "uiSession.current",
+				checks: [{
+					kind: "path",
+					service: "uiSession",
+					path: "current",
+					expect: "observable"
+				}],
+				sources: [{
+					path: "dsh-client-ui-session/lib/client.js",
+					literal: "uiSession"
+				}],
+				usedBy: "src/client/modelbg.ts"
+			},
+			{
+				id: "sessions.binding.projections",
+				group: "model",
+				kind: "host-service",
+				criticality: "core",
+				since: "<=0.1.6",
+				label: {
+					en: "Session binding + projections",
+					zh: "会话 binding 与 projections"
+				},
+				symptom: {
+					en: "this session's own model selection is unreadable — only the host default is left",
+					zh: "读不到本会话自己的模型选择，只剩宿主默认模型可用"
+				},
+				target: "binding(id).session.projections.faceOf(\"modelSelection\")",
+				checks: [{
+					kind: "path",
+					service: "sessions",
+					path: "binding",
+					expect: "function"
+				}],
+				sources: [{
+					path: "dsh-api-session-controller/lib/client.js",
+					literal: "faceOf"
+				}],
+				usedBy: "src/client/modelbg.ts"
+			},
+			{
+				id: "modelDirectories.directoryFor",
+				group: "model",
+				kind: "host-service",
+				criticality: "label",
+				since: "<=0.1.6",
+				label: {
+					en: "Model directory (display names)",
+					zh: "模型目录（显示名）"
+				},
+				symptom: {
+					en: "the model is shown as provider/model id instead of its display name",
+					zh: "模型只会显示 provider/模型 id，读不到显示名"
+				},
+				target: "modelDirectories.directoryFor(id)",
+				checks: [{
+					kind: "path",
+					service: "modelDirectories",
+					path: "directoryFor",
+					expect: "function"
+				}],
+				sources: [{
+					path: "dsh-client-ui-model-selection/lib/client.js",
+					literal: "modelSelection"
+				}],
+				usedBy: "src/client/modelbg.ts"
+			},
+			{
+				id: "shell.overlay",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "AppFrame overlay + its three columns",
+					zh: "主框架浮层与三列"
+				},
+				symptom: {
+					en: "per-part blur and the main-background opacity cannot find the columns at all",
+					zh: "分区域模糊与主背景透明度完全找不到那几列"
+				},
+				target: "[data-shell-overlay]",
+				checks: [{
+					kind: "attr",
+					attr: "data-shell-overlay"
+				}],
+				sources: [{
+					path: "dsh-client-ui-layout/lib/client.js",
+					literal: "data-shell-overlay"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "settings.dialog",
+				group: "surface",
+				kind: "dom-selector",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Settings dialog (aria-modal)",
+					zh: "设置弹窗（aria-modal）"
+				},
+				symptom: {
+					en: "the settings panel opacity and blur sliders stop having any effect",
+					zh: "设置界面透明度与模糊失效"
+				},
+				target: "[role=\"dialog\"][aria-modal=\"true\"][aria-labelledby]",
+				checks: [{
+					kind: "selector",
+					selector: "div[role=\"dialog\"][aria-modal=\"true\"][aria-labelledby]",
+					optionalWhen: "settingsClosed"
+				}],
+				sources: [{
+					path: "dsh-client-ui-primitives/lib/index.js",
+					literal: "aria-modal"
+				}, {
+					path: "src/client/components/ui.css.ts",
+					literal: ".dab-card"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "settings.card",
+				group: "surface",
+				kind: "host-style",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Option card inside the dialog (.dab-card)",
+					zh: "弹窗内的选项卡（.dab-card）"
+				},
+				symptom: {
+					en: "the dialog option-panel blur has nothing to attach to",
+					zh: "弹窗内选项卡的模糊没有附着对象"
+				},
+				target: ".dab-card",
+				checks: [{
+					kind: "rule",
+					match: ".dab-card",
+					hint: "settings dialog card class"
+				}],
+				sources: [{
+					path: "src/client/components/ui.css.ts",
+					literal: ".dab-card"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "composer.card",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Composer card",
+					zh: "输入框卡片"
+				},
+				symptom: {
+					en: "the composer loses its backdrop — the input blur slider does nothing",
+					zh: "输入框失去毛玻璃背板，输入区模糊滑块失效"
+				},
+				target: "[data-composer-card]",
+				checks: [{
+					kind: "attr",
+					attr: "data-composer-card",
+					optionalWhen: "chatNotMounted"
+				}],
+				sources: [{
+					path: "dsh-client-ui-conversation/lib/client.js",
+					literal: "data-composer-card"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "cordis.panel",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "label",
+				since: "<=0.1.6",
+				label: {
+					en: "Cordis panel",
+					zh: "Cordis 面板"
+				},
+				symptom: {
+					en: "the Cordis panel keeps the host surface instead of the input slider's alpha",
+					zh: "Cordis 面板拿不到输入区滑块的透明度，仍是宿主表面"
+				},
+				target: "[data-cordis-panel]",
+				checks: [{
+					kind: "attr",
+					attr: "data-cordis-panel",
+					optionalWhen: "cordisClosed"
+				}],
+				sources: [{
+					path: "dsh-client-ui-cordis/lib/client.js",
+					literal: "data-cordis-panel"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "rightbar.panel",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "looks",
+				since: "0.1.7",
+				label: {
+					en: "File-preview panel host",
+					zh: "文件预览面板宿主"
+				},
+				symptom: {
+					en: "the right panel loses its own opacity/blur card and falls back to the main background",
+					zh: "右侧栏失去自己的透明度/模糊控制，退回跟随主背景"
+				},
+				target: "[data-sidebar-right-panel]",
+				checks: [{
+					kind: "selector",
+					selector: "div[data-sidebar-right-panel]",
+					optionalWhen: "noRightPanel"
+				}],
+				sources: [{
+					path: `${SIDEBAR_RIGHT}/lib/client.js`,
+					literal: "data-sidebar-right-panel"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "rightbar.openFlag",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "looks",
+				since: "0.1.7",
+				label: {
+					en: "Right panel open/closed flag",
+					zh: "右侧栏开合标记"
+				},
+				symptom: {
+					en: "the panel's backdrop cannot tell open from closed — a frosted plate covers the empty half",
+					zh: "分不清右侧栏开着还是关着，空白的右半屏会出现磨砂板"
+				},
+				target: "[data-sidebar-right-open]",
+				checks: [{
+					kind: "rule",
+					match: "[data-sidebar-right-open]",
+					hint: "right panel open flag"
+				}],
+				sources: [{
+					path: `${SIDEBAR_RIGHT}/lib/client.js`,
+					literal: "data-sidebar-right-open"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "dockkit.content",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "core",
+				since: "0.1.7",
+				label: {
+					en: "Dock tab host (the panel's painted surface)",
+					zh: "停靠页宿主（面板真正的表面）"
+				},
+				symptom: {
+					en: "nothing carries the panel surface any more — the right-panel card is painted on a container that is always full width",
+					zh: "面板表面不再落在任何元素上，右面板卡片会被画在一个恒定满宽的容器上"
+				},
+				target: "[data-dockkit-content]",
+				checks: [{
+					kind: "rule",
+					match: "[data-dockkit-content]",
+					hint: "dock tab host"
+				}],
+				sources: [{
+					path: ".",
+					literal: "dockkit-content",
+					root: "frontend"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "dockkit.empty",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "looks",
+				since: "0.1.7",
+				label: {
+					en: "Dock empty seat",
+					zh: "停靠空位"
+				},
+				symptom: {
+					en: "an empty preview pane paints the host surface over the wallpaper",
+					zh: "空的预览格会用宿主表面盖住壁纸"
+				},
+				target: "[data-dockkit-empty]",
+				checks: [{
+					kind: "rule",
+					match: "[data-dockkit-empty]",
+					hint: "dock empty seat"
+				}],
+				sources: [{
+					path: `${SIDEBAR_RIGHT}/lib/client.js`,
+					literal: "data-dockkit-empty"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "dockkit.float",
+				group: "surface",
+				kind: "host-attr",
+				criticality: "label",
+				since: "0.1.7",
+				label: {
+					en: "Floating dock pane flag",
+					zh: "浮动停靠面板标记"
+				},
+				symptom: {
+					en: "floating panes would be painted like docked ones, frosting a panel that should stay the host's",
+					zh: "浮动面板会被当作停靠面板上色，本该保持宿主样式的面板被磨砂"
+				},
+				target: "[data-dockkit-float]",
+				checks: [{
+					kind: "rule",
+					match: "[data-dockkit-float]",
+					hint: "floating pane flag"
+				}],
+				sources: [{
+					path: `${SIDEBAR_RIGHT}/lib/client.js`,
+					literal: "data-dockkit-float"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "chat.flow",
+				group: "region",
+				kind: "dom-selector",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Chat message column",
+					zh: "对话消息列"
+				},
+				symptom: {
+					en: "the conversation card (and its opacity/blur) cannot find the message column",
+					zh: "对话卡片（及其透明度/模糊）找不到消息列"
+				},
+				target: "[data-chat-flow]",
+				checks: [{
+					kind: "selector",
+					selector: "[data-chat-flow]",
+					optionalWhen: "chatNotMounted"
+				}],
+				sources: [{
+					path: "dsh-client-ui-chat/lib/client.js",
+					literal: "data-chat-flow"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "conversation.scroll",
+				group: "region",
+				kind: "dom-selector",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Conversation scrollport",
+					zh: "对话滚动区"
+				},
+				symptom: {
+					en: "the marker-less fallback would wrap the whole scrollport in the conversation card",
+					zh: "标记缺失时的兜底会把整个滚动区套上对话卡片"
+				},
+				target: "[data-conversation-scroll]",
+				checks: [{
+					kind: "selector",
+					selector: "[data-conversation-scroll]",
+					optionalWhen: "chatNotMounted"
+				}],
+				sources: [{
+					path: "dsh-client-ui-conversation/lib/client.js",
+					literal: "data-conversation-scroll"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "trajectory.root",
+				group: "region",
+				kind: "dom-selector",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Trajectory view root",
+					zh: "轨迹页根节点"
+				},
+				symptom: {
+					en: "the trajectory opacity/blur sliders stop reaching the trajectory page",
+					zh: "轨迹页的透明度与模糊滑块失效"
+				},
+				target: "[data-conversation-composer-overlay]",
+				checks: [{
+					kind: "selector",
+					selector: "[data-conversation-composer-overlay]",
+					optionalWhen: "trajectoryNotMounted"
+				}],
+				sources: [{
+					path: "dsh-client-ui-trajectory/lib/client.js",
+					literal: "data-conversation-composer-overlay"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "markdown.wideTable",
+				group: "region",
+				kind: "host-style",
+				criticality: "label",
+				since: "<=0.1.6",
+				label: {
+					en: "Wide markdown table clamp",
+					zh: "宽表格收拢样式"
+				},
+				symptom: {
+					en: "a wide table bleeds outside the conversation card instead of scrolling inside it",
+					zh: "宽表格会溢出到对话卡片外，而不是在卡片内横向滚动"
+				},
+				target: ".md-table-wide",
+				checks: [{
+					kind: "rule",
+					match: ".md-table-wide",
+					hint: "markdown table class"
+				}],
+				sources: [{
+					path: "dsh-client-ui-chat/lib/client.js",
+					literal: "md-table-wide"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "token.bgBase",
+				group: "token",
+				kind: "host-token",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Main background surface",
+					zh: "主背景表面"
+				},
+				symptom: {
+					en: "the main-background slider and the right-panel card lose their surface",
+					zh: "主背景透明度与右侧栏卡片失去表面色"
+				},
+				target: "--dsw-alias-bg-base",
+				checks: [{
+					kind: "computed",
+					token: "--dsw-alias-bg-base"
+				}],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "--dsw-alias-bg-base"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "token.layers",
+				group: "token",
+				kind: "host-token",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Layered surfaces (cards)",
+					zh: "层次表面（卡片）"
+				},
+				symptom: {
+					en: "the card slider, the conversation card and the trajectory slider go blank",
+					zh: "卡片滑块、对话卡片与轨迹滑块失去颜色"
+				},
+				target: "--dsw-alias-bg-layer-1/2/3",
+				checks: [
+					{
+						kind: "computed",
+						token: "--dsw-alias-bg-layer-1"
+					},
+					{
+						kind: "computed",
+						token: "--dsw-alias-bg-layer-2"
+					},
+					{
+						kind: "computed",
+						token: "--dsw-alias-bg-layer-3"
+					}
+				],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "--dsw-alias-bg-layer-1"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "token.menuSurface",
+				group: "token",
+				kind: "host-token",
+				criticality: "core",
+				since: "0.1.7",
+				label: {
+					en: "Menu material fill (0.1.7 split)",
+					zh: "菜单材质填充（0.1.7 拆分）"
+				},
+				symptom: {
+					en: "the menu panel and its sticky group headings take two different fills — the solid band across the model picker",
+					zh: "菜单面板与吸顶分组标题用了两种填充 —— 模型选择器上那道白道"
+				},
+				target: "--dsw-menu-surface-fill",
+				checks: [{
+					kind: "rule",
+					match: "--dsw-menu-surface-fill",
+					hint: "MenuSurface material fill"
+				}, {
+					kind: "computed",
+					token: "--dsw-menu-surface-fill",
+					on: ".dab-root"
+				}],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "--dsw-menu-surface-fill"
+				}, {
+					path: "dsh-client-ui-primitives/lib/MenuSurface.module.css",
+					literal: "var(--dsw-menu-surface-fill)"
+				}],
+				usedBy: "src/client/utils/color.ts, src/client/wallpaper.ts"
+			},
+			{
+				id: "token.menuAlias",
+				group: "token",
+				kind: "host-token",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Menu overlay fill",
+					zh: "菜单浮层填充"
+				},
+				symptom: {
+					en: "dropdowns, the slash menu and popovers keep the host fill while the panel follows the plugin",
+					zh: "下拉、斜杠菜单与浮层保持宿主填充，而面板跟随插件，两边不一致"
+				},
+				target: "--dsw-specific-menu",
+				checks: [{
+					kind: "rule",
+					match: "--dsw-specific-menu",
+					hint: "menu overlay fill"
+				}, {
+					kind: "computed",
+					token: "--dsw-specific-menu",
+					on: ".dab-root"
+				}],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "--dsw-specific-menu"
+				}, {
+					path: "dsh-client-ui-chat/lib/client.js",
+					literal: "--dsw-specific-menu"
+				}],
+				usedBy: "src/client/utils/color.ts, src/client/wallpaper.ts"
+			},
+			{
+				id: "token.sidebarFill",
+				group: "token",
+				kind: "host-token",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Sidebar fill",
+					zh: "左侧栏填充"
+				},
+				symptom: {
+					en: "the sidebar opacity slider stops tinting the sidebar",
+					zh: "左侧栏透明度滑块失效"
+				},
+				target: "--dsw-specific-sidebar-fill",
+				checks: [{
+					kind: "computed",
+					token: "--dsw-specific-sidebar-fill"
+				}],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "--dsw-specific-sidebar-fill"
+				}],
+				usedBy: "src/client/utils/color.ts, src/client/wallpaper.ts"
+			},
+			{
+				id: "token.inputFill",
+				group: "token",
+				kind: "host-token",
+				criticality: "looks",
+				since: "<=0.1.6",
+				label: {
+					en: "Input/control surface",
+					zh: "输入与控件表面"
+				},
+				symptom: {
+					en: "the input slider stops tinting the composer and the controls",
+					zh: "输入区透明度滑块失效"
+				},
+				target: "--dsw-specific-input-major",
+				checks: [{
+					kind: "computed",
+					token: "--dsw-specific-input-major"
+				}],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "--dsw-specific-input-major"
+				}],
+				usedBy: "src/client/utils/color.ts, src/client/wallpaper.ts"
+			},
+			{
+				id: "token.schemeFlag",
+				group: "token",
+				kind: "host-attr",
+				criticality: "core",
+				since: "<=0.1.6",
+				label: {
+					en: "Dark-scheme flag on <body>",
+					zh: "<body> 上的深色标记"
+				},
+				symptom: {
+					en: "a dark rule can no longer force the dark palette — light surfaces flash through",
+					zh: "深色规则无法强制深色调色板，会闪出浅色表面"
+				},
+				target: "body[data-ds-dark-theme]",
+				checks: [{
+					kind: "rule",
+					match: "data-ds-dark-theme",
+					hint: "dark scheme attribute"
+				}],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "data-ds-dark-theme"
+				}, {
+					path: ".",
+					literal: "data-ds-dark-theme",
+					root: "frontend"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			},
+			{
+				id: "token.labelCaption",
+				group: "token",
+				kind: "host-token",
+				criticality: "label",
+				since: "<=0.1.6",
+				label: {
+					en: "Caption label token",
+					zh: "弱化文字令牌"
+				},
+				symptom: {
+					en: "placeholder text falls back to a hard-coded grey instead of the theme's caption colour",
+					zh: "占位文字退回固定灰色，不再跟随主题的弱化色"
+				},
+				target: "--dsw-alias-label-caption",
+				checks: [{
+					kind: "computed",
+					token: "--dsw-alias-label-caption"
+				}],
+				sources: [{
+					path: "dsh-client-ui-theme/lib/client.js",
+					literal: "--dsw-alias-label-caption"
+				}],
+				usedBy: "src/client/wallpaper.ts"
+			}
+		];
+		/** Localized label lookup for a contract. */
+		function labelOf(c, lang) {
+			return lang === "zh" ? c.label.zh : c.label.en;
+		}
+		/** Localized symptom lookup for a contract. */
+		function symptomOf(c, lang) {
+			return lang === "zh" ? c.symptom.zh : c.symptom.en;
+		}
+		/** Groups the panel renders, in order. */
+		const CONTRACT_GROUPS = [
+			{
+				id: "model",
+				label: {
+					en: "Model → rule resolution",
+					zh: "模型 → 规则匹配"
+				}
+			},
+			{
+				id: "surface",
+				label: {
+					en: "Surfaces the plugin paints",
+					zh: "插件着色的界面区域"
+				}
+			},
+			{
+				id: "token",
+				label: {
+					en: "Design tokens re-emitted",
+					zh: "被重新发出的设计令牌"
+				}
+			},
+			{
+				id: "region",
+				label: {
+					en: "Conversation views",
+					zh: "对话视图"
+				}
+			}
+		];
+		/** Overall verdict of a report, for the panel's headline. */
+		function verdictOf(report) {
+			if (report.results.length === 0) return "unknown";
+			if (report.summary.fail > 0) return report.summary.pass > 0 ? "partial" : "broken";
+			return report.summary.pass > 0 ? "ok" : "unknown";
+		}
+		/** Markdown rendering of a report — the thing a user pastes into an issue. */
+		function reportToMarkdown(report, lang) {
+			const zh = lang === "zh";
+			const lines = [];
+			lines.push(zh ? "## dsh-background-by-model 宿主自检" : "## dsh-background-by-model host check");
+			lines.push("");
+			lines.push(`- ${zh ? "阶段" : "phase"}: ${report.phase}`);
+			if (report.plugin.version !== "") lines.push(`- ${zh ? "插件" : "plugin"}: ${report.plugin.version} (dsh >=${report.plugin.floor})`);
+			lines.push(`- dsh: ${report.host.version !== "" ? report.host.version : zh ? "未读到" : "unreadable"}${report.host.compatible === false ? zh ? "（低于插件下限）" : " (below the plugin floor)" : ""}`);
+			if (report.host.node !== "") lines.push(`- node: ${report.host.node}`);
+			if (report.host.root !== "") lines.push(`- host root: ${report.host.root}`);
+			if (report.host.note !== "") lines.push(`- note: ${report.host.note}`);
+			if (report.host.model !== void 0) {
+				const m = report.host.model;
+				lines.push(`- ${zh ? "模型" : "model"}: \`${m.text !== "" ? m.text : "(none)"}\` · ${m.source}${m.note !== "" ? ` · ${m.note}` : ""} · ${zh ? "规则" : "rule"} ${m.rule !== "" ? m.rule : "-"}${m.matched ? "" : zh ? "（兜底）" : " (fallback)"}`);
+			}
+			lines.push("");
+			lines.push(`### ${zh ? "结论" : "Summary"}: ${report.summary.pass} pass / ${report.summary.fail} fail / ${report.summary.skip} n/a`);
+			lines.push("");
+			for (const r of report.results) {
+				const mark = r.status === "pass" ? "PASS" : r.status === "fail" ? "**FAIL**" : r.status === "skip" ? "n/a" : "info";
+				lines.push(`- ${mark} \`${r.id}\` — ${r.label} · \`${r.target}\``);
+				if (r.status === "fail") {
+					lines.push(`  - ${zh ? "现象" : "symptom"}: ${r.symptom}`);
+					lines.push(`  - ${zh ? "原因" : "reason"}: ${r.reason ?? r.detail}`);
+					lines.push(`  - ${zh ? "期望位置" : "expected in"}: ${r.sources.map((s) => s.path).join(", ")}`);
+				} else if (r.detail !== "") lines.push(`  - ${r.detail}`);
+			}
+			return lines.join("\n");
+		}
+		//#endregion
+		//#region src/client/judge.ts
+		/** The real browser environment. */
+		function browserEnv(ctx) {
+			return {
+				querySelector: (selector) => document.querySelector(selector),
+				computedValue: (token, on) => {
+					if (typeof document === "undefined") return "";
+					const host = on ?? document.documentElement;
+					return getComputedStyle(host).getPropertyValue(token).trim();
+				},
+				styleSheets: () => typeof document === "undefined" ? [] : Array.from(document.styleSheets),
+				ctx
+			};
+		}
+		const ANCHORS = {
+			settingsClosed: "div[role=\"dialog\"][aria-modal=\"true\"][aria-labelledby]",
+			chatNotMounted: "[data-chat-flow],[data-conversation-scroll]",
+			trajectoryNotMounted: "[data-conversation-composer-overlay]",
+			noRightPanel: "div[data-sidebar-right-panel],[data-dockkit-strip],[data-dockkit-pane]",
+			cordisClosed: "[data-cordis-panel]"
+		};
+		function mounted(env, anchorId) {
+			const sel = ANCHORS[anchorId];
+			if (sel === void 0) return true;
+			try {
+				return env.querySelector(sel) !== null;
+			} catch {
+				return false;
+			}
+		}
+		/** Walk a dotted path off a root object, tolerating a missing first hop. */
+		function walkPath(root, path) {
+			let cur = root;
+			for (const key of path.split(".")) {
+				if (cur === null || cur === void 0) return void 0;
+				cur = cur[key];
+			}
+			return cur;
+		}
+		function looksObservable(v) {
+			return typeof v === "object" && v !== null && typeof v.subscribe === "function" && typeof v.getSnapshot === "function";
+		}
+		/**
+		* A stylesheet mention of a literal.
+		*
+		* The host's rules are the only place a renamed token still answers honestly:
+		* a token can be *declared* by this plugin while the host's rule that consumed
+		* it is gone. Cross-origin sheets (none on a local dsh, but the probe must not
+		* throw if one ever appears) are skipped.
+		*/
+		function ruleMentioned(env, literal) {
+			for (const sheet of env.styleSheets()) {
+				if (sheet.ownerNode?.dataset?.plugin !== void 0) continue;
+				let rules = null;
+				try {
+					rules = sheet.cssRules;
+				} catch {
+					continue;
+				}
+				if (rules === null) continue;
+				for (const rule of Array.from(rules)) {
+					const text = rule.cssText;
+					if (typeof text === "string" && text.includes(literal)) return true;
+					const inner = rule.cssRules;
+					if (inner === void 0 || inner === null) continue;
+					for (const child of Array.from(inner)) {
+						const childText = child.cssText;
+						if (typeof childText === "string" && childText.includes(literal)) return true;
+					}
+				}
+			}
+			return false;
+		}
+		/** Whether any reachable host stylesheet could be read (false ⇒ the check is blind). */
+		function stylesReadable(env) {
+			for (const sheet of env.styleSheets()) try {
+				if (sheet.cssRules !== null) return true;
+			} catch {}
+			return false;
+		}
+		function evaluate(env, check) {
+			switch (check.kind) {
+				case "service": {
+					let svc;
+					try {
+						svc = env.ctx.get(check.id);
+					} catch {
+						svc = void 0;
+					}
+					return svc === void 0 || svc === null ? {
+						status: "fail",
+						name: `ctx.get('${check.id}')`,
+						detail: "service not published",
+						reason: `the host does not publish the "${check.id}" service`
+					} : {
+						status: "pass",
+						name: `ctx.get('${check.id}')`,
+						detail: "service present"
+					};
+				}
+				case "path": {
+					let svc;
+					try {
+						svc = env.ctx.get(check.service);
+					} catch {
+						svc = void 0;
+					}
+					if (svc === void 0 || svc === null) return {
+						status: "skip",
+						name: `${check.service}.${check.path}`,
+						detail: "service not published yet"
+					};
+					const value = walkPath(svc, check.path);
+					const name = `${check.service}.${check.path}`;
+					if (check.expect === "function") return typeof value === "function" ? {
+						status: "pass",
+						name,
+						detail: "is a function"
+					} : {
+						status: "fail",
+						name,
+						detail: `expected a function, got ${typeof value}`,
+						reason: `"${name}" is not a function on this host`
+					};
+					if (check.expect === "observable") return looksObservable(value) ? {
+						status: "pass",
+						name,
+						detail: "is an observable face"
+					} : {
+						status: "fail",
+						name,
+						detail: "not an observable face",
+						reason: `"${name}" no longer exposes subscribe()/getSnapshot()`
+					};
+					return value === void 0 ? {
+						status: "fail",
+						name,
+						detail: "undefined",
+						reason: `"${name}" is gone`
+					} : {
+						status: "pass",
+						name,
+						detail: typeof value
+					};
+				}
+				case "selector": {
+					const present = env.querySelector(check.selector) !== null;
+					const name = `querySelector(${JSON.stringify(check.selector)})`;
+					if (present) return {
+						status: "pass",
+						name,
+						detail: "element found"
+					};
+					if (check.optionalWhen !== void 0 && !mounted(env, check.optionalWhen)) return {
+						status: "skip",
+						name,
+						detail: "not on screen right now"
+					};
+					return {
+						status: "fail",
+						name,
+						detail: "no element matches",
+						reason: `no element matches ${check.selector} while its surface is on screen`
+					};
+				}
+				case "attr": {
+					const present = env.querySelector(`[${check.attr}]`) !== null;
+					const name = `querySelector([${check.attr}])`;
+					if (present) return {
+						status: "pass",
+						name,
+						detail: "attribute found"
+					};
+					if (check.optionalWhen !== void 0 && !mounted(env, check.optionalWhen)) return {
+						status: "skip",
+						name,
+						detail: "not on screen right now"
+					};
+					return {
+						status: "fail",
+						name,
+						detail: "no element carries it",
+						reason: `nothing in the DOM carries ${check.attr} while its surface is on screen`
+					};
+				}
+				case "computed": {
+					const host = check.on !== void 0 ? env.querySelector(check.on) : null;
+					const name = `computed(${check.token}${check.on !== void 0 ? ` on ${check.on}` : ""})`;
+					if (check.on !== void 0 && host === null) return {
+						status: "skip",
+						name,
+						detail: `${check.on} not mounted`
+					};
+					const value = env.computedValue(check.token, host);
+					return value !== "" ? {
+						status: "pass",
+						name,
+						detail: value
+					} : {
+						status: "fail",
+						name,
+						detail: "resolves to nothing",
+						reason: `${check.token} resolves to an empty value`
+					};
+				}
+				case "rule": {
+					const name = `stylesheet includes ${JSON.stringify(check.match)}`;
+					if (!stylesReadable(env)) return {
+						status: "skip",
+						name,
+						detail: "no stylesheet is readable"
+					};
+					return ruleMentioned(env, check.match) ? {
+						status: "pass",
+						name,
+						detail: "declared by a host rule"
+					} : {
+						status: "fail",
+						name,
+						detail: "no rule mentions it",
+						reason: `no stylesheet declares ${check.match}`
+					};
+				}
+				default: return {
+					status: "fail",
+					name: "unknown check",
+					detail: String(check)
+				};
+			}
+		}
+		/** A contract with no checks is documentation only (a legacy alias we still accept). */
+		function noChecks(c, lang) {
+			return {
+				id: c.id,
+				label: labelOf(c, lang),
+				symptom: symptomOf(c, lang),
+				status: "info",
+				detail: lang === "zh" ? "无需运行时检查 —— 仅记录兼容用法" : "no runtime check — accepted for compatibility",
+				target: c.target,
+				sources: c.sources,
+				usedBy: c.usedBy,
+				checks: []
+			};
+		}
+		/**
+		* Run every contract against a probe environment.
+		*
+		* Only the FIRST failing check of a contract is reported: the later ones usually
+		* depend on it (no service ⇒ no methods on it), so listing them all would turn
+		* one rename into five red lines.
+		*/
+		function probeContracts(env, lang) {
+			return HOST_CONTRACTS.map((c) => {
+				const result = {
+					id: c.id,
+					label: labelOf(c, lang),
+					symptom: symptomOf(c, lang),
+					status: "pass",
+					detail: "",
+					target: c.target,
+					sources: c.sources,
+					usedBy: c.usedBy,
+					checks: []
+				};
+				if (c.checks.length === 0) return noChecks(c, lang);
+				const outcomes = [];
+				let firstFail;
+				for (const check of c.checks) {
+					let outcome;
+					try {
+						outcome = evaluate(env, check);
+					} catch (e) {
+						outcome = {
+							status: "fail",
+							name: check.kind,
+							detail: String(e),
+							reason: `${check.kind} check threw`
+						};
+					}
+					outcomes.push(outcome);
+					if (outcome.status === "fail" && firstFail === void 0) firstFail = outcome;
+				}
+				result.checks = outcomes.map((o) => `${o.status} · ${o.name} — ${o.detail}`);
+				if (firstFail !== void 0) {
+					result.status = "fail";
+					result.detail = `${firstFail.name} — ${firstFail.detail}`;
+					result.reason = firstFail.reason;
+					return result;
+				}
+				const ran = outcomes.filter((o) => o.status !== "skip");
+				if (ran.length === 0) {
+					result.status = "skip";
+					result.detail = outcomes.map((o) => `${o.name} — ${o.detail}`).join("; ");
+					return result;
+				}
+				result.status = ran.some((o) => o.status === "info") && ran.every((o) => o.status === "info") ? "info" : "pass";
+				const last = ran[ran.length - 1];
+				result.detail = `${last.name} — ${last.detail}`;
+				return result;
+			});
+		}
+		/** Assemble the panel's report around a set of probe results. */
+		function buildClientReport(input, host) {
+			const results = probeContracts(browserEnv(input.ctx), input.lang);
+			const pass = results.filter((r) => r.status === "pass").length;
+			const fail = results.filter((r) => r.status === "fail").length;
+			const skip = results.filter((r) => r.status === "skip" || r.status === "info").length;
+			return {
+				phase: "client",
+				at: (/* @__PURE__ */ new Date()).toISOString(),
+				plugin: {
+					version: input.pluginVersion,
+					floor: input.floor
+				},
+				host: {
+					version: host.version,
+					compatible: host.compatible,
+					node: "",
+					root: "",
+					note: host.note,
+					model: input.model
+				},
+				results,
+				summary: {
+					pass,
+					fail,
+					skip,
+					total: results.length
+				}
+			};
+		}
+		//#endregion
+		//#region src/client/build-info.ts
+		/** This plugin's version at build time ('0.0.0' when built unbundled). */
+		const PLUGIN_VERSION = "0.4.2";
+		/** The dsh floor this build declares, straight from `engines.dsh`. */
+		const DSH_FLOOR = "0.1.7-rc.2";
 		const UI_CSS = `
 /* The section is rendered INLINE inside the host settings dialog's content
  * column: the host provides the modal chrome (backdrop, centering, closing).
@@ -2281,6 +3537,48 @@ window.__ModuleLoader__.load({
 .dab-rule-section-title{font-size:12px;font-weight:600;margin-bottom:9px;color:var(--dsw-alias-label-secondary,var(--dsw-alias-label-tertiary))}
 @container (max-width:760px){.dab-rule-cols{grid-template-columns:1fr}}
 
+/* ── host self-check ─────────────────────────────────────────────────────── */
+.dab-verdict{display:flex;flex-direction:column;gap:14px;position:relative;overflow:hidden}
+.dab-verdict::after{content:'';position:absolute;inset:0;pointer-events:none;opacity:.5;background:linear-gradient(120deg,transparent 55%,color-mix(in srgb,var(--dab-verdict-tone,transparent) 26%,transparent))}
+.dab-verdict-ok{--dab-verdict-tone:var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary));border-color:color-mix(in srgb,var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary)) 38%,var(--dsw-alias-border-l2))}
+.dab-verdict-partial,.dab-verdict-broken{--dab-verdict-tone:var(--dsw-alias-state-error-primary);border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 40%,var(--dsw-alias-border-l2))}
+.dab-verdict-unknown{--dab-verdict-tone:var(--dsw-alias-label-tertiary)}
+.dab-verdict-head{display:flex;align-items:center;gap:13px;flex-wrap:wrap}
+.dab-verdict-ico{width:34px;height:34px;flex:none;border-radius:11px;display:grid;place-items:center;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-layer-2)}
+.dab-verdict-ico-ok{color:var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary));background:color-mix(in srgb,var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary)) 14%,transparent)}
+.dab-verdict-ico-partial,.dab-verdict-ico-broken{color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 14%,transparent)}
+.dab-verdict-text{flex:1;min-width:170px}
+.dab-verdict-title{font-size:14.5px;font-weight:650}
+.dab-verdict-sub{margin-top:4px;font-size:12px;color:var(--dsw-alias-label-tertiary)}
+.dab-verdict-actions{display:flex;gap:8px;flex-wrap:wrap;margin-left:auto}
+.dab-facts{display:flex;flex-wrap:wrap;gap:8px;position:relative;z-index:1}
+.dab-fact{display:inline-flex;align-items:center;gap:7px;height:27px;padding:0 11px;border-radius:99px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);max-width:100%}
+.dab-fact.is-bad{border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 45%,transparent);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent)}
+.dab-fact-k{font-size:10.5px;font-weight:650;letter-spacing:.06em;text-transform:uppercase;color:var(--dsw-alias-label-tertiary);white-space:nowrap}
+.dab-fact-v{font-family:var(--dab-mono);font-size:11.5px;color:var(--dsw-alias-label-primary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:32ch}
+.dab-check-group-title{display:flex;align-items:center;gap:9px;font-size:12.5px;font-weight:650;margin-bottom:11px}
+.dab-check-group-count{margin-left:auto;font-family:var(--dab-mono);font-size:11px;font-weight:500;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-layer-2);border-radius:99px;padding:3px 9px}
+.dab-checks{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:2px}
+.dab-check{display:flex;gap:10px;padding:9px 10px;border-radius:11px;transition:background .2s ease}
+.dab-check:hover{background:var(--dsw-alias-bg-layer-2)}
+.dab-check-ico{width:19px;height:19px;flex:none;margin-top:1px;border-radius:50%;display:grid;place-items:center;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-layer-2)}
+.dab-check-ico-pass{color:var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary));background:color-mix(in srgb,var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary)) 15%,transparent)}
+.dab-check-ico-fail{color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 15%,transparent)}
+.dab-check-dot{width:5px;height:5px;border-radius:50%;background:currentColor;opacity:.65}
+.dab-check-body{min-width:0;flex:1;display:flex;flex-direction:column;gap:3px}
+.dab-check-head{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap}
+.dab-check-label{font-size:12.5px;font-weight:600}
+.dab-check-status{font-size:10px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;padding:1px 7px;border-radius:99px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-tertiary)}
+.dab-check-status-pass{color:var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary));background:color-mix(in srgb,var(--dsw-alias-state-success-primary,var(--dsw-alias-brand-primary)) 14%,transparent)}
+.dab-check-status-fail{color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 14%,transparent)}
+.dab-check-target{font-family:var(--dab-mono);font-size:10.5px;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-layer-2);border-radius:6px;padding:1px 6px;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.dab-check-detail{font-family:var(--dab-mono);font-size:11px;color:var(--dsw-alias-label-tertiary);line-height:1.5;overflow-wrap:anywhere}
+.dab-check-reason{display:flex;flex-direction:column;gap:5px;font-size:12px;line-height:1.55;color:var(--dsw-alias-label-secondary,var(--dsw-alias-label-tertiary))}
+.dab-check-symptom{color:var(--dsw-alias-state-error-primary)}
+.dab-check-where{display:flex;gap:7px;align-items:baseline;flex-wrap:wrap;font-size:11px;color:var(--dsw-alias-label-tertiary)}
+.dab-check-where code{font-family:var(--dab-mono);font-size:10.5px;overflow-wrap:anywhere}
+.dab-check-note{margin:12px 0 0;font-size:11.5px;line-height:1.55;color:var(--dsw-alias-label-tertiary);position:relative;z-index:1}
+
 /* ── keyframes ───────────────────────────────────────────────────────────── */
 @keyframes dab-fade-in{from{opacity:0}to{opacity:1}}
 @keyframes dab-page-in{from{opacity:0;transform:translateY(12px)}to{opacity:1;transform:none}}
@@ -2302,6 +3600,8 @@ window.__ModuleLoader__.load({
   .dab-nav-item{flex:none;padding:0 10px}
   .dab-nav-item.is-active{background:var(--dsw-alias-bg-layer-2)}
   .dab-types{grid-template-columns:1fr}
+  .dab-verdict-actions{margin-left:0;width:100%}
+  .dab-verdict-actions .dab-btn{flex:1}
 }
 @container (min-width:621px){
   .dab-shell{grid-template-columns:158px minmax(0,1fr);gap:26px}
@@ -2434,6 +3734,11 @@ window.__ModuleLoader__.load({
 			className,
 			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M7.2 1.8l1.2 3.1 3.1 1.2-3.1 1.2-1.2 3.1-1.2-3.1L2.9 6.1 6 4.9l1.2-3.1z" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M12 10.5l.5 1.2 1.2.5-1.2.5-.5 1.2-.5-1.2-1.2-.5 1.2-.5.5-1.2z" })]
 		});
+		const RefreshIcon = ({ size, className }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Glyph, {
+			size,
+			className,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M13.2 8A5.2 5.2 0 1 1 11.5 4.2" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M13.4 1.8v2.9h-2.9" })]
+		});
 		const DownloadIcon = ({ size, className }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Glyph, {
 			size,
 			className,
@@ -2494,6 +3799,17 @@ window.__ModuleLoader__.load({
 			className,
 			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M8 2.6l5.4 9.8H2.6L8 2.6z" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M8 6.8v2.4M8 11.4v.01" })]
 		});
+		const CopyIcon = ({ size, className }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Glyph, {
+			size,
+			className,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
+				x: "5.4",
+				y: "5.4",
+				width: "7.6",
+				height: "7.6",
+				rx: "1.6"
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M10.6 5.4V4.2a1.6 1.6 0 0 0-1.6-1.6H4.2a1.6 1.6 0 0 0-1.6 1.6v4.8a1.6 1.6 0 0 0 1.6 1.6h1.2" })]
+		});
 		const CanvasIcon = ({ size, className }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Glyph, {
 			size,
 			className,
@@ -4311,6 +5627,290 @@ window.__ModuleLoader__.load({
 			] });
 		}
 		//#endregion
+		//#region src/client/components/pages/HostPage.tsx
+		/**
+		* The "Host check" page.
+		*
+		* Two answers side by side, because a plugin that styles someone else's interface
+		* fails in two different ways:
+		*
+		*   this build, live     the probe in ../../judge.ts runs against the DOM, the
+		*                        host stylesheets and the Cordis services — what the
+		*                        plugin can actually see right now.
+		*   the installed files  the node half's scan (src/host-scan.ts) reports whether
+		*                        the packages on disk still contain every literal the
+		*                        plugin depends on, and names the host's own version.
+		*
+		* The page exists so a failure stops being "背景不动了": it names the hop, the
+		* literal, the file that should define it and the file of this plugin that reads
+		* it — and copies all of that as one markdown block for an issue.
+		*/
+		/** Contract id → its group, so the panel's order is the table's order. */
+		const GROUP_OF = new Map(HOST_CONTRACTS.map((c) => [c.id, c.group]));
+		function HostPage({ p, notify }) {
+			const { t, lang, readModelFacts } = p;
+			const [client, setClient] = (0, react.useState)(null);
+			const [scanned, setScanned] = (0, react.useState)(null);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const run = (0, react.useCallback)(async () => {
+				setBusy(true);
+				try {
+					setClient(buildClientReport({
+						ctx: p.ctx,
+						lang,
+						pluginVersion: PLUGIN_VERSION,
+						floor: DSH_FLOOR,
+						model: readModelFacts?.()
+					}, {
+						version: "",
+						compatible: null,
+						note: ""
+					}));
+					setScanned(await readHostScan(lang));
+				} finally {
+					setBusy(false);
+				}
+			}, [
+				p,
+				lang,
+				readModelFacts
+			]);
+			(0, react.useEffect)(() => {
+				run();
+			}, [run]);
+			const hostVersion = scanned?.host.version ?? "";
+			const compatible = scanned?.host.compatible ?? null;
+			const verdict = client === null ? "unknown" : verdictOf(client);
+			const diskVerdict = scanned === null ? "unknown" : verdictOf(scanned);
+			const rows = client?.results ?? [];
+			const copyReport = async () => {
+				const parts = [];
+				if (client !== null) parts.push(reportToMarkdown(client, lang));
+				if (scanned !== null) parts.push(reportToMarkdown(scanned, lang));
+				try {
+					await navigator.clipboard.writeText(parts.join("\n\n"));
+					notify(t("hostCopied"));
+				} catch {
+					notify(t("hostCopyFail"), false);
+				}
+			};
+			const statusWord = (s) => s === "pass" ? t("hostPass") : s === "fail" ? t("hostFail") : s === "skip" ? t("hostNa") : t("hostInfo");
+			const row = (r) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+				className: `dab-check dab-check-${r.status}`,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: `dab-check-ico dab-check-ico-${r.status}`,
+					"aria-hidden": "true",
+					children: r.status === "pass" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckIcon, { size: 12 }) : r.status === "fail" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AlertIcon, { size: 12 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "dab-check-dot" })
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dab-check-body",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dab-check-head",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dab-check-label",
+								children: r.label
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: `dab-check-status dab-check-status-${r.status}`,
+								children: statusWord(r.status)
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+								className: "dab-check-target",
+								children: r.target
+							})
+						]
+					}), r.status === "fail" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dab-check-reason",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children: r.reason ?? r.detail }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dab-check-symptom",
+								children: r.symptom
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dab-check-where",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("hostExpectedIn") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: r.sources.map((s) => s.path).join("  ·  ") })]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dab-check-where",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("hostUsedBy") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: r.usedBy })]
+							})
+						]
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "dab-check-detail",
+						title: r.checks.join("\n"),
+						children: r.detail
+					})]
+				})]
+			}, r.id);
+			let rise = 1;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+					className: "dab-head dab-rise",
+					style: { "--d": 0 },
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dab-overline",
+							children: "Host check"
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+							className: "dab-h1",
+							children: t("pageHostCheck")
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "dab-desc",
+							children: t("descHostCheck")
+						})
+					]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+					className: `dab-card dab-verdict dab-verdict-${verdict} dab-rise`,
+					style: { "--d": rise++ },
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dab-verdict-head",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: `dab-verdict-ico dab-verdict-ico-${verdict}`,
+									"aria-hidden": "true",
+									children: verdict === "ok" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckIcon, { size: 16 }) : verdict === "unknown" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LayersIcon, { size: 16 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AlertIcon, { size: 16 })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dab-verdict-text",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+										className: "dab-verdict-title",
+										children: verdict === "ok" ? t("hostAllOk") : verdict === "unknown" ? t("hostUnknown") : verdict === "broken" ? t("hostBroken") : t("hostPartial")
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+										className: "dab-verdict-sub",
+										children: t("hostSummary").replace("{pass}", String(client?.summary.pass ?? 0)).replace("{fail}", String(client?.summary.fail ?? 0)).replace("{skip}", String(client?.summary.skip ?? 0))
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dab-verdict-actions",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+										type: "button",
+										className: "dab-btn",
+										disabled: busy,
+										onClick: () => void run(),
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(RefreshIcon, { size: 13 }), busy ? t("hostRunning") : t("hostRerun")]
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+										type: "button",
+										className: "dab-btn dab-btn-primary",
+										onClick: () => void copyReport(),
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopyIcon, { size: 13 }), t("hostCopy")]
+									})]
+								})
+							]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dab-facts",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fact, {
+									label: "dsh",
+									value: hostVersion !== "" ? hostVersion : t("hostUnreadable"),
+									bad: compatible === false
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fact, {
+									label: t("hostPluginFloor"),
+									value: `>=${DSH_FLOOR}`
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fact, {
+									label: t("hostPlugin"),
+									value: PLUGIN_VERSION
+								}),
+								scanned !== null && scanned.host.node !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fact, {
+									label: "node",
+									value: scanned.host.node
+								}) : null,
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fact, {
+									label: t("hostDiskScan"),
+									value: diskVerdict === "ok" ? `${scanned?.summary.pass ?? 0}/${scanned?.summary.total ?? 0}` : diskVerdict === "unknown" ? t("hostNa") : `${scanned?.summary.fail ?? 0} ${t("hostFail")}`,
+									bad: diskVerdict === "broken" || diskVerdict === "partial"
+								}),
+								client?.host.model !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fact, {
+									label: t("hostModel"),
+									value: client.host.model.text !== "" ? client.host.model.text : t("hostModelNone")
+								}) : null
+							]
+						}),
+						compatible === false ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "dab-check-note",
+							children: t("hostBelowFloor")
+						}) : null,
+						scanned !== null && scanned.host.note !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "dab-check-note",
+							children: scanned.host.note
+						}) : null,
+						diskFailures(scanned) > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "dab-check-note",
+							children: t("hostDiskFailures").replace("{n}", String(diskFailures(scanned)))
+						}) : null
+					]
+				}),
+				client === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("section", {
+					className: "dab-card dab-rise",
+					style: { "--d": rise },
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "dab-check-detail",
+						children: t("hostRunning")
+					})
+				}) : null,
+				CONTRACT_GROUPS.map((group) => {
+					const groupRows = rows.filter((r) => GROUP_OF.get(r.id) === group.id);
+					if (groupRows.length === 0) return null;
+					const ok = groupRows.filter((r) => r.status === "pass").length;
+					return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: "dab-card dab-rise",
+						style: { "--d": rise++ },
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dab-check-group-title",
+							children: [lang === "zh" ? group.label.zh : group.label.en, /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dab-check-group-count",
+								children: [
+									ok,
+									"/",
+									groupRows.length
+								]
+							})]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+							className: "dab-checks",
+							children: groupRows.map(row)
+						})]
+					}, group.id);
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dab-hint dab-rise",
+					style: { "--d": rise++ },
+					children: t("hostHint")
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("footer", {
+					className: "dab-footer dab-rise",
+					style: { "--d": rise },
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "dab-footer-mono",
+						children: "dsh-background-by-model"
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("footerTag") })]
+				})
+			] });
+		}
+		/** How many contracts the on-disk scan could not find (0 when it did not answer). */
+		function diskFailures(report) {
+			return report === null ? 0 : report.summary.fail;
+		}
+		function Fact({ label, value, bad = false }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `dab-fact${bad ? " is-bad" : ""}`,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "dab-fact-k",
+					children: label
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+					className: "dab-fact-v",
+					title: value,
+					children: value
+				})]
+			});
+		}
+		//#endregion
 		//#region src/client/components/ThemeSection.tsx
 		/**
 		* dsh-background-by-model — settings section shell.
@@ -4358,6 +5958,14 @@ window.__ModuleLoader__.load({
 						p: props,
 						notify
 					})
+				},
+				{
+					label: t("pageHostCheck"),
+					Icon: GearIcon,
+					node: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HostPage, {
+						p: props,
+						notify
+					})
 				}
 			];
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ErrorBoundary, {
@@ -4620,11 +6228,33 @@ window.__ModuleLoader__.load({
 				if (id === activeRuleId) applyActive();
 				else sync();
 			};
+			const activeLang = () => {
+				try {
+					const snapshot = ctx.locale.getSnapshot();
+					return typeof snapshot?.active === "string" && snapshot.active.toLowerCase().startsWith("zh") ? "zh" : "en";
+				} catch {
+					return "en";
+				}
+			};
+			/** The model-resolution facts the host self-check reports, read on demand. */
+			const readModelFacts = () => {
+				const rule = activeRuleId === null ? null : ruleById(activeRuleId);
+				return {
+					text: modelText,
+					source: modelSource,
+					note: modelNote,
+					rule: rule === null ? "" : rule.match !== "" ? rule.match : rule.id,
+					matched: activeMatched
+				};
+			};
 			const sectionInject = (actions) => {
 				bound = actions;
 				sync();
 				return {
 					t: ctx.locale.bind(NS),
+					ctx,
+					lang: activeLang(),
+					readModelFacts,
 					imageOf: (slot) => displayImageOf(slot),
 					addRule: () => {
 						const rule = newRule(nextRuleId(), nextSlot());
@@ -4876,6 +6506,26 @@ window.__ModuleLoader__.load({
 			const onPageHide = () => flushSave();
 			window.addEventListener("pagehide", onPageHide);
 			ctx.effect(() => () => window.removeEventListener("pagehide", onPageHide), "dsh-background-by-model: pagehide flush");
+			const hostCheckTimer = window.setTimeout(() => {
+				try {
+					const report = buildClientReport({
+						ctx,
+						lang: activeLang(),
+						pluginVersion: PLUGIN_VERSION,
+						floor: DSH_FLOOR,
+						model: readModelFacts()
+					}, {
+						version: "",
+						compatible: null,
+						note: ""
+					});
+					const failed = report.results.filter((r) => r.status === "fail");
+					if (failed.length === 0) return;
+					console.warn(`dsh-background-by-model: ${failed.length} of ${report.results.length} host contract(s) are broken on this dsh build. Open Settings → ${ctx.locale.bind(NS)("pageHostCheck")} for the full report.`);
+					for (const r of failed) console.warn(`dsh-background-by-model: [${r.id}] ${r.reason ?? r.detail} — read by ${r.usedBy}; expected in ${r.sources.map((s) => s.path).join(", ")}`);
+				} catch {}
+			}, 2500);
+			ctx.effect(() => () => window.clearTimeout(hostCheckTimer), "dsh-background-by-model: host check");
 		}
 		/** Color of the currently active rule, or null when it uses the system theme. */
 		function activeRuleColor() {