dsh-calorie 0.3.12 → 0.3.13

package/dist/client.js

@@ -158,21 +158,6 @@ window.__ModuleLoader__.load({
 		function noFollowKeys() {
 			return [];
 		}
-		/** 这一行有没有「写的值 ≠ 生效值」这回事：只要是可改行、标了落点来源、写的非空、
-		*  且技能算出来的生效值另有其值（去掉尾分隔符后仍不同），就报这两个事实。 */
-		function fallbackFactsOf(item, raw, source) {
-			if (item.readonly === true || item.prefillFrom === void 0) return null;
-			const written = raw.trim();
-			if (written === "") return null;
-			const effective = prefillValueOf(source, item.prefillFrom);
-			if (effective === void 0) return null;
-			const strip = (path) => path.replace(/[\\/]+$/, "");
-			if (strip(written) === strip(effective)) return null;
-			return {
-				written,
-				effective
-			};
-		}
 		/** 配置面报错 → 人话指引。
 		*
 		*  报文由技能侧给出（`base-link-core` 的 `ConfigError` 已带行号与文件名，技能 `cli/config.ts`
@@ -1072,6 +1057,24 @@ window.__ModuleLoader__.load({
 		*
 		* 手写 `React.createElement`（本包 client 束禁 JSX）。样式表 `S` 就在本件里——面板怎么画只有这一处。
 		*
+		* **外观真源＝`docs/agents/配置区域视觉模型-v3.1.html`（#920 阶段二起）**：本件的 `S` 逐项照它的
+		* CSS（`:32-205`）、行模板照它的 `rowShell`／`masterShell`／`cardShell`（`:349-451`）、状态徽标照它的
+		* `badgeHTML`（`:544-552`）那七档。**颜色／间距／圆角／字号／层级一律照取值，不许自己重新设计**；
+		* 与本件不同的只有下面这四条（每条都在这里写明为什么，改之前先读 #920 的证据件）：
+		*   ① **字号一律 em，没有 px**：跨包锁 `test/panel-type-739.test.mjs` 钉死「零 `font:` 简写／零字族／
+		*      字号一律相对单位」——宿主没有界面字号 token，绝对 px 会在别的窗口尺寸上失真。v3.1 的 px 按它
+		*      自己已锁死的那两对锚点换算（`13.5px↔1.08em`、`11.5px↔0.92em` ⇒ **1px＝0.08em**），一个不丢。
+		*   ② **值列不写等宽字族**：v3.1 的值列要 `font-family: var(--ic-mono)`，而 `#739 ①` 明令共用件零
+		*      `fontFamily`／零 `font:` 简写 ⇒ 值继承宿主字族。这是与 v3.1 的**一处已知不同**（#920 证据件有账）。
+		*   ③ **换行判据交给 CSS，不按字符数估宽**：v3.1 靠 JS 量文本宽在两套模板间两选一（审查 P0-4／P0-5：
+		*      每列 6.048px、真阈值 40–43 列而注释按 34 估 ⇒ 9 行被无谓拆两行、快面一次性长高 194px）。
+		*      本件没有 DOM 可量，故照审查给的修法把同一个决定交给排版引擎：行是 `flex-wrap` 容器，标签列定宽、
+		*      值列 `flex-basis:auto`（＝内容的自然宽）——装不下时**整行让位**（值落第二行、按钮仍在第一行行尾，
+		*      与 v3.1 的 `.is-wide` 同形）；值再长就在自己那一行里 `overflow-wrap:anywhere` 折下去。
+		*      **零省略号、零截断**（`white-space` 不用 `nowrap`、`text-overflow` 一次都不出现）。
+		*   ④ **画不出来的三样**用等价形态顶上：分组箭头 `::before`／`[open]` 旋转／keyframes 动画内联样式
+		*      给不出 ⇒ 画静态「›」与静态环（形状与 v3.1 同，只少了动）。
+		*
 		* 三条定稿（v3）在本件落地：
 		*   ① **只读行的目录按钮不画**（不画一枚点了也没反应的死按钮）；
 		*   ② 目录行的按钮字面**两档合一**，一律「浏览文件夹」（入口供不了时整枚不画）；
@@ -1079,148 +1082,401 @@ window.__ModuleLoader__.load({
 		*
 		* 对外只经 `config-panel-api.ts` 那一道门；本件自己不出门。
 		*/
-		/** 面板的样式表：颜色走 DSH 主题别名（深浅主题自适应，写死值只做回退），字号一律相对单位（em）。 */
+		/** 面板的样式表：取值逐项照 v3.1（颜色走 DSH 主题别名，写死值只做回退；字号一律相对单位 em）。
+		*
+		* 键名一个都不许改：六家附加块真消费 `okText`／`error`／`rows`／`label`／`muted`／`hint`／`info`／
+		* `bar`／`btn` 这九格（`plugin-memo-ilife/src/client.ts`、`plugin-schedule-ilife/src/client.ts` 的
+		* `PanelStyleSlots`），跨包锁另钉 `card`／`input`／`btnPrimary`／`btnPick`／`summary`／`title`／`version`。 */
 		const S = {
+			/** `.ic-card`：`background:var(--ic-surface)`（＝bg-layer-1）＋`border:1px solid var(--ic-line-strong)`
+			*  ＋`border-radius:12px`＋`padding:14px`＋`box-shadow:inset 0 1px 0 rgba(255,255,255,.06)`。
+			*  基准字号**不钉在卡片上**（#739 ⑤：跟着宿主走）。 */
 			card: {
-				padding: "12px 14px",
-				borderRadius: 10,
-				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.35))",
-				background: "var(--dsw-alias-bg-base, transparent)",
-				color: "var(--dsw-alias-label-primary, inherit)",
-				lineHeight: 1.6
+				padding: 14,
+				borderRadius: 12,
+				border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+				background: "var(--dsw-alias-bg-layer-1, #232324)",
+				color: "var(--dsw-alias-label-primary, #f9fafb)",
+				boxShadow: "inset 0 1px 0 rgba(255,255,255,.06)"
+			},
+			/** `.ic-head{display:flex;align-items:center;gap:10px;min-height:22px}`（徽标靠 `margin-left:auto` 右贴）。 */
+			head: {
+				display: "flex",
+				alignItems: "center",
+				gap: 10,
+				minHeight: 22
 			},
+			/** `.ic-title{font-size:13.5px;font-weight:640}`——字号按 60 行那条锚点换算成 `1.08em`。 */
 			title: {
 				fontSize: "1.08em",
-				fontWeight: 700,
-				marginBottom: 8
+				fontWeight: 640
+			},
+			/** `.ic-file{margin-top:4px}` 的那 4px 挂在两行的公共容器上：`info` 自己一格 margin 都不写
+			*  （#743 ①：头部两行间距不一家一个数，故这一项一律不写 margin）。 */
+			fileWrap: { marginTop: 4 },
+			/** `.ic-file b{color:var(--ic-faint);font-weight:400;margin-right:5px}`（「配置文件」「数据目录」那两个字）。 */
+			fileLabel: {
+				color: "var(--dsw-alias-label-tertiary, #adb2b8)",
+				fontWeight: 400,
+				marginRight: 5
+			},
+			/** `.ic-file{color:var(--ic-muted);font-size:11.5px;word-break:break-all}`（11.5px ⇒ `0.92em`）。 */
+			info: {
+				color: "var(--dsw-alias-label-secondary, #cfd3d6)",
+				fontSize: "0.92em",
+				wordBreak: "break-all"
 			},
+			/** `.ic-muted` 那一档（次要字）。 */
 			muted: {
-				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				color: "var(--dsw-alias-label-secondary, #cfd3d6)",
 				fontSize: "0.92em"
 			},
+			/** 错误字：取 v3.1 的 `--ic-danger`；字号 `1em`（#739 钉死）。 */
 			error: {
 				marginTop: 8,
-				color: "var(--dsw-alias-label-error, #b3261e)",
+				color: "var(--dsw-alias-state-error-primary, #e0685f)",
 				fontSize: "1em",
 				whiteSpace: "pre-wrap"
 			},
+			/** 成功字：取 v3.1 的 `--ic-ok`；字号 `0.96em`（#739 钉死）。 */
 			okText: {
 				marginTop: 8,
-				color: "var(--dsw-alias-state-success-primary, #12805c)",
+				color: "var(--dsw-alias-state-success-primary, #4ec9a0)",
 				fontSize: "0.96em"
 			},
-			rows: {
-				marginTop: 8,
-				borderTop: "1px solid var(--dsw-alias-border, rgba(128,128,128,.25))",
-				paddingTop: 8
+			/** 行组的容器（六家附加块也拿它当外框；v3.1 没有对应类，故只给一个中性块）。 */
+			rows: { display: "block" },
+			/** `.ic-row`：三列栅格 ＋ `gap:4px 10px` ＋ `padding:7px 0` ＋ 一条 `.ic-line` 下边线。
+			*  本件把它落成**换行弹性盒**（见文件头 ③）：标签定宽在第一行，值装不下时整行让位，
+			*  动作槽绝对定位贴在行尾（`.ic-row .ic-slot[data-slot^="a:"]` 那一格）。 */
+			row: {
+				position: "relative",
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: "4px 10px",
+				padding: "7px 0",
+				borderBottom: "1px solid var(--dsw-alias-border-l1, rgba(255,255,255,.06))"
 			},
-			info: {
-				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+			/** `.ic-row:last-child{border-bottom:0}`——内联样式没有 `:last-child`，由画它的人明说。 */
+			rowLast: {
+				position: "relative",
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: "4px 10px",
+				padding: "7px 0"
+			},
+			/** `.ic-under{margin:9px 0 0 8px;border-left:1px solid var(--ic-line-strong);padding-left:13px}`：
+			*  **跟随行**相对它的可改行（母版行）缩进 8＋1＋13＝**22px**，左边挂一条线。
+			*
+			*  取值逐字照抄；只有一处形态差别要说清：`.ic-under` 在 v3.1 里是**一整块**（同一个可改行的一批
+			*  跟随者共用一个 div、共一条左边线、块首还有 9px 上边距），而共用件手上只有「谁是跟随行」这一个
+			*  集合（由六家交的 `followKeysOf` 钩子逐键探出），**没有**「这一行归哪一块」的分块归属
+			*  （同一个键可以同时挂在两张跟随表上，钩子只回一个去重后的并集）。故这里按**行**落这条缩进：
+			*  缩进量与左边线同值，块首那 9px 上边距不落（落下去会在每两行之间多出一道 9px 的缝）。 */
+			followerRow: {
+				position: "relative",
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: "4px 10px",
+				padding: "7px 0 7px 13px",
+				marginLeft: 8,
+				borderLeft: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+				borderBottom: "1px solid var(--dsw-alias-border-l1, rgba(255,255,255,.06))"
+			},
+			/** 跟随行的最后一行：同上，去掉下边线（照 `.ic-row:last-child{border-bottom:0}`）。 */
+			followerRowLast: {
+				position: "relative",
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: "4px 10px",
+				padding: "7px 0 7px 13px",
+				marginLeft: 8,
+				borderLeft: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))"
+			},
+			/** `.ic-row .ic-k{font-size:11.5px;color:var(--ic-muted)}`；`--ic-kw:118px` 是标签列的定宽。 */
+			rowKey: {
+				flex: "0 0 auto",
+				minWidth: 118,
 				fontSize: "0.92em",
-				overflowWrap: "anywhere"
+				color: "var(--dsw-alias-label-secondary, #cfd3d6)"
+			},
+			/** `.ic-row .ic-v{font-size:11px;min-width:0}`（11px ⇒ `0.88em`）＋ 文件头 ③ 的让位口径：
+			*  `flex:1 1 auto` ⇒ 装不下整行让位；`overflow-wrap:anywhere` ⇒ 折下去、零省略号；
+			*  `paddingRight` 给行尾那枚按钮（＋列间距）让出宽度——就是 `.ic-row` 第三列那一格。 */
+			rowValue: {
+				flex: "1 1 auto",
+				minWidth: 0,
+				paddingRight: 56,
+				fontSize: "0.88em",
+				whiteSpace: "normal",
+				overflowWrap: "anywhere",
+				lineHeight: 1.5
+			},
+			/** 行尾动作槽（复制／跟随标记）：绝对定位贴行尾，行一换行它仍留在第一行行尾（＝`.is-wide` 那一形）。 */
+			rowActs: {
+				position: "absolute",
+				right: 0,
+				top: 7,
+				display: "flex",
+				gap: 4,
+				alignItems: "center"
+			},
+			/** `.ic-follow{font-size:11px;color:var(--ic-attn);white-space:nowrap}`（11px ⇒ `0.88em`）。 */
+			follow: {
+				fontSize: "0.88em",
+				color: "var(--dsw-alias-state-warn-primary, #e0a33e)",
+				whiteSpace: "nowrap",
+				display: "inline-flex",
+				alignItems: "center",
+				gap: 4
+			},
+			/** `.ic-follow::before{content:'↳';opacity:.8}`——内联样式给不出伪元素，画成真的那一个字符。 */
+			followMark: { opacity: .8 },
+			/** `.ic-master`：母版行那一块盒子（`--ic-sunken` 底 ＋ `border-radius:8px` ＋ `padding:11px 12px`
+			*  ＋ `margin-top:11px` ＋ 内高光）。 */
+			master: {
+				background: "var(--dsw-alias-bg-layer-3, #353638)",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+				borderRadius: 8,
+				padding: "11px 12px",
+				marginTop: 11,
+				boxShadow: "inset 0 1px 0 rgba(255,255,255,.05)"
+			},
+			/** `.ic-master .ic-lab{font-weight:600;display:flex;align-items:center;gap:7px}`；
+			*  字号**不写**（#739 ④：`label` 这一项该继承宿主字号）。 */
+			label: {
+				display: "flex",
+				alignItems: "center",
+				gap: 7,
+				fontWeight: 600
+			},
+			/** `.ic-chip{font-size:10.5px;border:1px solid var(--ic-accent);border-radius:999px;padding:0 6px}`（10.5px ⇒ `0.84em`）。 */
+			chip: {
+				fontSize: "0.84em",
+				border: "1px solid var(--dsw-alias-brand-primary, #f9fafb)",
+				borderRadius: 999,
+				padding: "0 6px",
+				color: "var(--dsw-alias-brand-primary, #f9fafb)",
+				whiteSpace: "nowrap"
 			},
-			row: { marginBottom: 10 },
-			label: { fontWeight: 600 },
+			/** `.ic-master .ic-hint{color:var(--ic-muted);font-size:11.5px;margin-top:3px;line-height:1.5}`。 */
 			hint: {
-				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				color: "var(--dsw-alias-label-secondary, #cfd3d6)",
 				fontSize: "0.92em",
-				marginBottom: 4
+				marginTop: 3,
+				lineHeight: 1.5
 			},
+			/** `.ic-master input`：整行宽、`margin-top:7px`、`padding:5px 8px`、`--ic-bg` 底、`--ic-line-strong` 描边、
+			*  `border-radius:6px`。字号与字族**不写**（#739 ④／①：`input` 继承宿主）。 */
 			input: {
+				display: "block",
 				width: "100%",
+				marginTop: 7,
+				padding: "5px 8px",
 				boxSizing: "border-box",
-				padding: "4px 8px",
+				background: "var(--dsw-alias-bg-base, #151517)",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
 				borderRadius: 6,
-				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
-				background: "var(--dsw-alias-bg-base, transparent)",
-				color: "var(--dsw-alias-label-primary, inherit)"
+				color: "var(--dsw-alias-label-primary, #f9fafb)"
 			},
-			pickRow: {
-				display: "flex",
-				gap: 6,
-				alignItems: "center"
+			/** `.ic-master input.is-dirty`：`border:2px solid var(--ic-attn)` ＋ `padding:4px 7px`
+			*  ＋ `box-shadow:0 0 0 3px <琥珀 22%>`；2px 描边与 5→4 的内边距对消，宽高不变
+			*  （审查「站得住」第 7 条）。 */
+			inputDirty: {
+				display: "block",
+				width: "100%",
+				marginTop: 7,
+				padding: "4px 7px",
+				boxSizing: "border-box",
+				background: "var(--dsw-alias-bg-base, #151517)",
+				border: "2px solid var(--dsw-alias-state-warn-primary, #e0a33e)",
+				borderRadius: 6,
+				color: "var(--dsw-alias-label-primary, #f9fafb)",
+				boxShadow: "0 0 0 3px color-mix(in srgb, var(--dsw-alias-state-warn-primary, #e0a33e) 22%, transparent)"
 			},
+			/** 布尔档那枚方框（v3.1 的母版行只有文本框，这一格按输入框的同一套外边距对齐）。 */
+			checkbox: { marginTop: 7 },
+			/** `.ic-acts{display:flex;gap:5px;margin-top:7px;flex-wrap:wrap;align-items:center}`（母版行的按钮行）。 */
 			acts: {
 				display: "flex",
-				gap: 6,
-				alignItems: "center",
-				flex: "0 0 auto"
+				gap: 5,
+				marginTop: 7,
+				flexWrap: "wrap",
+				alignItems: "center"
 			},
+			/** `.ic-btn.is-mini{font-size:11px;padding:2px 7px;color:var(--ic-muted)}`——`btnPick` 是锁钉死的那一格，
+			*  字号**不写**（#739 ④：该继承宿主字号），形状照 v3.1。 */
 			btnPick: {
-				flex: "0 0 auto",
-				padding: "4px 10px",
+				padding: "2px 7px",
 				borderRadius: 6,
-				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
-				background: "var(--dsw-alias-bg-base, transparent)",
-				color: "var(--dsw-alias-label-primary, inherit)",
-				whiteSpace: "nowrap",
-				cursor: "pointer"
+				border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+				background: "transparent",
+				color: "var(--dsw-alias-label-secondary, #cfd3d6)",
+				cursor: "pointer",
+				whiteSpace: "nowrap"
 			},
+			/** `.ic-invalid{margin-top:7px;padding:7px 9px;border-radius:6px;font-size:11.5px;line-height:1.5;
+			*  background:color-mix(in srgb, var(--ic-attn) 16%, transparent);border:1px solid var(--ic-attn)}`。 */
 			invalid: {
-				marginTop: 6,
-				padding: "6px 8px",
+				marginTop: 7,
+				padding: "7px 9px",
 				borderRadius: 6,
-				background: "color-mix(in srgb, var(--dsw-alias-state-warning-primary, #b26a00) 16%, transparent)",
-				border: "1px solid var(--dsw-alias-state-warning-primary, #b26a00)",
-				color: "var(--dsw-alias-label-primary, inherit)",
+				fontSize: "0.92em",
+				lineHeight: 1.5,
+				background: "color-mix(in srgb, var(--dsw-alias-state-warn-primary, #e0a33e) 16%, transparent)",
+				border: "1px solid var(--dsw-alias-state-warn-primary, #e0a33e)",
+				color: "var(--dsw-alias-label-primary, #f9fafb)"
+			},
+			/** `.ic-group{margin-top:14px}`（高级组默认收起）。 */
+			advanced: { marginTop: 14 },
+			/** `.ic-group > .ic-ghead{display:flex;align-items:center;gap:8px;cursor:pointer;list-style:none;
+			*  font-weight:600;padding:2px 0}`——字号**不写**（#739 ④：`summary` 该继承宿主字号）。 */
+			summary: {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				cursor: "pointer",
+				listStyle: "none",
+				fontWeight: 600,
+				padding: "2px 0"
+			},
+			/** `.ic-ghead::before{content:'›';color:var(--ic-muted)}`——画成真的那一个字符（内联样式给不出伪元素）。 */
+			groupMark: { color: "var(--dsw-alias-label-secondary, #cfd3d6)" },
+			/** `.ic-ghead .ic-gnote{color:var(--ic-faint);font-weight:400;font-size:11.5px}`（11.5px ⇒ `0.92em`）。 */
+			groupNote: {
+				color: "var(--dsw-alias-label-tertiary, #adb2b8)",
+				fontWeight: 400,
 				fontSize: "0.92em"
 			},
+			/** `.ic-group > .ic-gbody{margin-top:9px;padding:11px 12px;background:var(--ic-sunken);
+			*  border-radius:8px;box-shadow:inset 0 1px 0 rgba(255,255,255,.04)}`。 */
+			groupBody: {
+				marginTop: 9,
+				padding: "11px 12px",
+				background: "var(--dsw-alias-bg-layer-3, #353638)",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+				borderRadius: 8,
+				boxShadow: "inset 0 1px 0 rgba(255,255,255,.04)"
+			},
+			/** `.ic-bar{display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin-top:14px;padding-top:12px;
+			*  border-top:1px solid var(--ic-line)}` ＋ **贴下沿吸住**（v3.1 的 `.ic-attnbar.is-sticky` 是它唯一的
+			*  吸底口径：`position:sticky;bottom:6px;z-index:3`；本票按票面「贴下沿」取 0，好让底栏与下沿齐平）。 */
 			bar: {
 				display: "flex",
 				gap: 8,
-				marginTop: 12,
+				alignItems: "center",
 				flexWrap: "wrap",
+				marginTop: 14,
+				paddingTop: 12,
+				borderTop: "1px solid var(--dsw-alias-border-l1, rgba(255,255,255,.06))",
 				position: "sticky",
 				bottom: 0,
-				zIndex: 1,
-				background: "var(--dsw-alias-bg-layer-1, #232329)",
-				padding: "8px 0",
-				borderTop: "1px solid var(--dsw-alias-border, rgba(128,128,128,.25))"
-			},
-			saveMsg: {
-				marginRight: "auto",
-				alignSelf: "center",
-				color: "var(--dsw-alias-state-warning-primary, #b26a00)",
-				fontSize: "0.9em"
+				zIndex: 3,
+				background: "var(--dsw-alias-bg-layer-1, #232324)"
 			},
-			dirtyDot: {
-				color: "var(--dsw-alias-state-warning-primary, #b26a00)",
-				fontSize: "0.85em",
-				marginLeft: 6,
-				fontWeight: 400
+			/** `.ic-bar .ic-note{margin-left:auto;color:var(--ic-faint);font-size:11.5px}`（就绪态那半句）。 */
+			barNote: {
+				marginLeft: "auto",
+				color: "var(--dsw-alias-label-tertiary, #adb2b8)",
+				fontSize: "0.92em"
 			},
-			followNote: {
-				color: "var(--dsw-alias-state-warning-primary, #b26a00)",
-				fontSize: "0.85em",
-				marginBottom: 4
+			/** 有改动时底栏那半句（黄字，粘在按钮组左侧）。 */
+			saveMsg: {
+				marginLeft: "auto",
+				color: "var(--dsw-alias-state-warn-primary, #e0a33e)",
+				fontSize: "0.92em"
 			},
+			/** `.ic-btn{font-size:12px;padding:4px 10px;border-radius:6px;border:1px solid var(--ic-line-strong);
+			*  background:transparent;color:var(--ic-text)}`——字号**不写**（#739 ④）。 */
 			btn: {
-				padding: "4px 12px",
+				padding: "4px 10px",
 				borderRadius: 6,
-				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
-				background: "var(--dsw-alias-bg-base, transparent)",
-				color: "var(--dsw-alias-label-primary, inherit)",
-				cursor: "pointer"
+				border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+				background: "transparent",
+				color: "var(--dsw-alias-label-primary, #f9fafb)",
+				cursor: "pointer",
+				whiteSpace: "nowrap"
 			},
+			/** `.ic-btn.is-primary{background:var(--ic-accent);border-color:var(--ic-accent);color:var(--ic-accent-ink);
+			*  font-weight:500}`——`--ic-accent` 取 `--dsw-alias-brand-primary`，前景取 `label-primary-foreground`。 */
 			btnPrimary: {
-				padding: "4px 12px",
+				padding: "4px 10px",
 				borderRadius: 6,
-				border: "1px solid var(--dsw-alias-brand-primary, #2f6fed)",
-				background: "var(--dsw-alias-brand-primary, #2f6fed)",
-				color: "#fff",
-				cursor: "pointer"
-			},
-			advanced: { marginTop: 12 },
-			summary: {
+				border: "1px solid var(--dsw-alias-brand-primary, #f9fafb)",
+				background: "var(--dsw-alias-brand-primary, #f9fafb)",
+				color: "var(--dsw-alias-label-primary-foreground, #0f1115)",
+				fontWeight: 500,
 				cursor: "pointer",
-				fontWeight: 600
+				whiteSpace: "nowrap"
 			},
+			/** 附加块（版本行／状态行）那份字面：`--ic-faint` ＋ `0.92em`（#739 ③ 钉死这一格）。 */
 			version: {
 				marginTop: 8,
 				paddingTop: 8,
-				borderTop: "1px dashed var(--dsw-alias-border, rgba(128,128,128,.25))",
-				color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
+				borderTop: "1px dashed var(--dsw-alias-border-l1, rgba(255,255,255,.06))",
+				color: "var(--dsw-alias-label-tertiary, #adb2b8)",
 				fontSize: "0.92em"
+			},
+			/** `.ic-badge{font-size:11px;line-height:1;padding:4px 9px;border-radius:999px;white-space:nowrap;
+			*  display:inline-flex;align-items:center;gap:6px;border:1px solid transparent}`（11px ⇒ `0.88em`）。 */
+			badge: {
+				fontSize: "0.88em",
+				lineHeight: 1,
+				padding: "4px 9px",
+				borderRadius: 999,
+				whiteSpace: "nowrap",
+				display: "inline-flex",
+				alignItems: "center",
+				gap: 6,
+				border: "1px solid transparent"
+			},
+			/** `.ic-badge .ic-bd{width:6px;height:6px;border-radius:50%;background:currentColor}`。 */
+			badgeDot: {
+				width: 6,
+				height: 6,
+				borderRadius: "50%",
+				background: "currentColor"
+			},
+			/** `.ic-spin{width:11px;height:11px;border-radius:50%;border:1.5px solid rgba(0,0,0,.25);
+			*  border-top-color:currentColor}`——旋转那半要 `@keyframes`（内联样式给不出），故只画环。 */
+			badgeSpinner: {
+				width: 11,
+				height: 11,
+				borderRadius: "50%",
+				border: "1.5px solid rgba(0,0,0,.25)",
+				borderTopColor: "currentColor",
+				display: "inline-block"
+			},
+			/** `.ic-badge.is-dirty`：`--ic-attn` 实底 ＋ `--ic-attn-ink` 深字（那 3:1 是设计专门解过的对比度）。 */
+			badgeDirty: {
+				color: "#241703",
+				background: "var(--dsw-alias-state-warn-primary, #e0a33e)",
+				borderColor: "var(--dsw-alias-state-warn-primary, #e0a33e)",
+				fontWeight: 600
+			},
+			/** `.ic-badge.is-busy`：与 dirty 同色（写的时候还在那一档上）。 */
+			badgeBusy: {
+				color: "#241703",
+				background: "var(--dsw-alias-state-warn-primary, #e0a33e)",
+				borderColor: "var(--dsw-alias-state-warn-primary, #e0a33e)",
+				fontWeight: 600
+			},
+			/** `.ic-badge.is-ok{color:var(--ic-ok);border-color:var(--ic-ok);background:color-mix(in srgb, var(--ic-ok) 14%, transparent)}`。 */
+			badgeOk: {
+				color: "var(--dsw-alias-state-success-primary, #4ec9a0)",
+				borderColor: "var(--dsw-alias-state-success-primary, #4ec9a0)",
+				background: "color-mix(in srgb, var(--dsw-alias-state-success-primary, #4ec9a0) 14%, transparent)"
+			},
+			/** `.ic-badge.is-bad{color:var(--ic-danger-ink);background:var(--ic-danger);border-color:var(--ic-danger)}`。 */
+			badgeBad: {
+				color: "#fff5f4",
+				background: "var(--dsw-alias-state-error-primary, #e0685f)",
+				borderColor: "var(--dsw-alias-state-error-primary, #e0685f)",
+				fontWeight: 600
 			}
 		};
 		/** 复制那一枚按钮的字面（定稿 v3 第三条：就地变，不弹提示）。 */
@@ -1229,29 +1485,85 @@ window.__ModuleLoader__.load({
 			if (state === "failed") return "复制失败";
 			return "复制";
 		}
-		/** 一行输入（四种控件对齐受限 YAML 子集：文本／数字／布尔／目录）。
+		/** 状态 → 徽标那一档（v3.1 `paint()` 里的先后次序：读取失败／写入中／写入失败／值非法／有改动／已保存／就绪）。 */
+		function panelBadgeOf(facts) {
+			if (facts.readFailed) return "readFailed";
+			if (facts.busy) return "busy";
+			if (facts.writeFailed) return "writeFailed";
+			if (facts.invalid) return "invalid";
+			if (facts.dirtyCount > 0) return "dirty";
+			if (facts.saved) return "saved";
+			return "ready";
+		}
+		/** 徽标那一档画的字（v3.1 `badgeHTML` 的字面，只把「已保存 · 刚刚」的演示时刻换成档名）。 */
+		function badgeTextOf(kind, dirtyCount) {
+			if (kind === "dirty") return `${dirtyCount} 项未保存`;
+			if (kind === "busy") return "正在写入";
+			if (kind === "saved") return "已保存";
+			if (kind === "invalid") return "配置里有值用不了";
+			if (kind === "writeFailed") return "写入失败";
+			return "";
+		}
+		/** 徽标那一档的底色（v3.1 的四条 `.ic-badge.is-*`）。 */
+		function badgeStyleOf(kind) {
+			if (kind === "dirty" || kind === "invalid") return {
+				...S.badge,
+				...S.badgeDirty
+			};
+			if (kind === "busy") return {
+				...S.badge,
+				...S.badgeBusy
+			};
+			if (kind === "saved") return {
+				...S.badge,
+				...S.badgeOk
+			};
+			if (kind === "writeFailed") return {
+				...S.badge,
+				...S.badgeBad
+			};
+			return S.badge;
+		}
+		/** 画卡片标题行右端那枚状态徽标（就绪态与读取失败那一支不画）。 */
+		function PanelBadgeView(props) {
+			const text = badgeTextOf(props.kind, props.dirtyCount);
+			if (text === "") return null;
+			return react.createElement("span", { style: badgeStyleOf(props.kind) }, props.kind === "busy" ? react.createElement("span", { style: S.badgeSpinner }) : react.createElement("span", { style: S.badgeDot }), text);
+		}
+		/** 一行怎么画（照 v3.1 的两套行模板）：
+		*
+		* **只读行**（`.ic-row`）＝标签—值同行、值装不下整行让位、行尾一枚「复制」——**不画输入框**
+		* （值来自技能侧解析，页面上本来就不给改），也不画那行说明（v3.1 的 `rowShell` 里没有它）。
+		* **可改行**（`.ic-master`）＝标签 ＋「可改」小徽标 ＋ 说明 ＋ 整行输入框 ＋ 按钮行。
 		*
 		* 目录档＝文本框 ＋ 一枚唤起目录选择的按钮；入口三态是 `none`（命名空间拿不到、或这条路已被拒）
 		* **就不画按钮**，文本框照旧——那是该缝自己的契约（供不了就收起入口，不是失败）。
-		* **只读行**：控件一律 `disabled`、`onChange` 不接，目录行的按钮**一枚都不画**（定稿 v3 ①）。 */
+		* 只读行：目录入口**一枚都不画**（定稿 v3 ①）。 */
 		function Row(props) {
 			const { item } = props;
 			const readonly = item.readonly === true;
 			const disabled = props.disabled || readonly;
-			const onChange = readonly ? void 0 : (e) => props.onChange(item.key, e.target.value);
+			const copy = react.createElement("button", {
+				style: S.btnPick,
+				type: "button",
+				disabled: props.onCopy === void 0,
+				onClick: () => props.onCopy?.(item.key, props.value)
+			}, copyLabelOf(props.copyState));
+			const follow = props.follow === true ? react.createElement("span", { style: S.follow }, react.createElement("span", { style: S.followMark }, "↳"), "将跟随更新") : null;
+			if (readonly) {
+				/** 跟随行落 `.ic-under` 那一档缩进；其余按是不是本组最后一行挑有没有下边线。 */
+				const rowStyle = props.nested === true ? props.last === true ? S.followerRowLast : S.followerRow : props.last === true ? S.rowLast : S.row;
+				return react.createElement("div", { style: rowStyle }, react.createElement("span", { style: S.rowKey }, item.title), react.createElement("span", { style: S.rowValue }, props.value), react.createElement("span", { style: S.rowActs }, follow, copy));
+			}
+			const onChange = (e) => props.onChange(item.key, e.target.value);
 			const control = item.control === "switch" ? react.createElement("input", {
 				type: "checkbox",
+				style: S.checkbox,
 				checked: props.value === "true",
 				disabled,
-				onChange: readonly ? void 0 : (e) => props.onChange(item.key, e.target.checked ? "true" : "false")
+				onChange: (e) => props.onChange(item.key, e.target.checked ? "true" : "false")
 			}) : react.createElement("input", {
-				style: props.dirty === true ? {
-					...S.input,
-					borderColor: "var(--dsw-alias-state-warning-primary, #b26a00)"
-				} : readonly && props.follow === true ? {
-					...S.input,
-					opacity: .55
-				} : S.input,
+				style: props.dirty === true ? S.inputDirty : S.input,
 				type: item.control === "number" ? "number" : "text",
 				value: props.value,
 				disabled,
@@ -1260,21 +1572,13 @@ window.__ModuleLoader__.load({
 			});
 			/** 目录入口：只读行不画（定稿 v3 ①），供不了（`none`／缺席）也不画。 */
 			const entry = props.browser ?? null;
-			const browse = item.control === "directory" && !readonly && entry !== null && entry.mode !== "none" ? react.createElement("button", {
+			const browse = item.control === "directory" && entry !== null && entry.mode !== "none" ? react.createElement("button", {
 				style: S.btnPick,
 				type: "button",
 				disabled,
 				onClick: () => entry.onOpen(item.key)
 			}, "浏览文件夹") : null;
-			const copy = react.createElement("button", {
-				style: S.btnPick,
-				type: "button",
-				disabled: props.onCopy === void 0,
-				onClick: () => props.onCopy?.(item.key, props.value)
-			}, copyLabelOf(props.copyState));
-			const acts = react.createElement("div", { style: S.acts }, browse, copy);
-			const facts = props.fallback ?? null;
-			return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title, props.dirty === true ? react.createElement("span", { style: S.dirtyDot }, "●已改动") : null), react.createElement("div", { style: S.hint }, item.hint), readonly && props.follow === true ? react.createElement("div", { style: S.followNote }, "将跟随更新，保存后生效。") : null, facts === null ? null : react.createElement("div", { style: S.invalid }, "配置里写的是 ", react.createElement("b", null, facts.written), "；现在生效的是 ", react.createElement("b", null, facts.effective), "。"), react.createElement("div", { style: S.pickRow }, control, acts));
+			return react.createElement("div", { style: S.master }, react.createElement("div", { style: S.label }, item.title, react.createElement("span", { style: S.chip }, "可改")), react.createElement("div", { style: S.hint }, item.hint), control, react.createElement("div", { style: S.acts }, browse, copy), props.alert == null ? null : react.createElement("div", { style: S.invalid }, props.alert.message));
 		}
 		/** 应用内浏览器对话框的文案（面板自带，逐条对应图上那几个位置）。 */
 		const BROWSER_LABELS = {
@@ -1301,14 +1605,27 @@ window.__ModuleLoader__.load({
 			const surface = state.kind === "ready" ? state.surface : null;
 			const headText = title === void 0 ? "配置" : `${title} · 配置`;
 			const headDataDir = surface === null ? "" : surface.resolved?.["dbDir"] ?? surface.dataDir;
-			const head = react.createElement("div", null, react.createElement("div", { style: S.title }, headText), surface === null ? null : react.createElement("div", null, react.createElement("div", { style: S.info }, `配置文件 ${surface.path}`), react.createElement("div", { style: S.info }, `数据目录 ${headDataDir}`), surface.created ? react.createElement("div", { style: S.muted }, "（配置文件刚按默认值生成）") : null));
+			const ready = state.kind === "ready";
+			const dirtyCount = ready ? props.dirtyKeys.length : 0;
+			const badge = panelBadgeOf({
+				readFailed: state.kind === "failed",
+				busy: props.busy,
+				writeFailed: props.writeError !== null,
+				invalid: props.invalid === true,
+				dirtyCount,
+				saved: props.notice !== null
+			});
+			const head = react.createElement("div", { style: S.head }, react.createElement("div", { style: S.title }, headText), react.createElement(PanelBadgeView, {
+				kind: badge,
+				dirtyCount
+			}));
+			const fileLines = surface === null ? null : react.createElement("div", { style: S.fileWrap }, react.createElement("div", { style: S.info }, react.createElement("b", { style: S.fileLabel }, "配置文件"), surface.path), react.createElement("div", { style: S.info }, react.createElement("b", { style: S.fileLabel }, "数据目录"), headDataDir), surface.created ? react.createElement("div", { style: S.muted }, "（配置文件刚按默认值生成）") : null);
 			const parts = {
 				styles: S,
 				reply: surface
 			};
 			const extra = props.extra === void 0 ? null : props.extra(parts);
-			if (state.kind === "loading") return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.muted }, "配置读取中"), extra);
-			if (state.kind === "failed") return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.error }, state.message), extra, react.createElement("div", { style: S.bar }, react.createElement("button", {
+			if (state.kind === "failed") return react.createElement("div", { style: S.card }, head, fileLines, react.createElement("div", { style: S.error }, state.message), extra, react.createElement("div", { style: S.bar }, react.createElement("button", {
 				style: S.btn,
 				type: "button",
 				onClick: props.onRetry
@@ -1319,37 +1636,49 @@ window.__ModuleLoader__.load({
 			}, "重置为默认")));
 			const common = props.items.filter((item) => item.tier === "common");
 			const advanced = props.items.filter((item) => item.tier === "advanced");
-			const renderRow = (item) => react.createElement(Row, {
+			/** 还没读到整面（`loading`）时**框架照画**：行表与控件形状是客户端常量，不必等任何回执。
+			*  值先空着、控件与三枚底栏键一律不可用；回执到了由 `ready` 那一支把值填上（见 `config-panel.ts`）。 */
+			const frozen = props.busy || !ready;
+			const followers = props.followerKeys ?? [];
+			const renderRow = (item, last) => react.createElement(Row, {
 				key: item.key,
 				item,
 				value: props.draft[item.key] ?? "",
-				disabled: props.busy,
+				disabled: frozen,
 				onChange: props.onChange,
 				browser: props.rowEntry,
-				dirty: props.dirtyKeys.includes(item.key),
-				follow: props.followKeys.includes(item.key),
-				onCopy: props.onCopy,
+				dirty: ready && props.dirtyKeys.includes(item.key),
+				follow: ready && props.followKeys.includes(item.key),
+				onCopy: ready ? props.onCopy : void 0,
 				copyState: props.copy !== null && props.copy.key === item.key ? props.copy.ok ? "done" : "failed" : "idle",
-				fallback: item.readonly !== true && item.prefillFrom !== void 0 ? fallbackFactsOf(item, props.draft[item.key] ?? "", draftSourceOf(surface)) : null
+				alert: ready ? surface?.alerts?.[item.key] ?? null : null,
+				last,
+				nested: followers.includes(item.key)
 			});
-			const dirtyCount = props.dirtyKeys.length;
-			const dirty = dirtyCount > 0;
-			return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.rows }, common.map(renderRow)), advanced.length === 0 ? null : react.createElement("details", { style: S.advanced }, react.createElement("summary", { style: S.summary }, ADVANCED_GROUP_TITLE), react.createElement("div", { style: S.muted }, ADVANCED_GROUP_NOTE), advanced.map(renderRow)), extra, react.createElement("div", { style: S.bar }, dirty ? react.createElement("div", { style: S.saveMsg }, `浏览改动后请点保存（${dirtyCount} 项未保存），保存后跟随项自动更新`) : null, react.createElement("button", {
+			/** 每组最后那一行才免掉下边线（`.ic-row:last-child`）；母版行自己不带线，不必管。 */
+			const lastIndexOf = (list) => {
+				for (let i = list.length - 1; i >= 0; i -= 1) if (list[i].readonly === true) return i;
+				return -1;
+			};
+			const commonLast = lastIndexOf(common);
+			const advancedLast = lastIndexOf(advanced);
+			const dirty = ready && dirtyCount > 0;
+			return react.createElement("div", { style: S.card }, head, fileLines, ready ? null : react.createElement("div", { style: S.muted }, "配置读取中"), react.createElement("div", { style: S.rows }, common.map((item, index) => renderRow(item, index === commonLast))), advanced.length === 0 ? null : react.createElement("details", { style: S.advanced }, react.createElement("summary", { style: S.summary }, react.createElement("span", { style: S.groupMark }, "›"), ADVANCED_GROUP_TITLE, react.createElement("span", { style: S.groupNote }, ADVANCED_GROUP_NOTE)), react.createElement("div", { style: S.groupBody }, advanced.map((item, index) => renderRow(item, index === advancedLast)))), extra, react.createElement("div", { style: S.bar }, react.createElement("button", {
 				style: dirty ? S.btnPrimary : S.btn,
 				type: "button",
-				disabled: props.busy || !dirty,
+				disabled: frozen || !dirty,
 				onClick: props.onSave
 			}, props.busy ? "处理中" : dirty ? `保存（${dirtyCount} 项未保存）` : "保存"), react.createElement("button", {
 				style: S.btn,
 				type: "button",
-				disabled: props.busy,
+				disabled: frozen,
 				onClick: props.onReset
 			}, "重置为默认"), react.createElement("button", {
 				style: S.btn,
 				type: "button",
-				disabled: props.busy,
+				disabled: frozen,
 				onClick: props.onRetry
-			}, "重新读取")), props.picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框：选中后自动填上，取消则不动。") : null, props.browseRow !== null ? react.createElement(DirectoryBrowserFromRow, {
+			}, "重新读取"), dirty ? react.createElement("div", { style: S.saveMsg }, `浏览改动后请点保存（${dirtyCount} 项未保存），保存后跟随项自动更新`) : ready ? react.createElement("div", { style: S.barNote }, "没有未保存的改动") : null), props.picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框：选中后自动填上，取消则不动。") : null, props.browseRow !== null ? react.createElement(DirectoryBrowserFromRow, {
 				open: true,
 				row: props.browseRow,
 				labels: BROWSER_LABELS
@@ -1358,15 +1687,6 @@ window.__ModuleLoader__.load({
 				role: "alert"
 			}, props.writeError) : null, props.error !== null ? react.createElement("div", { style: S.error }, props.error) : null, props.notice !== null ? react.createElement("div", { style: S.okText }, props.notice) : null);
 		}
-		/** 「写的值 ≠ 生效值」两个事实要的那几格：整面回执里取值本身、落点顶层那一个、`resolved` 组。 */
-		function draftSourceOf(surface) {
-			if (surface === null) return { values: {} };
-			return {
-				values: surface.values,
-				dataDir: surface.dataDir,
-				resolved: surface.resolved
-			};
-		}
 		//#endregion
 		//#region ../plugin-manager/dist/directory-browser-roots.js
 		/** 「本机根清单」的取数接线（客户端半）：把一通电话变成图上那一行可跳转的根。
@@ -1504,6 +1824,18 @@ window.__ModuleLoader__.load({
 				return false;
 			}
 		}
+		/** **静态**跟随行名单：给行表里每个键喂一遍六家交的钩子，收它返回的跟随者。
+		*
+		* 为什么能这么探：`followKeysOf` 是**纯函数**，六家的实现都只是「脏键里有没有这一格」那一下判断
+		* （各家 `src/client.ts`），喂单键即得「谁跟着它」——**与当刻脏不脏无关**。有了这个集合，共用件就能
+		* 照 v3.1 的 `.ic-under` 把跟随行相对它的可改行缩进（#920 补），**六家源码一个字节不用改**。
+		* 拿不到钩子时回空表（一行都不缩进，照旧平铺）。 */
+		function followerKeysOf(items, hook) {
+			if (hook === void 0) return [];
+			const out = /* @__PURE__ */ new Set();
+			for (const item of items) for (const key of hook([item.key])) out.add(key);
+			return [...out];
+		}
 		/** 技能设置页：承载一家自己的全部可配置项（只配置，不干活）。 */
 		function ConfigPanel(props) {
 			const [state, setState] = react.useState({ kind: "loading" });
@@ -1662,6 +1994,10 @@ window.__ModuleLoader__.load({
 			const baseline = surface !== null ? toDraft(props.items, surface.values, surface) : null;
 			const dirtyKeys = baseline === null ? [] : dirtyKeysOf(props.items, draft, baseline);
 			const followKeys = (props.followKeysOf ?? noFollowKeys)(dirtyKeys);
+			/** 技能侧报出「有格子真用不了」⇒ 标题行那枚「配置里有值用不了」徽标才亮（#915 第二步）。 */
+			const hasAlert = surface !== null && surface.alerts !== void 0 && Object.keys(surface.alerts).length > 0;
+			/** 静态那一份（与脏不脏无关）：画跟随行的缩进用（v3.1 的 `.ic-under`）。 */
+			const followerKeys = followerKeysOf(props.items, props.followKeysOf);
 			const mode = pickerModeOf(picker);
 			const rowEntry = mode === "none" ? null : {
 				mode,
@@ -1681,6 +2017,8 @@ window.__ModuleLoader__.load({
 				rowEntry,
 				dirtyKeys,
 				followKeys,
+				followerKeys,
+				invalid: hasAlert,
 				copy,
 				onCopy,
 				onChange,