@daweifu/capability-menu 0.1.2 → 0.1.4

package/lib/client.js

@@ -284,7 +284,7 @@ function prefixIssues(path, issues) {
 		return iss;
 	});
 }
-function unwrapMessage(message) {
+function unwrapMessage$1(message) {
 	return typeof message === "string" ? message : message?.message;
 }
 function attachSchema(issues, start, inst) {
@@ -299,7 +299,7 @@ function finalizeIssue(iss, ctx, config) {
 		else iss.schema = iss.inst;
 	}
 	const schemaError = iss.schema !== iss.inst ? iss.schema?._zod.def?.error : void 0;
-	const message = iss.message ? iss.message : unwrapMessage(iss.inst?._zod.def?.error?.(iss)) ?? unwrapMessage(schemaError?.(iss)) ?? unwrapMessage(ctx?.error?.(iss)) ?? unwrapMessage(config.customError?.(iss)) ?? unwrapMessage(config.localeError?.(iss)) ?? "Invalid input";
+	const message = iss.message ? iss.message : unwrapMessage$1(iss.inst?._zod.def?.error?.(iss)) ?? unwrapMessage$1(schemaError?.(iss)) ?? unwrapMessage$1(ctx?.error?.(iss)) ?? unwrapMessage$1(config.customError?.(iss)) ?? unwrapMessage$1(config.localeError?.(iss)) ?? "Invalid input";
 	const { inst: _inst, schema: _schema, continue: _continue, input: _input, ...rest } = iss;
 	rest.path ?? (rest.path = []);
 	rest.message = message;
@@ -5190,12 +5190,57 @@ function superRefine(fn, params) {
 * namespace and exports a `TYPERT_REMOTE` contribution that the browser
 * plugin mounts via `ctx.remote.$mount(...)`.
 */
+const stringRecord$schema = record(string(), string());
+const mcpLocation$schema = object({
+	id: string().readonly(),
+	serverName: string().readonly(),
+	transport: union([literal("stdio"), literal("streamable-http")]).readonly(),
+	disabled: boolean().readonly(),
+	command: string().optional().readonly(),
+	args: array(string()).optional().readonly(),
+	env: stringRecord$schema.optional().readonly(),
+	cwd: string().optional().readonly(),
+	url: string().optional().readonly(),
+	headers: stringRecord$schema.optional().readonly(),
+	toolCallTimeoutMs: number().optional().readonly()
+});
+const skillLocation$schema = object({
+	name: string().readonly(),
+	path: string().readonly(),
+	linked: boolean().readonly(),
+	valid: boolean().readonly(),
+	root: union([literal("user"), literal("project")]).readonly(),
+	entryDir: string().readonly(),
+	target: string().optional().readonly()
+});
+const mcpInput$schema = object({
+	serverName: string(),
+	transport: union([literal("stdio"), literal("streamable-http")]),
+	command: string().optional(),
+	args: array(string()).optional(),
+	env: stringRecord$schema.optional(),
+	cwd: string().optional(),
+	url: string().optional(),
+	headers: stringRecord$schema.optional(),
+	toolCallTimeoutMs: number().optional()
+});
+const mcpUpdateInput$schema = object({
+	transport: union([literal("stdio"), literal("streamable-http")]),
+	command: string().optional(),
+	args: array(string()).optional(),
+	env: stringRecord$schema.optional(),
+	cwd: string().optional(),
+	url: string().optional(),
+	headers: stringRecord$schema.optional(),
+	toolCallTimeoutMs: number().optional()
+});
 const capabilityRow$schema = object({
 	id: string().readonly(),
 	kind: union([literal("tool"), literal("skill")]).readonly(),
 	name: string().readonly(),
 	server: string().optional().readonly(),
 	source: string().optional().readonly(),
+	preset: string().optional().readonly(),
 	class: union([
 		literal("resident"),
 		literal("on-demand"),
@@ -5229,7 +5274,8 @@ const toolDetail$schema = object({
 		provider: string().readonly(),
 		serverName: string().optional().readonly(),
 		path: string().optional().readonly(),
-		source: string().optional().readonly()
+		source: string().optional().readonly(),
+		preset: string().optional().readonly()
 	}).readonly(),
 	tags: array(string()).readonly(),
 	stats: object({
@@ -5257,7 +5303,7 @@ const TYPERT_REMOTE = {
 			},
 			sourceLocation: {
 				file: "src/server/remote.ts",
-				line: 60,
+				line: 61,
 				column: 3
 			}
 		},
@@ -5284,7 +5330,7 @@ const TYPERT_REMOTE = {
 			},
 			sourceLocation: {
 				file: "src/server/remote.ts",
-				line: 66,
+				line: 67,
 				column: 3
 			}
 		},
@@ -5302,7 +5348,25 @@ const TYPERT_REMOTE = {
 			},
 			sourceLocation: {
 				file: "src/server/remote.ts",
-				line: 72,
+				line: 73,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/refresh",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "refresh",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: {
+				mode: "strict",
+				typeSymbol: "void",
+				schema: _undefined()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 84,
 				column: 3
 			}
 		},
@@ -5339,7 +5403,7 @@ const TYPERT_REMOTE = {
 			},
 			sourceLocation: {
 				file: "src/server/remote.ts",
-				line: 84,
+				line: 85,
 				column: 3
 			}
 		},
@@ -5375,7 +5439,7 @@ const TYPERT_REMOTE = {
 			},
 			sourceLocation: {
 				file: "src/server/remote.ts",
-				line: 90,
+				line: 91,
 				column: 3
 			}
 		},
@@ -5402,7 +5466,7 @@ const TYPERT_REMOTE = {
 			},
 			sourceLocation: {
 				file: "src/server/remote.ts",
-				line: 78,
+				line: 79,
 				column: 3
 			}
 		},
@@ -5420,29 +5484,1121 @@ const TYPERT_REMOTE = {
 			},
 			sourceLocation: {
 				file: "src/server/remote.ts",
-				line: 100,
+				line: 104,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/listLocations",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "listLocations",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: {
+				mode: "strict",
+				typeSymbol: "@daweifu/capability-menu#McpLocation[]",
+				schema: array(mcpLocation$schema)
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 193,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/addLocation",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "addLocation",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "input",
+				wire: "input",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "@daweifu/capability-menu#McpInput",
+					schema: mcpInput$schema
+				}
+			}],
+			result: {
+				mode: "strict",
+				typeSymbol: "string",
+				schema: string()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 199,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/removeLocation",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "removeLocation",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "id",
+				wire: "id",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "string",
+					schema: string()
+				}
+			}],
+			result: {
+				mode: "strict",
+				typeSymbol: "boolean",
+				schema: boolean()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 205,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/updateLocation",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "updateLocation",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "id",
+				wire: "id",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "string",
+					schema: string()
+				}
+			}, {
+				name: "input",
+				wire: "input",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "@daweifu/capability-menu#McpUpdateInput",
+					schema: mcpUpdateInput$schema
+				}
+			}],
+			result: {
+				mode: "strict",
+				typeSymbol: "boolean",
+				schema: boolean()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 211,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/listSkillLocations",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "listSkillLocations",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: {
+				mode: "strict",
+				typeSymbol: "@daweifu/capability-menu#SkillLocation[]",
+				schema: array(skillLocation$schema)
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 229,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/addSkillLocation",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "addSkillLocation",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "dir",
+				wire: "dir",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "string",
+					schema: string()
+				}
+			}, {
+				name: "projectPath",
+				wire: "projectPath",
+				source: "json",
+				acceptsUndefined: true,
+				codec: {
+					mode: "strict",
+					typeSymbol: "string",
+					schema: string().optional()
+				}
+			}],
+			result: {
+				mode: "strict",
+				typeSymbol: "string",
+				schema: string()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 252,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/removeSkillLocation",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "removeSkillLocation",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "name",
+				wire: "name",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "string",
+					schema: string()
+				}
+			}, {
+				name: "entryDir",
+				wire: "entryDir",
+				source: "json",
+				acceptsUndefined: true,
+				codec: {
+					mode: "strict",
+					typeSymbol: "string",
+					schema: string().optional()
+				}
+			}],
+			result: {
+				mode: "strict",
+				typeSymbol: "boolean",
+				schema: boolean()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 258,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/adoptSkillLocation",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "adoptSkillLocation",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "name",
+				wire: "name",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "string",
+					schema: string()
+				}
+			}],
+			result: {
+				mode: "strict",
+				typeSymbol: "string",
+				schema: string()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 259,
 				column: 3
 			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/updateSkillLocation",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "updateSkillLocation",
+			invocation: { kind: "direct" },
+			parameters: [
+				{
+					name: "name",
+					wire: "name",
+					source: "json",
+					codec: {
+						mode: "strict",
+						typeSymbol: "string",
+						schema: string()
+					}
+				},
+				{
+					name: "dir",
+					wire: "dir",
+					source: "json",
+					codec: {
+						mode: "strict",
+						typeSymbol: "string",
+						schema: string()
+					}
+				},
+				{
+					name: "entryDir",
+					wire: "entryDir",
+					source: "json",
+					acceptsUndefined: true,
+					codec: {
+						mode: "strict",
+						typeSymbol: "string",
+						schema: string().optional()
+					}
+				}
+			],
+			result: {
+				mode: "strict",
+				typeSymbol: "boolean",
+				schema: boolean()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 264,
+				column: 3
+			}
+		},
+		{
+			id: "@daweifu/capability-menu#capabilityPolicy/catalogVersion",
+			service: "capabilityPolicy",
+			namespace: "capabilityPolicy",
+			method: "catalogVersion",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: {
+				mode: "strict",
+				typeSymbol: "number",
+				schema: number()
+			},
+			sourceLocation: {
+				file: "src/server/remote.ts",
+				line: 317,
+				column: 3
+			}
+		}
+	]
+};
+//#endregion
+//#region src/client/store.ts
+/** Unwrap a RemoteResult-like, throwing a readable error on failure. */
+function unwrap(result, what) {
+	if (!result.ok) throw new Error(`${what} failed: ${result.error.code}: ${result.error.message}`);
+	return result.value;
+}
+/**
+* Unwrap a RemoteResult-like for a user-facing mutation.
+*
+* The policy service's messages are already written for the person at the
+* dialog (Chinese, naming the offending path), so the RPC name and error code
+* that `unwrap` adds for diagnostics are dropped here: they would surface as
+* `capabilityPolicy.addSkillLocation failed: <code>: 目录中没有 SKILL.md：…`
+* in a dialog that is otherwise plain Chinese.
+*/
+function unwrapMessage(result) {
+	if (!result.ok) throw new Error(result.error.message);
+	return result.value;
+}
+/**
+* The last successful snapshot, at module scope.
+*
+* The section is remounted every time the settings tab is opened, and a cold
+* `classifyAll` can be slow once per page load (the plugin's mount awaits a full
+* catalog enumeration before the surface has data). Keeping the previous rows
+* lets a remount paint them immediately and revalidate behind the user instead
+* of showing a loading placeholder. This is a view cache only — every read is
+* still followed by an authoritative one.
+*/
+let lastSnapshot;
+/** The previously loaded snapshot, when this page session has one. */
+function cachedSnapshot() {
+	return lastSnapshot;
+}
+/** Load the classification list from the remote, remembering it for remounts. */
+async function loadSnapshot(remote) {
+	lastSnapshot = { rows: unwrap(await remote.classifyAll(), "capabilityPolicy.classifyAll") };
+	return lastSnapshot;
+}
+//#endregion
+//#region src/client/LocationModal.tsx
+/**
+* 能力来源弹窗：注册与编辑 MCP 服务器 / Skill 目录。
+*
+* Two modes, one form implementation:
+*
+* - **注册** — opened from the header's 注册能力 button. Carries the two
+*   sub-tabs (MCP servers / skill directories) and opens on the one matching
+*   the main tab the user is on, so one button is context-sensitive. No list of
+*   what is already registered: that lives on the entries themselves, behind
+*   the per-row 编辑 buttons, where it is actually actionable.
+* - **编辑** — opened from a row's 编辑 button with the entry prefilled.
+*
+* Only 注册 / 保存 / 移除 are offered. Temporarily silencing a source is the
+* exposure policy's job (classify the capability as Disabled), so there is no
+* second enable switch here.
+*/
+const CSS_ID$1 = "capability-menu-location-css";
+const CSS$1 = `
+.lm-block{display:flex;flex-direction:column;gap:8px}
+.lm-btn{border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);font:inherit;font-size:12px;line-height:20px;padding:0 10px;cursor:pointer;white-space:nowrap}
+.lm-btn:hover{border-color:var(--dsw-alias-border-l3);background:var(--dsw-alias-interactive-bg-hover)}
+.lm-btn--danger:hover{color:#b3261e;border-color:#b3261e}
+.lm-btn:disabled{opacity:.55;cursor:default}
+/* Each field is its own two-column grid with a fixed label track.
+   A single form-wide grid looked tidier but was fragile: it needed
+   .lm-field{display:contents}, which turned every hint into a free-floating grid
+   item, and one extra half-width item pushed the following labels into column 2 and
+   their inputs into column 1 — which is exactly how the streamable-http layout got
+   scrambled (that branch has an odd number of items). Per-field grids mean a hint
+   can only ever affect its own field, and a fixed label track (rather than
+   min-width, which sizes per row) keeps every label column identical. */
+.lm-form{display:flex;flex-direction:column;gap:6px}
+.lm-field{--lm-label-w:104px;display:grid;grid-template-columns:var(--lm-label-w) 1fr;gap:2px 8px;align-items:start}
+.lm-label{grid-column:1;min-width:0;overflow-wrap:anywhere;font-size:12px;line-height:20px;color:var(--dsw-alias-label-tertiary)}
+/* width:100% must come with border-box: the field carries a 1px border plus 8px of
+   padding, which would otherwise overflow the column and clip. */
+.lm-input{grid-column:2;width:100%;box-sizing:border-box;min-width:0;border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-1);color:inherit;font:inherit;font-size:12px;line-height:20px;padding:2px 8px}
+.lm-input:disabled{opacity:.6}
+textarea.lm-input{resize:vertical;font-family:var(--dsw-font-markdown-code-block-font-family)}
+/* Lives inside its field, in the content column: it lines up with the box it
+   annotates and takes the caption colour so it does not read as another label. */
+.lm-hint{grid-column:2;margin:0;font-size:11px;line-height:16px;color:var(--dsw-alias-label-caption)}
+.lm-error{margin:0;font-size:12px;color:#b3261e;word-break:break-word}
+.lm-actions{display:flex;gap:8px;justify-content:flex-end;padding:4px 0 0}
+/* Removal is irreversible, so it takes over the action row for one confirmation
+   step: the message states the consequence, then the buttons act. */
+.lm-confirm{display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:8px 10px;border:1px solid #b3261e;border-radius:6px}
+.lm-confirm-msg{flex:1 1 auto;margin:0;font-size:12px;line-height:18px;word-break:break-word}
+.lm-confirm-actions{display:flex;gap:8px;flex-shrink:0}
+/* The modal shell itself carries no padding (it is shared with the read-only
+   catalog viewer, whose body supplies its own); the form supplies it here. */
+.lm-body{padding:14px 16px;overflow:auto;flex:1 1 auto;min-height:0}
+`;
+if (typeof document !== "undefined" && document.querySelector(`style[data-css-id="${CSS_ID$1}"]`) === null) {
+	const tag = document.createElement("style");
+	tag.dataset.cssId = CSS_ID$1;
+	tag.textContent = CSS$1;
+	document.head.appendChild(tag);
+}
+/** Render a key/value map as `Key: Value` lines. */
+function toLines(record) {
+	if (record === void 0) return "";
+	return Object.entries(record).map(([key, value]) => `${key}: ${value}`).join("\n");
+}
+/** Parse `Key: Value` lines into a map; blank lines and lines without `:` are skipped. */
+function fromLines(text) {
+	const out = {};
+	for (const line of text.split("\n")) {
+		const trimmed = line.trim();
+		if (trimmed.length === 0) continue;
+		const at = trimmed.indexOf(":");
+		if (at <= 0) continue;
+		const key = trimmed.slice(0, at).trim();
+		const value = trimmed.slice(at + 1).trim();
+		if (key.length > 0) out[key] = value;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+function LocationModal(props) {
+	const { remote, t, defaultKind = "mcp", editMcp, editSkill, onClose, onChanged } = props;
+	const editing = editMcp !== void 0 || editSkill !== void 0;
+	const [subTab, setSubTab] = (0, react.useState)(editSkill !== void 0 ? "skill" : editMcp !== void 0 ? "mcp" : defaultKind);
+	const [error, setError] = (0, react.useState)(null);
+	const [busy, setBusy] = (0, react.useState)(false);
+	/**
+	* Which action is waiting for confirmation, if any. Two need one: 移除, and
+	* 保存 on an entry that is a real directory — repointing unlinks the entry
+	* first, which recursively deletes a real directory's contents.
+	*/
+	const [confirm, setConfirm] = (0, react.useState)(null);
+	const [serverName, setServerName] = (0, react.useState)(editMcp?.serverName ?? "");
+	const [transport, setTransport] = (0, react.useState)(editMcp?.transport ?? "streamable-http");
+	const [command, setCommand] = (0, react.useState)(editMcp?.command ?? "");
+	const [args, setArgs] = (0, react.useState)((editMcp?.args ?? []).join(" "));
+	const [cwd, setCwd] = (0, react.useState)(editMcp?.cwd ?? "");
+	const [env, setEnv] = (0, react.useState)(toLines(editMcp?.env));
+	const [url, setUrl] = (0, react.useState)(editMcp?.url ?? "");
+	const [headers, setHeaders] = (0, react.useState)(toLines(editMcp?.headers));
+	const [timeoutSec, setTimeoutSec] = (0, react.useState)(editMcp?.toolCallTimeoutMs === void 0 ? "" : String(Math.round(editMcp.toolCallTimeoutMs / 1e3)));
+	const [skillDir, setSkillDir] = (0, react.useState)(editSkill?.target ?? editSkill?.path ?? "");
+	const [skillRoot, setSkillRoot] = (0, react.useState)(editSkill?.root ?? "user");
+	/** A path inside the project; the server derives the project root from it. */
+	const [projectPath, setProjectPath] = (0, react.useState)("");
+	/**
+	* What the operator sees this entry called. They got here from a row named by
+	* the skill's declared name, so the messages use that and not the entry's own
+	* name — which is only ever handed back to the server, since that is what
+	* addresses the symlink on disk.
+	*/
+	const skillLabel = editSkill?.skillName ?? editSkill?.name ?? "";
+	const title = (0, react.useMemo)(() => {
+		if (editMcp !== void 0) return t("editMcp");
+		if (editSkill !== void 0) return t("editSkillNamed", { name: skillLabel });
+		return t("registerCapability");
+	}, [
+		editMcp,
+		editSkill,
+		skillLabel,
+		t
+	]);
+	/** Run a mutation; on success close and ask the parent to re-pull. */
+	const submit = (0, react.useCallback)(async (action, noticeFor) => {
+		if (busy) return;
+		setBusy(true);
+		try {
+			const changed = await action();
+			if (changed === false) throw new Error(t("entryNotFound"));
+			setError(null);
+			onChanged(noticeFor?.(changed));
+			onClose();
+		} catch (e) {
+			setError(String(e));
+		} finally {
+			setBusy(false);
+		}
+	}, [
+		busy,
+		onChanged,
+		onClose,
+		t
+	]);
+	const submitMcp = (0, react.useCallback)(() => {
+		const trimmedTimeout = timeoutSec.trim();
+		const timeoutMs = trimmedTimeout.length === 0 ? void 0 : Math.round(Number(trimmedTimeout) * 1e3);
+		if (timeoutMs !== void 0 && !Number.isFinite(timeoutMs)) {
+			setError(t("timeoutInvalid"));
+			return;
+		}
+		const parsedEnv = fromLines(env);
+		const parsedHeaders = fromLines(headers);
+		const common = {
+			transport,
+			...transport === "stdio" ? {
+				command: command.trim(),
+				...args.trim().length > 0 ? { args: args.trim().split(/\s+/) } : {},
+				...parsedEnv !== void 0 ? { env: parsedEnv } : {},
+				...cwd.trim().length > 0 ? { cwd: cwd.trim() } : {}
+			} : {
+				url: url.trim(),
+				...parsedHeaders !== void 0 ? { headers: parsedHeaders } : {}
+			},
+			...timeoutMs !== void 0 ? { toolCallTimeoutMs: timeoutMs } : {}
+		};
+		submit(async () => editMcp !== void 0 ? unwrapMessage(await remote.updateLocation(editMcp.id, common)) : unwrapMessage(await remote.addLocation({
+			serverName: serverName.trim(),
+			...common
+		})));
+	}, [
+		submit,
+		remote,
+		editMcp,
+		serverName,
+		transport,
+		command,
+		args,
+		cwd,
+		env,
+		url,
+		headers,
+		timeoutSec,
+		t
+	]);
+	const submitSkill = (0, react.useCallback)(() => {
+		const asked = skillRoot === "project" ? projectPath.trim() : void 0;
+		submit(async () => editSkill !== void 0 ? unwrapMessage(await remote.updateSkillLocation(editSkill.name, skillDir.trim(), editSkill.entryDir)) : unwrapMessage(await remote.addSkillLocation(skillDir.trim(), asked)), (result) => editSkill !== void 0 ? t("skillRepointed", { dir: skillDir.trim() }) : t("skillRegisteredAt", { path: String(result) }));
+	}, [
+		submit,
+		remote,
+		editSkill,
+		skillDir,
+		skillRoot,
+		projectPath,
+		t
+	]);
+	const remove = (0, react.useCallback)(() => {
+		if (editMcp !== void 0) {
+			submit(async () => unwrapMessage(await remote.removeLocation(editMcp.id)));
+			return;
+		}
+		if (editSkill !== void 0) submit(async () => unwrapMessage(await remote.removeSkillLocation(editSkill.name, editSkill.entryDir)));
+	}, [
+		submit,
+		remote,
+		editMcp,
+		editSkill
+	]);
+	/**
+	* What removal actually costs, which differs by target: an MCP row only loses
+	* its config, a linked skill only loses its symlink — but `removeSkill`
+	* recursively deletes a *real* directory in the skill root, so that case has to
+	* say so before the click, not after.
+	*/
+	const removalWarning = (0, react.useMemo)(() => {
+		if (editMcp !== void 0) return t("confirmRemoveMcp", { name: editMcp.serverName });
+		if (editSkill === void 0) return "";
+		return editSkill.linked ? t("confirmRemoveSkillLink", { name: skillLabel }) : t("confirmRemoveSkillDir", { name: skillLabel });
+	}, [
+		editMcp,
+		editSkill,
+		skillLabel,
+		t
+	]);
+	/** Saving needs a confirmation only when it would delete a real directory. */
+	const needsSaveConfirm = editSkill !== void 0 && !editSkill.linked;
+	/** The action row, or the confirmation step that has replaced it. */
+	const renderActions = (onSubmit) => confirm !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "lm-confirm",
+		role: "alert",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			className: "lm-confirm-msg",
+			children: confirm === "save" ? t("saveConfirmRealDir", { name: skillLabel }) : removalWarning
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "lm-confirm-actions",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "lm-btn",
+				disabled: busy,
+				onClick: () => setConfirm(null),
+				children: t("cancel")
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "lm-btn lm-btn--danger",
+				disabled: busy,
+				onClick: () => {
+					if (confirm === "save") onSubmit();
+					else remove();
+				},
+				children: confirm === "save" ? t("confirmSaveAnyway") : t("confirmRemove")
+			})]
+		})]
+	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "lm-actions",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+			type: "button",
+			className: "lm-btn",
+			disabled: busy,
+			onClick: () => {
+				if (needsSaveConfirm) setConfirm("save");
+				else onSubmit();
+			},
+			children: editing ? t("save") : t("register")
+		}), editing && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+			type: "button",
+			className: "lm-btn lm-btn--danger",
+			disabled: busy,
+			onClick: () => setConfirm("remove"),
+			children: t("remove")
+		})]
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "mc-preview-mask",
+		onClick: onClose,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "mc-preview",
+			onClick: (e) => e.stopPropagation(),
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "mc-preview-head",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "mc-preview-title",
+						children: title
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "mc-preview-close",
+						onClick: onClose,
+						children: t("previewClose")
+					})]
+				}),
+				!editing && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "mc-subtabs mc-catalog-tabs",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "mc-tab-group",
+						role: "tablist",
+						"aria-label": t("registerCapability"),
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							role: "tab",
+							className: "mc-tab",
+							"aria-selected": subTab === "mcp",
+							"data-active": subTab === "mcp" ? "true" : void 0,
+							onClick: () => setSubTab("mcp"),
+							children: t("mcpServers")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							role: "tab",
+							className: "mc-tab",
+							"aria-selected": subTab === "skill",
+							"data-active": subTab === "skill" ? "true" : void 0,
+							onClick: () => setSubTab("skill"),
+							children: t("skillDirs")
+						})]
+					})
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "lm-body",
+					children: [error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "lm-error",
+						children: error
+					}), subTab === "mcp" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "lm-block",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "lm-form",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("transport")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+											className: "lm-input",
+											value: transport,
+											onChange: (e) => setTransport(e.target.value === "stdio" ? "stdio" : "streamable-http"),
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+												value: "stdio",
+												children: t("transportStdio")
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+												value: "streamable-http",
+												children: t("transportHttp")
+											})]
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "lm-hint",
+											children: transport === "stdio" ? t("transportHintStdio") : t("transportHintHttp")
+										})
+									]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("serverName")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "lm-input",
+											value: serverName,
+											disabled: editMcp !== void 0,
+											onChange: (e) => setServerName(e.target.value)
+										}),
+										editMcp !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "lm-hint",
+											children: t("serverNameImmutable")
+										})
+									]
+								}),
+								transport === "stdio" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "lm-field",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("command")
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "lm-input",
+											value: command,
+											onChange: (e) => setCommand(e.target.value)
+										})]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "lm-field",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("args")
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "lm-input",
+											value: args,
+											onChange: (e) => setArgs(e.target.value)
+										})]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "lm-field",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("cwd")
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "lm-input",
+											value: cwd,
+											onChange: (e) => setCwd(e.target.value)
+										})]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "lm-field",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("env")
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
+											className: "lm-input",
+											rows: 3,
+											value: env,
+											onChange: (e) => setEnv(e.target.value)
+										})]
+									})
+								] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "lm-label",
+										children: t("url")
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										className: "lm-input",
+										value: url,
+										onChange: (e) => setUrl(e.target.value)
+									})]
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("headers")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
+											className: "lm-input",
+											rows: 4,
+											value: headers,
+											onChange: (e) => setHeaders(e.target.value)
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "lm-hint",
+											children: t("headersHint")
+										})
+									]
+								})] }),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "lm-label",
+										children: t("timeout")
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										className: "lm-input",
+										value: timeoutSec,
+										placeholder: "60",
+										onChange: (e) => setTimeoutSec(e.target.value)
+									})]
+								}),
+								renderActions(() => void submitMcp())
+							]
+						})
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "lm-block",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "lm-form",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("skillRoot")
+										}),
+										editSkill !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "lm-input",
+											value: t(editSkill.root === "project" ? "skillRootProject" : "skillRootUser"),
+											disabled: true
+										}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+											className: "lm-input",
+											value: skillRoot,
+											onChange: (e) => setSkillRoot(e.target.value === "project" ? "project" : "user"),
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+												value: "user",
+												children: t("skillRootUser")
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+												value: "project",
+												children: t("skillRootProject")
+											})]
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "lm-hint",
+											children: skillRoot === "project" || editSkill?.root === "project" ? t("skillRootHintProject") : t("skillRootHintUser")
+										})
+									]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("skillDirPath")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "lm-input",
+											value: skillDir,
+											onChange: (e) => setSkillDir(e.target.value)
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "lm-hint",
+											children: t("skillDirHint")
+										})
+									]
+								}),
+								editSkill === void 0 && skillRoot === "project" && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "lm-field",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "lm-label",
+											children: t("skillProjectPath")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "lm-input",
+											value: projectPath,
+											onChange: (e) => setProjectPath(e.target.value)
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											className: "lm-hint",
+											children: t("skillProjectPathHint")
+										})
+									]
+								}),
+								renderActions(() => void submitSkill())
+							]
+						})
+					})]
+				})
+			]
+		})
+	});
+}
+/**
+* dsh's source labels for a project's own skill roots — the `project`-prefixed
+* providers of `@deepseek-ai/dsh-skill-filesystem`, which scan
+* `<projectRoot>/.dsh/skills` and `<projectRoot>/.agents/skills`. Every other
+* label (`user-dsh`, `user-agents`, `bundled`, `custom`, `runtime`) is a
+* user-level root. Shared so the server's location manager and the browser's
+* 全局 / 项目 grouping agree on what "project scoped" means.
+*/
+const PROJECT_SKILL_SOURCES = /* @__PURE__ */ new Set(["project-dsh", "project-agents"]);
+/**
+* Source labels for user-level skill roots whose entries this plugin can adopt:
+* linking the skill's own directory into the user root (where the entry becomes
+* editable) without touching its content. `user-dsh` is excluded because that
+* root is already managed, and `bundled` because a packaged skill should not be
+* shadowed by a user copy.
+*/
+const ADOPTABLE_SKILL_SOURCES = /* @__PURE__ */ new Set(["user-agents", "custom"]);
+//#endregion
+//#region src/client/skillGroups.ts
+/**
+* What the capability list decides about *which* rows it shows, kept out of
+* `CapabilitySection.tsx` as pure functions.
+*
+* The split is deliberate: the grouping rules are where this plugin got its one
+* real mis-grouping (preset skills filed under 全局技能), and they are also the
+* only part of the client a test can reach — this repo has no DOM harness, so
+* anything that lives inside the component can only be checked by hand.
+*/
+/** Group tools by server name; skills stay flat (no server), both name-sorted. */
+function groupRows(rows) {
+	const byServer = /* @__PURE__ */ new Map();
+	const skills = [];
+	for (const row of rows) {
+		if (row.kind === "skill") {
+			skills.push(row);
+			continue;
+		}
+		const server = row.server ?? "built-in";
+		const list = byServer.get(server);
+		if (list === void 0) byServer.set(server, [row]);
+		else list.push(row);
+	}
+	return {
+		servers: [...byServer.entries()].map(([server, tools]) => ({
+			server,
+			tools: [...tools].sort((a, b) => a.name.localeCompare(b.name))
+		})).sort((a, b) => a.server.localeCompare(b.server)),
+		skills: [...skills].sort((a, b) => a.name.localeCompare(b.name))
+	};
+}
+/**
+* Compile the box. A `/…/` wrapper is optional — it is stripped when present, so
+* both `cordis|ptc` and `/cordis|ptc/` are read as patterns — and it keeps the
+* common case of pasting a slash-delimited pattern from working.
+*/
+function compileNameFilter(input) {
+	const raw = input.trim();
+	const needle = raw.toLowerCase();
+	if (raw === "") return {
+		needle,
+		regex: false,
+		test: () => true
+	};
+	const pattern = raw.length > 1 && raw.startsWith("/") && raw.endsWith("/") ? raw.slice(1, -1) : raw;
+	try {
+		const compiled = new RegExp(pattern, "i");
+		return {
+			needle,
+			regex: true,
+			test: (values) => values.some((v) => v !== void 0 && compiled.test(v))
+		};
+	} catch {
+		return {
+			needle,
+			regex: false,
+			test: (values) => values.some((v) => v !== void 0 && v.toLowerCase().includes(needle))
+		};
+	}
+}
+/**
+* Everything a row is matched against: its own name, plus the dimensions that
+* name the group it sits in — the MCP server (or the label the built-in group is
+* drawn with), the skill's source root, and the preset that ships it.
+*
+* Group headings are labels rather than row fields, which is exactly why typing
+* 系统 used to find nothing: the server id is `built-in`, and 系统内置 is only how
+* that id is painted. Both spellings are searchable now.
+*/
+function searchableText(row, labels = {}) {
+	const values = [row.name];
+	if (row.server !== void 0) {
+		values.push(row.server);
+		if (row.server === "built-in") values.push(labels.builtIn);
+	}
+	if (row.source !== void 0) values.push(row.source, labels.source?.(row.source));
+	values.push(row.preset);
+	return values.filter((v) => v !== void 0 && v !== "");
+}
+/**
+* Narrow a list by the filter. Applied *before* grouping so a server header's
+* own counts describe the rows actually listed under it.
+*/
+function filterRows(rows, filter, labels = {}) {
+	if (filter.needle === "") return [...rows];
+	return rows.filter((row) => filter.test(searchableText(row, labels)));
+}
+/**
+* Split skill rows across the three sub-tabs.
+*
+* Preset skills are split off by their `preset` field and never by `source`: a
+* preset's own `skill-filesystem` labels its skills `custom`, exactly like a
+* user-configured `customSkillDirs` entry, so a source-based rule drags both
+* into 全局技能 — filing a preset asset as global is precisely the mis-grouping
+* this split exists to fix. Rows keep the order they arrive in, so callers that
+* pass name-sorted rows get name-sorted groups.
+*/
+function splitSkillGroups(skills) {
+	const presetSkills = [];
+	const projectSkills = [];
+	const globalSkills = [];
+	const presetGroups = [];
+	for (const skill of skills) {
+		const preset = skill.preset;
+		if (preset !== void 0) {
+			presetSkills.push(skill);
+			const group = presetGroups.find(([id]) => id === preset);
+			if (group === void 0) presetGroups.push([preset, [skill]]);
+			else group[1].push(skill);
+			continue;
 		}
-	]
-};
+		if (PROJECT_SKILL_SOURCES.has(skill.source ?? "")) projectSkills.push(skill);
+		else globalSkills.push(skill);
+	}
+	presetGroups.sort(([a], [b]) => a.localeCompare(b));
+	return {
+		presetSkills,
+		presetGroups,
+		projectSkills,
+		globalSkills
+	};
+}
+/**
+* The sub-tab the Skills panel actually shows: the requested one, unless it is
+* 预设技能 while no preset ships skills. That tab does not exist then, and a
+* selection left on it must not survive — deployed presets are re-scanned on
+* every refresh, so the tab can disappear under the operator.
+*/
+function resolveSkillTab(selected, groups) {
+	return selected === "preset" && groups.presetSkills.length === 0 ? "global" : selected;
+}
+/** Rows in one tier. Counts the *displayed* rows, not the whole catalog. */
+function countByClass(rows, cls) {
+	return rows.reduce((n, row) => row.class === cls ? n + 1 : n, 0);
+}
 //#endregion
