@dsh-plus/actual 0.2.7 → 0.2.9

package/lib/client.js

@@ -4,11 +4,36 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region \0rolldown/runtime.js
+		var __create = Object.create;
+		var __defProp = Object.defineProperty;
+		var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+		var __getOwnPropNames = Object.getOwnPropertyNames;
+		var __getProtoOf = Object.getPrototypeOf;
+		var __hasOwnProp = Object.prototype.hasOwnProperty;
+		var __copyProps = (to, from, except, desc) => {
+			if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+				key = keys[i];
+				if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+			return to;
+		};
+		var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+			value: mod,
+			enumerable: true
+		}) : target, mod));
+		//#endregion
 		let react = require("react");
+		react = __toESM(react, 1);
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let _deepseek_ai_schemastery = require("@deepseek-ai/schemastery");
+		_deepseek_ai_schemastery = __toESM(_deepseek_ai_schemastery, 1);
 		require("@deepseek-ai/dsh-client-ui-primitives");
 		//#region ../shared/src/client/fields.tsx
-		/** 卡片按钮（与 CardChrome 页脚同一套类名与视觉）。 */
+		/** 卡片按钮（与 ConfigShell 页脚同一套类名与视觉）。 */
 		function Button(props) {
 			const p = props.prefix ?? "dshp";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
@@ -112,11 +137,26 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region ../shared/src/client/card.tsx
+		/**
+		* 配置卡片外壳与排版件：`ConfigShell`（卡片级无边框分节）、`Section`（卡片内二级
+		* 分组）、`FieldGrid`（字段排布）、`Note`（只读说明）、`ListEditor`（数组型资源
+		* 统一编辑）、`CardLoading`（取值未到达占位）。
+		*
+		* 宿主页面（`plugins.row.config` / `plugins.bundle.config` 的 page 视图）自己画
+		* 标题、图标、面包屑与页面级内边距，视图只填内容区——所以这里不再自绘带边框
+		* 卡片（会形成卡片套卡片，把移动端可用宽度逐层扣掉），也不做折叠：page 视图
+		* 本身就是表单落地页。度量对齐官方设置页（dsh-client-ui-primitives 的
+		* settings-form）：小节标题 13px/600、字段区零横向内边距、页脚非 sticky。
+		*
+		* 各插件 card.tsx 只填 children 字段区与 actions；类名前缀与样式由
+		* cardCss(prefix) 配套。
+		* @module @dsh-plus/shared/client/card
+		*/
 		const IDLE_STATUS = {
 			kind: "idle",
 			text: ""
 		};
-		function CardChrome(props) {
+		function ConfigShell(props) {
 			const p = props.prefix;
 			const badge = props.statusBadge;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
@@ -172,7 +212,20 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		/** 取值未到达时的占位：与 CardChrome 同形态，避免宿主页里闪一次卡片外壳。 */
+		/** 只读说明块（部署面字段、无编辑器字段的「为什么」）。 */
+		function Note(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${props.prefix}-note`,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: `${props.prefix}-noteTitle`,
+					children: props.title
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: `${props.prefix}-noteBody`,
+					children: props.body
+				})]
+			});
+		}
+		/** 取值未到达时的占位：与 ConfigShell 同形态，避免宿主页里闪一次卡片外壳。 */
 		function CardLoading(props) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("section", {
 				className: `${props.prefix}-section`,
@@ -184,14 +237,744 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region ../shared/src/client/code-ops.ts
+		/** 是否为普通对象（配置文档的合法节点）。 */
+		function isPlainObject(value) {
+			if (value === null || typeof value !== "object") return false;
+			const proto = Object.getPrototypeOf(value);
+			return proto === Object.prototype || proto === null;
+		}
+		/** 从 V8 语法错误消息中取行列；新版带 `(line L column C)`，旧版只有偏移量。 */
+		function positionOf(message, text) {
+			const located = /\(line (\d+) column (\d+)\)/.exec(message);
+			if (located !== null) return {
+				line: Number(located[1]),
+				column: Number(located[2])
+			};
+			const offset = /at position (\d+)/.exec(message);
+			if (offset === null) return {
+				line: null,
+				column: null
+			};
+			const index = Math.min(Number(offset[1]), text.length);
+			const head = text.slice(0, index);
+			return {
+				line: head.split("\n").length,
+				column: index - head.lastIndexOf("\n")
+			};
+		}
+		/**
+		* 解析配置文档：必须是 JSON 对象（配置根节点为行级 Config 对象）。
+		* @param text - 编辑器全文。
+		* @returns 成功给出对象；失败给出原因与可定位的行列。
+		*/
+		function parseConfigJson(text) {
+			if (text.trim() === "") return {
+				ok: false,
+				reason: "empty",
+				message: "",
+				line: null,
+				column: null
+			};
+			let parsed;
+			try {
+				parsed = JSON.parse(text);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				return {
+					ok: false,
+					reason: "syntax",
+					message,
+					...positionOf(message, text)
+				};
+			}
+			if (!isPlainObject(parsed)) return {
+				ok: false,
+				reason: "root",
+				message: "",
+				line: 1,
+				column: 1
+			};
+			return {
+				ok: true,
+				value: parsed
+			};
+		}
+		/** 两空格缩进格式化（解析失败时原样返回输入与失败信息）。 */
+		function formatConfigJson(text) {
+			const parsed = parseConfigJson(text);
+			if (!parsed.ok) return {
+				ok: false,
+				result: parsed
+			};
+			return {
+				ok: true,
+				text: `${JSON.stringify(parsed.value, null, 2)}\n`
+			};
+		}
+		/** 差分：对象删键 → unset；数组删元素 → 下标降序 unset（保持其余下标有效）。 */
+		function diffToOps(before, after) {
+			const ops = [];
+			walk(before, after, [], ops);
+			return ops;
+		}
+		function walk(before, after, path, ops) {
+			if (Array.isArray(after)) {
+				walkArray(before, after, path, ops);
+				return;
+			}
+			if (isPlainObject(after)) {
+				walkObject(before, after, path, ops);
+				return;
+			}
+			if (!Object.is(before, after)) ops.push({
+				op: "set",
+				path: [...path],
+				value: after
+			});
+		}
+		function walkObject(before, after, path, ops) {
+			if (!isPlainObject(before)) {
+				ops.push({
+					op: "set",
+					path: [...path],
+					value: after
+				});
+				return;
+			}
+			for (const [key, value] of Object.entries(after)) {
+				if (!Object.hasOwn(before, key)) {
+					ops.push({
+						op: "set",
+						path: [...path, key],
+						value
+					});
+					continue;
+				}
+				walk(before[key], value, [...path, key], ops);
+			}
+			for (const key of Object.keys(before)) if (!Object.hasOwn(after, key)) ops.push({
+				op: "unset",
+				path: [...path, key]
+			});
+		}
+		function walkArray(before, after, path, ops) {
+			if (!Array.isArray(before)) {
+				ops.push({
+					op: "set",
+					path: [...path],
+					value: after
+				});
+				return;
+			}
+			const shared = Math.min(before.length, after.length);
+			for (let index = 0; index < shared; index += 1) walk(before[index], after[index], [...path, String(index)], ops);
+			for (let index = before.length - 1; index >= after.length; index -= 1) ops.push({
+				op: "unset",
+				path: [...path, String(index)]
+			});
+			for (let index = before.length; index < after.length; index += 1) ops.push({
+				op: "set",
+				path: [...path, String(index)],
+				value: after[index]
+			});
+		}
+		/** schema JSON 里的密钥字段路径（`meta.role === 'secret'`）：源码编辑器不呈现它们。 */
+		function secretPathsOf(schemaJson) {
+			const refs = refsOf(schemaJson);
+			if (refs === null) return [];
+			const root = schemaJson.uid;
+			if (typeof root !== "number") return [];
+			const out = [];
+			collectSecretPaths(refs, root, [], out, /* @__PURE__ */ new Set());
+			return out;
+		}
+		/**
+		* 文档里 schema 未声明的键路径。
+		*
+		* schemastery 对未声明键**透传忽略**（不报错、不剥离），所以这类键会被原样写进
+		* 用户层并永久留存——典型来源是历史配置键与手写拼写错误。源码编辑器把它作为
+		* 非阻断警告列出来（迁移期新旧键并存时不至于挡住应用）。
+		*/
+		function unknownKeysOf(schemaJson, value) {
+			const refs = refsOf(schemaJson);
+			if (refs === null || !isPlainObject(value)) return [];
+			const root = schemaJson.uid;
+			if (typeof root !== "number") return [];
+			return [...unknownKeysAt(refs, root, value)].sort();
+		}
+		/** 返回「该节点下所有未被 schema 声明的键路径」的集合。 */
+		function unknownKeysAt(refs, index, value) {
+			const node = refs[String(index)];
+			if (node === void 0) return /* @__PURE__ */ new Set();
+			if (node.list !== void 0) return intersectBranches(refs, node.list, value);
+			if (node.inner !== void 0) {
+				if (Array.isArray(value)) {
+					const out = /* @__PURE__ */ new Set();
+					for (const [at, item] of value.entries()) for (const path of unknownKeysAt(refs, node.inner, item)) out.add(`${at}.${path}`);
+					return out;
+				}
+				return unknownKeysAt(refs, node.inner, value);
+			}
+			if (node.dict === void 0 || !isPlainObject(value)) return /* @__PURE__ */ new Set();
+			const out = /* @__PURE__ */ new Set();
+			for (const [key, child] of Object.entries(value)) {
+				const next = node.dict[key];
+				if (next === void 0) {
+					out.add(key);
+					continue;
+				}
+				for (const path of unknownKeysAt(refs, next, child)) out.add(`${key}.${path}`);
+			}
+			return out;
+		}
+		/** 联合类型：只在「对象型分支」之间取交集（标量分支不否决键判定）。 */
+		function intersectBranches(refs, list, value) {
+			const objectBranches = list.filter((branch) => refs[String(branch)]?.dict !== void 0);
+			if (objectBranches.length === 0) return /* @__PURE__ */ new Set();
+			let result = null;
+			for (const branch of objectBranches) {
+				const keys = unknownKeysAt(refs, branch, value);
+				if (result === null) {
+					result = keys;
+					continue;
+				}
+				for (const key of [...result]) if (!keys.has(key)) result.delete(key);
+			}
+			return result ?? /* @__PURE__ */ new Set();
+		}
+		function refsOf(schemaJson) {
+			if (!isPlainObject(schemaJson)) return null;
+			const refs = schemaJson.refs;
+			return isPlainObject(refs) ? refs : null;
+		}
+		function collectSecretPaths(refs, index, path, out, seen) {
+			const node = refs[String(index)];
+			if (node === void 0) return;
+			const marker = `${index}:${path.join(".")}`;
+			if (seen.has(marker)) return;
+			seen.add(marker);
+			if (node.meta?.role === "secret") {
+				out.push([...path]);
+				return;
+			}
+			for (const [key, child] of Object.entries(node.dict ?? {})) collectSecretPaths(refs, child, [...path, key], out, seen);
+			if (typeof node.inner === "number") collectSecretPaths(refs, node.inner, path, out, seen);
+			for (const child of node.list ?? []) collectSecretPaths(refs, child, path, out, seen);
+		}
+		//#endregion
+		//#region ../shared/src/client/code-validate.ts
+		/**
+		* 配置源码编辑的模式校验：用宿主 `describe` 回传的 schema JSON 在浏览器本地
+		* 重建同一套 schemastery 校验（库 23KB 纯 JS，随 client bundle 打苞——浏览器端
+		* 没有宿主实例，不存在跨实例符号身份问题，见 docs/reference/官方机制参照.md
+		* 「客户端平台」）。
+		*
+		* 校验与宿主写入路径同源：`new Schema(json)` 后按同一份 volatile 投影调用，
+		* 因此本地拦下的错误与宿主 `settings/rejected` 的判据一致。
+		* @module @dsh-plus/shared/client/code-validate
+		*/
+		/** 重建结果按 schema JSON 对象身份缓存（describe 每次应答一个新对象，无泄漏风险）。 */
+		const cache = /* @__PURE__ */ new WeakMap();
+		function rebuild(schemaJson) {
+			if (!isPlainObject(schemaJson)) return null;
+			const cached = cache.get(schemaJson);
+			if (cached !== void 0) return cached;
+			let built = null;
+			try {
+				built = new _deepseek_ai_schemastery.default(schemaJson);
+			} catch {
+				built = null;
+			}
+			cache.set(schemaJson, built);
+			return built;
+		}
+		/** 从 schemastery 错误消息里取路径前缀：`$.a.b expected number but got x` → `a.b`。 */
+		function pathOf(message) {
+			const located = /^\$\.([^\s]+)/.exec(message);
+			return located === null ? "" : located[1] ?? "";
+		}
+		/**
+		* 按宿主 schema 校验一份配置文档。
+		* @param schemaJson - `describe` 应答里的 `schema`（schemastery `toJSON()` 形态）。
+		* @param value - 编辑器解析出的对象。
+		* @returns 通过（含「未校验」标记）或问题清单。
+		*/
+		function validateAgainstSchema(schemaJson, value) {
+			const validate = rebuild(schemaJson);
+			if (validate === null) return {
+				ok: true,
+				validated: false
+			};
+			try {
+				validate(value);
+				return {
+					ok: true,
+					validated: true
+				};
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				return {
+					ok: false,
+					validated: true,
+					issues: [{
+						path: pathOf(message),
+						message
+					}]
+				};
+			}
+		}
+		//#endregion
+		//#region ../shared/src/client/styles.ts
+		/**
+		* 配置分节样式工厂（各插件 client 的公共收编版）。
+		*
+		* 目标宿主 dsh 0.2.1-alpha.2：插件页把配置视图放进已有页面级内边距的容器里
+		* （`div.detailSections[data-plugin-config]` 或 `section.detailSection[data-plugin-config]`），
+		* 外层无边框——故这里输出的是**无边框分节**（小节标题 13px/600、字段 12px 0、
+		* 横向零内边距、页脚非 sticky），度量对齐官方设置页
+		* （`@deepseek-ai/dsh-client-ui-primitives` 的 settings-form）。
+		*
+		* 移动端与可达性（767px 断点 + pointer:coarse，对齐 ui-mobile-fit 约定）：
+		* - 窄屏 input/textarea 16px（防 iOS 聚焦缩放）、可点目标 ≥44px；
+		* - 页脚按钮等宽换行、状态文字独占一行。
+		* 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载），不覆盖上游选择器。
+		* @module @dsh-plus/shared/client/styles
+		*/
+		/** 生成全套分节 CSS；prefix 为插件类名前缀（如 'dne'），extra 为插件特有规则。 */
+		function cardCss(prefix, extra = "") {
+			return `
+.${prefix}-section{box-sizing:border-box;flex-direction:column;width:100%;min-width:0;padding:16px 0;display:flex}
+.${prefix}-sectionHead{align-items:center;gap:8px;min-width:0;display:flex}
+.${prefix}-sectionTitle{min-width:0;color:var(--dsw-alias-label-primary);flex:1;margin:0;font-size:13px;font-weight:600;line-height:1.5}
+.${prefix}-sectionBadge{white-space:nowrap;border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.${prefix}-sectionDesc{color:var(--dsw-alias-label-tertiary);margin:4px 0 0;font-size:12px;line-height:1.5}
+.${prefix}-sectionBody{flex-direction:column;min-width:0;display:flex}
+.${prefix}-sectionFooter{align-items:center;gap:8px;padding-top:16px;display:flex;flex-wrap:wrap}
+.${prefix}-pending{white-space:nowrap;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.${prefix}-statusOn{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
+.${prefix}-statusOff{color:var(--dsw-alias-label-tertiary)}
+.${prefix}-field{flex-direction:column;gap:6px;padding:12px 0;display:flex}
+.${prefix}-field+.${prefix}-field{border-top:1px solid var(--dsw-alias-border-l2)}
+.${prefix}-head{align-items:center;gap:8px;display:flex}
+.${prefix}-label{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5}
+.${prefix}-badge{white-space:nowrap;border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.${prefix}-badgeSet{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
+.${prefix}-badgeUnset{color:var(--dsw-alias-label-tertiary)}
+.${prefix}-input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);height:34px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;transition:border-color .18s,background .18s}
+.${prefix}-input:hover:not(:disabled):not(:focus-visible){border-color:var(--dsw-alias-label-dimmed)}
+.${prefix}-input:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
+.${prefix}-input:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
+.${prefix}-inputInvalid{border-color:var(--dsw-alias-label-error)}
+.${prefix}-textarea{box-sizing:border-box;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;height:auto;line-height:1.6;min-height:120px;padding:8px 12px;resize:vertical;white-space:pre;width:100%}
+.${prefix}-select{appearance:none;background:var(--dsw-alias-bg-module-platform);border:none;cursor:pointer;background-image:linear-gradient(45deg,transparent 50%,var(--dsw-alias-label-secondary) 50%),linear-gradient(135deg,var(--dsw-alias-label-secondary) 50%,transparent 50%);background-position:calc(100% - 16px) 50%,calc(100% - 11px) 50%;background-size:5px 5px;background-repeat:no-repeat;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;height:34px;box-sizing:border-box;border-radius:8px;padding:0 30px 0 12px;transition:background-color .18s}
+.${prefix}-select:hover:not(:disabled){background-color:var(--dsw-alias-interactive-bg-hover)}
+.${prefix}-hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}
+.${prefix}-invalid{color:var(--dsw-alias-label-error);margin:0;font-size:12px;line-height:1.5}
+.${prefix}-checkRow{align-items:center;gap:10px;display:flex;padding:6px 0}
+.${prefix}-checkRow label{color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5;cursor:pointer;flex:1;min-width:0}
+/* 自绘圆角扁平开关（官方 UI 无可见原生 checkbox，选择类全走胶囊/菜单） */
+.${prefix}-checkRow input{appearance:none;-webkit-appearance:none;position:relative;box-sizing:border-box;background:var(--dsw-alias-bg-module-platform);border:none;border-radius:999px;width:34px;height:20px;flex:none;cursor:pointer;transition:background .18s;margin:0}
+.${prefix}-checkRow input::after{content:"";position:absolute;top:2px;left:2px;background:var(--dsw-alias-label-primary);border-radius:999px;width:16px;height:16px;transition:left .18s cubic-bezier(.4,0,.2,1)}
+.${prefix}-checkRow input:checked{background:var(--dsw-alias-brand-primary)}
+.${prefix}-checkRow input:checked::after{left:16px;background:var(--dsw-alias-bg-base)}
+.${prefix}-checkRow input:disabled{opacity:.4;cursor:default}
+.${prefix}-checkRow input:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}
+.${prefix}-groupLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:600;padding:12px 0 2px;margin:0}
+/* 分节（Section）：卡片内的二级分组，与一级分节同度量、无边框 */
+.${prefix}-sub{flex-direction:column;padding:12px 0 0;display:flex}
+.${prefix}-subHead{align-items:center;gap:8px;min-width:0;display:flex}
+.${prefix}-subTitle{min-width:0;color:var(--dsw-alias-label-secondary);flex:1;margin:0;font-size:12px;font-weight:600;line-height:1.5}
+.${prefix}-subDesc{color:var(--dsw-alias-label-tertiary);margin:4px 0 0;font-size:12px;line-height:1.5}
+.${prefix}-subBody{flex-direction:column;min-width:0;display:flex}
+.${prefix}-subToggle{appearance:none;background:0 0;border:none;color:var(--dsw-alias-label-tertiary);cursor:pointer;font:inherit;font-size:12px;padding:2px 6px;border-radius:6px}
+.${prefix}-subToggle:hover{color:var(--dsw-alias-label-primary)}
+/* 字段排布（FieldGrid）：窄屏单列，宽屏可两列 */
+.${prefix}-grid{display:grid;grid-template-columns:1fr;min-width:0}
+@media (min-width:768px){
+.${prefix}-grid2{grid-template-columns:1fr 1fr;column-gap:16px}
+}
+/* 只读说明块（Note） */
+.${prefix}-note{background:var(--dsw-alias-bg-module-platform);border-radius:8px;margin:12px 0 0;padding:10px 12px}
+.${prefix}-noteTitle{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px;font-weight:600;line-height:1.5}
+.${prefix}-noteBody{color:var(--dsw-alias-label-tertiary);margin:4px 0 0;font-size:12px;line-height:1.5;white-space:pre-wrap}
+/* 列表编辑器（ListEditor）：条目头 + 折叠 + 行内操作 */
+.${prefix}-list{flex-direction:column;gap:8px;padding:8px 0 0;display:flex}
+.${prefix}-listItem{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:8px 12px}
+.${prefix}-listItemHead{align-items:center;gap:8px;min-width:0;display:flex}
+.${prefix}-listItemTitle{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.${prefix}-listItemBody{flex-direction:column;min-width:0;display:flex;padding-top:4px}
+.${prefix}-listActions{align-items:center;gap:4px;display:flex;flex-wrap:wrap}
+.${prefix}-iconBtn{appearance:none;background:0 0;border:1px solid #0000;border-radius:6px;color:var(--dsw-alias-label-tertiary);cursor:pointer;font:inherit;font-size:12px;line-height:1.5;padding:2px 8px}
+.${prefix}-iconBtn:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-border-l2)}
+.${prefix}-iconBtn:disabled{opacity:.4;cursor:default}
+.${prefix}-listAdd{align-self:flex-start}
+.${prefix}-listAddRow{align-items:center;align-self:flex-start;gap:8px;display:flex;flex-wrap:wrap}
+.${prefix}-listEmpty{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5;padding:4px 0}
+.${prefix}-readOnly{color:var(--dsw-alias-label-tertiary);margin:12px 0 0;font-size:12px;line-height:1.5}
+.${prefix}-warn{color:var(--dsw-alias-label-error);margin:12px 0 0;font-size:12px;line-height:1.5}
+.${prefix}-status{min-width:0;color:var(--dsw-alias-label-secondary);flex:1;margin:0;font-size:12px;line-height:1.5}
+.${prefix}-statusError{color:var(--dsw-alias-label-error)}
+.${prefix}-btn{appearance:none;font:inherit;cursor:pointer;border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5}
+.${prefix}-btnGhost{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}
+.${prefix}-btnGhost:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}
+.${prefix}-btnPrimary{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}
+.${prefix}-btn:disabled{opacity:.4;cursor:default}
+.${prefix}-btn:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}
+@media (max-width:767px){
+.${prefix}-input,.${prefix}-select{font-size:16px;height:40px}
+.${prefix}-checkRow{min-height:44px;padding:8px 0}
+.${prefix}-status{flex-basis:100%;flex:none}
+.${prefix}-btn{min-height:44px;flex:1;min-width:96px}
+}
+@media (pointer:coarse){
+.${prefix}-btn{min-height:44px}
+.${prefix}-checkRow{min-height:44px}
+.${prefix}-input,.${prefix}-select{height:40px}
+}
+${extra}
+`;
+		}
+		/** 源码编辑节的固定类名前缀。 */
+		const CODE_SECTION_PREFIX = "dshc";
+		/**
+		* 源码编辑节（ConfigCodeSection）专用样式：前缀固定 `dshc`，由 shared 自行注入
+		* （插件卡片不必知道它的存在）。基础规则复用 cardCss，只追加 details/摘要与
+		* 代码文本域的度量。
+		*/
+		function codeSectionCss() {
+			return cardCss(CODE_SECTION_PREFIX, `
+.${CODE_SECTION_PREFIX}-details{padding:4px 0 0}
+.${CODE_SECTION_PREFIX}-summary{color:var(--dsw-alias-label-primary);cursor:pointer;font-size:13px;font-weight:600;line-height:1.5;list-style:none;padding:8px 0}
+.${CODE_SECTION_PREFIX}-summary::-webkit-details-marker{display:none}
+.${CODE_SECTION_PREFIX}-summary::before{content:"▸";color:var(--dsw-alias-label-tertiary);display:inline-block;margin-right:6px;transition:transform .18s}
+.${CODE_SECTION_PREFIX}-details[open] .${CODE_SECTION_PREFIX}-summary::before{transform:rotate(90deg)}
+.${CODE_SECTION_PREFIX}-desc{color:var(--dsw-alias-label-tertiary);margin:0 0 8px;font-size:12px;line-height:1.5}
+.${CODE_SECTION_PREFIX}-input{box-sizing:border-box;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;height:auto;line-height:1.6;min-height:240px;padding:10px 12px;resize:vertical;tab-size:2;white-space:pre;width:100%}
+.${CODE_SECTION_PREFIX}-foot{align-items:center;gap:8px;display:flex;flex-wrap:wrap;padding-top:12px}
+.${CODE_SECTION_PREFIX}-foot .${CODE_SECTION_PREFIX}-btn:last-child{margin-left:auto}
+@media (max-width:767px){
+.${CODE_SECTION_PREFIX}-input{font-size:16px}
+}
+`);
+		}
+		/**
+		* 幂等注入样式标签（官方 data-plugin-css 约定）；返回新标签，
+		* 已存在或环境无 document 时返回 null（调用方 effect 卸载用）。
+		*/
+		function injectCardStyle(pluginId, css) {
+			if (typeof document === "undefined") return null;
+			const tagId = `${pluginId}/card.css`;
+			if (document.querySelector(`style[data-plugin-css=${JSON.stringify(tagId)}]`) !== null) return null;
+			const tag = document.createElement("style");
+			tag.dataset.plugin = pluginId;
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+			return tag;
+		}
+		//#endregion
+		//#region ../shared/src/client/code-section.ts
+		/**
+		* 配置源码编辑节（自动追加到每张插件配置卡片页）。
+		*
+		* 形态：无边框分节，与 ConfigShell/Section 的小节度量一致；文档＝宿主 `describe` 回传的
+		* volatile 投影（JSON，两空格缩进），校验＝本地 JSON 语法 + schemastery 模式，
+		* 写回＝官方 `settings.mutate` 路径 ops（密钥字段不进文档，也不会被写坏）。
+		*
+		* 本文件刻意不写 JSX：`@dsh-plus/shared` 的 client 纯逻辑测试用 `node --test`
+		* 直跑 .ts（Node 原生类型擦除不支持 JSX），而 `config-slots.ts` 会被测试导入，
+		* 因此这条导入链上的模块一律用 `createElement`。React 只经默认导入取用
+		* （react 是 CJS，Node ESM 下具名导入不保证可解析）。
+		* @module @dsh-plus/shared/client/code-section
+		*/
+		const { createElement: h$1, useEffect: useEffect$2, useMemo: useMemo$1, useState: useState$3, useSyncExternalStore: useSyncExternalStore$1 } = react.default;
+		const IDLE = {
+			kind: "idle",
+			text: ""
+		};
+		/** 文档播种文本：对象 → 两空格缩进 JSON。 */
+		function seedText(value) {
+			return value === void 0 ? "{}\n" : `${JSON.stringify(value, null, 2)}\n`;
+		}
+		/** 解析/校验失败的原因文案（逐条给出行列或字段路径）。 */
+		function problemLines(text, snapshot, t) {
+			const parsed = parseConfigJson(text);
+			if (!parsed.ok) {
+				if (parsed.reason === "empty") return {
+					problems: [t("codeInvalidEmpty")],
+					validated: false
+				};
+				if (parsed.reason === "root") return {
+					problems: [t("codeInvalidRoot")],
+					validated: false
+				};
+				const line = t("codeLine").replace("{line}", String(parsed.line ?? 0)).replace("{column}", String(parsed.column ?? 0));
+				return {
+					problems: [`${t("codeInvalidJson")}（${line}）${parsed.message}`],
+					validated: false
+				};
+			}
+			const result = validateAgainstSchema(snapshot.schema, parsed.value);
+			if (result.ok) return {
+				problems: [],
+				validated: result.validated
+			};
+			return {
+				problems: result.issues.map((issue) => `${t("codeInvalidSchema")}：${issue.path === "" ? issue.message : `${issue.path} — ${issue.message}`}`),
+				validated: true
+			};
+		}
+		/** 与当前快照的差分（无改动时为空数组）。 */
+		function opsOf(text, snapshot) {
+			const parsed = parseConfigJson(text);
+			return parsed.ok ? diffToOps(snapshot.value, parsed.value) : [];
+		}
+		/** 应用：官方路径 ops 写回，成功后重载快照（revision 变化会重新播种文档）。 */
+		function applyOps(options) {
+			const { api, scope, ops, revision, t, setStatus, setApplying } = options;
+			setApplying(true);
+			api.mutate(ops, revision).then(() => {
+				setStatus({
+					kind: "ok",
+					text: t("codeApplied")
+				});
+				return scope.load();
+			}).catch((error) => {
+				const message = error instanceof Error ? error.message : String(error);
+				setStatus({
+					kind: "error",
+					text: `${t("codeApplyFailed")}${message}`
+				});
+			}).finally(() => setApplying(false));
+		}
+		/** 草稿动作：应用（官方路径 ops 写回）、格式化、编辑与 Tab 缩进。 */
+		function draftHandlers(options) {
+			const { api, scope, t, snapshot, text, ops, setText, setStatus, setApplying } = options;
+			return {
+				onApply: () => {
+					applyOps({
+						api,
+						scope,
+						ops,
+						revision: snapshot.revision,
+						t,
+						setStatus,
+						setApplying
+					});
+				},
+				onFormat: () => {
+					const formatted = formatConfigJson(text);
+					if (formatted.ok) setText(formatted.text);
+				},
+				onChange: (event) => {
+					setText(event.target.value);
+					setStatus(IDLE);
+				},
+				onKeyDown: (event) => {
+					if (event.key !== "Tab") return;
+					event.preventDefault();
+					const target = event.currentTarget;
+					const { selectionStart, selectionEnd, value } = target;
+					setText(`${value.slice(0, selectionStart)}  ${value.slice(selectionEnd)}`);
+					queueMicrotask(() => {
+						target.selectionStart = selectionStart + 2;
+						target.selectionEnd = selectionStart + 2;
+					});
+				}
+			};
+		}
+		/** 校验派生量：逐次编辑重算（problems 供提示与禁用判定，validated 区分「模式外」）。 */
+		function useCodeChecks(text, snapshot, t) {
+			const { problems, validated } = useMemo$1(() => problemLines(text, snapshot, t), [
+				text,
+				snapshot,
+				t
+			]);
+			return {
+				problems,
+				validated,
+				ops: useMemo$1(() => opsOf(text, snapshot), [text, snapshot]),
+				secrets: useMemo$1(() => secretPathsOf(snapshot.schema), [snapshot.schema]),
+				unknown: useMemo$1(() => {
+					const parsed = parseConfigJson(text);
+					return parsed.ok ? unknownKeysOf(snapshot.schema, parsed.value) : [];
+				}, [text, snapshot.schema])
+			};
+		}
+		/** 分节状态：快照订阅、文档文本、校验结果与草稿动作（主组件只做组装）。 */
+		function useCodeSection(props) {
+			const { ns, t, scope, api } = props;
+			const snapshot = useSyncExternalStore$1((listener) => scope.subscribe(listener), () => scope.getSnapshot());
+			const [text, setText] = useState$3(() => seedText(snapshot.value));
+			const [status, setStatus] = useState$3(IDLE);
+			const [applying, setApplying] = useState$3(false);
+			const [open, setOpen] = useState$3(false);
+			const revision = snapshot.revision;
+			const snapshotStatus = snapshot.status;
+			useEffect$2(() => {
+				setText(seedText(snapshot.value));
+				setStatus(IDLE);
+			}, [revision, snapshotStatus]);
+			useEffect$2(() => {
+				injectCardStyle("@dsh-plus/shared", codeSectionCss());
+			}, []);
+			const { problems, validated, ops, secrets, unknown } = useCodeChecks(text, snapshot, t);
+			const ready = snapshot.status === "ready";
+			const disabled = !ready || !snapshot.writable || applying;
+			return {
+				ready,
+				ns,
+				t,
+				scope,
+				snapshot,
+				text,
+				setText,
+				status,
+				setStatus,
+				applying,
+				setApplying,
+				open,
+				setOpen,
+				problems,
+				validated,
+				ops,
+				secrets,
+				unknown,
+				disabled,
+				canApply: !disabled && problems.length === 0 && ops.length > 0,
+				...draftHandlers({
+					api,
+					scope,
+					t,
+					snapshot,
+					text,
+					ops,
+					setText,
+					setStatus,
+					setApplying
+				})
+			};
+		}
+		/** 提示行：无改动 / 未校验 / 密钥计数 / 模式外键 / 不可用或只读。 */
+		function noteLines(state) {
+			const { t, ready, problems, validated, ops, secrets, unknown, snapshot } = state;
+			const notes = [];
+			if (problems.length === 0 && ops.length === 0 && ready) notes.push(h$1("p", {
+				className: "dshc-hint",
+				key: "no-change"
+			}, t("codeNoChanges")));
+			if (problems.length === 0 && !validated) notes.push(h$1("p", {
+				className: "dshc-hint",
+				key: "unvalidated"
+			}, t("codeUnvalidated")));
+			if (secrets.length > 0) notes.push(h$1("p", {
+				className: "dshc-hint",
+				key: "secrets"
+			}, t("codeSecretsNote").replace("{n}", String(secrets.length))));
+			if (unknown.length > 0) notes.push(h$1("p", {
+				className: "dshc-hint",
+				key: "unknown"
+			}, t("codeUnknownKeys").replace("{n}", String(unknown.length)).replace("{keys}", unknown.slice(0, 8).join("、"))));
+			if (snapshot.status === "unavailable") notes.push(h$1("p", {
+				className: "dshc-hint",
+				key: "unavailable"
+			}, t("codeUnavailable")));
+			else if (!snapshot.writable) notes.push(h$1("p", {
+				className: "dshc-hint",
+				key: "readonly"
+			}, t("codeReadOnly")));
+			return notes;
+		}
+		/** 页脚：状态行 + 格式化 / 应用按钮。 */
+		function codeFooter(state) {
+			const { t, status, disabled, canApply, applying, onFormat, onApply } = state;
+			return h$1("div", { className: "dshc-foot" }, status.kind === "idle" ? null : h$1("p", {
+				className: `dshc-status${status.kind === "error" ? " dshc-statusError" : ""}`,
+				role: "status"
+			}, status.text), h$1("button", {
+				type: "button",
+				className: "dshc-btn dshc-btnGhost",
+				disabled,
+				onClick: onFormat
+			}, t("codeFormat")), h$1("button", {
+				type: "button",
+				className: "dshc-btn dshc-btnPrimary",
+				disabled: !canApply,
+				onClick: onApply
+			}, applying ? t("codeApplying") : t("codeApply")));
+		}
+		function ConfigCodeSection(props) {
+			const state = useCodeSection(props);
+			const { ns, t, text, disabled, open, setOpen, status, problems, onChange, onKeyDown } = state;
+			return h$1("section", {
+				className: "dshc-section",
+				"aria-label": `${ns} ${t("codeSectionTitle")}`
+			}, h$1("details", {
+				className: "dshc-details",
+				open: open || status.kind === "error",
+				onToggle: (event) => {
+					setOpen(event.currentTarget.open);
+				}
+			}, h$1("summary", { className: "dshc-summary" }, t("codeSectionTitle")), h$1("p", { className: "dshc-desc" }, t("codeSectionDesc")), h$1("textarea", {
+				className: `dshc-input${problems.length > 0 ? " dshc-inputInvalid" : ""}`,
+				rows: 16,
+				spellCheck: false,
+				"aria-invalid": problems.length > 0 ? true : void 0,
+				value: text,
+				disabled,
+				onChange,
+				onKeyDown
+			}), problems.map((problem) => h$1("p", {
+				className: "dshc-invalid",
+				role: "alert",
+				key: problem
+			}, problem)), ...noteLines(state), codeFooter(state)));
+		}
+		//#endregion
 		//#region ../shared/src/client/config-slots.ts
+		/**
+		* 配置卡片的槽位注册助手（目标宿主：dsh 0.2.1-alpha.2）。
+		*
+		* 官方插件页（`dsh-client-ui-plugin-manager`）为第三方配置视图声明两个 keyed 槽位：
+		* - `plugins.row.config`（key = `<bundle 包名>#<row id>`）：bundle 详情页对应行出现
+		*   「配置」入口，行配置页渲染 `view: 'summary'`（一行简介）与 `view: 'page'`
+		*   （带保存控件的表单）；
+		* - `plugins.bundle.config`（key = 包名）：包详情页本体配置，仅渲染 `view: 'page'`。
+		*
+		* 页面自己画标题、图标、面包屑与页面级内边距（`detailSections` 内无边框容器），
+		* 故 page 视图输出无边框分节（见 card.tsx），summary 视图只返回一行文本。
+		* 旧 `settings.plugin.item` 槽位已随官方插件页迁移删除，不再注册。
+		*
+		* **源码编辑节自动追加**：注册时把插件组件包一层，page 视图在原卡片之后追加
+		* `ConfigCodeSection`（复用同一份 scope/api），summary 视图原样透传。因此「只要
+		* 插件存在可配置项」就有源码编辑入口，插件侧零接线；命名空间没有 volatile 字段时
+		* 它本身不出现在 describe 视图里，该节自然显示为不可用。
+		*
+		* @module @dsh-plus/shared/client/config-slots
+		*/
+		const { createElement: h, Fragment } = react.default;
 		/** dsh-plus 聚合 bundle 的包名（各插件 row 均经其补丁层插入 profile）。 */
 		const DSH_PLUS_BUNDLE = "@dsh-plus/bundle-main";
+		/** page 视图：插件卡片 + 自动追加的源码编辑节（summary 视图原样透传）。 */
+		function withCodeSection(component, ns) {
+			return function AutoConfigView(props) {
+				const card = h(component, props);
+				if (props.view !== "page") return card;
+				return h(Fragment, null, card, h(ConfigCodeSection, {
+					ns,
+					t: props.t,
+					scope: props.scope,
+					api: props.api
+				}));
+			};
+		}
 		/**
 		* 把一张配置卡片注册进插件页的两个配置槽位。
 		* 两个槽位都由 0.2.1-alpha.2 的插件页声明，任一缺席即报错——不做版本探测。
 		*/
 		function injectPluginConfigCard(slots, reg) {
+			const component = withCodeSection(reg.component, reg.ns);
 			const base = {
 				locale: reg.ns,
 				inject: reg.inject
@@ -200,12 +983,112 @@ window.__ModuleLoader__.load({
 				name: "plugins.row.config",
 				key: `${DSH_PLUS_BUNDLE}#${reg.rowId}`,
 				...base
-			}, reg.component));
+			}, component));
 			slots.inject("plugins.bundle.config", () => slots.register({
 				name: "plugins.bundle.config",
 				key: reg.pkg,
 				...base
-			}, reg.component));
+			}, component));
+		}
+		//#endregion
+		//#region ../shared/src/client/credentials.tsx
+		/**
+		* 凭据面（共享件）：官方 settings-controller 的 `remote.credentials` 命名空间
+		* （describe/set/unset/onChange），复用官方 credentials seam，不另开 HTTP 端点。
+		* **值只写不读**——describe 只回「已配置 / 来源 / 可写」，没有任何方法回传值。
+		*
+		* 凭据与 settings 草稿相互独立：不进命名空间、不参与脏判定，保存即落
+		* `$DSH_HOME/.credentials.yaml` 并热生效（宿主每次工具调用重新 resolve），
+		* 因此改口令不需要保存卡片、也不需要 /reload 或重启。
+		* @module @dsh-plus/shared/client/credentials
+		*/
+		/**
+		* 把官方 `remote.credentials` 收成窄面：只补一个把宿主事件包成订阅的方法，
+		* 让状态层不必认识 `$on` 的事件名与载荷形状。
+		*/
+		function credentialsFace(remote) {
+			const { credentials } = remote;
+			return {
+				describe: (refs) => credentials.describe(refs),
+				set: (ref, value) => credentials.set(ref, value),
+				unset: (ref) => credentials.unset(ref),
+				onChange: (listener) => remote.$on("credentials/reference-updated", (ref) => {
+					if (typeof ref === "string") listener(ref);
+				})
+			};
+		}
+		/** 未答（或应答缺项）时的视图：按「未配置、可写」呈现。 */
+		const ABSENT_VIEW = {
+			configured: false,
+			writable: true
+		};
+		/** 取某引用的视图；应答缺项回落为 {@link ABSENT_VIEW}。 */
+		function viewOf(views, ref) {
+			return views[ref] ?? ABSENT_VIEW;
+		}
+		/** 应答信封的错误文案（成功为空串）。 */
+		function failureOf(result) {
+			return result.ok ? "" : result.error.message ?? "";
+		}
+		function messageOf(error) {
+			return error instanceof Error ? error.message : String(error);
+		}
+		/**
+		* 凭据行状态：挂载即 describe 一次，写入后重新 describe；
+		* 外部改动经 `credentials/reference-updated` 触发同一路径刷新。
+		* @param face - 官方 credentials 远程面。
+		* @param refs - 本卡片关心的引用名（以换行拼接作为稳定依赖，避免数组身份抖动）。
+		*/
+		function useCredentials$1(face, refs) {
+			const key = refs.join("\n");
+			const [views, setViews] = (0, react.useState)({});
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)("");
+			const read = (0, react.useCallback)(async () => {
+				const list = key === "" ? [] : key.split("\n");
+				const result = await face.describe(list);
+				if (!result.ok) {
+					setError(failureOf(result));
+					return;
+				}
+				setError("");
+				setViews(result.value);
+			}, [face, key]);
+			(0, react.useEffect)(() => {
+				read();
+			}, [read]);
+			(0, react.useEffect)(() => face.onChange((ref) => {
+				if ((key === "" ? [] : key.split("\n")).includes(ref)) read();
+			}), [
+				face,
+				key,
+				read
+			]);
+			const write = (0, react.useCallback)(async (run) => {
+				setBusy(true);
+				try {
+					const result = await run();
+					if (!result.ok) {
+						setError(failureOf(result));
+						return false;
+					}
+					setError("");
+					await read();
+					return true;
+				} catch (thrown) {
+					setError(messageOf(thrown));
+					return false;
+				} finally {
+					setBusy(false);
+				}
+			}, [read]);
+			return {
+				views,
+				busy,
+				error,
+				save: (0, react.useCallback)((ref, value) => write(() => face.set(ref, value)), [face, write]),
+				clear: (0, react.useCallback)((ref) => write(() => face.unset(ref)), [face, write])
+			};
 		}
 		//#endregion
 		//#region ../shared/src/client/draft.ts
