@daweifu/capability-menu 0.1.3 → 0.1.4

package/lib/client.js

@@ -5240,6 +5240,7 @@ const capabilityRow$schema = object({
 	name: string().readonly(),
 	server: string().optional().readonly(),
 	source: string().optional().readonly(),
+	preset: string().optional().readonly(),
 	class: union([
 		literal("resident"),
 		literal("on-demand"),
@@ -5273,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({
@@ -5762,6 +5764,24 @@ const TYPERT_REMOTE = {
 				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
+			}
 		}
 	]
 };
@@ -6361,6 +6381,219 @@ const PROJECT_SKILL_SOURCES = /* @__PURE__ */ new Set(["project-dsh", "project-a
 */
 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/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);
+}
+/**
+* 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.
@@ -6412,6 +6645,8 @@ const CSS = `
 .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}
@@ -6435,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}
@@ -6442,13 +6686,17 @@ 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}
-/* Skills panel: its first row is the 全局技能/项目技能 sub-tab bar, which sits
-   directly under the main tab bar. It is a second level of the same control, so
-   the two bars have to read as one stack: no panel padding at all, and the
-   sub-tabs keep a token top padding instead of the 7px they share with the
-   primary tabs. Together the label sits ~13px under the main label rather than
-   ~20px, with the main bar's rule between them. */
+/* 面板的第一行必须和另一个 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}
@@ -6508,6 +6756,9 @@ body[data-ds-dark-theme] .mc-count--disabled{color:#b8abad}
 .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)}
@@ -6555,32 +6806,22 @@ function sourceLabel(source, t) {
 	const key = SOURCE_LABEL_KEYS[source];
 	return key === void 0 ? source : t(key);
 }
-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))
-	};
-}
-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 } = props;
+	const { remote, t, mountError, subscribeSignals } = props;
 	const [state, setState] = (0, react.useState)(() => {
 		const cached = cachedSnapshot();
 		return cached === void 0 ? { status: "loading" } : {
@@ -6649,6 +6890,84 @@ 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;
@@ -6744,19 +7063,31 @@ function CapabilitySection(props) {
 				onToggleServer: toggleServer,
 				onCycle: cycleClass,
 				onRefresh: () => void refreshCatalog(),
-				refreshing,
 				onNotice: setNotice
 			})
 		]
 	});
 }
 function ReadyBody(props) {
-	const { remote, snapshot, openServers, busy, activeTab, t, onTabChange, onToggleServer, onCycle, onRefresh, refreshing, onNotice } = props;
-	const { servers, skills } = groupRows(snapshot.rows);
-	const projectSkills = skills.filter((skill) => PROJECT_SKILL_SOURCES.has(skill.source ?? ""));
-	const globalSkills = skills.filter((skill) => !PROJECT_SKILL_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)
@@ -6936,35 +7267,36 @@ function ReadyBody(props) {
 				})]
 			}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "mc-summary",
-				children: [
-					summary.map(({ cls, count }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-						className: `mc-chip mc-chip--${cls}`,
-						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: `mc-dot mc-dot--${cls}`,
-								"aria-hidden": "true"
-							}),
-							t(CLASS_SHORT_KEYS[cls]),
-							" · ",
-							count
-						]
-					}, cls)),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-						type: "button",
-						className: "mc-catalog-btn",
-						onClick: () => onRefresh(),
-						disabled: refreshing,
-						children: refreshing ? t("refreshing") : t("refresh")
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-						type: "button",
-						className: "mc-catalog-btn",
-						onClick: () => setRegisterOpen(true),
-						children: t("registerCapability")
-					})
-				]
+				children: [summary.map(({ cls, count }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					className: `mc-chip mc-chip--${cls}`,
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: `mc-dot mc-dot--${cls}`,
+							"aria-hidden": "true"
+						}),
+						t(CLASS_SHORT_KEYS[cls]),
+						" · ",
+						count
+					]
+				}, cls)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					className: "mc-catalog-btn",
+					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",
@@ -6973,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) => ({
@@ -7095,32 +7427,44 @@ function ReadyBody(props) {
 				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,
@@ -7132,7 +7476,7 @@ function ReadyBody(props) {
 				}) : /* @__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,
@@ -7144,7 +7488,22 @@ function ReadyBody(props) {
 				}) : /* @__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", {
@@ -7498,7 +7857,11 @@ function SkillList(props) {
 										"aria-hidden": "true"
 									}), t(CLASS_SHORT_KEYS[skill.class])]
 								}),
-								!editableSkills.has(skill.id) && (ADOPTABLE_SKILL_SOURCES.has(skill.source ?? "") ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								!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,
@@ -7638,8 +8001,12 @@ async function apply(ctx) {
 		builtInGroup: "系统内置",
 		globalSkills: "全局技能",
 		projectSkills: "项目技能",
+		presetSkills: "预设技能",
 		emptyGlobalSkills: "暂无全局技能",
 		emptyProjectSkills: "暂无项目技能",
+		filterByName: "按名字、分组或正则过滤…",
+		filterHint: "忽略大小写。匹配工具/技能名、MCP server、技能来源标签与预设 id；也可以直接写正则，例如 cordis|ptc 或 /^mcp__dbx/。",
+		filterNoMatch: "没有匹配的能力（清空过滤框可恢复完整列表）",
 		emptyTools: "暂无工具",
 		emptySkills: "暂无 Skill",
 		toolCount: "{count} 个工具",
@@ -7651,8 +8018,6 @@ async function apply(ctx) {
 		previewClose: "关闭",
 		detailNotFound: "未找到该工具的详情",
 		cycleOverridden: "分类未生效：{count} 个能力被更高优先级规则覆盖（如通配规则），可移除对应通配规则后重试",
-		refresh: "刷新",
-		refreshing: "刷新中…",
 		refreshFailed: "刷新失败，请查看日志",
 		retry: "重试",
 		carrierFailureHint: "请求未到达服务端：浏览器与 dsh 之间的连接已断开（Failed to fetch 属传输层失败，服务端方法未执行）。若刚重启过 dsh web，请先硬刷新页面（Ctrl/Cmd+Shift+R）再重试。",
@@ -7687,6 +8052,8 @@ async function apply(ctx) {
 		skillAdopted: "已纳入管理：{path}",
 		skillSource: "来源：{source}",
 		skillSourceHint: "该技能由 dsh 从其它根发现，不在本插件管理的技能目录里，因此没有「编辑」。",
+		skillFromPreset: "来自预设 {preset}",
+		skillFromPresetHint: "该技能随 agent preset 分发，只对挂载了该预设的会话可见；不能纳入管理（那会把它软链进全局技能根，对所有会话生效）。",
 		skillUnmanaged: "未纳入管理",
 		sourceCustom: "自定义技能目录",
 		sourceBundled: "随 dsh 预置",
@@ -7732,8 +8099,12 @@ async function apply(ctx) {
 		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",
@@ -7745,8 +8116,6 @@ 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.",
-		refresh: "Refresh",
-		refreshing: "Refreshing…",
 		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.",
@@ -7781,6 +8150,8 @@ async function apply(ctx) {
 		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",
@@ -7832,10 +8203,44 @@ 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 = () => {
 		return {
 			remote: remote(),
 			t,
+			subscribeSignals,
 			...mountError !== void 0 ? { mountError } : {}
 		};
 	};