@mangoc/dsh-sub2api-sync 0.2.0 → 0.2.2

package/lib/client.cjs

@@ -125,8 +125,8 @@ const zh = {
 	detailSectionEmpty: "还没有同步过——在设置 → Sub2API 同步 完成首次同步",
 	activationTitle: "开始使用 Sub2API 同步",
 	activationStep1: "1. 在设置中连接面板（账号密码或网页授权）",
-	activationStep2: "2. 勾选要同步的分组（key 自动准备）",
-	activationStep3: "3. 点击「立即同步」，模型即可使用",
+	activationStep2: "2. 在 Keys 卡勾选要同步的 key（可跨分组）",
+	activationStep3: "3. 点击「同步所选」，模型即可使用",
 	activationOpenConfig: "打开配置页",
 	activationDismiss: "知道了",
 	keysTitle: "Keys",
@@ -138,9 +138,13 @@ const zh = {
 	keyCreated: "已创建并绑定：{name}",
 	keysListEmpty: "还没有 key",
 	keysListLoading: "正在读取 keys…",
+	keysSearchPlaceholder: "搜索 key…",
+	keysSearchEmpty: "没有匹配的 key",
 	syncSelected: "同步所选（{count}）",
 	syncSelectedDone: "同步完成：{ok}/{total} 条成功",
-	keysLoadMore: "加载更多（还有 {count} 个）"
+	keysPagePrev: "上一页",
+	keysPageNext: "下一页",
+	keysPageStatus: "第 {page} / {pages} 页 · 共 {total} 个"
 };
 const en = {
 	nav: "Sub2API Sync",
@@ -235,8 +239,8 @@ const en = {
 	detailSectionEmpty: "Never synced — finish the first sync in Settings → Sub2API Sync",
 	activationTitle: "Get started with Sub2API Sync",
 	activationStep1: "1. Connect the panel in Settings (account password or web authorization)",
-	activationStep2: "2. Check the groups to sync (keys are prepared automatically)",
-	activationStep3: "3. Click \"Sync now\" and the models are ready",
+	activationStep2: "2. Tick the keys to sync on the Keys card (cross-group)",
+	activationStep3: "3. Click \"Sync selected\" and the models are ready",
 	activationOpenConfig: "Open configuration",
 	activationDismiss: "Got it",
 	keysTitle: "Keys",
@@ -248,9 +252,13 @@ const en = {
 	keyCreated: "Created and bound: {name}",
 	keysListEmpty: "No keys yet",
 	keysListLoading: "Loading keys…",
+	keysSearchPlaceholder: "Search keys…",
+	keysSearchEmpty: "No keys match",
 	syncSelected: "Sync selected ({count})",
 	syncSelectedDone: "Synced: {ok}/{total} succeeded",
-	keysLoadMore: "Load more ({count} left)"
+	keysPagePrev: "Previous page",
+	keysPageNext: "Next page",
+	keysPageStatus: "Page {page} / {pages} · {total} keys"
 };
 const dictionaries = {
 	zh,
@@ -404,7 +412,7 @@ function createPluginApi() {
 		login2fa: (code) => callJson(ROUTES.login2fa, post({ code })),
 		logout: () => callJson(ROUTES.logout, post()),
 		groups: () => callJson(ROUTES.groups),
-		listKeys: (page, pageSize) => callJson(`${ROUTES.keys}?page=${page}&pageSize=${pageSize}`),
+		listKeys: (page, pageSize, search) => callJson(`${ROUTES.keys}?page=${page}&pageSize=${pageSize}${search !== undefined && search.length > 0 ? `&search=${encodeURIComponent(search)}` : ""}`),
 		createKey: (input) => callJson(ROUTES.keys, post(input)),
 		site: () => callJson(ROUTES.site),
 		account: () => callJson(ROUTES.account),
@@ -743,6 +751,31 @@ const CSS = `
   opacity: 0.55;
 }
 
+/* The keys-card search input: fixed-width slot between the title and the
+   action buttons (see the s2s-actions flex layout). */
+.s2s-searchInput {
+  flex: none;
+  width: 220px;
+}
+
+/* The keys-card pager: centered prev / status / next strip. */
+.s2s-pager {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 10px;
+  flex-wrap: wrap;
+  min-height: 32px;
+}
+
+.s2s-pageStatus {
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 18px;
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+}
+
 /* U2 placements: the provider-card badge, the Models-page footer strip, and
    the Plugins-page activation steps. */
 .s2s-badgeRow {
@@ -1148,12 +1181,16 @@ function protocolForPlatform(platform) {
 //#endregion
 //#region src/client/section/KeysCard.tsx
 const PAGE_SIZE = 5;
+const SEARCH_DEBOUNCE_MS = 300;
 function KeysCard({ api, config, groups, t }) {
 	const snapshot$1 = useConfigForm(config);
 	const [keys, setKeys] = (0, react.useState)([]);
-	const [page, setPage] = (0, react.useState)(0);
+	const [search, setSearch] = (0, react.useState)("");
+	const [query, setQuery] = (0, react.useState)("");
+	const [page, setPage] = (0, react.useState)(1);
 	const [pages, setPages] = (0, react.useState)(1);
 	const [total, setTotal] = (0, react.useState)(0);
+	const [reloadTick, setReloadTick] = (0, react.useState)(0);
 	const [loading, setLoading] = (0, react.useState)(false);
 	const [listError, setListError] = (0, react.useState)(undefined);
 	const [creating, setCreating] = (0, react.useState)(false);
@@ -1164,23 +1201,41 @@ function KeysCard({ api, config, groups, t }) {
 	const [busy, setBusy] = (0, react.useState)(false);
 	const [syncing, setSyncing] = (0, react.useState)(false);
 	const [feedback, setFeedback] = (0, react.useState)(undefined);
-	const loadPage = (next) => {
+	const appliedQueryRef = (0, react.useRef)(query);
+	(0, react.useEffect)(() => {
+		const timer$1 = window.setTimeout(() => {
+			const next = search.trim();
+			if (appliedQueryRef.current !== next) {
+				appliedQueryRef.current = next;
+				setQuery(next);
+				setPage(1);
+			}
+		}, SEARCH_DEBOUNCE_MS);
+		return () => window.clearTimeout(timer$1);
+	}, [search]);
+	const requestSeqRef = (0, react.useRef)(0);
+	(0, react.useEffect)(() => {
+		const requestId = ++requestSeqRef.current;
 		setLoading(true);
 		setListError(undefined);
-		api.listKeys(next, PAGE_SIZE).then((response) => {
-			setKeys((previous) => next === 1 ? response.keys : [...previous, ...response.keys]);
+		api.listKeys(page, PAGE_SIZE, query === "" ? undefined : query).then((response) => {
+			if (requestSeqRef.current !== requestId) return;
+			setKeys(response.keys);
 			setPages(response.pages);
 			setTotal(response.total);
-			setPage(next);
+			if (response.pages > 0 && page > response.pages) setPage(response.pages);
 		}).catch((cause) => {
+			if (requestSeqRef.current !== requestId) return;
 			setListError(cause instanceof Error ? cause.message : String(cause));
 		}).finally(() => {
-			setLoading(false);
+			if (requestSeqRef.current === requestId) setLoading(false);
 		});
-	};
-	(0, react.useEffect)(() => {
-		loadPage(1);
-	}, [api]);
+	}, [
+		api,
+		page,
+		query,
+		reloadTick
+	]);
 	const selectedIds = snapshot$1.value?.selectedKeys ?? [];
 	const toggle = (keyId, next) => {
 		const nextSet = new Set(selectedIds);
@@ -1241,7 +1296,8 @@ else nextSet.delete(keyId);
 				text: t("keyCreated", { name: response.key.name })
 			});
 			closeCreate();
-			loadPage(1);
+			setPage(1);
+			setReloadTick((tick) => tick + 1);
 		}).catch((cause) => {
 			setFeedback({
 				tone: "error",
@@ -1276,10 +1332,19 @@ else nextSet.delete(keyId);
 				}), (0, react_jsx_runtime.jsxs)("div", {
 					className: "s2s-actions",
 					children: [
+						(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Input, {
+							className: "s2s-searchInput",
+							type: "text",
+							value: search,
+							placeholder: t("keysSearchPlaceholder"),
+							onChange: (event) => {
+								setSearch(event.target.value);
+							}
+						}),
 						(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
 							variant: "outline",
 							onClick: () => {
-								loadPage(1);
+								setReloadTick((tick) => tick + 1);
 							},
 							children: t("groupsRefresh")
 						}),
@@ -1309,7 +1374,7 @@ else nextSet.delete(keyId);
 			}),
 			!loading && keys.length === 0 && listError === undefined && (0, react_jsx_runtime.jsx)("p", {
 				className: "s2s-feedback s2s-hint",
-				children: t("keysListEmpty")
+				children: query !== "" ? t("keysSearchEmpty") : t("keysListEmpty")
 			}),
 			loading && keys.length === 0 && (0, react_jsx_runtime.jsx)("p", {
 				className: "s2s-feedback s2s-hint",
@@ -1354,16 +1419,34 @@ else nextSet.delete(keyId);
 					}, key.id);
 				})
 			}),
-			keys.length > 0 && page < pages && (0, react_jsx_runtime.jsx)("div", {
-				className: "s2s-actions",
-				children: (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
-					variant: "outline",
-					disabled: loading,
-					onClick: () => {
-						loadPage(page + 1);
-					},
-					children: t("keysLoadMore", { count: Math.max(0, Math.min(PAGE_SIZE, total - keys.length)) })
-				})
+			keys.length > 0 && (pages > 1 || query !== "") && (0, react_jsx_runtime.jsxs)("div", {
+				className: "s2s-pager",
+				children: [
+					(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "outline",
+						disabled: loading || page <= 1,
+						onClick: () => {
+							setPage(page - 1);
+						},
+						children: t("keysPagePrev")
+					}),
+					(0, react_jsx_runtime.jsx)("span", {
+						className: "s2s-pageStatus",
+						children: t("keysPageStatus", {
+							page,
+							pages,
+							total
+						})
+					}),
+					(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "outline",
+						disabled: loading || page >= pages,
+						onClick: () => {
+							setPage(page + 1);
+						},
+						children: t("keysPageNext")
+					})
+				]
 			}),
 			(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Modal, {
 				open: creating,
@@ -2313,7 +2396,7 @@ function DetailSectionBody({ t }) {
 //#endregion
 //#region src/client/plugins/ActivationGuide.tsx
 function ActivationGuide(props) {
-	const { t, onDismiss, onOpenDetails } = props;
+	const { t, onDismiss, onOpenDetails, openBundleDetails } = props;
 	return (0, react_jsx_runtime.jsxs)("div", {
 		className: "s2s-card",
 		children: [
@@ -2333,7 +2416,9 @@ function ActivationGuide(props) {
 				className: "s2s-actions",
 				children: [(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
 					variant: "primary",
-					onClick: onOpenDetails,
+					onClick: () => {
+						if (!(openBundleDetails?.() ?? false)) onOpenDetails();
+					},
 					children: t("activationOpenConfig")
 				}), (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
 					variant: "ghost",
@@ -2391,10 +2476,17 @@ function mount(ctx) {
 		id: "sub2api-sync",
 		locale: NS
 	}, DetailSection));
+	const activationOps = { openBundleDetails: () => {
+		const nav = ctx.pluginNavigation;
+		if (nav === undefined) return false;
+		nav.openBundle(PKG_NAME);
+		return true;
+	} };
 	ctx.slots.inject("plugins.bundle.activation", () => ctx.slots.register({
 		name: "plugins.bundle.activation",
 		key: PKG_NAME,
-		locale: NS
+		locale: NS,
+		inject: () => activationOps
 	}, ActivationGuide));
 }
 
@@ -2404,7 +2496,8 @@ const name = "dsh-sub2api-sync-client";
 const inject = [
 	"slots",
 	"locale",
-	"configForms"
+	"configForms",
+	"pluginNavigation"
 ];
 function apply(ctx) {
 	mount(ctx);

package/lib/client.js

@@ -131,8 +131,8 @@ const zh = {
 	detailSectionEmpty: "还没有同步过——在设置 → Sub2API 同步 完成首次同步",
 	activationTitle: "开始使用 Sub2API 同步",
 	activationStep1: "1. 在设置中连接面板（账号密码或网页授权）",
-	activationStep2: "2. 勾选要同步的分组（key 自动准备）",
-	activationStep3: "3. 点击「立即同步」，模型即可使用",
+	activationStep2: "2. 在 Keys 卡勾选要同步的 key（可跨分组）",
+	activationStep3: "3. 点击「同步所选」，模型即可使用",
 	activationOpenConfig: "打开配置页",
 	activationDismiss: "知道了",
 	keysTitle: "Keys",
@@ -144,9 +144,13 @@ const zh = {
 	keyCreated: "已创建并绑定：{name}",
 	keysListEmpty: "还没有 key",
 	keysListLoading: "正在读取 keys…",
+	keysSearchPlaceholder: "搜索 key…",
+	keysSearchEmpty: "没有匹配的 key",
 	syncSelected: "同步所选（{count}）",
 	syncSelectedDone: "同步完成：{ok}/{total} 条成功",
-	keysLoadMore: "加载更多（还有 {count} 个）"
+	keysPagePrev: "上一页",
+	keysPageNext: "下一页",
+	keysPageStatus: "第 {page} / {pages} 页 · 共 {total} 个"
 };
 const en = {
 	nav: "Sub2API Sync",
@@ -241,8 +245,8 @@ const en = {
 	detailSectionEmpty: "Never synced — finish the first sync in Settings → Sub2API Sync",
 	activationTitle: "Get started with Sub2API Sync",
 	activationStep1: "1. Connect the panel in Settings (account password or web authorization)",
-	activationStep2: "2. Check the groups to sync (keys are prepared automatically)",
-	activationStep3: "3. Click \"Sync now\" and the models are ready",
+	activationStep2: "2. Tick the keys to sync on the Keys card (cross-group)",
+	activationStep3: "3. Click \"Sync selected\" and the models are ready",
 	activationOpenConfig: "Open configuration",
 	activationDismiss: "Got it",
 	keysTitle: "Keys",
@@ -254,9 +258,13 @@ const en = {
 	keyCreated: "Created and bound: {name}",
 	keysListEmpty: "No keys yet",
 	keysListLoading: "Loading keys…",
+	keysSearchPlaceholder: "Search keys…",
+	keysSearchEmpty: "No keys match",
 	syncSelected: "Sync selected ({count})",
 	syncSelectedDone: "Synced: {ok}/{total} succeeded",
-	keysLoadMore: "Load more ({count} left)"
+	keysPagePrev: "Previous page",
+	keysPageNext: "Next page",
+	keysPageStatus: "Page {page} / {pages} · {total} keys"
 };
 const dictionaries = {
 	zh,
@@ -410,7 +418,7 @@ function createPluginApi() {
 		login2fa: (code) => callJson(ROUTES.login2fa, post({ code })),
 		logout: () => callJson(ROUTES.logout, post()),
 		groups: () => callJson(ROUTES.groups),
-		listKeys: (page, pageSize) => callJson(`${ROUTES.keys}?page=${page}&pageSize=${pageSize}`),
+		listKeys: (page, pageSize, search) => callJson(`${ROUTES.keys}?page=${page}&pageSize=${pageSize}${search !== undefined && search.length > 0 ? `&search=${encodeURIComponent(search)}` : ""}`),
 		createKey: (input) => callJson(ROUTES.keys, post(input)),
 		site: () => callJson(ROUTES.site),
 		account: () => callJson(ROUTES.account),
@@ -749,6 +757,31 @@ const CSS = `
   opacity: 0.55;
 }
 
+/* The keys-card search input: fixed-width slot between the title and the
+   action buttons (see the s2s-actions flex layout). */
+.s2s-searchInput {
+  flex: none;
+  width: 220px;
+}
+
+/* The keys-card pager: centered prev / status / next strip. */
+.s2s-pager {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 10px;
+  flex-wrap: wrap;
+  min-height: 32px;
+}
+
+.s2s-pageStatus {
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 18px;
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+}
+
 /* U2 placements: the provider-card badge, the Models-page footer strip, and
    the Plugins-page activation steps. */
 .s2s-badgeRow {
@@ -1154,12 +1187,16 @@ function protocolForPlatform(platform) {
 //#endregion
 //#region src/client/section/KeysCard.tsx
 const PAGE_SIZE = 5;
+const SEARCH_DEBOUNCE_MS = 300;
 function KeysCard({ api, config, groups, t }) {
 	const snapshot$1 = useConfigForm(config);
 	const [keys, setKeys] = (0, react.useState)([]);
-	const [page, setPage] = (0, react.useState)(0);
+	const [search, setSearch] = (0, react.useState)("");
+	const [query, setQuery] = (0, react.useState)("");
+	const [page, setPage] = (0, react.useState)(1);
 	const [pages, setPages] = (0, react.useState)(1);
 	const [total, setTotal] = (0, react.useState)(0);
+	const [reloadTick, setReloadTick] = (0, react.useState)(0);
 	const [loading, setLoading] = (0, react.useState)(false);
 	const [listError, setListError] = (0, react.useState)(undefined);
 	const [creating, setCreating] = (0, react.useState)(false);
@@ -1170,23 +1207,41 @@ function KeysCard({ api, config, groups, t }) {
 	const [busy, setBusy] = (0, react.useState)(false);
 	const [syncing, setSyncing] = (0, react.useState)(false);
 	const [feedback, setFeedback] = (0, react.useState)(undefined);
-	const loadPage = (next) => {
+	const appliedQueryRef = (0, react.useRef)(query);
+	(0, react.useEffect)(() => {
+		const timer$1 = window.setTimeout(() => {
+			const next = search.trim();
+			if (appliedQueryRef.current !== next) {
+				appliedQueryRef.current = next;
+				setQuery(next);
+				setPage(1);
+			}
+		}, SEARCH_DEBOUNCE_MS);
+		return () => window.clearTimeout(timer$1);
+	}, [search]);
+	const requestSeqRef = (0, react.useRef)(0);
+	(0, react.useEffect)(() => {
+		const requestId = ++requestSeqRef.current;
 		setLoading(true);
 		setListError(undefined);
-		api.listKeys(next, PAGE_SIZE).then((response) => {
-			setKeys((previous) => next === 1 ? response.keys : [...previous, ...response.keys]);
+		api.listKeys(page, PAGE_SIZE, query === "" ? undefined : query).then((response) => {
+			if (requestSeqRef.current !== requestId) return;
+			setKeys(response.keys);
 			setPages(response.pages);
 			setTotal(response.total);
-			setPage(next);
+			if (response.pages > 0 && page > response.pages) setPage(response.pages);
 		}).catch((cause) => {
+			if (requestSeqRef.current !== requestId) return;
 			setListError(cause instanceof Error ? cause.message : String(cause));
 		}).finally(() => {
-			setLoading(false);
+			if (requestSeqRef.current === requestId) setLoading(false);
 		});
-	};
-	(0, react.useEffect)(() => {
-		loadPage(1);
-	}, [api]);
+	}, [
+		api,
+		page,
+		query,
+		reloadTick
+	]);
 	const selectedIds = snapshot$1.value?.selectedKeys ?? [];
 	const toggle = (keyId, next) => {
 		const nextSet = new Set(selectedIds);
@@ -1247,7 +1302,8 @@ else nextSet.delete(keyId);
 				text: t("keyCreated", { name: response.key.name })
 			});
 			closeCreate();
-			loadPage(1);
+			setPage(1);
+			setReloadTick((tick) => tick + 1);
 		}).catch((cause) => {
 			setFeedback({
 				tone: "error",
@@ -1282,10 +1338,19 @@ else nextSet.delete(keyId);
 				}), (0, react_jsx_runtime.jsxs)("div", {
 					className: "s2s-actions",
 					children: [
+						(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Input, {
+							className: "s2s-searchInput",
+							type: "text",
+							value: search,
+							placeholder: t("keysSearchPlaceholder"),
+							onChange: (event) => {
+								setSearch(event.target.value);
+							}
+						}),
 						(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
 							variant: "outline",
 							onClick: () => {
-								loadPage(1);
+								setReloadTick((tick) => tick + 1);
 							},
 							children: t("groupsRefresh")
 						}),
@@ -1315,7 +1380,7 @@ else nextSet.delete(keyId);
 			}),
 			!loading && keys.length === 0 && listError === undefined && (0, react_jsx_runtime.jsx)("p", {
 				className: "s2s-feedback s2s-hint",
-				children: t("keysListEmpty")
+				children: query !== "" ? t("keysSearchEmpty") : t("keysListEmpty")
 			}),
 			loading && keys.length === 0 && (0, react_jsx_runtime.jsx)("p", {
 				className: "s2s-feedback s2s-hint",
@@ -1360,16 +1425,34 @@ else nextSet.delete(keyId);
 					}, key.id);
 				})
 			}),
-			keys.length > 0 && page < pages && (0, react_jsx_runtime.jsx)("div", {
-				className: "s2s-actions",
-				children: (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
-					variant: "outline",
-					disabled: loading,
-					onClick: () => {
-						loadPage(page + 1);
-					},
-					children: t("keysLoadMore", { count: Math.max(0, Math.min(PAGE_SIZE, total - keys.length)) })
-				})
+			keys.length > 0 && (pages > 1 || query !== "") && (0, react_jsx_runtime.jsxs)("div", {
+				className: "s2s-pager",
+				children: [
+					(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "outline",
+						disabled: loading || page <= 1,
+						onClick: () => {
+							setPage(page - 1);
+						},
+						children: t("keysPagePrev")
+					}),
+					(0, react_jsx_runtime.jsx)("span", {
+						className: "s2s-pageStatus",
+						children: t("keysPageStatus", {
+							page,
+							pages,
+							total
+						})
+					}),
+					(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "outline",
+						disabled: loading || page >= pages,
+						onClick: () => {
+							setPage(page + 1);
+						},
+						children: t("keysPageNext")
+					})
+				]
 			}),
 			(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Modal, {
 				open: creating,
@@ -2319,7 +2402,7 @@ function DetailSectionBody({ t }) {
 //#endregion
 //#region src/client/plugins/ActivationGuide.tsx
 function ActivationGuide(props) {
-	const { t, onDismiss, onOpenDetails } = props;
+	const { t, onDismiss, onOpenDetails, openBundleDetails } = props;
 	return (0, react_jsx_runtime.jsxs)("div", {
 		className: "s2s-card",
 		children: [
@@ -2339,7 +2422,9 @@ function ActivationGuide(props) {
 				className: "s2s-actions",
 				children: [(0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
 					variant: "primary",
-					onClick: onOpenDetails,
+					onClick: () => {
+						if (!(openBundleDetails?.() ?? false)) onOpenDetails();
+					},
 					children: t("activationOpenConfig")
 				}), (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Button, {
 					variant: "ghost",
@@ -2397,10 +2482,17 @@ function mount(ctx) {
 		id: "sub2api-sync",
 		locale: NS
 	}, DetailSection));
+	const activationOps = { openBundleDetails: () => {
+		const nav = ctx.pluginNavigation;
+		if (nav === undefined) return false;
+		nav.openBundle(PKG_NAME);
+		return true;
+	} };
 	ctx.slots.inject("plugins.bundle.activation", () => ctx.slots.register({
 		name: "plugins.bundle.activation",
 		key: PKG_NAME,
-		locale: NS
+		locale: NS,
+		inject: () => activationOps
 	}, ActivationGuide));
 }
 
@@ -2410,7 +2502,8 @@ const name = "dsh-sub2api-sync-client";
 const inject = [
 	"slots",
 	"locale",
-	"configForms"
+	"configForms",
+	"pluginNavigation"
 ];
 function apply(ctx) {
 	mount(ctx);

package/lib/index.js

@@ -1829,6 +1829,8 @@ var PanelClient = class {
 			timezone: timeZoneOf()
 		});
 		if (options?.groupId !== undefined) query.set("group_id", String(options.groupId));
+		const search = options?.search?.trim();
+		if (search !== undefined && search.length > 0) query.set("search", search);
 		const data = await this.call(token, "GET", `/keys?${query.toString()}`);
 		const record = data;
 		const items = record?.items;
@@ -2206,11 +2208,11 @@ function conflictStatus(error) {
 function registerRoutes(ctx, deps) {
 	ctx.inject(["webServer"], (webCtx) => {
 		const route = (path, handler) => {
-			webCtx.webServer.register({
+			webCtx.effect(() => webCtx.webServer.register({
 				kind: "exact",
 				path,
 				handler
-			});
+			}));
 		};
 		const guard = (req, res) => {
 			if (!trustedRequest(req, deps.allowRemote())) {
@@ -2342,7 +2344,9 @@ function registerRoutes(ctx, deps) {
 					const rawSize = Number(url.searchParams.get("pageSize") ?? "5");
 					const page = Number.isSafeInteger(rawPage) && rawPage > 0 ? rawPage : 1;
 					const pageSize = Number.isSafeInteger(rawSize) && rawSize > 0 ? Math.min(rawSize, 50) : 5;
-					const result = await deps.listKeys(page, pageSize);
+					const rawSearch = (url.searchParams.get("search") ?? "").trim();
+					const search = rawSearch.length > 0 ? rawSearch : undefined;
+					const result = await deps.listKeys(page, pageSize, search);
 					json(res, 200, {
 						ok: true,
 						keys: result.keys,
@@ -2528,6 +2532,8 @@ function registerRoutes(ctx, deps) {
 				});
 			}
 		});
+	}).then(undefined, (error) => {
+		ctx.logger.error(error);
 	});
 }
 /** Standalone failure page when the callback handler itself throws. Inline on
@@ -2688,10 +2694,11 @@ function apply(ctx, config) {
 		},
 		lastReport: () => reports.report(),
 		lastReportAt: () => reports.at(),
-		listKeys: async (page, pageSize) => {
+		listKeys: async (page, pageSize, search) => {
 			const result = await gateway.use((panel, token) => panel.listKeys(token, {
 				page,
-				pageSize
+				pageSize,
+				...search !== undefined && search.length > 0 ? { search } : {}
 			}));
 			return {
 				keys: result.items.map((key) => ({

package/lib/panel.d.ts

@@ -100,6 +100,7 @@ export declare class PanelClient {
         groupId?: number;
         page?: number;
         pageSize?: number;
+        search?: string;
         sortBy?: string;
         sortOrder?: string;
     }): Promise<PanelKeyPage>;

package/lib/routes.d.ts

@@ -193,8 +193,9 @@ export interface RouteDeps {
     sync(keyIds?: number[]): Promise<SyncReport>;
     lastReport(): SyncReport | undefined;
     lastReportAt(): number | undefined;
-    /** One page of the panel's keys (newest first; page is 1-based). */
-    listKeys(page: number, pageSize: number): Promise<KeysListPage>;
+    /** One page of the panel's keys (newest first; page is 1-based), optional
+     * server-side `search` over key names. */
+    listKeys(page: number, pageSize: number, search?: string): Promise<KeysListPage>;
     /** Create one relay key (name defaults to the group name upstream of this seam). */
     createKey(input: {
         groupId: number;
@@ -247,7 +248,16 @@ export interface RouteDeps {
     /** Drop a pending attempt (user cancelled the dialog). */
     oauthCancel(attemptId: string): Promise<void>;
 }
-/** Register all card routes on the web server (no-op without one). */
+/** Register all card routes on the web server (no-op without one).
+ *
+ * Lifecycle: every registration's disposer rides the registering inject fiber
+ * (`webCtx.effect`). A plugin reload must remove its routes BEFORE the next
+ * apply re-registers them — the webserver rejects duplicate (kind, path)
+ * entries, and a dropped disposer would orphan the old entries: the new apply
+ * fails silently (an inject child failure does not fail the plugin fiber) and
+ * the table keeps serving the disposed fiber's closures, whose every service
+ * access then throws `cannot get required service … in inactive context`
+ * (the OAuth callback's 授权失败). */
 export declare function registerRoutes(ctx: Context, deps: RouteDeps): void;
 /**
  * Assemble the `ownedRoutes` view for the status endpoint from the live

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Sub2API Sync",
-    "description": "Sync one sub2api instance's groups, keys, and models into dsh-llm-pi-ai provider routes: panel-driven login (PAT / password / OAuth) first, one group one provider."
+    "description": "Sync one sub2api instance's groups, keys, and models into dsh-llm-pi-ai provider routes: panel-driven login (password / OAuth), one relay key one provider."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Sub2API 同步",
-    "description": "把一个 sub2api 实例的分组、key 与模型同步为 dsh-llm-pi-ai 供应商路由：先连接面板（PAT / 密码 / OAuth），一个分组一个供应商。"
+    "description": "把一个 sub2api 实例的分组、key 与模型同步为 dsh-llm-pi-ai 供应商路由：面板登录（密码 / OAuth），一把 key 一个供应商。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mangoc/dsh-sub2api-sync",
-  "description": "Sync one sub2api instance's groups, keys, and models into dsh-llm-pi-ai provider routes: panel-driven login (password / OAuth) first, one group one provider.",
-  "version": "0.2.0",
+  "description": "Sync one sub2api instance's groups, keys, and models into dsh-llm-pi-ai provider routes: panel-driven login (password / OAuth), one relay key one provider.",
+  "version": "0.2.2",
   "license": "MIT",
   "author": "Shuai-S",
   "homepage": "https://github.com/Shuai-S/dsh-sub2api-sync#readme",