@@ -302,7 +1185,31 @@ window.__ModuleLoader__.load({
 			enabledOff: "未启用",
 			saveFailed: "保存失败，请检查填写内容。",
 			confirm: "确认",
-			cancel: "取消"
+			cancel: "取消",
+			listAdd: "新增",
+			listRemove: "删除",
+			listMoveUp: "上移",
+			listMoveDown: "下移",
+			listDuplicate: "复制",
+			listEmpty: "暂无条目。",
+			codeSectionTitle: "源码编辑（JSON）",
+			codeSectionDesc: "直接编辑本插件的可配置字段（仅 .volatile() 字段）。「应用」按官方路径编辑写回用户层，密钥字段不在此编辑器内。",
+			codeFormat: "格式化",
+			codeApply: "应用",
+			codeApplying: "应用中…",
+			codeApplied: "已应用。",
+			codeNoChanges: "与当前配置一致，无需应用。",
+			codeInvalidJson: "JSON 语法错误",
+			codeInvalidEmpty: "配置不能为空。",
+			codeInvalidRoot: "根节点必须是对象。",
+			codeInvalidSchema: "模式校验未通过",
+			codeUnvalidated: "宿主未回传 schema，已跳过本地校验（写入仍由宿主把关）。",
+			codeSecretsNote: "有 {n} 个密钥字段不在此编辑器内（在凭据区或行级配置中管理）。",
+			codeUnknownKeys: "有 {n} 个键不在 schema 里（{keys}）：会被原样保留并被运行时忽略，建议删除。",
+			codeUnavailable: "该行未激活或命名空间不可用，源码编辑不可用。",
+			codeReadOnly: "当前部署无 settings provider，源码编辑只读。",
+			codeApplyFailed: "应用失败：",
+			codeLine: "第 {line} 行第 {column} 列"
 		};
 		const commonEn = {
 			save: "Save",
@@ -319,7 +1226,31 @@ window.__ModuleLoader__.load({
 			enabledOff: "Off",
 			saveFailed: "Save failed; check the fields.",
 			confirm: "Confirm",
-			cancel: "Cancel"
+			cancel: "Cancel",
+			listAdd: "Add",
+			listRemove: "Remove",
+			listMoveUp: "Move up",
+			listMoveDown: "Move down",
+			listDuplicate: "Duplicate",
+			listEmpty: "No entries yet.",
+			codeSectionTitle: "Source editor (JSON)",
+			codeSectionDesc: "Edit this plugin’s configurable fields directly (only .volatile() fields). Apply writes back through the official path edits; secret fields never appear here.",
+			codeFormat: "Format",
+			codeApply: "Apply",
+			codeApplying: "Applying…",
+			codeApplied: "Applied.",
+			codeNoChanges: "Identical to the current config; nothing to apply.",
+			codeInvalidJson: "JSON syntax error",
+			codeInvalidEmpty: "Config must not be empty.",
+			codeInvalidRoot: "The root node must be an object.",
+			codeInvalidSchema: "Schema validation failed",
+			codeUnvalidated: "The host returned no schema, so local validation was skipped (writes are still validated by the host).",
+			codeSecretsNote: "{n} secret field(s) are not editable here (manage them in the credentials section or at the row level).",
+			codeUnknownKeys: "{n} key(s) are absent from the schema ({keys}): they are preserved verbatim and ignored at runtime; remove them.",
+			codeUnavailable: "This row is inactive or its namespace is unavailable; the source editor is disabled.",
+			codeReadOnly: "No settings provider in this deployment; the source editor is read-only.",
+			codeApplyFailed: "Apply failed: ",
+			codeLine: "line {line}, column {column}"
 		};
 		/**
 		* own 覆盖同键合并（返回新对象，入参不可变）。
@@ -346,6 +1277,8 @@ window.__ModuleLoader__.load({
 			let state = {
 				status: "loading",
 				value: void 0,
+				schema: void 0,
+				secrets: [],
 				revision: void 0,
 				writable: false
 			};
@@ -371,6 +1304,8 @@ window.__ModuleLoader__.load({
 					publish({
 						status: "unavailable",
 						value: void 0,
+						schema: void 0,
+						secrets: [],
 						revision: void 0,
 						writable: view.writable
 					});
@@ -379,6 +1314,8 @@ window.__ModuleLoader__.load({
 				publish({
 					status: "ready",
 					value: namespace.value,
+					schema: namespace.schema,
+					secrets: namespace.secrets,
 					revision: namespace.revision,
 					writable: view.writable
 				});
@@ -412,6 +1349,10 @@ window.__ModuleLoader__.load({
 					const response = await remote.update(ns, patch, expectedRevision);
 					if (!response.ok) throw new Error(response.error.message ?? "settings update failed");
 				},
+				mutate: async (ops, expectedRevision) => {
+					const response = await remote.mutate(ns, ops, expectedRevision);
+					if (!response.ok) throw new Error(response.error.message ?? "settings mutate failed");
+				},
 				describe: async () => {
 					const response = await remote.describe();
 					if (!response.ok) throw new Error(response.error.message ?? "settings describe failed");
@@ -420,101 +1361,6 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
-		//#region ../shared/src/client/styles.ts
-		/**
-		* 配置分节样式工厂（各插件 client 的公共收编版）。
-		*
-		* 目标宿主 dsh 0.2.1-alpha.2：插件页把配置视图放进已有页面级内边距的容器里
-		* （`div.detailSections[data-plugin-config]` 或 `section.detailSection[data-plugin-config]`），
-		* 外层无边框——故这里输出的是**无边框分节**（小节标题 13px/600、字段 12px 0、
-		* 横向零内边距、页脚非 sticky），度量对齐官方设置页
-		* （`@deepseek-ai/dsh-client-ui-primitives` 的 settings-form）。
-		*
-		* 移动端与可达性（767px 断点 + pointer:coarse，对齐 ui-mobile-fit 约定）：
-		* - 窄屏 input/textarea 16px（防 iOS 聚焦缩放）、可点目标 ≥44px；
-		* - 页脚按钮等宽换行、状态文字独占一行。
-		* 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载），不覆盖上游选择器。
-		* @module @dsh-plus/shared/client/styles
-		*/
-		/** 生成全套分节 CSS；prefix 为插件类名前缀（如 'dne'），extra 为插件特有规则。 */
-		function cardCss(prefix, extra = "") {
-			return `
-.${prefix}-section{box-sizing:border-box;flex-direction:column;width:100%;min-width:0;padding:16px 0;display:flex}
-.${prefix}-sectionHead{align-items:center;gap:8px;min-width:0;display:flex}
-.${prefix}-sectionTitle{min-width:0;color:var(--dsw-alias-label-primary);flex:1;margin:0;font-size:13px;font-weight:600;line-height:1.5}
-.${prefix}-sectionBadge{white-space:nowrap;border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
-.${prefix}-sectionDesc{color:var(--dsw-alias-label-tertiary);margin:4px 0 0;font-size:12px;line-height:1.5}
-.${prefix}-sectionBody{flex-direction:column;min-width:0;display:flex}
-.${prefix}-sectionFooter{align-items:center;gap:8px;padding-top:16px;display:flex;flex-wrap:wrap}
-.${prefix}-pending{white-space:nowrap;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
-.${prefix}-statusOn{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
-.${prefix}-statusOff{color:var(--dsw-alias-label-tertiary)}
-.${prefix}-field{flex-direction:column;gap:6px;padding:12px 0;display:flex}
-.${prefix}-field+.${prefix}-field{border-top:1px solid var(--dsw-alias-border-l2)}
-.${prefix}-head{align-items:center;gap:8px;display:flex}
-.${prefix}-label{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5}
-.${prefix}-badge{white-space:nowrap;border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
-.${prefix}-badgeSet{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
-.${prefix}-badgeUnset{color:var(--dsw-alias-label-tertiary)}
-.${prefix}-input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);height:34px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;transition:border-color .18s,background .18s}
-.${prefix}-input:hover:not(:disabled):not(:focus-visible){border-color:var(--dsw-alias-label-dimmed)}
-.${prefix}-input:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
-.${prefix}-input:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
-.${prefix}-inputInvalid{border-color:var(--dsw-alias-label-error)}
-.${prefix}-select{appearance:none;background:var(--dsw-alias-bg-module-platform);border:none;cursor:pointer;background-image:linear-gradient(45deg,transparent 50%,var(--dsw-alias-label-secondary) 50%),linear-gradient(135deg,var(--dsw-alias-label-secondary) 50%,transparent 50%);background-position:calc(100% - 16px) 50%,calc(100% - 11px) 50%;background-size:5px 5px;background-repeat:no-repeat;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;height:34px;box-sizing:border-box;border-radius:8px;padding:0 30px 0 12px;transition:background-color .18s}
-.${prefix}-select:hover:not(:disabled){background-color:var(--dsw-alias-interactive-bg-hover)}
-.${prefix}-hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}
-.${prefix}-invalid{color:var(--dsw-alias-label-error);margin:0;font-size:12px;line-height:1.5}
-.${prefix}-checkRow{align-items:center;gap:10px;display:flex;padding:6px 0}
-.${prefix}-checkRow label{color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5;cursor:pointer;flex:1;min-width:0}
-/* 自绘圆角扁平开关（官方 UI 无可见原生 checkbox，选择类全走胶囊/菜单） */
-.${prefix}-checkRow input{appearance:none;-webkit-appearance:none;position:relative;box-sizing:border-box;background:var(--dsw-alias-bg-module-platform);border:none;border-radius:999px;width:34px;height:20px;flex:none;cursor:pointer;transition:background .18s;margin:0}
-.${prefix}-checkRow input::after{content:"";position:absolute;top:2px;left:2px;background:var(--dsw-alias-label-primary);border-radius:999px;width:16px;height:16px;transition:left .18s cubic-bezier(.4,0,.2,1)}
-.${prefix}-checkRow input:checked{background:var(--dsw-alias-brand-primary)}
-.${prefix}-checkRow input:checked::after{left:16px;background:var(--dsw-alias-bg-base)}
-.${prefix}-checkRow input:disabled{opacity:.4;cursor:default}
-.${prefix}-checkRow input:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}
-.${prefix}-groupLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:600;padding:12px 0 2px;margin:0}
-.${prefix}-readOnly{color:var(--dsw-alias-label-tertiary);margin:12px 0 0;font-size:12px;line-height:1.5}
-.${prefix}-warn{color:var(--dsw-alias-label-error);margin:12px 0 0;font-size:12px;line-height:1.5}
-.${prefix}-status{min-width:0;color:var(--dsw-alias-label-secondary);flex:1;margin:0;font-size:12px;line-height:1.5}
-.${prefix}-statusError{color:var(--dsw-alias-label-error)}
-.${prefix}-btn{appearance:none;font:inherit;cursor:pointer;border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5}
-.${prefix}-btnGhost{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}
-.${prefix}-btnGhost:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}
-.${prefix}-btnPrimary{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}
-.${prefix}-btn:disabled{opacity:.4;cursor:default}
-.${prefix}-btn:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}
-@media (max-width:767px){
-.${prefix}-input,.${prefix}-select{font-size:16px;height:40px}
-.${prefix}-checkRow{min-height:44px;padding:8px 0}
-.${prefix}-status{flex-basis:100%;flex:none}
-.${prefix}-btn{min-height:44px;flex:1;min-width:96px}
-}
-@media (pointer:coarse){
-.${prefix}-btn{min-height:44px}
-.${prefix}-checkRow{min-height:44px}
-.${prefix}-input,.${prefix}-select{height:40px}
-}
-${extra}
-`;
-		}
-		/**
-		* 幂等注入样式标签（官方 data-plugin-css 约定）；返回新标签，
-		* 已存在或环境无 document 时返回 null（调用方 effect 卸载用）。
-		*/
-		function injectCardStyle(pluginId, css) {
-			if (typeof document === "undefined") return null;
-			const tagId = `${pluginId}/card.css`;
-			if (document.querySelector(`style[data-plugin-css=${JSON.stringify(tagId)}]`) !== null) return null;
-			const tag = document.createElement("style");
-			tag.dataset.plugin = pluginId;
-			tag.dataset.pluginCss = tagId;
-			tag.textContent = css;
-			document.head.appendChild(tag);
-			return tag;
-		}
-		//#endregion
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖）。
@@ -539,7 +1385,6 @@ ${extra}
 		/** 命名空间解析值 → 草稿。 */
 		function draftFromValue(value) {
 			return {
-				enabled: value.enabled,
 				serverUrl: value.serverUrl,
 				syncId: value.syncId,
 				cliCommand: argvToText(value.cliCommand),
@@ -552,7 +1397,6 @@ ${extra}
 		/** 草稿 → 命名空间补丁（仅本卡片负责的字段）。 */
 		function patchFromDraft(draft) {
 			return {
-				enabled: draft.enabled,
 				serverUrl: draft.serverUrl.trim(),
 				syncId: draft.syncId.trim(),
 				cliCommand: textToArgv(draft.cliCommand),
@@ -606,78 +1450,18 @@ ${extra}
 		];
 		//#endregion
 		//#region src/client/secrets.ts
-		/** 未答（或应答缺项）时的视图：按「未配置、可写」呈现。 */
-		const ABSENT_VIEW = {
-			configured: false,
-			writable: true
-		};
-		/** 取某引用的视图；应答缺项回落为 {@link ABSENT_VIEW}。 */
-		function viewOf(views, ref) {
-			return views[ref] ?? ABSENT_VIEW;
-		}
-		/** 应答信封的错误文案（成功为空串）。 */
-		function failureOf(result) {
-			return result.ok ? "" : result.error.message ?? "";
-		}
-		/** 提取异常文本。 */
-		function messageOf(error) {
-			return error instanceof Error ? error.message : String(error);
-		}
-		/**
-		* 订阅宿主凭据变更：只认本插件关心的引用，其余（别的插件写自己的密钥）
-		* 不触发重读。
-		*/
-		function useCredentialChanges(face, read) {
-			(0, react.useEffect)(() => face.onChange((ref) => {
-				if (CREDENTIAL_REFS.includes(ref)) read();
-			}), [face, read]);
-		}
 		/**
-		* 凭据行状态：挂载即 describe 一次，写入后重新 describe；
-		* 外部改动经 `credentials/reference-updated` 触发同一路径刷新。
+		* 浏览器半的凭据面：复用 `@dsh-plus/shared/client` 的凭据 hook（describe/set/unset，
+		* 支持多引用），此处只绑定本插件关心的引用清单。
+		*
+		* **值只写不读**——describe 只回「已配置 / 来源 / 可写」，没有任何方法回传值。
+		* 凭据与 settings 草稿相互独立：它不进命名空间、不参与脏判定，保存即落
+		* `$DSH_HOME/.credentials.yaml` 并热生效（宿主每次工具调用重新 resolve）。
+		* @module @dsh-plus/actual/client/secrets
 		*/
+		/** 本插件的凭据行状态（引用清单固定为 {@link CREDENTIAL_REFS}）。 */
 		function useCredentials(face) {
-			const [views, setViews] = (0, react.useState)({});
-			const [busy, setBusy] = (0, react.useState)(false);
-			const [error, setError] = (0, react.useState)("");
-			const read = (0, react.useCallback)(async () => {
-				const result = await face.describe([...CREDENTIAL_REFS]);
-				if (!result.ok) {
-					setError(failureOf(result));
-					return;
-				}
-				setError("");
-				setViews(result.value);
-			}, [face]);
-			(0, react.useEffect)(() => {
-				read();
-			}, [read]);
-			useCredentialChanges(face, read);
-			const write = (0, react.useCallback)(async (run) => {
-				setBusy(true);
-				try {
-					const result = await run();
-					if (!result.ok) {
-						setError(failureOf(result));
-						return false;
-					}
-					setError("");
-					await read();
-					return true;
-				} catch (thrown) {
-					setError(messageOf(thrown));
-					return false;
-				} finally {
-					setBusy(false);
-				}
-			}, [read]);
-			return {
-				views,
-				busy,
-				error,
-				save: (0, react.useCallback)((ref, value) => write(() => face.set(ref, value)), [face, write]),
-				clear: (0, react.useCallback)((ref) => write(() => face.unset(ref)), [face, write])
-			};
+			return useCredentials$1(face, CREDENTIAL_REFS);
 		}
 		//#endregion
 		//#region src/client/secrets-section.tsx
@@ -826,19 +1610,6 @@ ${extra}
 				invalidLabel: label
 			} : { invalid: false };
 		}
-		/** 说明段落（无编辑器的字段在此交代落点）。 */
-		function Note(props) {
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "act-note",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-					className: "act-noteTitle",
-					children: props.title
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-					className: "act-noteBody",
-					children: props.body
-				})]
-			});
-		}
 		/** 连接小节：服务器地址、预算、CLI 命令与版本策略。 */
 		function ConnectionSection(props) {
 			const { t, draft, disabled, violation, onEdit } = props;
@@ -903,7 +1674,7 @@ ${extra}
 					onEdit: (value) => onEdit({ confirmWrites: value })
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-					className: "act-noteBody",
+					className: "act-hint",
 					children: t("confirmWritesHint")
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
@@ -915,7 +1686,7 @@ ${extra}
 					onEdit: (value) => onEdit({ auxTools: value })
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-					className: "act-noteBody",
+					className: "act-hint",
 					children: t("auxToolsHint")
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
@@ -952,14 +1723,10 @@ ${extra}
 				violation,
 				onEdit: edit
 			};
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CardChrome, {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ConfigShell, {
 				prefix: "act",
 				title: t("title"),
 				description: t("description"),
-				statusBadge: {
-					text: t(draft.enabled ? "enabledOn" : "enabledOff"),
-					on: draft.enabled
-				},
 				dirty,
 				dirtyLabel: t("unsaved"),
 				readOnlyNotice: disabled ? t("readOnly") : void 0,
@@ -977,18 +1744,6 @@ ${extra}
 					onClick: save
 				}],
 				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
