@dsh-plus/web-search-services 0.1.19 → 0.2.0

package/lib/client.js

@@ -54,6 +54,62 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
+		/**
+		* 勾选行：自绘圆角扁平开关（switch），对齐官方 WebUI 无原生 checkbox 的
+		* 设计语言（官方选择类控件全走胶囊/菜单，见 cardCss 的 -switch 规则）。
+		* 语义保持 checkbox（无障碍树与表单语义不变），视觉自绘。
+		*/
+		function CheckRow(props) {
+			const p = props.prefix ?? "dshp";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${p}-checkRow`,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+					id: props.id,
+					type: "checkbox",
+					role: "switch",
+					"aria-checked": props.checked,
+					checked: props.checked,
+					disabled: props.disabled === true,
+					onChange: (event) => props.onEdit(event.target.checked)
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+					htmlFor: props.id,
+					children: props.label
+				})]
+			});
+		}
+		function SelectField(props) {
+			const p = props.prefix ?? "dshp";
+			const invalid = props.invalid === true;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${p}-field`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: `${p}-head`,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+							className: `${p}-label`,
+							htmlFor: props.id,
+							children: props.label
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+						id: props.id,
+						className: `${p}-select${invalid ? ` ${p}-inputInvalid` : ""}`,
+						"aria-invalid": invalid || void 0,
+						value: props.value,
+						disabled: props.disabled === true,
+						onChange: (event) => props.onEdit(event.target.value),
+						children: props.options.map((option) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+							value: option.value,
+							children: option.label
+						}, option.value))
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: invalid ? `${p}-invalid` : `${p}-hint`,
+						children: invalid ? props.invalidLabel ?? "" : props.hint ?? ""
+					})
+				]
+			});
+		}
 		//#endregion
 		//#region ../shared/src/client/card.tsx
 		const IDLE_STATUS = {
@@ -152,6 +208,198 @@ window.__ModuleLoader__.load({
 			}, reg.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(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])
+			};
+		}
+		/** 单行密钥：输入框 + 保存/清除，保存成功后清空输入（值不驻留 DOM）。 */
+		function SecretRow(props) {
+			const { prefix, row, view, busy, labels } = props;
+			const [text, setText] = (0, react.useState)("");
+			const locked = busy || !view.writable;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${prefix}-field`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+						prefix,
+						id: `${prefix}-secret-${row.ref}`,
+						label: row.label,
+						...row.hint === void 0 ? {} : { hint: row.hint },
+						password: true,
+						value: text,
+						disabled: locked,
+						badge: {
+							text: view.configured ? labels.configured : labels.missing,
+							set: view.configured
+						},
+						onEdit: setText
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: `${prefix}-sectionFooter`,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
+							prefix,
+							variant: "primary",
+							label: labels.save,
+							disabled: locked || text === "",
+							onClick: () => {
+								props.onSave(row.ref, text).then((ok) => {
+									if (ok) setText("");
+								});
+							}
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
+							prefix,
+							variant: "ghost",
+							label: labels.clear,
+							disabled: locked || !view.configured,
+							onClick: () => {
+								props.onClear(row.ref);
+							}
+						})]
+					}),
+					view.writable ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: `${prefix}-warn`,
+						children: labels.shadowed
+					})
+				]
+			});
+		}
+		/**
+		* 凭据小节：一行一个引用，值经官方 credentials 接口写入，不回显。
+		* 引用被进程环境遮蔽（`writable:false`）时禁用编辑并说明原因。
+		*/
+		function CredentialsSection(props) {
+			const { prefix, rows, face, labels } = props;
+			const { views, busy, error, save, clear } = useCredentials(face, rows.map((row) => row.ref));
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${prefix}-section`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: `${prefix}-sectionHead`,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+							className: `${prefix}-sectionTitle`,
+							children: props.title
+						})
+					}),
+					props.description === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: `${prefix}-sectionDesc`,
+						children: props.description
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: `${prefix}-sectionBody`,
+						children: rows.map((row) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SecretRow, {
+							prefix,
+							row,
+							labels,
+							face,
+							view: viewOf(views, row.ref),
+							busy,
+							onSave: save,
+							onClear: clear
+						}, row.ref))
+					}),
+					error === "" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+						className: `${prefix}-warn`,
+						children: [labels.failed, error]
+					})
+				]
+			});
+		}
+		//#endregion
 		//#region ../shared/src/client/draft.ts
 		/**
 		* 单命名空间 staged 草稿（简单配置卡片共用）：读 scope 快照、播种草稿、
@@ -468,83 +716,766 @@ ${extra}
 		*/
 		const SETTINGS_NS = "dsh-plus-web-search-services";
 		//#endregion