-//#region src/client/store.ts
-/** Unwrap a RemoteResult-like, throwing a readable error on failure. */
-function unwrap(result, what) {
-	if (!result.ok) throw new Error(`${what} failed: ${result.error.code}: ${result.error.message}`);
-	return result.value;
+//#region src/client/revalidate.ts
+/**
+* When to re-read the catalog, and how often to look — the decisions behind the
+* management page keeping itself fresh, kept as pure functions.
+*
+* Wiring lives in `CapabilitySection.tsx` (timers, the `visibilitychange`
+* listener, the two subscriptions); everything that could be got wrong lives
+* here, where a test can reach it. This repo has no DOM harness.
+*/
+/**
+* How often a visible, idle page asks the host for its catalog version.
+*
+* This is the resolution of the one case nothing on the wire announces — a file
+* dropped into an already-registered skill directory — so it doubles as "how
+* long will I stare at a stale list after an agent changes something next to
+* me". 5s keeps that from being annoying; the cost is one tiny request per tick,
+* and only while this settings page is on screen.
+*/
+const POLL_INTERVAL_MS = 5e3;
+/** Ceiling for the failure backoff, so a long outage does not spin. */
+const POLL_BACKOFF_MAX_MS = 6e4;
+/**
+* How long one version sample may take before it is treated as a failure.
+*
+* Without this, a request that neither resolves nor rejects would end the poll
+* for good: the next tick is only scheduled after the current one settles, and
+* nothing else restarts the effect while the page stays visible and idle.
+*/
+const POLL_SAMPLE_TIMEOUT_MS = 15e3;
+/**
+* Delay before the next version poll.
+*
+* `failures` is the run of consecutive failures ending at this decision: 0
+* means the last sample succeeded and the plain interval applies, otherwise the
+* delay doubles until it hits the ceiling. This is what turns "the carrier
+* died" from a hot loop into a slow retry that heals itself when it comes back.
+*/
+function pollDelayMs(failures) {
+	if (!Number.isFinite(failures) || failures <= 0) return POLL_INTERVAL_MS;
+	return Math.min(POLL_INTERVAL_MS * 2 ** failures, POLL_BACKOFF_MAX_MS);
 }
-/** Load the classification list from the remote. */
-async function loadSnapshot(remote) {
-	return { rows: unwrap(await remote.classifyAll(), "capabilityPolicy.classifyAll") };
+/**
+* Whether a version sample means the catalog moved under the page.
+*
+* Deliberately `!==` rather than `>`: the counter is in-process, so it restarts
+* from zero when the plugin reloads, and a plain "greater than" test would sit
+* there believing a fresh host was the same host. `undefined` (nothing sampled
+* yet) only records — the page has just read the snapshot, and re-reading it
+* because it has no baseline would be busywork.
+*/
+function versionChanged(seen, current) {
+	return seen !== void 0 && seen !== current;
+}
+/**
+* The value of `work`, or a rejection if it has not settled within `ms`.
+*
+* Used so a carrier that accepts a request and then goes quiet degrades into
+* the same retry path as a carrier that refuses one.
+*/
+function withDeadline(work, ms) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`timed out after ${ms}ms`)), ms);
+		work.then((value) => {
+			clearTimeout(timer);
+			resolve(value);
+		}, (error) => {
+			clearTimeout(timer);
+			reject(error);
+		});
+	});
+}
+/** Whether a signal may act now, or has to be parked until the page is idle. */
+function canRevalidate(gate) {
+	return gate.visible && gate.ready && !gate.busy && !gate.rebuilding;
 }
 //#endregion
 //#region src/client/CapabilitySection.tsx
 /**
 * ⚠️ VERIFIED AGAINST REAL rc.8 CLIENT API.
 *
-* React section for the 能力管理 settings tab. Follows the real dsh client
+* React section for the 能力菜单 settings tab. Follows the real dsh client
 * pattern (see `dsh-client-ui-settings-plugins`): two tabs (工具 / Skills)
 * under one heading, each listing capabilities with a clickable class chip.
 *
@@ -5482,9 +6638,15 @@ const CSS = `
 .mc-section{display:flex;flex-direction:column;gap:12px;color:var(--dsw-alias-label-primary)}
 .mc-heading{margin:0;font-size:18px;font-weight:600}
 .mc-desc{margin:0;color:var(--dsw-alias-label-tertiary);font-size:13px}
+/* 说明行右侧放只读文档入口：把它从头部的计数行挪出来，计数多（Tools 常驻 ·
+   167）时那一行不再因此折行。 */
+.mc-desc-row{display:flex;align-items:center;justify-content:space-between;gap:12px}
+.mc-desc-row .mc-desc{flex:1 1 auto;min-width:0}
 .mc-summary{display:flex;gap:12px;flex-wrap:wrap;justify-content:flex-end;align-items:center;padding-bottom:8px}
 .mc-catalog-btn{border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);font:inherit;font-size:12px;line-height:20px;padding:0 10px;cursor:pointer;white-space:nowrap}
 .mc-catalog-btn:hover{border-color:var(--dsw-alias-border-l3);background:var(--dsw-alias-interactive-bg-hover)}