-						prefix: "act",
-						id: "act-enabled",
-						label: t("enabled"),
-						checked: draft.enabled,
-						disabled,
-						onEdit: (value) => edit({ enabled: value })
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-						className: "act-noteBody",
-						children: t("enabledHint")
-					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConnectionSection, { ...section }),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SecretsSection, {
 						t,
@@ -996,6 +1751,7 @@ ${extra}
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(PolicySection, { ...section }),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Note, {
+						prefix: "act",
 						title: t("advancedTitle"),
 						body: t("advancedBody")
 					})
@@ -1017,8 +1773,6 @@ ${extra}
 			title: "Actual Budget 连接",
 			description: "配置本机 Actual 同步服务器与 CLI 行为。改动热生效，无需重载：连接相关字段会触发能力重新发现。",
 			summaryLine: "Actual 服务器地址、预算 Sync ID、CLI 与工具策略。",
-			enabled: "启用 actual 预设",
-			enabledHint: "关闭即不注册该预设（等价插件未安装）；已开的会话保持原组合，新会话起不再出现。",
 			serverUrl: "同步服务器地址",
 			serverUrlHint: "自托管默认 http://127.0.0.1:5006。服务端版本从 <地址>/info 读取，用于版本一致性告警。",
 			serverUrlInvalid: "必须是 http(s):// 开头的完整地址",