-		//#region src/client/draft.ts
-		/** 可选后端（与 config.ts 的 PRIORITY_ENTRY union 同源顺序）。 */
-		const SEARCH_BACKENDS = [
-			"tavily",
-			"exa",
-			"openai-chat"
-		];
-		/** 单次搜索子进程超时下限（与 config.ts 的 .min(1000) 一致）。 */
-		const TIMEOUT_MIN_MS = 1e3;
-		function draftFromValue(value) {
-			return {
-				scriptPath: value.scriptPath,
-				envFile: value.envFile,
-				python: value.python,
-				priorityText: value.priority.join("\n"),
-				timeoutMsText: String(value.timeoutMs)
-			};
+		//#region ../web-providers-core/src/card-ui.tsx
+		/**
+		* 条目链编辑器（搜索/抓取两个插件共用）：字段、默认值与校验全部由 spec/kit 决定，
+		* 本组件只认「条目列表 + 字段描述符」，不认业务，因此新增后端字段时这里不用改。
+		*
+		* 控件形态来自 `./spec.ts`；校验提示是代号（`IssueCode`），文案由插件经 `labels.issue`
+		* 翻译；样式类名前缀由插件经 `prefix` 传入（各插件自己的 CSS 命名空间）。
+		* @module @dsh-plus/web-providers-core/card-ui
+		*/
+		/** 取出某条目下标的问题（键去掉前缀）。 */
+		function issuesFor(issues, index) {
+			const prefix = `${index}.`;
+			return Object.fromEntries(Object.entries(issues).filter(([key]) => key.startsWith(prefix)).map(([key, code]) => [key.slice(prefix.length), code]));
 		}
-		/** 优先级文本 → 后端序列；顺带返回无法识别的行（供 UI 提示）。 */
-		function parsePriority(text) {
-			const backends = [];
-			const unknown = [];
-			const duplicated = [];
-			for (const raw of text.split("\n")) {
-				const line = raw.trim();
-				if (line === "") continue;
-				const match = SEARCH_BACKENDS.find((backend) => backend === line);
-				if (match === void 0) {
-					unknown.push(line);
-					continue;
-				}
-				if (backends.includes(match)) {
-					duplicated.push(line);
-					continue;
+		/** 单个条目字段：按 spec 的 kind 分发控件。 */
+		function EntryField(props) {
+			const { prefix, labels, idPrefix, field, value, issue, disabled } = props;
+			const invalid = issue !== void 0;
+			const invalidLabel = issue === void 0 ? void 0 : labels.issue(issue);
+			const id = `${idPrefix}-${field.key}`;
+			const label = field.key;
+			if (field.kind === "boolean") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
+				prefix,
+				id,
+				label,
+				checked: value === true,
+				disabled,
+				onEdit: (checked) => props.onEdit(checked)
+			});
+			const text = typeof value === "string" ? value : "";
+			if (field.kind === "select") {
+				const options = (field.options ?? []).map((option) => ({
+					value: option,
+					label: option === "" ? labels.unsetOption : option
+				}));
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SelectField, {
+					prefix,
+					id,
+					label,
+					value: text,
+					options,
+					disabled,
+					invalid,
+					...invalidLabel === void 0 ? {} : { invalidLabel },
+					onEdit: (next) => props.onEdit(next)
+				});
+			}
+			if (field.kind === "libraries" || field.kind === "headers") return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${prefix}-field`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: `${prefix}-head`,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+							className: `${prefix}-label`,
+							htmlFor: id,
+							children: label
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
+						id,
+						className: `${prefix}-json${invalid ? ` ${prefix}-inputInvalid` : ""}`,
+						rows: field.kind === "libraries" ? 4 : 3,
+						value: text,
+						disabled,
+						onChange: (event) => props.onEdit(event.target.value)
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: invalid ? `${prefix}-invalid` : `${prefix}-hint`,
+						children: invalid ? invalidLabel ?? "" : field.kind === "libraries" ? labels.librariesHint : labels.headersHint
+					})
+				]
+			});
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+				prefix,
+				id,
+				label,
+				...field.kind === "csv" ? { hint: labels.csvHint } : {},
+				value: text,
+				numeric: field.kind === "number",
+				disabled,
+				invalid,
+				...invalidLabel === void 0 ? {} : { invalidLabel },
+				onEdit: (next) => props.onEdit(next)
+			});
+		}
+		/** 单个条目：头部（序号/类型/条目名/链内开关/顺序与删除）+ 字段区。 */
+		function EntryBlock(props) {
+			const { prefix, labels, index, entry, issues, total, disabled } = props;
+			const spec = props.kit.specOf(entry.type);
+			const idIssue = issues.id;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${prefix}-entry`,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: `${prefix}-entryHead`,
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: `${prefix}-entryIndex`,
+							children: index + 1
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: `${prefix}-badge ${prefix}-badgeSet`,
+							children: entry.type
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: `${prefix}-entryActions`,
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
+									prefix,
+									variant: "ghost",
+									label: labels.moveUp,
+									disabled: disabled || index === 0,
+									onClick: () => props.onMove(-1)
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
+									prefix,
+									variant: "ghost",
+									label: labels.moveDown,
+									disabled: disabled || index === total - 1,
+									onClick: () => props.onMove(1)
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
+									prefix,
+									variant: "ghost",
+									label: labels.remove,
+									disabled,
+									onClick: props.onRemove
+								})
+							]
+						})
+					]
+				}), spec === void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: `${prefix}-invalid`,
+					children: labels.unknownType
+				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+						prefix,
+						id: `${prefix}-entry-${index}-id`,
+						label: labels.entryId,
+						hint: labels.entryIdHint,
+						value: entry.id,
+						disabled,
+						invalid: idIssue !== void 0,
+						...idIssue === void 0 ? {} : { invalidLabel: labels.issue(idIssue) },
+						onEdit: (next) => props.onEdit({ id: next })
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
+						prefix,
+						id: `${prefix}-entry-${index}-enabled`,
+						label: labels.entryEnabled,
+						checked: entry.enabled,
+						disabled,
+						onEdit: (checked) => props.onEdit({ enabled: checked })
+					}),
+					spec.fields.map((field) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EntryField, {
+						prefix,
+						labels,
+						idPrefix: `${prefix}-entry-${index}`,
+						field,
+						value: entry.fields[field.key] ?? "",
+						issue: issues[field.key],
+						disabled,
+						onEdit: (value) => props.onField(field.key, value)
+					}, field.key))
+				] })]
+			});
+		}
+		/** 后端链编辑器：条目块列表 + 新增条目。 */
+		function EntryEditor(props) {
+			const { prefix, kit, labels, draft, disabled, onChange } = props;
+			const issues = kit.issuesOf(draft);
+			const [addType, setAddType] = (0, react.useState)(kit.entryTypes[0] ?? "");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${prefix}-section`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: `${prefix}-sectionHead`,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+							className: `${prefix}-sectionTitle`,
+							children: labels.title
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: `${prefix}-sectionDesc`,
+						children: labels.description
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: `${prefix}-sectionBody`,
+						children: [draft.entries.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: `${prefix}-warn`,
+							children: labels.empty
+						}) : null, draft.entries.map((entry, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EntryBlock, {
+							prefix,
+							kit,
+							labels,
+							index,
+							entry,
+							total: draft.entries.length,
+							issues: issuesFor(issues, index),
+							disabled,
+							onEdit: (patch) => {
+								const entries = draft.entries.map((item, position) => position === index ? {
+									...item,
+									...patch
+								} : item);
+								onChange({
+									...draft,
+									entries
+								});
+							},
+							onField: (key, value) => {
+								const entries = draft.entries.map((item, position) => position === index ? {
+									...item,
+									fields: {
+										...item.fields,
+										[key]: value
+									}
+								} : item);
+								onChange({
+									...draft,
+									entries
+								});
+							},
+							onMove: (delta) => onChange(kit.moveEntry(draft, index, delta)),
+							onRemove: () => onChange(kit.removeEntry(draft, index))
+						}, entry.key))]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: `${prefix}-sectionFooter`,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+							id: `${prefix}-add-type`,
+							className: `${prefix}-select`,
+							value: addType,
+							disabled,
+							onChange: (event) => setAddType(event.target.value),
+							children: kit.entryTypes.map((type) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: type,
+								children: type
+							}, type))
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
+							prefix,
+							label: labels.addEntry,
+							disabled: disabled || addType === "",
+							onClick: () => onChange(kit.addEntry(draft, addType))
+						})]
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region ../web-providers-core/src/card.ts
+		/** 解析值 → 草稿文本：csv 走逗号拼接，JSON 类字段走格式化 JSON（畸形值原样露出）。 */
+		function asText(value, field) {
+			if (field.kind === "csv") return Array.isArray(value) ? value.join(", ") : String(value ?? "");
+			if (field.kind === "libraries" || field.kind === "headers") return JSON.stringify(value ?? (field.kind === "libraries" ? [] : {}), null, 2);
+			return String(value ?? "");
+		}
+		function numberIssue(value, field) {
+			if (!/^-?\d+$/.test(value.trim())) return "int";
+			const parsed = Number(value);
+			if (parsed < (field.min ?? 0)) return "below-min";
+			if (field.max !== void 0 && parsed > field.max) return "above-max";
+		}
+		function jsonIssue(value, kind) {
+			let parsed;
+			try {
+				parsed = JSON.parse(value === "" ? kind === "libraries" ? "[]" : "{}" : value);
+			} catch {
+				return "json";
+			}
+			if (kind === "libraries") {
+				if (!Array.isArray(parsed)) return "json-array";
+				for (const item of parsed) {
+					const name = item?.name;
+					if (typeof item !== "object" || item === null || typeof name !== "string") return "library-shape";
 				}
-				backends.push(match);
+				return;
 			}
-			return {
-				backends,
-				unknown,
-				duplicated
-			};
+			if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return "json-object";
+			return Object.values(parsed).every((item) => typeof item === "string") ? void 0 : "json-strings";
 		}
-		/** 优先级是否可用：至少一个后端、无未知项、无重复项。 */
-		function priorityTextOk(text) {
-			const { backends, unknown, duplicated } = parsePriority(text);
-			return backends.length > 0 && unknown.length === 0 && duplicated.length === 0;
+		function fieldIssue(field, value) {
+			if (field.kind === "boolean") return void 0;
+			if (typeof value !== "string") return "json";
+			if (field.required === true && value.trim() === "") return "required";
+			switch (field.kind) {
+				case "number": return numberIssue(value, field);
+				case "select":
+					if (field.options === void 0) return void 0;
+					return field.options.includes(value) ? void 0 : "option";
+				case "libraries":
+				case "headers": return jsonIssue(value, field.kind);
+				default: return;
+			}
 		}
-		/** 超时是否可用：≥1000 的整数（对齐 schema 的 .natural().min(1000)）。 */
-		function timeoutTextOk(text) {
-			if (!/^\d+$/.test(text.trim())) return false;
-			return Number(text) >= TIMEOUT_MIN_MS;
+		function fieldValue(field, value) {
+			if (field.kind === "boolean") return value === true;
+			const text = typeof value === "string" ? value : "";
+			switch (field.kind) {
+				case "number": return Number(text);
+				case "csv": return text.split(",").map((item) => item.trim()).filter((item) => item !== "");
+				case "libraries": return JSON.parse(text === "" ? "[]" : text);
+				case "headers": return JSON.parse(text === "" ? "{}" : text);
+				default: return text;
+			}
 		}
-		/** 草稿 → 提交形状（调用方保证已通过校验）。 */
-		function toPatch(draft) {
+		/** 用一份条目描述符建卡片工具箱。 */
+		function createCardKit(specs) {
+			const specOf = (type) => specs.find((spec) => spec.type === type);
+			let nextKey = 0;
+			const newKey = () => {
+				nextKey += 1;
+				return `entry-${nextKey}`;
+			};
+			const entryFromDefaults = (type, id, spec) => {
+				const fields = {};
+				for (const field of spec.fields) {
+					const raw = spec.defaults[field.key];
+					fields[field.key] = field.kind === "boolean" ? raw === true : asText(raw, field);
+				}
+				return {
+					key: newKey(),
+					type,
+					id,
+					enabled: true,
+					fields
+				};
+			};
+			const entryIssues = (entry) => {
+				const issues = {};
+				if (entry.id.trim() === "") issues.id = "id-empty";
+				const spec = specOf(entry.type);
+				if (spec === void 0) {
+					issues.type = "type-unknown";
+					return issues;
+				}
+				for (const field of spec.fields) {
+					const issue = fieldIssue(field, entry.fields[field.key] ?? "");
+					if (issue !== void 0) issues[field.key] = issue;
+				}
+				return issues;
+			};
+			const issuesOf = (draft) => {
+				const issues = {};
+				const seen = /* @__PURE__ */ new Set();
+				draft.entries.forEach((entry, index) => {
+					for (const [key, code] of Object.entries(entryIssues(entry))) issues[`${index}.${key}`] = code;
+					if (seen.has(entry.id)) issues[`${index}.id`] = "id-duplicate";
+					seen.add(entry.id);
+				});
+				return issues;
+			};
 			return {
-				scriptPath: draft.scriptPath,
-				envFile: draft.envFile,
-				python: draft.python,
-				priority: parsePriority(draft.priorityText).backends,
-				timeoutMs: Number(draft.timeoutMsText)
+				entryTypes: specs.map((spec) => spec.type),
+				specOf,
+				defaultsSeed: (type) => {
+					const spec = specOf(type);
+					return spec === void 0 ? void 0 : entryFromDefaults(type, type, spec);
+				},
+				draftFromValue: (value) => ({
+					enabled: value.enabled,
+					exposeEntries: value.exposeEntries,
+					proxy: value.proxy,
+					entries: value.entries.map((entry) => {
+						const type = String(entry.type ?? "");
+						const fields = {};
+						for (const field of specOf(type)?.fields ?? []) {
+							const raw = entry[field.key];
+							fields[field.key] = field.kind === "boolean" ? raw === true : asText(raw, field);
+						}
+						return {
+							key: newKey(),
+							type,
+							id: String(entry.id ?? ""),
+							enabled: entry.enabled !== false,
+							fields
+						};
+					})
+				}),
+				addEntry: (draft, type) => {
+					const seed = specOf(type);
+					return seed === void 0 ? draft : {
+						...draft,
+						entries: [...draft.entries, entryFromDefaults(type, type, seed)]
+					};
+				},
+				removeEntry: (draft, index) => ({
+					...draft,
+					entries: draft.entries.filter((_, position) => position !== index)
+				}),
+				moveEntry: (draft, index, delta) => {
+					const target = index + delta;
+					const moved = draft.entries[index];
+					const displaced = draft.entries[target];
+					if (moved === void 0 || displaced === void 0) return draft;
+					const entries = [...draft.entries];
+					entries[index] = displaced;
+					entries[target] = moved;
+					return {
+						...draft,
+						entries
+					};
+				},
+				entryIssues,
+				issuesOf,
+				draftValid: (draft) => Object.keys(issuesOf(draft)).length === 0,
+				toPatch: (draft) => ({
+					enabled: draft.enabled,
+					exposeEntries: draft.exposeEntries,
+					proxy: draft.proxy,
+					entries: draft.entries.map((entry) => {
+						const out = {
+							type: entry.type,
+							id: entry.id.trim(),
+							enabled: entry.enabled
+						};
+						for (const field of specOf(entry.type)?.fields ?? []) out[field.key] = fieldValue(field, entry.fields[field.key] ?? "");
+						return out;
+					})
+				}),
+				refsOf: (draft) => {
+					const refs = [];
+					for (const entry of draft.entries) for (const field of specOf(entry.type)?.fields ?? []) {
+						if (field.refs !== true) continue;
+						const value = entry.fields[field.key];
+						if (typeof value !== "string") continue;
+						for (const ref of value.split(",")) {
+							const name = ref.trim();
+							if (name !== "" && !refs.includes(name)) refs.push(name);
+						}
+					}
+					return refs;
+				}
 			};
 		}
 		//#endregion
+		//#region src/client/draft.ts
+		/**
+		* 搜索插件的卡片逻辑绑定：字段清单/默认值/校验全部来自
+		* `@dsh-plus/web-providers-core`（与后端 schema 同源），本文件只把搜索那份 spec 绑上。
+		* @module web-search-services/client/draft
+		*/
+		const SEARCH_KIT = createCardKit([
+			{
+				type: "tavily",
+				defaults: {
+					enabled: true,
+					baseURL: "https://api.tavily.com",
+					apiKeyRefs: ["TAVILY_API_KEY"],
+					searchDepth: "basic",
+					topic: "general",
+					timeRange: "",
+					includeAnswer: "",
+					includeDomains: [],
+					excludeDomains: [],
+					maxResults: 0,
+					timeoutMs: 2e4
+				},
+				fields: [
+					{
+						key: "baseURL",
+						kind: "text"
+					},
+					{
+						key: "apiKeyRefs",
+						kind: "csv",
+						refs: true
+					},
+					{
+						key: "searchDepth",
+						kind: "select",
+						options: [
+							"basic",
+							"advanced",
+							"fast",
+							"ultra-fast"
+						]
+					},
+					{
+						key: "topic",
+						kind: "select",
+						options: [
+							"general",
+							"news",
+							"finance"
+						]
+					},
+					{
+						key: "timeRange",
+						kind: "select",
+						options: [
+							"",
+							"day",
+							"week",
+							"month",
+							"year"
+						],
+						allowEmpty: true
+					},
+					{
+						key: "includeAnswer",
+						kind: "select",
+						options: [
+							"",
+							"basic",
+							"advanced"
+						],
+						allowEmpty: true
+					},
+					{
+						key: "includeDomains",
+						kind: "csv"
+					},
+					{
+						key: "excludeDomains",
+						kind: "csv"
+					},
+					{
+						key: "maxResults",
+						kind: "number",
+						max: 20
+					},
+					{
+						key: "timeoutMs",
+						kind: "number",
+						min: 1e3
+					}
+				]
+			},
+			{
+				type: "exa",
+				defaults: {
+					enabled: true,
+					baseURL: "https://api.exa.ai",
+					apiKeyRef: "EXA_API_KEY",
+					searchType: "auto",
+					category: "",
+					includeDomains: [],
+					excludeDomains: [],
+					highlights: true,
+					summary: false,
+					textMaxChars: 0,
+					numResults: 0,
+					timeoutMs: 2e4
+				},
+				fields: [
+					{
+						key: "baseURL",
+						kind: "text"
+					},
+					{
+						key: "apiKeyRef",
+						kind: "text",
+						refs: true
+					},
+					{
+						key: "searchType",
+						kind: "select",
+						options: [
+							"auto",
+							"fast",
+							"instant",
+							"deep-lite",
+							"deep",
+							"deep-reasoning"
+						]
+					},
+					{
+						key: "category",
+						kind: "text"
+					},
+					{
+						key: "includeDomains",
+						kind: "csv"
+					},
+					{
+						key: "excludeDomains",
+						kind: "csv"
+					},
+					{
+						key: "highlights",
+						kind: "boolean"
+					},
+					{
+						key: "summary",
+						kind: "boolean"
+					},
+					{
+						key: "textMaxChars",
+						kind: "number"
+					},
+					{
+						key: "numResults",
+						kind: "number",
+						max: 25
+					},
+					{
+						key: "timeoutMs",
+						kind: "number",
+						min: 1e3
+					}
+				]
+			},
+			{
+				type: "openai-chat",
+				defaults: {
+					enabled: true,
+					baseURL: "https://api.openai.com/v1",
+					apiKeyRef: "SEARCH_OPENAI_API_KEY",
+					model: "",
+					answerFormat: "markdown",
+					platform: "",
+					systemPrompt: "",
+					thinkingEffort: "",
+					thinkingField: "reasoning_effort",
+					maxTokens: 0,
+					temperature: -1,
+					timeoutMs: 12e4,
+					maxElapsedMs: 0
+				},
+				fields: [
+					{
+						key: "baseURL",
+						kind: "text"
+					},
+					{
+						key: "apiKeyRef",
+						kind: "text",
+						refs: true
+					},
+					{
+						key: "model",
+						kind: "text",
+						required: true
+					},
+					{
+						key: "answerFormat",
+						kind: "select",
+						options: [
+							"markdown",
+							"text",
+							"json"
+						]
+					},
+					{
+						key: "platform",
+						kind: "text"
+					},
+					{
+						key: "systemPrompt",
+						kind: "text"
+					},
+					{
+						key: "thinkingEffort",
+						kind: "select",
+						options: [
+							"",
+							"low",
+							"medium",
+							"high"
+						],
+						allowEmpty: true
+					},
+					{
+						key: "thinkingField",
+						kind: "text"
+					},
+					{
+						key: "maxTokens",
+						kind: "number"
+					},
+					{
+						key: "temperature",
+						kind: "number",
+						min: -1,
+						max: 2
+					},
+					{
+						key: "timeoutMs",
+						kind: "number",
+						min: 1e3
+					},
+					{
+						key: "maxElapsedMs",
+						kind: "number"
+					}
+				]
+			},
+			{
+				type: "context7",
+				defaults: {
+					enabled: true,
+					baseURL: "https://context7.com/api",
+					apiKeyRef: "CONTEXT7_API_KEY",
+					libraries: [],
+					fast: false,
+					responseType: "json",
+					maxContentChars: 4e3,
+					timeoutMs: 2e4
+				},
+				fields: [
+					{
+						key: "baseURL",
+						kind: "text"
+					},
+					{
+						key: "apiKeyRef",
+						kind: "text",
+						refs: true
+					},
+					{
+						key: "libraries",
+						kind: "libraries"
+					},
+					{
+						key: "fast",
+						kind: "boolean"
+					},
+					{
+						key: "responseType",
+						kind: "select",
+						options: ["json", "text"]
+					},
+					{
+						key: "maxContentChars",
+						kind: "number",
+						min: 200
+					},
+					{
+						key: "timeoutMs",
+						kind: "number",
+						min: 1e3
+					}
+				]
+			}
+		]);
+		const kit = SEARCH_KIT;
+		kit.entryTypes;
+		kit.specOf;
+		const draftFromValue = kit.draftFromValue;
+		kit.addEntry;
+		kit.removeEntry;
+		kit.moveEntry;
+		kit.entryIssues;
+		kit.issuesOf;
+		const draftValid = kit.draftValid;
+		const toPatch = kit.toPatch;
+		const refsOf = kit.refsOf;
+		//#endregion
 		//#region src/client/card.tsx
 		/**
 		* 「搜索后端聚合」配置卡片：经 injectPluginConfigCard 注册（插件页
 		* plugins.row.config / plugins.bundle.config，view 分发 summary/page）。
-		* 字段：scriptPath / envFile / python / priority（每行一个后端）/ timeoutMs。
-		* 密钥不走卡片：keys 段的 role(secret) 字段只允许 profile 行级注入，用户层
-		* 写入会被脱敏遮蔽——卡片改为把密钥来源（env 文件）与覆盖方式写在页面上。
-		* 外壳与控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/
-		* useNamespaceDraft）；纯校验逻辑在同目录 draft.ts（node --test 可直测）。
+		*
+		* 结构：总开关 / 暴露条目 / 代理 → 后端链（条目块）→ 密钥（官方 credentials）。
+		* 字段与默认值来自 `@dsh-plus/web-providers-core/spec`，校验逻辑来自其 `card` 工具箱，
+		* 本文件只负责布局与文案。
 		* @module web-search-services/client/card
 		*/
 		function WebSearchServicesCard(props) {
-			const { t, scope, api } = props;
+			const { t, scope, api, credentials } = props;
 			const { draft, dirty, saving, status, disabled, edit, reset, save } = useNamespaceDraft({
 				scope,
 				api,
@@ -557,8 +1488,60 @@ ${extra}
 				prefix: "wsv",
 				text: t("loading")
 			});
-			const priorityInvalid = !priorityTextOk(draft.priorityText);
-			const timeoutInvalid = !timeoutTextOk(draft.timeoutMsText);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardBody, {
+				t,
+				draft,
+				status,
+				disabled,
+				dirty,
+				saving,
+				credentials,
+				onEdit: edit,
+				onReset: reset,
+				onSave: save
+			});
+		}
+		/** 校验代号 → 文案键。 */
+		const ISSUE_KEYS = {
+			"id-empty": "issueIdEmpty",
+			required: "issueRequired",
+			"id-duplicate": "issueIdDuplicate",
+			"type-unknown": "issueTypeUnknown",
+			int: "issueInt",
+			"below-min": "issueBelowMin",
+			"above-max": "issueAboveMax",
+			option: "issueOption",
+			json: "issueJson",
+			"json-array": "issueJsonArray",
+			"json-object": "issueJsonObject",
+			"json-strings": "issueJsonStrings",
+			"library-shape": "issueLibraryShape"
+		};
+		/** 条目编辑器的已翻译文案（字段标签用 spec 的技术名，不做翻译）。 */
+		function editorLabels(t) {
+			return {
+				title: t("entriesTitle"),
+				description: t("entriesHint"),
+				addEntry: t("addEntry"),
+				empty: t("entriesEmpty"),
+				unknownType: t("unknownType"),
+				entryId: t("entryId"),
+				entryIdHint: t("entryIdHint"),
+				entryEnabled: t("entryEnabled"),
+				moveUp: t("moveUp"),
+				moveDown: t("moveDown"),
+				remove: t("remove"),
+				unsetOption: t("unsetOption"),
+				csvHint: t("csvHint"),
+				librariesHint: t("librariesHint"),
+				headersHint: t("headersHint"),
+				issue: (code) => t(ISSUE_KEYS[code])
+			};
+		}
+		function CardBody(props) {
+			const { t, draft, status, disabled, dirty, saving, credentials } = props;
+			const refs = (0, react.useMemo)(() => refsOf(draft), [draft]);
+			const valid = draftValid(draft);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CardChrome, {
 				prefix: "wsv",
 				title: t("title"),
@@ -571,95 +1554,73 @@ ${extra}
 					key: "discard",
 					label: t("discard"),
 					disabled: !dirty || saving,
-					onClick: reset
+					onClick: props.onReset
 				}, {
 					key: "save",
 					label: t(saving ? "saving" : "save"),
 					variant: "primary",
-					disabled: !dirty || priorityInvalid || timeoutInvalid || saving || disabled,
-					onClick: save
+					disabled: !dirty || !valid || saving || disabled,
+					onClick: props.onSave
 				}],
 				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
 						prefix: "wsv",
-						id: "wsv-script",
-						label: t("scriptPath"),
-						hint: t("scriptPathHint"),
-						value: draft.scriptPath,
+						id: "wsv-enabled",
+						label: t("enabled"),
+						checked: draft.enabled,
 						disabled,
-						onEdit: (v) => edit({ scriptPath: v })
+						onEdit: (checked) => props.onEdit({ enabled: checked })
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
 						prefix: "wsv",
-						id: "wsv-envfile",
-						label: t("envFile"),
-						hint: t("envFileHint"),
-						value: draft.envFile,
+						id: "wsv-expose",
+						label: t("exposeEntries"),
+						checked: draft.exposeEntries,
 						disabled,
-						onEdit: (v) => edit({ envFile: v })
+						onEdit: (checked) => props.onEdit({ exposeEntries: checked })
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "wsv-hint",
+						children: t("exposeEntriesHint")
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
 						prefix: "wsv",
-						id: "wsv-python",
-						label: t("python"),
-						hint: t("pythonHint"),
-						value: draft.python,
+						id: "wsv-proxy",
+						label: t("proxy"),
+						hint: t("proxyHint"),
+						value: draft.proxy,
 						disabled,
-						onEdit: (v) => edit({ python: v })
+						onEdit: (value) => props.onEdit({ proxy: value })
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "wsv-field",
-						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-								className: "wsv-head",
-								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
-									className: "wsv-label",
-									htmlFor: "wsv-priority",
-									children: t("priority")
-								})
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
-								id: "wsv-priority",
-								className: "wsv-priority",
-								rows: 3,
-								value: draft.priorityText,
-								disabled,
-								onChange: (event) => edit({ priorityText: event.target.value })
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: priorityInvalid ? "wsv-invalid" : "wsv-hint",
-								children: priorityInvalid ? t("invalidPriority") : t("priorityHint")
-							})
-						]
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "wsv-hint",
+						children: t("enabledHint")
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(EntryEditor, {
 						prefix: "wsv",
-						id: "wsv-timeout",
-						label: t("timeoutMs"),
-						hint: t("timeoutMsHint"),
-						value: draft.timeoutMsText,
-						numeric: true,
+						kit: SEARCH_KIT,
+						labels: editorLabels(t),
+						draft,
 						disabled,
-						invalid: timeoutInvalid,
-						invalidLabel: t("invalidTimeout"),
-						onEdit: (v) => edit({ timeoutMsText: v })
+						onChange: (next) => props.onEdit(next)
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "wsv-keys",
-						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: "wsv-keysTitle",
-								children: t("keysGroup")
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: "wsv-hint",
-								children: t("keysHint")
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: "wsv-hint",
-								children: t("keysUserLayerHint")
-							})
-						]
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CredentialsSection, {
+						prefix: "wsv",
+						title: t("secretsTitle"),
+						description: t("secretsBody"),
+						rows: refs.map((ref) => ({
+							ref,
+							label: ref
+						})),
+						face: credentials,
+						labels: {
+							save: t("save"),
+							clear: t("secretClear"),
+							configured: t("secretConfigured"),
+							missing: t("secretMissing"),
+							shadowed: t("secretShadowed"),
+							failed: t("secretFailed")
+						}
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: "wsv-hint",
@@ -671,52 +1632,106 @@ ${extra}
 		//#endregion
 		//#region src/client/i18n.ts
 		/**
-		* 配置卡片文案（zh/en）。经 ctx.locale.register 注册、bind 取用。
+		* 配置卡片文案（zh/en）：经 ctx.locale.register 注册、bind 取用。
 		* 公共键（save/discard/unsaved 等）来自 shared 的 common 字典，本文件只维护业务键。
 		* @module web-search-services/client/i18n
 		*/
 		const NS = "dsh-plus-web-search-services";
 		const ownZh = {
 			title: "搜索后端聚合",
-			description: "把 search-services skill 接成 dsh 的 web_search 后端：按优先级尝试 Tavily / Exa / OpenAI-compatible，失败自动回退。",
-			summaryLine: "web_search 免费后端聚合：优先级链 + 失败自动回退（密钥读 skill 的 env 文件）。",
-			scriptPath: "search.py 路径",
-			scriptPathHint: "留空 = 使用随包内置脚本；支持 ~ 展开。",
-			envFile: "密钥 env 文件",
-			envFileHint: "默认 ~/.config/search-services/env（skill 的单事实源）；留空表示不读该文件。支持 ~ 展开。",
-			python: "python 解释器",
-			pythonHint: "可含参数（如 py -3）；留空 = 自动发现（桌面捆绑运行时 → PATH → 平台兜底名）。",
-			priority: "后端优先级",
-			priorityHint: "每行一个，靠前先试，失败自动回退到下一个。可选值：tavily、exa、openai-chat；重复或未知值会被拒绝保存。",
-			timeoutMs: "单次搜索超时（毫秒）",
-			timeoutMsHint: "应低于 dsh-tool-web 的 searchTimeoutMs；下限 1000，默认 55000。",
-			invalidPriority: "请填写至少一个有效后端，且不要重复",
-			invalidTimeout: "请输入不小于 1000 的整数",
-			keysGroup: "密钥与覆盖项（本卡片不编辑）",
-			keysHint: "密钥主来源是上面的 env 文件，保持 skill 单事实源：TAVILY_API_KEY、EXA_API_KEY、SEARCH_OPENAI_API_KEY，以及可选的 SEARCH_OPENAI_BASE_URL、SEARCH_OPENAI_MODEL。",
-			keysUserLayerHint: "schema 里的 keys 段是行级覆盖逃生舱（role(secret) 字段只允许 profile 行级注入）；写入 settings 用户层会被脱敏遮蔽，因此配置卡片不提供编辑。需要覆盖时请改 env 文件，或在 profile 的 cordis.patch.yml 行级注入。",
-			reloadHint: "改动热生效（下一次 web_search 调用即用新配置）；scriptPath / python 变化无需重启。"
+			description: "把 web_search 接到多个搜索后端：按条目顺序尝试，失败自动回退到下一个；官方工具、渲染与 Sources 格式零修改。",
+			summaryLine: "web_search 多后端聚合：顺序尝试 + 失败自动回退（密钥走官方 credentials）。",
+			enabled: "启用本插件",
+			enabledHint: "关闭后 web_search 不再选用本插件注册的 provider；官方工具与提示词不变。",
+			exposeEntries: "暴露每条目 provider",
+			exposeEntriesHint: "额外注册 dsh-plus-search-<条目名>，便于在 profile 里用 searchProvider 钉住单个后端；改动条目列表后需 /reload 生效。",
+			proxy: "HTTP(S) 代理",
+			proxyHint: "全部后端共用（Tavily/Exa/OpenAI/Context7 的基址都走这里）；留空 = 读环境变量 HTTP_PROXY/HTTPS_PROXY/NO_PROXY。",
+			entriesTitle: "后端链",
+			entriesHint: "顺序即优先级：靠前的先试，失败自动回退到下一个。条目内的密钥引用在下方「密钥」小节填写。",
+			addEntry: "新增条目",
+			entryId: "条目名",
+			entryIdHint: "链内标识，同时是 provider id 的后缀（dsh-plus-search-<条目名>），需唯一。",
+			entryEnabled: "参与链",
+			moveUp: "上移",
+			moveDown: "下移",
+			remove: "删除",
+			type: "类型",
+			unsetOption: "（不设置）",
+			csvHint: "多项用逗号分隔，留空表示不限。",
+			librariesHint: "JSON 数组：[{\"name\":\"react\",\"id\":\"/facebook/react\",\"keywords\":[\"react\"]}]（id 可留空，运行时按名称解析）。",
+			headersHint: "JSON 对象：{\"Accept-Language\":\"zh-CN\"}。",
+			entriesEmpty: "至少保留一个条目，否则本 provider 不可用。",
+			unknownType: "未知条目类型（来自更早版本的配置），保存前请删除或改类型。",
+			issueIdEmpty: "条目名不能为空。",
+			issueRequired: "必填：留空会让该条目永不可用。",
+			issueIdDuplicate: "条目名重复。",
+			issueTypeUnknown: "未知条目类型。",
+			issueInt: "需为整数。",
+			issueBelowMin: "低于允许的最小值（见后端 schema）。",
+			issueAboveMax: "高于允许的最大值（见后端 schema）。",
+			issueOption: "取值不在候选内。",
+			issueJson: "需为合法 JSON。",
+			issueJsonArray: "需为 JSON 数组。",
+			issueJsonObject: "需为 JSON 对象。",
+			issueJsonStrings: "值需为字符串。",
+			issueLibraryShape: "每项需含 name 字段（可选 id 与 keywords）。",
+			secretsTitle: "密钥",
+			secretsBody: "值经官方 credentials 接口写入 $DSH_HOME/.credentials.yaml，卡片不回显；引用名由上面的条目决定。也可用环境变量提供同名值。",
+			secretConfigured: "已配置",
+			secretMissing: "未配置",
+			secretShadowed: "该引用被进程环境（或只读来源）提供，卡片不能改写。",
+			secretFailed: "凭据写入失败：",
+			secretClear: "清除",
+			reloadHint: "条目增删后需 /reload 才会重新注册 provider；超时、密钥、顺序等字段改动下一次调用即生效。"
 		};
 		const ownEn = {
 			title: "Search backend aggregation",
-			description: "Bridges the search-services skill into dsh as a web_search backend: tries Tavily / Exa / OpenAI-compatible in priority order with automatic fallback.",
-			summaryLine: "web_search backend aggregation: priority chain with automatic fallback (keys from the skill env file).",
-			scriptPath: "search.py path",
-			scriptPathHint: "Empty uses the bundled copy; ~ is expanded.",
-			envFile: "Credential env file",
-			envFileHint: "Defaults to ~/.config/search-services/env (the skill’s single source); empty skips the file. ~ is expanded.",
-			python: "Python interpreter",
-			pythonHint: "May include arguments (e.g. py -3); empty auto-detects (desktop runtime → PATH → platform default).",
-			priority: "Backend priority",
-			priorityHint: "One per line, earlier first, with automatic fallback on failure. Allowed: tavily, exa, openai-chat; duplicates or unknown values block saving.",
-			timeoutMs: "Per-search timeout (ms)",
-			timeoutMsHint: "Keep it below dsh-tool-web’s searchTimeoutMs; minimum 1000, default 55000.",
-			invalidPriority: "Enter at least one valid backend without duplicates",
-			invalidTimeout: "Enter an integer of at least 1000",
-			keysGroup: "Credentials and overrides (not edited here)",
-			keysHint: "Credentials come from the env file above, keeping the skill as the single source: TAVILY_API_KEY, EXA_API_KEY, SEARCH_OPENAI_API_KEY, plus optional SEARCH_OPENAI_BASE_URL and SEARCH_OPENAI_MODEL.",
-			keysUserLayerHint: "The keys section in the schema is a line-level escape hatch (role(secret) fields accept profile-line injection only); values written to the settings user layer are masked, so this card offers no editor. To override, edit the env file or inject at the profile row in cordis.patch.yml.",
-			reloadHint: "Changes apply hot (the next web_search call uses them); scriptPath / python need no restart."
+			description: "Routes web_search to several search backends: entries are tried in order with automatic fallback. Official tool, rendering and Sources formatting are untouched.",
+			summaryLine: "web_search backend chain: ordered attempts with automatic fallback (keys via official credentials).",
+			enabled: "Enable this plugin",
+			enabledHint: "When off, web_search no longer selects the providers registered here; the official tool and prompt are unchanged.",
+			exposeEntries: "Expose per-entry providers",
+			exposeEntriesHint: "Also registers dsh-plus-search-<entry id> so a profile can pin one backend via searchProvider; changing the entry list needs /reload.",
+			proxy: "HTTP(S) proxy",
+			proxyHint: "Shared by every backend (Tavily/Exa/OpenAI/Context7 base URLs); empty reads HTTP_PROXY/HTTPS_PROXY/NO_PROXY.",
+			entriesTitle: "Backend chain",
+			entriesHint: "Order is priority: the first entry is tried first and failures fall through to the next. Credential references are edited in the Secrets section below.",
+			addEntry: "Add entry",
+			entryId: "Entry name",
+			entryIdHint: "Identifies the entry inside the chain and suffixes the provider id (dsh-plus-search-<entry>); must be unique.",
+			entryEnabled: "In chain",
+			moveUp: "Move up",
+			moveDown: "Move down",
+			remove: "Remove",
+			type: "Type",
+			unsetOption: "(unset)",
+			csvHint: "Separate multiple values with commas; empty means no restriction.",
+			librariesHint: "JSON array: [{\"name\":\"react\",\"id\":\"/facebook/react\",\"keywords\":[\"react\"]}] (id optional; resolved by name at runtime).",
+			headersHint: "JSON object: {\"Accept-Language\":\"zh-CN\"}.",
+			entriesEmpty: "Keep at least one entry, otherwise this provider is unavailable.",
+			unknownType: "Unknown entry type (from an older configuration); remove it or change its type before saving.",
+			issueIdEmpty: "Entry name is required.",
+			issueRequired: "Required: leaving it empty makes the entry permanently unusable.",
+			issueIdDuplicate: "Entry name is duplicated.",
+			issueTypeUnknown: "Unknown entry type.",
+			issueInt: "Enter an integer.",
+			issueBelowMin: "Below the minimum allowed by the backend schema.",
+			issueAboveMax: "Above the maximum allowed by the backend schema.",
+			issueOption: "Value is not one of the options.",
+			issueJson: "Enter valid JSON.",
+			issueJsonArray: "Enter a JSON array.",
+			issueJsonObject: "Enter a JSON object.",
+			issueJsonStrings: "Values must be strings.",
+			issueLibraryShape: "Each item needs a name (optional id and keywords).",
+			secretsTitle: "Credentials",
+			secretsBody: "Values are written through the official credentials API into $DSH_HOME/.credentials.yaml and are never echoed back; references come from the entries above. Environment variables with the same name also work.",
+			secretConfigured: "Configured",
+			secretMissing: "Not configured",
+			secretShadowed: "This reference comes from the process environment (or a read-only source); the card cannot change it.",
+			secretFailed: "Credential write failed: ",
+			secretClear: "Clear",
+			reloadHint: "Adding or removing entries needs /reload to re-register providers; timeouts, keys and order take effect on the next call."
 		};
 		const zh = mergeDict(commonZh, ownZh);
 		const en = mergeDict(commonEn, ownEn);
@@ -724,19 +1739,22 @@ ${extra}
 		//#region src/client/styles.ts
 		/**
 		* 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('wsv')，
-		* 本文件只补插件特有规则（优先级多行文本域、密钥说明块）。
+		* 本文件只补插件特有规则（条目块、JSON 文本域、条目操作按钮组）。
 		* 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载）。
 		* @module web-search-services/client/styles
 		*/
 		const PLUGIN_ID = "@dsh-plus/web-search-services";
 		const cardCssAll = cardCss("wsv", `
-.wsv-priority{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:8px 12px;font-size:13px;line-height:1.6;min-height:72px;resize:vertical;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
-.wsv-priority:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
-.wsv-priority:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
-.wsv-keys{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;margin:12px 0 0;padding:10px 12px}
-.wsv-keysTitle{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px;font-weight:600}
+.wsv-entry{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;margin:12px 0 0;padding:4px 12px 12px}
+.wsv-entryHead{align-items:center;gap:8px;display:flex;flex-wrap:wrap;padding:12px 0 4px}
+.wsv-entryIndex{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}
+.wsv-entryActions{margin-left:auto;gap:6px;display:flex;flex-wrap:wrap}
+.wsv-json{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:8px 12px;font-size:13px;line-height:1.6;resize:vertical;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
+.wsv-json:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
+.wsv-json:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
 @media (max-width:767px){
-.wsv-priority{font-size:16px}
+.wsv-json{font-size:16px}
+.wsv-entryActions{width:100%;margin-left:0}
 }
 `);
 		/** 幂等注入样式标签；返回标签（已存在或环境无 document 时为 null）。 */
@@ -746,12 +1764,17 @@ ${extra}
 		//#endregion
 		//#region src/client/client.ts
 		const name = "dsh-plus-web-search-services";
-		/** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
+		/**
+		* 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject
+		* 管包加载顺序）。`remote.credentials` 为硬依赖：卡片是密钥的唯一配置面，
+		* 命名空间缺席时整张卡片都不该挂（官方设置页同样如此声明）。
+		*/
 		const inject = [
 			"slots",
 			"locale",
 			"remote",
-			"remote.settings"
+			"remote.settings",
+			"remote.credentials"
 		];
 		function apply(ctx) {
 			const c = ctx;
@@ -765,6 +1788,7 @@ ${extra}
 			}), "web-search-services: locale");
 			const scope = createSettingsScope(c, SETTINGS_NS, "web-search-services: settings scope");
 			const api = createNamespaceApi(c.get("remote").settings, SETTINGS_NS);
+			const credentials = credentialsFace(c.get("remote"));
 			injectPluginConfigCard(c.slots, {
 				ns: SETTINGS_NS,
 				rowId: "dsh-plus-web-search-services",
@@ -773,7 +1797,8 @@ ${extra}
 				inject: () => ({
 					t: c.locale.bind(NS),
 					scope,
-					api
+					api,
+					credentials
 				})
 			});
 		}