+/* 忙碌态靠变淡表示，而不是换文案：换文案会改按钮宽度，把这行挤到第二行。 */
+.mc-catalog-btn:disabled{cursor:default;opacity:.6}
 .mc-catalog-tabs{padding:8px 16px 0}
 .mc-catalog-path{padding:8px 16px 0;margin:0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary);word-break:break-all}
 .mc-chip{display:inline-flex;align-items:center;gap:6px;font-size:12px;line-height:20px;white-space:nowrap}
@@ -5508,6 +6670,15 @@ body[data-ds-dark-theme] .mc-chip--resident{color:#96b6d1}
 body[data-ds-dark-theme] .mc-chip--on-demand{color:#d4b26b}
 body[data-ds-dark-theme] .mc-chip--disabled{color:#b8abad}
 .mc-tabs{border-bottom:1px solid var(--dsw-alias-border-l2);display:flex;align-items:flex-end;justify-content:space-between;gap:22px}
+/* 名字过滤框：两个 tab 共用一条，宽度占满，与下方列表左对齐。
+   它属于上面的主 tab 栏，不属于下面的列表，所以两侧都把 .mc-section 的 12px
+   栏距收掉一部分：下划线—6px—输入框—8px—全局/项目 子页签文字（后者里的 4px
+   是子页签自己的 padding-top）。改之前是 12+12=24px 和 12+4=16px，读起来像
+   两个不相干的块。 */
+.mc-filter{display:flex;padding-top:0;margin-top:-6px;margin-bottom:-8px}
+.mc-filter input{box-sizing:border-box;width:100%;min-width:0;padding:6px 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-1);color:inherit;font:inherit;font-size:13px;line-height:18px}
+.mc-filter input:hover{border-color:var(--dsw-alias-border-l3)}
+.mc-filter input:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:1px;border-color:transparent}
 /* Skills sub-tab bar (全局技能/项目技能): same underline chrome, no right-side summary. */
 .mc-subtabs{border-bottom:1px solid var(--dsw-alias-border-l2);display:flex;align-items:flex-end;gap:22px}
 .mc-tab-group{display:flex;align-items:flex-end;gap:22px}
@@ -5515,7 +6686,19 @@ body[data-ds-dark-theme] .mc-chip--disabled{color:#b8abad}
 .mc-tab:hover,.mc-tab[data-active=true]{color:var(--dsw-alias-label-primary)}
 .mc-tab[data-active=true]:after,.mc-tab:focus-visible:after{background:var(--dsw-alias-label-primary);content:"";border-radius:2px 2px 0 0;height:2px;position:absolute;bottom:-1px;left:0;right:0}
 .mc-tab:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px;color:var(--dsw-alias-label-primary);border-radius:2px}
-.mc-panel{min-width:0;padding-top:12px}
+/* 面板的第一行必须和另一个 tab 的第一行从过滤框下沿出发走同样远，否则切 tab 时
+   首行会跳一下。这里留 4px，加上 .mc-section 的 4px 栏距（过滤框那侧被 -8px 收
+   掉后剩 4px）= 8px，正好是 Skills 面板子页签文字的位置（4px 栏距 + 子页签自己
+   的 4px padding-top）。原来这里是 12px，Tools 的首个分组因此落在过滤框下 16px
+   处，比「全局技能」那行低一半。 */
+.mc-panel{min-width:0;padding-top:4px}
+/* Skills panel: its first row is the 全局技能/项目技能 sub-tab bar, and that bar
+   belongs to the header stack above it (rule → name filter → sub-tabs) rather
+   than to the list below. So the panel adds no padding of its own, and the
+   sub-tab labels keep a 4px top padding instead of the 7px they share with the
+   primary tabs. */
+.mc-panel--tight{padding-top:0}
+.mc-panel--tight .mc-subtabs .mc-tab{padding-top:4px}
 .mc-panel-inner{display:flex;flex-direction:column;gap:14px}
 .mc-group{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;overflow:hidden}
 .mc-group-header{box-sizing:border-box;display:flex;align-items:center;gap:10px;width:100%;min-width:0;padding:10px 12px;background:var(--dsw-alias-bg-layer-1);border:0;color:inherit;font:inherit;text-align:left;cursor:pointer}
@@ -5536,6 +6719,11 @@ body[data-ds-dark-theme] .mc-chip--disabled{color:#b8abad}
 body[data-ds-dark-theme] .mc-count--resident{color:#96b6d1}
 body[data-ds-dark-theme] .mc-count--on-demand{color:#d4b26b}
 body[data-ds-dark-theme] .mc-count--disabled{color:#b8abad}
+/* 「编辑」是动作，不是分类计数：沿用 chip 的尺寸以对齐，但用次要文字色、hover
+   才变蓝加下划线。裸用 .mc-count 时会继承 .mc-section 的 label-primary（浅色
+   主题下近黑），夹在着色的计数 chip 旁会读成一枚没有圆点的黑色 chip。 */
+.mc-count--action{color:var(--dsw-alias-label-secondary)}
+.mc-count--action:hover{color:var(--dsw-alias-state-business-primary);text-decoration:underline}
 .mc-tools{border-top:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-base)}
 .mc-tool{display:flex;align-items:center;gap:10px;padding:7px 12px 7px 26px;font-size:13px;line-height:20px;cursor:pointer}
 .mc-tool:hover{background:var(--dsw-alias-interactive-bg-hover)}
@@ -5547,14 +6735,30 @@ body[data-ds-dark-theme] .mc-count--disabled{color:#b8abad}
 .mc-tag{font-size:11px;line-height:18px;padding:0 8px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-tertiary)}
 .mc-empty{padding:16px;text-align:center;font-size:13px;color:var(--dsw-alias-label-tertiary);border:1px dashed var(--dsw-alias-border-l2);border-radius:8px}
 .mc-error{padding:12px;border:1px solid var(--dsw-alias-state-error-primary);border-radius:8px;color:var(--dsw-alias-state-error-primary);font-size:13px}
-.mc-error pre{margin:8px 0 0;white-space:pre-wrap;word-break:break-all;font-size:11px;color:var(--dsw-alias-label-tertiary)}
+.mc-error p{margin:0}
+.mc-error p.mc-error-hint{margin-top:8px;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}
+.mc-error-actions{display:flex;justify-content:flex-end;margin-top:10px}
 .mc-notice{padding:10px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;color:var(--dsw-alias-label-secondary);font-size:13px}
 .mc-skill{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;overflow:hidden;background:var(--dsw-alias-bg-layer-1)}
 .mc-skill-row{box-sizing:border-box;display:flex;align-items:center;gap:10px;width:100%;min-width:0;padding:10px 12px;background:0 0;border:0;color:inherit;font:inherit;text-align:left;cursor:pointer}
 .mc-skill-row:hover{background:var(--dsw-alias-interactive-bg-hover)}
 .mc-skill-name{font-weight:600;font-size:14px;line-height:20px;flex:1 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .mc-skill-meta{margin-left:auto;display:flex;align-items:center;gap:8px;flex:0 1 auto;min-width:0}
+/* A row has no room for prose: let a long source label truncate instead of
+   pushing the row's buttons past the right edge. */
+.mc-source{font-size:11px;line-height:18px;color:var(--dsw-alias-label-caption);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;min-width:0;flex:0 1 auto}
+/* One sentence to confirm a row action: the shared modal chrome, sized down. */
+.mc-confirm-dialog{width:min(420px,calc(100vw - 48px))}
+.mc-confirm-body{display:flex;flex-direction:column;gap:12px;padding:14px 16px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary)}
+.mc-confirm-body p{margin:0}
+/* A directory has no spaces to break at, and the modal is where it can show in
+   full: wrap it instead of truncating it the way a row's 来源 slot must. */
+.mc-confirm-path{font-family:var(--dsw-font-markdown-code-block-font-family);word-break:break-all}
+.mc-confirm-actions{display:flex;justify-content:flex-end;gap:8px}
 .mc-skill-body{border-top:1px solid var(--dsw-alias-border-l1);padding:8px 12px 12px}
+/* 预设技能组：预设 id 是页签之下的分组小标题，不是新一级页签。 */
+.mc-skill-group{display:flex;flex-direction:column;gap:8px;min-width:0}
+.mc-skill-group-title{font-size:12px;line-height:18px;font-weight:600;color:var(--dsw-alias-label-secondary);padding:0 2px}
 .mc-tree{display:flex;flex-direction:column;gap:2px;font-size:13px;line-height:20px}
 .mc-tree-row{display:flex;align-items:center;gap:8px;padding:3px 4px;border-radius:6px;cursor:pointer;min-width:0}
 .mc-tree-row:hover{background:var(--dsw-alias-interactive-bg-hover)}
@@ -5577,37 +6781,54 @@ if (typeof document !== "undefined" && document.querySelector(`style[data-css-id
 	tag.textContent = CSS;
 	document.head.appendChild(tag);
 }
-/** The reserved server key grouping harness-native (non-MCP) tools. */
-const BUILT_IN_SERVER = "built-in";
-/** Skills whose source root lives inside the current project. */
-const PROJECT_SOURCES = /* @__PURE__ */ new Set(["project-dsh", "project-agents"]);
-function groupRows(rows) {
-	const byServer = /* @__PURE__ */ new Map();
-	const skills = [];
-	for (const row of rows) {
-		if (row.kind === "skill") {
-			skills.push(row);
-			continue;
-		}
-		const server = row.server ?? BUILT_IN_SERVER;
-		const list = byServer.get(server);
-		if (list === void 0) byServer.set(server, [row]);
-		else list.push(row);
-	}
-	return {
-		servers: [...byServer.entries()].map(([server, tools]) => ({
-			server,
-			tools: [...tools].sort((a, b) => a.name.localeCompare(b.name))
-		})).sort((a, b) => a.server.localeCompare(b.server)),
-		skills: [...skills].sort((a, b) => a.name.localeCompare(b.name))
-	};
+/**
+* dsh's skill source labels, shown on rows this plugin cannot edit — so "why is
+* there no 编辑 button" has a visible answer. Labels that name one directory are
+* shown as that path; the rest name a category and go through the dictionary, so
+* none of dsh's internal labels (`custom`, `bundled`, …) reach the operator raw.
+*/
+const SOURCE_PATHS = {
+	"user-dsh": "~/.dsh/skills",
+	"user-agents": "~/.agents/skills",
+	"project-dsh": "<project>/.dsh/skills",
+	"project-agents": "<project>/.agents/skills"
+};
+/** Source labels that name no single directory; shown via `t`. */
+const SOURCE_LABEL_KEYS = {
+	"custom": "sourceCustom",
+	"bundled": "sourceBundled"
+};
+/** How to name a skill's source root on a row we cannot manage. */
+function sourceLabel(source, t) {
+	if (source === void 0) return t("skillUnmanaged");
+	const path = SOURCE_PATHS[source];
+	if (path !== void 0) return path;
+	const key = SOURCE_LABEL_KEYS[source];
+	return key === void 0 ? source : t(key);
 }
-function countByClass(rows, cls) {
-	return rows.reduce((n, row) => row.class === cls ? n + 1 : n, 0);
+/**
+* Whether the document is visible. A hidden settings tab does no polling and
+* takes no re-reads; coming back is itself a revalidation trigger.
+*/
+function useDocumentVisible() {
+	const [visible, setVisible] = (0, react.useState)(true);
+	(0, react.useEffect)(() => {
+		const update = () => setVisible(document.visibilityState !== "hidden");
+		update();
+		document.addEventListener("visibilitychange", update);
+		return () => document.removeEventListener("visibilitychange", update);
+	}, []);
+	return visible;
 }
 function CapabilitySection(props) {
-	const { remote, t, mountError, remoteKeys } = props;
-	const [state, setState] = (0, react.useState)({ status: "loading" });
+	const { remote, t, mountError, subscribeSignals } = props;
+	const [state, setState] = (0, react.useState)(() => {
+		const cached = cachedSnapshot();
+		return cached === void 0 ? { status: "loading" } : {
+			status: "ready",
+			snapshot: cached
+		};
+	});
 	const [busy, setBusy] = (0, react.useState)(false);
 	const [notice, setNotice] = (0, react.useState)(null);
 	const [openServers, setOpenServers] = (0, react.useState)(/* @__PURE__ */ new Set());
@@ -5626,15 +6847,41 @@ function CapabilitySection(props) {
 				snapshot
 			})));
 		} catch (e) {
-			setState({
+			setState((prev) => prev.status === "ready" ? prev : {
 				status: "error",
 				message: String(e)
 			});
+			setNotice(String(e));
 		}
 	}, [remote, mountError]);
 	(0, react.useEffect)(() => {
 		reload();
 	}, [reload]);
+	const [refreshing, setRefreshing] = (0, react.useState)(false);
+	/**
+	* Rebuild the host catalog, then re-read the classification list. Used after
+	* registering a new source so the list reflects it without waiting for the
+	* scheduler's debounce window.
+	*/
+	const refreshCatalog = (0, react.useCallback)(async () => {
+		if (refreshing) return;
+		setRefreshing(true);
+		try {
+			if (remote !== void 0) unwrap(await remote.refresh(), "capabilityPolicy.refresh");
+			await reload();
+			setNotice(null);
+		} catch (e) {
+			console.error("[capability-menu] refresh failed:", e);
+			setNotice(t("refreshFailed"));
+		} finally {
+			setRefreshing(false);
+		}
+	}, [
+		refreshing,
+		remote,
+		reload,
+		t
+	]);
 	const toggleServer = (0, react.useCallback)((server) => {
 		setOpenServers((prev) => {
 			const next = new Set(prev);
@@ -5643,10 +6890,99 @@ function CapabilitySection(props) {
 			return next;
 		});
 	}, []);
+	const visible = useDocumentVisible();
+	const [pendingSignal, setPendingSignal] = (0, react.useState)(false);
+	const seenVersion = (0, react.useRef)(void 0);
+	const pollFailures = (0, react.useRef)(0);
+	const gate = (0, react.useRef)({
+		visible: true,
+		ready: false,
+		busy: false,
+		rebuilding: false
+	});
+	(0, react.useEffect)(() => {
+		gate.current = {
+			visible,
+			ready: state.status === "ready",
+			busy,
+			rebuilding: refreshing
+		};
+	});
+	/**
+	* A signal that the host catalog may have moved. Runs now when the page is
+	* idle; otherwise parks until it is, so a signal that lands mid-click is
+	* never dropped (and never repaints the row under the cursor).
+	*/
+	const onExternalSignal = (0, react.useCallback)(() => {
+		if (canRevalidate(gate.current)) refreshCatalog();
+		else setPendingSignal(true);
+	}, [refreshCatalog]);
+	(0, react.useEffect)(() => {
+		return subscribeSignals?.(onExternalSignal);
+	}, [subscribeSignals, onExternalSignal]);
+	(0, react.useEffect)(() => {
+		if (!pendingSignal) return;
+		if (!canRevalidate({
+			visible,
+			ready: state.status === "ready",
+			busy,
+			rebuilding: refreshing
+		})) return;
+		setPendingSignal(false);
+		refreshCatalog();
+	}, [
+		pendingSignal,
+		visible,
+		state.status,
+		busy,
+		refreshing,
+		refreshCatalog
+	]);
+	(0, react.useEffect)(() => {
+		if (!visible || state.status !== "ready" || busy || refreshing) return;
+		let stopped = false;
+		let timer;
+		const tick = async () => {
+			try {
+				const version = unwrap(await withDeadline(remote.catalogVersion(), POLL_SAMPLE_TIMEOUT_MS), "capabilityPolicy.catalogVersion");
+				pollFailures.current = 0;
+				if (versionChanged(seenVersion.current, version)) {
+					seenVersion.current = version;
+					await reload();
+				}
+			} catch {
+				pollFailures.current += 1;
+			}
+			if (!stopped) timer = setTimeout(() => void tick(), pollDelayMs(pollFailures.current));
+		};
+		timer = setTimeout(() => void tick(), 0);
+		return () => {
+			stopped = true;
+			if (timer !== void 0) clearTimeout(timer);
+		};
+	}, [
+		visible,
+		state.status,
+		busy,
+		refreshing,
+		remote,
+		reload
+	]);
 	/** Move one or more capability ids to the next class in the click cycle. */
 	const cycleClass = (0, react.useCallback)(async (ids, kind) => {
 		if (ids.length === 0 || busy) return;
 		setBusy(true);
+		const from = ids.map((id) => state.status === "ready" ? state.snapshot.rows.find((r) => r.id === id)?.class : void 0).find((c) => c !== void 0) ?? "on-demand";
+		const to = NEXT_CLASS[from];
+		const moved = new Set(ids);
+		setState((prev) => prev.status === "ready" ? {
+			status: "ready",
+			snapshot: { rows: prev.snapshot.rows.map((row) => moved.has(row.id) ? {
+				...row,
+				class: to,
+				classLabel: void 0
+			} : row) }
+		} : prev);
 		try {
 			const config = unwrap(await remote.getConfig(), "capabilityPolicy.getConfig");
 			const key = kind === "skill" ? "skills" : "tools";
@@ -5660,13 +6996,11 @@ function CapabilitySection(props) {
 				const raw = set && typeof set === "object" && !Array.isArray(set) ? set[cls] : void 0;
 				lists[cls] = Array.isArray(raw) ? raw.filter((x) => typeof x === "string") : [];
 			}
-			const from = ids.map((id) => state.status === "ready" ? state.snapshot.rows.find((r) => r.id === id)?.class : void 0).find((c) => c !== void 0) ?? "on-demand";
-			const to = NEXT_CLASS[from];
 			for (const cls of CLASS_KEYS) lists[cls] = lists[cls].filter((id) => !ids.includes(id));
 			lists[to] = [...lists[to], ...ids];
 			const nextLists = {};
 			for (const cls of CLASS_KEYS) nextLists[cls] = lists[cls];
-			await remote.updateConfig({ [key]: nextLists });
+			unwrap(await remote.updateConfig({ [key]: nextLists }), "capabilityPolicy.updateConfig");
 			const next = await loadSnapshot(remote);
 			setState({
 				status: "ready",
@@ -5697,7 +7031,22 @@ function CapabilitySection(props) {
 			}),
 			state.status === "error" && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "mc-error",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: state.message }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", { children: `mountError=${String(mountError)}\nremoteKeys=${String(remoteKeys)}` })]
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: state.message }),
+					state.message.includes("Failed to fetch") && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "mc-error-hint",
+						children: t("carrierFailureHint")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "mc-error-actions",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							className: "mc-catalog-btn",
+							onClick: () => void reload(),
+							children: t("retry")
+						})
+					})
+				]
 			}),
 			notice !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "mc-notice",
@@ -5712,18 +7061,33 @@ function CapabilitySection(props) {
 				t,
 				onTabChange: setActiveTab,
 				onToggleServer: toggleServer,
-				onCycle: cycleClass
+				onCycle: cycleClass,
+				onRefresh: () => void refreshCatalog(),
+				onNotice: setNotice
 			})
 		]
 	});
 }
 function ReadyBody(props) {
-	const { remote, snapshot, openServers, busy, activeTab, t, onTabChange, onToggleServer, onCycle } = props;
-	const { servers, skills } = groupRows(snapshot.rows);
-	const projectSkills = skills.filter((skill) => PROJECT_SOURCES.has(skill.source ?? ""));
-	const globalSkills = skills.filter((skill) => !PROJECT_SOURCES.has(skill.source ?? ""));
+	const { remote, snapshot, openServers, busy, activeTab, t, onTabChange, onToggleServer, onCycle, onRefresh, onNotice } = props;
+	/** Name filter, shared by both tabs: it narrows whichever list is shown. */
+	const [filter, setFilter] = (0, react.useState)("");
+	const nameFilter = compileNameFilter(filter);
+	const needle = nameFilter.needle;
+	const shownRows = filterRows(snapshot.rows, nameFilter, {
+		builtIn: t("builtInGroup"),
+		source: (source) => sourceLabel(source, t)
+	});
+	const { servers, skills } = groupRows(shownRows);
+	const { presetSkills, presetGroups, projectSkills, globalSkills } = splitSkillGroups(skills);
 	const [skillTab, setSkillTab] = (0, react.useState)("global");
-	const statRows = activeTab === "tools" ? snapshot.rows.filter((r) => r.kind === "tool") : skillTab === "project" ? projectSkills : globalSkills;
+	const activeSkillTab = resolveSkillTab(skillTab, {
+		presetSkills,
+		presetGroups,
+		projectSkills,
+		globalSkills
+	});
+	const statRows = activeTab === "tools" ? shownRows.filter((r) => r.kind === "tool") : activeSkillTab === "project" ? projectSkills : activeSkillTab === "preset" ? presetSkills : globalSkills;
 	const summary = CLASS_KEYS.map((cls) => ({
 		cls,
 		count: countByClass(statRows, cls)
@@ -5758,6 +7122,93 @@ function ReadyBody(props) {
 	/** 能力目录弹层状态：查看三档策略配置 + 按需能力目录文件。 */
 	const [catalogDocs, setCatalogDocs] = (0, react.useState)(null);
 	const [catalogTab, setCatalogTab] = (0, react.useState)("policy");
+	/** 注册能力 modal; its default sub-tab follows `activeTab`. */
+	const [registerOpen, setRegisterOpen] = (0, react.useState)(false);
+	/** 编辑 target; at most one is set. */
+	const [editMcp, setEditMcp] = (0, react.useState)(void 0);
+	const [editSkill, setEditSkill] = (0, react.useState)(void 0);
+	/**
+	* Skill directories registered under the skill root. Only those can be
+	* edited: a project or bundled skill has no row to repoint, so its row gets
+	* no 编辑 button rather than a button that always fails.
+	*/
+	const [editableSkills, setEditableSkills] = (0, react.useState)(/* @__PURE__ */ new Set());
+	const skillSignature = skills.map((skill) => `${skill.id}\u0000${skill.source ?? ""}`).join("
");
+	(0, react.useEffect)(() => {
+		let cancelled = false;
+		(async () => {
+			try {
+				const rows = unwrap(await remote.listSkillLocations(), "capabilityPolicy.listSkillLocations");
+				if (!cancelled) setEditableSkills(new Set(rows.map((row) => row.skillName ?? row.name)));
+			} catch {}
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, [remote, skillSignature]);
+	/** Open the 编辑 form for the MCP server behind a Tools-tab group header. */
+	const openMcpEdit = (0, react.useCallback)(async (serverName) => {
+		try {
+			const found = unwrap(await remote.listLocations(), "capabilityPolicy.listLocations").find((row) => row.serverName === serverName);
+			if (found === void 0) {
+				onNotice(t("notEditable"));
+				return;
+			}
+			setEditMcp(found);
+		} catch (e) {
+			onNotice(String(e));
+		}
+	}, [
+		remote,
+		t,
+		onNotice
+	]);
+	/**
+	* Adopt a skill that dsh discovered from a user-level root this plugin reads
+	* but does not manage: link its own directory into the user root so it becomes
+	* an editable entry. The content is untouched.
+	*/
+	const adoptSkill = (0, react.useCallback)(async (name) => {
+		try {
+			const entry = unwrap(await remote.adoptSkillLocation(name), "capabilityPolicy.adoptSkillLocation");
+			onNotice(t("skillAdopted", { path: entry }));
+			onRefresh();
+		} catch (e) {
+			onNotice(String(e));
+		}
+	}, [
+		remote,
+		t,
+		onNotice,
+		onRefresh
+	]);
+	/**
+	* Open the 编辑 form for a managed skill entry. `name` is the skill's declared
+	* name, which is what the row and the panel address it by — an entry is
+	* matched on that rather than on its own, possibly different, name. A bare
+	* name can exist in both the user root and a project root, so the row's source
+	* decides which entry the click meant; without it we fall back to the first
+	* match.
+	*/
+	const openSkillEdit = (0, react.useCallback)(async (name, source) => {
+		try {
+			const rows = unwrap(await remote.listSkillLocations(), "capabilityPolicy.listSkillLocations");
+			const wanted = PROJECT_SKILL_SOURCES.has(source ?? "") ? "project" : "user";
+			const named = rows.filter((row) => (row.skillName ?? row.name) === name);
+			const found = named.find((row) => row.root === wanted) ?? named[0];
+			if (found === void 0) {
+				onNotice(t("notEditable"));
+				return;
+			}
+			setEditSkill(found);
+		} catch (e) {
+			onNotice(String(e));
+		}
+	}, [
+		remote,
+		t,
+		onNotice
+	]);
 	/** Fetch and show the two read-only catalog documents. */
 	const openCatalogDocs = (0, react.useCallback)(async () => {
 		setCatalogDocs({ status: "loading" });
@@ -5779,9 +7230,17 @@ function ReadyBody(props) {
 			className: "mc-heading",
 			children: t("title")
 		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-			className: "mc-desc",
-			children: t("desc")
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "mc-desc-row",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "mc-desc",
+				children: t("desc")
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "mc-catalog-btn",
+				onClick: () => void openCatalogDocs(),
+				children: t("viewCatalog")
+			})]
 		}),
 		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "mc-tabs",
@@ -5822,11 +7281,22 @@ function ReadyBody(props) {
 				}, cls)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 					type: "button",
 					className: "mc-catalog-btn",
-					onClick: () => void openCatalogDocs(),
-					children: t("viewCatalog")
+					onClick: () => setRegisterOpen(true),
+					children: t("registerCapability")
 				})]
 			})]
 		}),
+		snapshot.rows.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "mc-filter",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+				type: "search",
+				value: filter,
+				placeholder: t("filterByName"),
+				"aria-label": t("filterByName"),
+				title: t("filterHint"),
+				onChange: (e) => setFilter(e.target.value)
+			})
+		}),
 		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			role: "tabpanel",
 			hidden: activeTab !== "tools",
@@ -5835,7 +7305,7 @@ function ReadyBody(props) {
 				className: "mc-panel-inner",
 				children: servers.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 					className: "mc-empty",
-					children: t("emptyTools")
+					children: needle === "" ? t("emptyTools") : t("filterNoMatch")
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: servers.map(({ server, tools }) => {
 					const open = openServers.has(server);
 					const counts = CLASS_KEYS.map((cls) => ({
@@ -5863,15 +7333,15 @@ function ReadyBody(props) {
 								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: "mc-server-name",
-									children: server === BUILT_IN_SERVER ? t("builtInGroup") : server
+									children: server === "built-in" ? t("builtInGroup") : server
 								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: "mc-server-count",
 									children: t("toolCount", { count: tools.length })
 								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 									className: "mc-server-meta",
-									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 										className: "mc-counts",
 										children: counts.filter(({ count }) => count > 0).map(({ cls, count }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 											type: "button",
@@ -5892,7 +7362,16 @@ function ReadyBody(props) {
 												count
 											]
 										}, cls))
-									})
+									}), server !== "built-in" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "mc-count mc-count--action",
+										disabled: busy,
+										onClick: (e) => {
+											e.stopPropagation();
+											openMcpEdit(server);
+										},
+										children: t("edit")
+									})]
 								})
 							]
 						}), open && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -5943,55 +7422,88 @@ function ReadyBody(props) {
 		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			role: "tabpanel",
 			hidden: activeTab !== "skills",
-			className: "mc-panel",
+			className: "mc-panel mc-panel--tight",
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "mc-panel-inner",
 				children: skills.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 					className: "mc-empty",
-					children: t("emptySkills")
+					children: needle === "" ? t("emptySkills") : t("filterNoMatch")
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 					className: "mc-subtabs",
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "mc-tab-group",
 						role: "tablist",
 						"aria-label": t("skillsGroup"),
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							role: "tab",
-							className: "mc-tab",
-							"aria-selected": skillTab === "global",
-							"data-active": skillTab === "global" ? "true" : void 0,
-							onClick: () => setSkillTab("global"),
-							children: t("globalSkills")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							role: "tab",
-							className: "mc-tab",
-							"aria-selected": skillTab === "project",
-							"data-active": skillTab === "project" ? "true" : void 0,
-							onClick: () => setSkillTab("project"),
-							children: t("projectSkills")
-						})]
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								role: "tab",
+								className: "mc-tab",
+								"aria-selected": activeSkillTab === "global",
+								"data-active": activeSkillTab === "global" ? "true" : void 0,
+								onClick: () => setSkillTab("global"),
+								children: t("globalSkills")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								role: "tab",
+								className: "mc-tab",
+								"aria-selected": activeSkillTab === "project",
+								"data-active": activeSkillTab === "project" ? "true" : void 0,
+								onClick: () => setSkillTab("project"),
+								children: t("projectSkills")
+							}),
+							presetSkills.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								role: "tab",
+								className: "mc-tab",
+								"aria-selected": activeSkillTab === "preset",
+								"data-active": activeSkillTab === "preset" ? "true" : void 0,
+								onClick: () => setSkillTab("preset"),
+								children: t("presetSkills")
+							})
+						]
 					})
-				}), skillTab === "global" ? globalSkills.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillList, {
+				}), activeSkillTab === "global" ? globalSkills.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillList, {
 					skills: globalSkills,
 					remote,
 					busy,
 					t,
-					onCycle
+					onCycle,
+					editableSkills,
+					onEditSkill: openSkillEdit,
+					onAdoptSkill: adoptSkill
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 					className: "mc-empty",
 					children: t("emptyGlobalSkills")
-				}) : projectSkills.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillList, {
+				}) : activeSkillTab === "project" ? projectSkills.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillList, {
 					skills: projectSkills,
 					remote,
 					busy,
 					t,
-					onCycle
+					onCycle,
+					editableSkills,
+					onEditSkill: openSkillEdit,
+					onAdoptSkill: adoptSkill
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 					className: "mc-empty",
 					children: t("emptyProjectSkills")
-				})] })
+				}) : presetGroups.map(([preset, group]) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "mc-skill-group",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "mc-skill-group-title",
+						children: preset
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillList, {
+						skills: group,
+						remote,
+						busy,
+						t,
+						onCycle,
+						editableSkills,
+						onEditSkill: openSkillEdit,
+						onAdoptSkill: adoptSkill
+					})]
+				}, preset))] })
 			})
 		}),
 		toolDetail !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -6035,6 +7547,22 @@ function ReadyBody(props) {
 				]
 			})
 		}),
+		(registerOpen || editMcp !== void 0 || editSkill !== void 0) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LocationModal, {
+			remote,
+			t,
+			defaultKind: activeTab === "skills" ? "skill" : "mcp",
+			...editMcp !== void 0 ? { editMcp } : {},
+			...editSkill !== void 0 ? { editSkill } : {},
+			onClose: () => {
+				setRegisterOpen(false);
+				setEditMcp(void 0);
+				setEditSkill(void 0);
+			},
+			onChanged: (notice) => {
+				onRefresh();
+				if (notice !== void 0) onNotice(notice);
+			}
+		}),
 		catalogDocs !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			className: "mc-preview-mask",
 			onClick: () => setCatalogDocs(null),
@@ -6108,7 +7636,9 @@ function ReadyBody(props) {
 	] });
 }
 function SkillList(props) {
-	const { skills, remote, busy, t, onCycle } = props;
+	const { skills, remote, busy, t, onCycle, editableSkills, onEditSkill, onAdoptSkill } = props;
+	/** Skill id whose 纳入管理 is waiting for a confirmation click. */
+	const [confirmAdopt, setConfirmAdopt] = (0, react.useState)(null);
 	const [openSkill, setOpenSkill] = (0, react.useState)(null);
 	const [tree, setTree] = (0, react.useState)({
 		open: {},
@@ -6277,89 +7807,169 @@ function SkillList(props) {
 			}, relPath);
 		});
 	};
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [skills.map((skill) => {
-		const open = openSkill === skill.id;
-		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			className: "mc-skill",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "mc-skill-row",
-				role: "button",
-				tabIndex: 0,
-				"aria-expanded": open,
-				onClick: () => void toggleSkill(skill.id),
-				onKeyDown: (e) => {
-					if (e.key === "Enter" || e.key === " ") {
-						e.preventDefault();
-						toggleSkill(skill.id);
-					}
-				},
-				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTriangleRightFill14, {
-						size: 12,
-						className: `mc-chevron${open ? " mc-chevron--open" : ""}`
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: "mc-skill-name",
-						children: skill.name
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-						className: "mc-skill-meta",
-						children: [skill.mandatory && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: "mc-tag",
-							children: t("mandatory")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-							type: "button",
-							className: `mc-count mc-count--${skill.class}`,
-							disabled: busy || skill.mandatory,
-							title: skill.classLabel,
-							onClick: (e) => {
-								e.stopPropagation();
-								onCycle([skill.id], "skill");
-							},
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: `mc-dot mc-dot--${skill.class}`,
-								"aria-hidden": "true"
-							}), t(CLASS_SHORT_KEYS[skill.class])]
-						})]
+	/** The row the 纳入管理 confirmation is for, so the dialog can name it and
+	show the directory the click will link. */
+	const confirmAdoptRow = confirmAdopt === null ? void 0 : skills.find((row) => row.id === confirmAdopt);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		skills.map((skill) => {
+			const open = openSkill === skill.id;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "mc-skill",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "mc-skill-row",
+					role: "button",
+					tabIndex: 0,
+					"aria-expanded": open,
+					onClick: () => void toggleSkill(skill.id),
+					onKeyDown: (e) => {
+						if (e.key === "Enter" || e.key === " ") {
+							e.preventDefault();
+							toggleSkill(skill.id);
+						}
+					},
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTriangleRightFill14, {
+							size: 12,
+							className: `mc-chevron${open ? " mc-chevron--open" : ""}`
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "mc-skill-name",
+							children: skill.name
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+							className: "mc-skill-meta",
+							children: [
+								skill.mandatory && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "mc-tag",
+									children: t("mandatory")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+									type: "button",
+									className: `mc-count mc-count--${skill.class}`,
+									disabled: busy || skill.mandatory,
+									title: skill.classLabel,
+									onClick: (e) => {
+										e.stopPropagation();
+										onCycle([skill.id], "skill");
+									},
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: `mc-dot mc-dot--${skill.class}`,
+										"aria-hidden": "true"
+									}), t(CLASS_SHORT_KEYS[skill.class])]
+								}),
+								!editableSkills.has(skill.id) && (skill.preset !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "mc-source",
+									title: t("skillFromPresetHint"),
+									children: t("skillFromPreset", { preset: skill.preset })
+								}) : ADOPTABLE_SKILL_SOURCES.has(skill.source ?? "") ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "mc-count mc-count--action",
+									disabled: busy,
+									title: t("adoptSkillHint"),
+									onClick: (e) => {
+										e.stopPropagation();
+										setConfirmAdopt(skill.id);
+									},
+									children: t("adoptSkill")
+								}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "mc-source",
+									title: t("skillSourceHint"),
+									children: t("skillSource", { source: sourceLabel(skill.source, t) })
+								})),
+								editableSkills.has(skill.id) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "mc-count mc-count--action",
+									disabled: busy,
+									onClick: (e) => {
+										e.stopPropagation();
+										onEditSkill(skill.id, skill.source);
+									},
+									children: t("edit")
+								})
+							]
+						})
+					]
+				}), open && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "mc-skill-body",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "mc-tree",
+						children: renderEntries(tree.dirs[`${skill.id}:`], skill.id, "") ?? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "mc-tree-row",
+							children: "…"
+						})
 					})
-				]
-			}), open && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "mc-skill-body",
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: "mc-tree",
-					children: renderEntries(tree.dirs[`${skill.id}:`], skill.id, "") ?? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "mc-tree-row",
-						children: "…"
+				})]
+			}, skill.id);
+		}),
+		confirmAdopt !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "mc-preview-mask",
+			onClick: () => setConfirmAdopt(null),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "mc-preview mc-confirm-dialog",
+				onClick: (e) => e.stopPropagation(),
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "mc-preview-head",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "mc-preview-title",
+						children: t("adoptSkillTitle", { name: confirmAdoptRow?.name ?? confirmAdopt })
 					})
-				})
-			})]
-		}, skill.id);
-	}), preview !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		className: "mc-preview-mask",
-		onClick: () => setPreview(null),
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			className: "mc-preview",
-			onClick: (e) => e.stopPropagation(),
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "mc-preview-head",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					className: "mc-preview-title",
-					children: preview.relPath
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-					type: "button",
-					className: "mc-preview-close",
-					onClick: () => setPreview(null),
-					children: t("previewClose")
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "mc-confirm-body",
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("adoptSkillHint") }),
+						confirmAdoptRow !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "mc-confirm-path",
+							children: t("skillSource", { source: confirmAdoptRow.path ?? sourceLabel(confirmAdoptRow.source, t) })
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "mc-confirm-actions",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "mc-catalog-btn",
+								onClick: () => setConfirmAdopt(null),
+								children: t("cancel")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "mc-catalog-btn",
+								onClick: () => {
+									const id = confirmAdopt;
+									setConfirmAdopt(null);
+									onAdoptSkill(id);
+								},
+								children: t("adoptSkill")
+							})]
+						})
+					]
 				})]
-			}), preview.content !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
-				className: "mc-preview-body",
-				children: preview.content
-			}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "mc-preview-hint",
-				children: preview.error ?? "…"
-			})]
+			})
+		}),
+		preview !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "mc-preview-mask",
+			onClick: () => setPreview(null),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "mc-preview",
+				onClick: (e) => e.stopPropagation(),
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "mc-preview-head",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "mc-preview-title",
+						children: preview.relPath
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "mc-preview-close",
+						onClick: () => setPreview(null),
+						children: t("previewClose")
+					})]
+				}), preview.content !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+					className: "mc-preview-body",
+					children: preview.content
+				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "mc-preview-hint",
+					children: preview.error ?? "…"
+				})]
+			})
 		})
-	})] });
+	] });
 }
 //#endregion
 //#region src/client/index.ts
@@ -6374,28 +7984,29 @@ const inject = [
 	"locale",
 	"remote"
 ];
-/** Register the 能力管理 section once `settings.section` is on the ledger. */
+/** Register the 能力菜单 section once `settings.section` is on the ledger. */
 async function apply(ctx) {
 	const zh = {
-		nav: "能力管理",
-		title: "能力管理",
+		nav: "能力菜单",
+		title: "能力菜单",
 		desc: "管理工具与技能的 常驻 / 按需 / 禁用 三档分类。",
 		resident: "Resident（常驻上下文）",
 		"on-demand": "On-demand（按需发现）",
 		disabled: "Disabled（禁用）",
-		kind: "类型",
-		class: "分类",
 		tool: "tool",
 		skill: "skill",
 		mandatory: "meta",
-		rules: "规则",
 		toolsGroup: "Tools",
 		skillsGroup: "Skills",
 		builtInGroup: "系统内置",
 		globalSkills: "全局技能",
 		projectSkills: "项目技能",
+		presetSkills: "预设技能",
 		emptyGlobalSkills: "暂无全局技能",
 		emptyProjectSkills: "暂无项目技能",
+		filterByName: "按名字、分组或正则过滤…",
+		filterHint: "忽略大小写。匹配工具/技能名、MCP server、技能来源标签与预设 id；也可以直接写正则，例如 cordis|ptc 或 /^mcp__dbx/。",
+		filterNoMatch: "没有匹配的能力（清空过滤框可恢复完整列表）",
 		emptyTools: "暂无工具",
 		emptySkills: "暂无 Skill",
 		toolCount: "{count} 个工具",
@@ -6407,10 +8018,69 @@ async function apply(ctx) {
 		previewClose: "关闭",
 		detailNotFound: "未找到该工具的详情",
 		cycleOverridden: "分类未生效：{count} 个能力被更高优先级规则覆盖（如通配规则），可移除对应通配规则后重试",
-		viewCatalog: "查看能力目录",
+		refreshFailed: "刷新失败，请查看日志",
+		retry: "重试",
+		carrierFailureHint: "请求未到达服务端：浏览器与 dsh 之间的连接已断开（Failed to fetch 属传输层失败，服务端方法未执行）。若刚重启过 dsh web，请先硬刷新页面（Ctrl/Cmd+Shift+R）再重试。",
+		registerCapability: "注册能力",
+		editMcp: "编辑 MCP 服务器",
+		editSkillNamed: "编辑 Skill 目录：{name}",
+		edit: "编辑",
+		save: "保存",
+		remove: "移除",
+		cancel: "取消",
+		confirmRemove: "确认移除",
+		confirmRemoveMcp: "移除 MCP 服务器「{name}」？其 patch 文件中的配置行（含 headers、环境变量）将被删除，mcp__{name}__* 工具随之消失。",
+		confirmRemoveSkillLink: "移除 Skill「{name}」？仅删除 ~/.dsh/skills 下的软链，源目录不受影响。",
+		confirmRemoveSkillDir: "移除 Skill「{name}」？该项位于 ~/.dsh/skills 下且非软链，将连同文件递归删除，且不可恢复。",
+		confirmSaveAnyway: "仍然保存",
+		saveConfirmRealDir: "「{name}」这个条目是真实目录、不是软链：保存会先把它连同文件递归删除，再改为指向新路径，且不可恢复。",
+		register: "注册",
+		notEditable: "该项未在注册表中（可能是项目技能或内置技能），无法编辑。",
+		entryNotFound: "目标已不存在，可能已被移除。",
+		mcpServers: "MCP 服务器",
+		skillDirs: "Skill 目录",
+		skillDirPath: "技能来源路径",
+		skillRoot: "技能位置",
+		skillRootUser: "全局技能（~/.dsh/skills）",
+		skillRootProject: "项目技能（<项目根>/.dsh/skills）",
+		skillRootHintUser: "所有会话都能看到该技能。",
+		skillRootHintProject: "只对 cwd 落在该项目内的会话可见。",
+		skillProjectPath: "目标项目路径",
+		skillProjectPathHint: "项目内任意一个已存在的路径即可；项目根按 dsh 的规则确定（向上找最近的 .git），技能写进 <项目根>/.dsh/skills。",
+		skillRegisteredAt: "已注册到 {path}",
+		skillRepointed: "已改为指向 {dir}",
+		skillAdopted: "已纳入管理：{path}",
+		skillSource: "来源：{source}",
+		skillSourceHint: "该技能由 dsh 从其它根发现，不在本插件管理的技能目录里，因此没有「编辑」。",
+		skillFromPreset: "来自预设 {preset}",
+		skillFromPresetHint: "该技能随 agent preset 分发，只对挂载了该预设的会话可见；不能纳入管理（那会把它软链进全局技能根，对所有会话生效）。",
+		skillUnmanaged: "未纳入管理",
+		sourceCustom: "自定义技能目录",
+		sourceBundled: "随 dsh 预置",
+		adoptSkill: "纳入管理",
+		adoptSkillHint: "把它软链进 dsh 的技能根目录（默认 ~/.dsh/skills），内容不动；之后就能编辑与移除了。",
+		adoptSkillTitle: "纳入管理「{name}」？",
+		skillDirHint: "目录内需有 SKILL.md（按 dsh 的 skill 格式校验）。技能名以 SKILL.md 里声明的为准，目录名只决定注册后的软链名，两者不同也可以。",
+		serverName: "serverName",
+		serverNameImmutable: "serverName 不可修改：它构成工具名前缀 mcp__<serverName>__<tool>，并已被既有会话历史与权限规则引用；修改后这些记录将不再匹配。",
+		transport: "传输方式",
+		transportStdio: "stdio（本地子进程）",
+		transportHttp: "streamable-http（HTTP MCP 端点）",
+		transportHintStdio: "由客户端将该 MCP server 作为子进程启动，JSON-RPC 报文经标准输入 / 输出交换。",
+		transportHintHttp: "该 MCP server 作为独立进程运行，可服务多个客户端连接；客户端经单个支持 POST / GET 的 HTTP 端点（MCP endpoint）与其通信。",
+		command: "命令",
+		args: "参数（空格分隔）",
+		cwd: "工作目录",
+		env: "环境变量",
+		url: "URL",
+		headers: "请求头",
+		headersHint: "每行一个 Header，格式 Key: Value；Bearer token 等认证凭据在此填写。",
+		timeout: "超时（秒）",
+		timeoutInvalid: "超时须为数字，单位为秒。",
+		viewCatalog: "策略与目录",
 		catalogPolicy: "三档策略配置",
 		catalogOnDemand: "按需能力目录",
-		catalogPolicyNote: "实时生成，只读；持久化入口为 cordis.patch.yml（未列出规则的能力默认常驻）",
+		catalogPolicyNote: "实时生成；点选改动会在停手后自动写回 cordis.patch.yml（未列出规则的能力默认常驻）",
 		catalogDisabled: "按需能力目录未启用（catalogFile 为空）",
 		catalogUnreadable: "按需能力目录文件读取失败"
 	};
@@ -6421,19 +8091,20 @@ async function apply(ctx) {
 		resident: "Resident",
 		"on-demand": "On-demand",
 		disabled: "Disabled",
-		kind: "kind",
-		class: "class",
 		tool: "tool",
 		skill: "skill",
 		mandatory: "meta",
-		rules: "rules",
 		toolsGroup: "Tools",
 		skillsGroup: "Skills",
 		builtInGroup: "System built-in",
 		globalSkills: "Global skills",
 		projectSkills: "Project skills",
+		presetSkills: "Preset skills",
 		emptyGlobalSkills: "No global skills",
 		emptyProjectSkills: "No project skills",
+		filterByName: "Filter by name, group, or regex…",
+		filterHint: "Case-insensitive. Matches tool/skill names, MCP servers, skill source labels and preset ids; a regular expression works too, e.g. cordis|ptc or /^mcp__dbx/.",
+		filterNoMatch: "No capability matches (clear the filter to see the full list)",
 		emptyTools: "No tools",
 		emptySkills: "No skills",
 		toolCount: "{count} tools",
@@ -6445,10 +8116,69 @@ async function apply(ctx) {
 		previewClose: "Close",
 		detailNotFound: "Tool detail not found",
 		cycleOverridden: "Classification not applied: {count} capability(ies) overridden by a higher-priority rule (e.g. a wildcard). Remove the matching wildcard rule and retry.",
-		viewCatalog: "View capability catalog",
+		refreshFailed: "Refresh failed; see the log",
+		retry: "Retry",
+		carrierFailureHint: "The request never reached the server: the browser connection to dsh is broken (\"Failed to fetch\" is a transport failure, so no server method ran). If dsh web was just restarted, hard-refresh the page (Ctrl/Cmd+Shift+R) and retry.",
+		registerCapability: "Register capability",
+		editMcp: "Edit MCP server",
+		editSkillNamed: "Edit skill directory: {name}",
+		edit: "Edit",
+		save: "Save",
+		remove: "Remove",
+		cancel: "Cancel",
+		confirmRemove: "Confirm removal",
+		confirmRemoveMcp: "Remove the MCP server \"{name}\"? Its config row in the patch file (headers and environment included) is deleted, and the mcp__{name}__* tools disappear with it.",
+		confirmRemoveSkillLink: "Unregister the skill \"{name}\"? Only the symlink under ~/.dsh/skills is removed; the source directory is left untouched.",
+		confirmRemoveSkillDir: "Remove the skill \"{name}\"? It sits under ~/.dsh/skills and is not a symlink, so it will be deleted recursively with all of its files. This cannot be undone.",
+		confirmSaveAnyway: "Save anyway",
+		saveConfirmRealDir: "The entry \"{name}\" is a real directory, not a symlink: saving deletes it and its files recursively before repointing it, and that cannot be undone.",
+		register: "Register",
+		notEditable: "This entry is not in the registry (a project or bundled skill), so it cannot be edited.",
+		entryNotFound: "The target no longer exists; it may have been removed.",
+		mcpServers: "MCP servers",
+		skillDirs: "Skill directories",
+		skillDirPath: "Skill source path",
+		skillRoot: "Skill location",
+		skillRootUser: "Global (~/.dsh/skills)",
+		skillRootProject: "Project (<projectRoot>/.dsh/skills)",
+		skillRootHintUser: "Visible to every session.",
+		skillRootHintProject: "Visible only to sessions whose cwd sits inside that project.",
+		skillProjectPath: "Target project path",
+		skillProjectPathHint: "Any existing path inside the project; the project root is derived the way dsh derives it (nearest .git above it) and the skill is written under <projectRoot>/.dsh/skills.",
+		skillRegisteredAt: "Registered at {path}",
+		skillRepointed: "Repointed to {dir}",
+		skillAdopted: "Adopted: {path}",
+		skillSource: "Source: {source}",
+		skillSourceHint: "dsh found this skill in another root, not in a skill directory this plugin manages, so there is no Edit button.",
+		skillFromPreset: "From preset {preset}",
+		skillFromPresetHint: "This skill ships with an agent preset and is visible only to sessions that mount it. It cannot be adopted (adopting would link it into the global skill root, making it apply to every session).",
+		skillUnmanaged: "Not managed here",
+		sourceCustom: "custom skill dirs",
+		sourceBundled: "bundled with dsh",
+		adoptSkill: "Adopt",
+		adoptSkillHint: "Link it into dsh's skill root (default ~/.dsh/skills); the content is untouched, and it becomes editable and removable.",
+		adoptSkillTitle: "Adopt \"{name}\"?",
+		skillDirHint: "The directory must hold a SKILL.md in dsh's skill format. The skill name is the one declared in SKILL.md; the directory name only names the link this registers, so the two may differ.",
+		serverName: "serverName",
+		serverNameImmutable: "serverName is immutable: it forms the tool name prefix mcp__<serverName>__<tool> and is referenced by existing session history and permission rules, which stop matching once it changes.",
+		transport: "Transport",
+		transportStdio: "stdio (local subprocess)",
+		transportHttp: "streamable-http (HTTP MCP endpoint)",
+		transportHintStdio: "The client launches the MCP server as a subprocess and exchanges JSON-RPC messages over its standard input and output.",
+		transportHintHttp: "The server runs as an independent process that can handle multiple client connections; the client reaches it over a single HTTP endpoint (the MCP endpoint) supporting POST and GET.",
+		command: "Command",
+		args: "Args (space separated)",
+		cwd: "Working directory",
+		env: "Environment",
+		url: "URL",
+		headers: "Headers",
+		headersHint: "One header per line as Key: Value; credentials such as a Bearer token go here.",
+		timeout: "Timeout (seconds)",
+		timeoutInvalid: "Timeout must be a number of seconds.",
+		viewCatalog: "Policy & catalog",
 		catalogPolicy: "Policy (effective)",
 		catalogOnDemand: "On-demand catalog",
-		catalogPolicyNote: "Generated live from the effective policy (read-only); persist via cordis.patch.yml. Capabilities without a rule default to Resident.",
+		catalogPolicyNote: "Generated live from the effective policy; clicked changes are written back to cordis.patch.yml once you stop. Capabilities without a rule default to Resident.",
 		catalogDisabled: "On-demand catalog emission is disabled (catalogFile is empty).",
 		catalogUnreadable: "Failed to read the on-demand catalog file."
 	};
@@ -6473,18 +8203,45 @@ async function apply(ctx) {
 			return;
 		}
 	};
+	/**
+	* The two signals that say "the host catalog may have moved, and this page did
+	* not ask": a settings document edit, and a carrier reconnect.
+	*
+	* `settings/document-updated` is one of the events dsh forwards to browsers
+	* (so it arrives over the same validated channel as the remote calls) and it
+	* fires for external edits too — composition files are edited outside the
+	* browser, and nothing else on the wire announces that. `connection/reset` is
+	* the client's own reconnect signal rather than a forwarded one, which is why
+	* it is a plain local `ctx.on`; dsh's own settings sections listen to exactly
+	* this pair, including the first connection, which closes the window where a
+	* change lands between the initial read and the subscription.
+	*
+	* Neither subscription is fatal: the section falls back to its version poll.
+	*/
+	const subscribeSignals = (listener) => {
+		const disposers = [];
+		const forwarded = ctx.remote;
+		try {
+			if (typeof forwarded.$on !== "function") throw new Error("ctx.remote.$on is unavailable");
+			disposers.push(forwarded.$on("settings/document-updated", () => listener()));
+		} catch (error) {
+			console.error("[capability-menu] settings/document-updated subscription failed:", error);
+		}
+		try {
+			disposers.push(ctx.on("connection/reset", () => listener()));
+		} catch (error) {
+			console.error("[capability-menu] connection/reset subscription failed:", error);
+		}
+		return () => {
+			for (const dispose of disposers) dispose();
+		};
+	};
 	const injected = () => {
-		const namespace = remote();
-		const remoteKeys = namespace == null ? void 0 : Object.keys(namespace).filter((k) => [
-			"getConfig",
-			"updateConfig",
-			"classifyAll"
-		].includes(k)).join(",");
 		return {
-			remote: namespace,
+			remote: remote(),
 			t,
-			...mountError !== void 0 ? { mountError } : {},
-			...remoteKeys !== void 0 ? { remoteKeys } : {}
+			subscribeSignals,
+			...mountError !== void 0 ? { mountError } : {}
 		};
 	};
 	ctx.slots.inject("settings.section", () => ctx.slots.register({