@@ -1058,8 +1812,6 @@ ${extra}
 			title: "Actual Budget connection",
 			description: "Configure the local Actual sync server and CLI behaviour. Changes apply hot — connection fields trigger a fresh capability discovery.",
 			summaryLine: "Actual server address, budget sync ID, CLI and tool policy.",
-			enabled: "Enable the actual preset",
-			enabledHint: "Off stops registering the preset (equivalent to not installed). Live sessions keep their composition; new ones will not see it.",
 			serverUrl: "Sync server URL",
 			serverUrlHint: "Self-hosted default is http://127.0.0.1:5006. The server version is read from <url>/info for the version-mismatch warning.",
 			serverUrlInvalid: "Must be a full http(s):// URL",
@@ -1132,22 +1884,6 @@ ${extra}
 			"remote.settings",
 			"remote.credentials"
 		];
-		/**
-		* 把官方 `remote.credentials` 收成窄面：只补一个把宿主事件包成订阅的方法，
-		* 让状态层不必认识 `$on` 的事件名与载荷形状。
-		*/
-		function credentialsFace(c) {
-			const remote = c.get("remote");
-			const { credentials } = remote;
-			return {
-				describe: (refs) => credentials.describe(refs),
-				set: (ref, value) => credentials.set(ref, value),
-				unset: (ref) => credentials.unset(ref),
-				onChange: (listener) => remote.$on("credentials/reference-updated", (ref) => {
-					if (typeof ref === "string") listener(ref);
-				})
-			};
-		}
 		function apply(ctx) {
 			const c = ctx;
 			const tag = injectStyle();
@@ -1160,7 +1896,7 @@ ${extra}
 			}), "actual: locale");
 			const scope = createSettingsScope(c, SETTINGS_NS, "actual: settings scope");
 			const api = createNamespaceApi(c.get("remote").settings, SETTINGS_NS);
-			const credentials = credentialsFace(c);
+			const credentials = credentialsFace(c.get("remote"));
 			injectPluginConfigCard(c.slots, {
 				ns: SETTINGS_NS,
 				rowId: "dsh-plus-actual",