@michengai/dsh-agency-agents 0.1.13 → 0.1.15

package/README.md

@@ -18,7 +18,7 @@
 
 ## Features
 
-- Browse, enable, and disable bundled experts across 17 divisions in **Settings → Experts**.
+- Filter by category or search, then enable or disable bundled experts in **Settings → Experts**.
 - Summon enabled experts by name or slug from the composer's **Experts** picker.
 - Use `list_experts` to discover experts and `summon_expert` to start a one-shot specialist subagent.
 - Use 271 bundled personas immediately, or connect a separately synchronized expert directory.

package/README.zh-CN.md

@@ -18,7 +18,7 @@
 
 ## 功能概览
 
-- 在「设置 → 专家」中按 17 个分区浏览、启用或停用内置专家。
+- 在「设置 → 专家」中按分类筛选或搜索，再启用或停用内置专家。
 - 在输入框的「专家」中按名称或 slug 召唤已启用的专家处理完整任务。
 - 提供 `list_experts` 与 `summon_expert` 工具，分别用于发现专家和启动一次性子代理。
 - 内置 271 份 persona，无需额外下载；也可接入自行同步的专家目录。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/05-/346/212/200/346/234/257/346/236/266/346/236/204/345/237/272/347/272/277.md

@@ -1,6 +1,6 @@
 # 技术架构基线
 
-更新时间：2026-08-16 00:10（Asia/Shanghai）
+更新时间：2026-08-17 03:00（Asia/Shanghai）
 
 - 运行时：Node.js ESM、TypeScript 严格模式、DSH/Cordis 插件机制。
 - 智能体资产：`assets\agency-agents` 是默认根目录；显式 `root` 优先，其次读取 `AGENCY_AGENTS_ROOT`。
@@ -9,7 +9,8 @@
 - 深度：`maxDepth` 为可选正整数绝对上限；未配置时不改变宿主的既有深度策略。
 - 启停与持久化：通过 `@deepseek-ai/dsh-settings` 的 settings namespace（`agency-agents`，schema `{ enabled: string[] }`）在宿主侧持久化；**白名单语义，默认全停用**，用户在设置「专家」标签页启用。宿主工具按「已启用」过滤。
 - 客户端取数：启用状态不经过 `api.settings`（那是 Host 自有配置面，`WEB_SETTINGS_NAMESPACES` 白名单对第三方插件硬编码封死），改走插件自有的 **Typert Remote** 通道 —— 宿主 `AgencyAgentsRemote extends TypertRemoteService`（`@Remote getEnabled/setEnabled`）由 gateway SRC 自动发现，客户端 `$mount(TYPERT_REMOTE)` 后经 `ctx.remote.agencyAgents` 读写（`src/client/remote.ts` 手写 strict 贡献）。第三方安装无需修改或重编 DSH 源码。
-- 客户端：client bundle（`lib/client.js`，`window.__ModuleLoader__.load` 格式）提供 composer「专家」按钮 + 弹窗、设置「专家」标签页、@ 菜单；静态花名册与中文名打包进 client（`src/client/roster.ts`、`src/names.ts`）。
+- 客户端：client bundle（`lib/client.js`，`window.__ModuleLoader__.load` 格式）提供 composer「专家」按钮 + 弹窗、设置「专家」标签页、@ 菜单；静态花名册与中英文名打包进 client（`src/client/roster.ts`、`src/names.ts`）。界面词条走 `agency` 命名空间；专家名/简介/排序跟随 `locale` 的 `zh`/`en`。
+- 宿主文案：`list_experts` 的名单、分区标题和用户可见错误读取 settings `locale.preference`（仅显式 `en` 走英文，其余回退 `zh`）。分区筛选同时认 key、中文名和英文名。
 - 发布：包必须包含 `lib`（含 `client.js`）、智能体资产、`cordis.patch.yml`、Apache `LICENSE` 和 `NOTICE`。
 
 ## 与早期临时动态插件（agency-1）的差异

package/docs/03-/346/212/200/346/234/257/346/236/266/346/236/204/00-/346/217/222/344/273/266/346/236/266/346/236/204.md

@@ -7,6 +7,9 @@
 ## 组件职责
 
 - `src\index.ts`：解析 frontmatter、加载目录、注册工具和系统提示。
+- `src\i18n.ts`：宿主侧中英文词条，以及分区/专家名的语言切换。
+- `src\names.ts`：中英文分区名与中文专家名。
+- `src\client\locales.ts`：设置页、按钮、`@` 菜单的客户端词条。
 - `cordis.patch.yml`：通过 DSH bundle 把插件挂载进 profile。
 - `scripts\verify.mjs`：校验构建入口、发布文件、bundle patch 和许可证资产。
 - `assets\agency-agents`：上游 persona 快照；仅其中的合法 frontmatter Markdown 会进入目录。

package/lib/client.js

@@ -49,6 +49,26 @@ window.__ModuleLoader__.load({
 			support: "支持",
 			testing: "测试"
 		};
+		/** 分区目录名 → 英文分区名。 */
+		const EN_DIVISION = {
+			academic: "Academic",
+			design: "Design",
+			engineering: "Engineering",
+			finance: "Finance",
+			"game-development": "Game Development",
+			gis: "GIS",
+			healthcare: "Healthcare",
+			marketing: "Marketing",
+			"paid-media": "Paid Media",
+			product: "Product",
+			"project-management": "Project Management",
+			sales: "Sales",
+			security: "Security",
+			"spatial-computing": "Spatial Computing",
+			specialized: "Specialized",
+			support: "Support",
+			testing: "Testing"
+		};
 		/** 智能体 slug（文件名去 .md）→ 中文名（现实岗位）。缺省时回退英文 frontmatter name。 */
 		const ZH_NAME = {
 			"academic-anthropologist": "人类学家",
@@ -2509,6 +2529,16 @@ window.__ModuleLoader__.load({
 			"settings.loading": "正在加载专家…",
 			"settings.enabled": "已启用",
 			"settings.disabled": "已停用",
+			"settings.filter.category": "分类",
+			"settings.filter.all": "全部",
+			"settings.filter.option": "{name}（{count}）",
+			"settings.filter.showing.one": "显示 {count} 位",
+			"settings.filter.showing.other": "显示 {count} 位",
+			"settings.search": "搜索",
+			"settings.search.placeholder": "名称、slug 或简介",
+			"settings.search.clear": "清除搜索",
+			"settings.empty": "没有匹配的专家。试试其他关键词，或切换到「{all}」。",
+			"settings.empty.reset": "清除筛选",
 			"error.conflict": "配置已被其他窗口修改。",
 			"error.conflict.refreshed": "配置已被其他窗口修改，已为您刷新。",
 			"error.conflict.refreshFailed": "配置已被其他窗口修改，但刷新失败，请手动刷新。",
@@ -2522,7 +2552,6 @@ window.__ModuleLoader__.load({
 			"summary.group": "{count} 个",
 			"button.title": "召唤专家",
 			"menu.empty": "暂无可召唤的专家",
-			"group.count": "{division}（{count}）",
 			"summon.instruction": "召唤专家「{name}」（{slug}）处理以下任务：",
 			"summon.instruction.withTask": "召唤专家「{name}」（{slug}）处理以下任务：\n{task}",
 			"division.academic": ZH_DIVISION.academic,
@@ -2550,6 +2579,16 @@ window.__ModuleLoader__.load({
 			"settings.loading": "Loading experts…",
 			"settings.enabled": "Enabled",
 			"settings.disabled": "Disabled",
+			"settings.filter.category": "Category",
+			"settings.filter.all": "All",
+			"settings.filter.option": "{name} ({count})",
+			"settings.filter.showing.one": "Showing {count} expert",
+			"settings.filter.showing.other": "Showing {count} experts",
+			"settings.search": "Search",
+			"settings.search.placeholder": "Name, slug, or description",
+			"settings.search.clear": "Clear search",
+			"settings.empty": "No matching experts. Try another keyword, or switch to {all}.",
+			"settings.empty.reset": "Clear filters",
 			"error.conflict": "Settings were changed in another window.",
 			"error.conflict.refreshed": "Settings were changed in another window and have been refreshed.",
 			"error.conflict.refreshFailed": "Settings were changed in another window, but refresh failed. Please refresh manually.",
@@ -2563,26 +2602,25 @@ window.__ModuleLoader__.load({
 			"summary.group": "{count} items",
 			"button.title": "Summon expert",
 			"menu.empty": "No experts available yet",
-			"group.count": "{division} ({count})",
 			"summon.instruction": "Summon expert \"{name}\" ({slug}) to handle the following task:",
 			"summon.instruction.withTask": "Summon expert \"{name}\" ({slug}) to handle the following task:\n{task}",
-			"division.academic": "Academic",
-			"division.design": "Design",
-			"division.engineering": "Engineering",
-			"division.finance": "Finance",
-			"division.game-development": "Game Development",
-			"division.gis": "GIS",
-			"division.healthcare": "Healthcare",
-			"division.marketing": "Marketing",
-			"division.paid-media": "Paid Media",
-			"division.product": "Product",
-			"division.project-management": "Project Management",
-			"division.sales": "Sales",
-			"division.security": "Security",
-			"division.spatial-computing": "Spatial Computing",
-			"division.specialized": "Specialized",
-			"division.support": "Support",
-			"division.testing": "Testing"
+			"division.academic": EN_DIVISION.academic,
+			"division.design": EN_DIVISION.design,
+			"division.engineering": EN_DIVISION.engineering,
+			"division.finance": EN_DIVISION.finance,
+			"division.game-development": EN_DIVISION["game-development"],
+			"division.gis": EN_DIVISION.gis,
+			"division.healthcare": EN_DIVISION.healthcare,
+			"division.marketing": EN_DIVISION.marketing,
+			"division.paid-media": EN_DIVISION["paid-media"],
+			"division.product": EN_DIVISION.product,
+			"division.project-management": EN_DIVISION["project-management"],
+			"division.sales": EN_DIVISION.sales,
+			"division.security": EN_DIVISION.security,
+			"division.spatial-computing": EN_DIVISION["spatial-computing"],
+			"division.specialized": EN_DIVISION.specialized,
+			"division.support": EN_DIVISION.support,
+			"division.testing": EN_DIVISION.testing
 		};
 		//#endregion
 		//#region node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
@@ -6627,10 +6665,17 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			emoji: e.emoji,
 			division: e.division,
 			divisionZh: ZH_DIVISION[e.division] ?? e.division,
+			divisionEn: EN_DIVISION[e.division] ?? e.division,
 			description: e.description,
 			descriptionEn: e.descriptionEn
 		})).sort((a, b) => a.division.localeCompare(b.division) || a.slug.localeCompare(b.slug));
-		function groupByDivision(list) {
+		/** 按当前语言比较专家显示名，供设置页和菜单分组排序。 */
+		function compareExpertName(a, b, active) {
+			const left = active === "en" ? a.nameEn : a.name;
+			const right = active === "en" ? b.nameEn : b.name;
+			return left.localeCompare(right, active === "en" ? "en" : "zh");
+		}
+		function groupByDivision(list, active) {
 			const groups = /* @__PURE__ */ new Map();
 			for (const e of list) {
 				const arr = groups.get(e.division) ?? [];
@@ -6640,9 +6685,34 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return DIVISION_ORDER.filter((d) => groups.has(d)).map((d) => ({
 				division: d,
 				divisionZh: ZH_DIVISION[d] ?? d,
-				experts: (groups.get(d) ?? []).slice().sort((a, b) => a.name.localeCompare(b.name, "zh"))
+				experts: (groups.get(d) ?? []).slice().sort((a, b) => compareExpertName(a, b, active))
 			}));
 		}
+		/** 规范化检索词：去首尾空白并转小写，便于中英和 slug 统一匹配。 */
+		function normalizeExpertQuery(query) {
+			return query.trim().toLowerCase();
+		}
+		/** 按名称、slug、分区或简介做包含匹配；空检索视为全部命中。 */
+		function matchExpertQuery(expert, query) {
+			const q = normalizeExpertQuery(query);
+			if (q === "") return true;
+			return [
+				expert.slug,
+				expert.name,
+				expert.nameEn,
+				expert.division,
+				expert.divisionZh,
+				expert.divisionEn,
+				expert.description,
+				expert.descriptionEn
+			].some((field) => field.toLowerCase().includes(q));
+		}
+		/** 先按分区收窄，再按检索词过滤。division 为空表示全部分类。 */
+		function filterExperts(list, options) {
+			const division = options.division ?? "";
+			return list.filter((expert) => (division === "" || expert.division === division) && matchExpertQuery(expert, options.query ?? ""));
+		}
+		const DIVISION_COUNTS = Object.fromEntries(DIVISION_ORDER.map((division) => [division, EXPERTS.filter((expert) => expert.division === division).length]));
 		/** 按当前 locale 取专家显示名：en 用花名册英文名，其余用中文名。 */
 		function displayName(e, active) {
 			return active === "en" ? e.nameEn : e.name;
@@ -6651,7 +6721,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function displayDescription(e, active) {
 			return active === "en" && e.descriptionEn !== "" ? e.descriptionEn : e.description;
 		}
-		const CSS = ".aag-btn-wrap{position:relative;order:1;margin-right:-8px}.aag-btn{display:inline-flex;align-items:center;gap:4px;height:28px;padding:0 4px 0 8px;border:none;border-radius:24px;background:transparent;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px;font-weight:500;cursor:pointer}.aag-btn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}.aag-menu{position:absolute;bottom:calc(100% + 4px);left:0;box-sizing:border-box;padding:4px;display:flex;flex-direction:column;gap:0;width:300px;max-width:360px;max-height:calc(100vh - 24px);overflow-y:auto;border:1px solid var(--dsw-alias-border-inverted);border-radius:12px;background:var(--dsw-specific-menu);box-shadow:var(--dsw-shadow-lv3);z-index:10000}.aag-menu-title{padding:8px 10px;font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary)}.aag-menu-item{display:flex;align-items:center;gap:8px;width:100%;min-height:40px;padding:8px 10px;border:none;border-radius:10px;background:transparent;cursor:pointer;text-align:left;font-size:14px;line-height:22px;color:var(--dsw-alias-label-primary);box-sizing:border-box}.aag-menu-item:hover{background:var(--dsw-alias-interactive-bg-hover)}.aag-emoji{flex:0 0 auto;font-size:16px}.aag-menu-empty{padding:8px 10px;color:var(--dsw-alias-label-secondary);font-size:13px}[data-composer-card] :has(> button[aria-haspopup=\"listbox\"]) > :nth-child(2){order:2}\n.aag-section{box-sizing:border-box;display:flex;min-width:0;max-width:760px;width:100%;margin:0 auto;flex-direction:column;gap:16px;padding:0 0 32px;color:var(--dsw-alias-label-primary)}\n.aag-toolbar{display:flex;align-items:flex-start;gap:16px;padding-bottom:12px}\n.aag-title{margin:0;font-size:20px;line-height:28px;font-weight:650;letter-spacing:-.2px}\n.aag-desc{margin:4px 0 0;max-width:42em;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}\n.aag-actions{display:flex;align-items:center;gap:8px;margin-left:auto}\n.aag-action{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;min-height:32px;padding:0 12px;border:1px solid transparent;border-radius:8px;background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);font:inherit;font-size:13px;font-weight:550;cursor:pointer;transition:opacity 180ms ease,background 180ms ease,border-color 180ms ease}\n.aag-action:hover:not(:disabled){opacity:.9}.aag-action:disabled{opacity:.5;cursor:default}\n.aag-action-secondary{background:transparent;border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}\n.aag-action:focus-visible{outline:2px solid var(--dsw-alias-state-success-primary);outline-offset:2px}\n.aag-summary{display:flex;align-items:center;gap:12px;padding:12px 14px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:var(--dsw-alias-bg-layer-2)}\n.aag-summary-count{font-size:18px;font-weight:650}.aag-summary-label{color:var(--dsw-alias-label-secondary);font-size:12px}.aag-summary-separator{width:1px;height:24px;background:var(--dsw-alias-border-l2)}\n.aag-group{display:flex;flex-direction:column;overflow:hidden;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-2)}\n.aag-group-head{display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1px solid var(--dsw-alias-border-l1)}\n.aag-group-title{margin:0;font-size:14px;font-weight:600}.aag-count{color:var(--dsw-alias-label-tertiary);font-size:12px}\n.aag-row{display:flex;align-items:center;gap:12px;padding:13px 16px;border-bottom:1px solid var(--dsw-alias-border-l1)}\n.aag-row:last-child{border-bottom:0}\n.aag-row-main{display:flex;min-width:0;flex:1;flex-direction:column;gap:3px}\n.aag-row-id{display:flex;align-items:center;gap:7px;min-width:0}\n.aag-row-name{overflow:hidden;font-size:13px;font-weight:500;line-height:20px;text-overflow:ellipsis;white-space:nowrap}\n.aag-tag{flex:none;padding:1px 6px;border:1px solid var(--dsw-alias-border-l3);border-radius:4px;color:var(--dsw-alias-label-secondary);font-size:11px;line-height:16px}\n.aag-tag-on{border-color:var(--dsw-alias-state-success-primary);color:var(--dsw-alias-state-success-primary)}\n.aag-tag-off{border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}\n.aag-note{overflow:hidden;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;text-overflow:ellipsis;white-space:nowrap}\n.aag-error{color:var(--dsw-alias-state-error-primary);font-size:13px;line-height:20px}\n@media (max-width:560px){.aag-toolbar{flex-wrap:wrap}.aag-actions{margin-left:0}.aag-row{align-items:flex-start;flex-wrap:wrap}.aag-row>.aag-action{margin-left:auto}}\n@media (prefers-reduced-motion:reduce){.aag-action{transition:none}}\n" + DIVISION_ORDER.map((d) => `[role="listbox"] div[data-source="division.${d}"] ~ button span:last-child`).join(",") + "{flex:1 1 auto;max-width:none;min-width:0}";
+		const CSS = ".aag-btn-wrap{position:relative;order:1;margin-right:-8px}.aag-btn{display:inline-flex;align-items:center;gap:4px;height:28px;padding:0 4px 0 8px;border:none;border-radius:24px;background:transparent;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px;font-weight:500;cursor:pointer}.aag-btn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}.aag-menu{position:absolute;bottom:calc(100% + 4px);left:0;box-sizing:border-box;padding:4px;display:flex;flex-direction:column;gap:0;width:300px;max-width:360px;max-height:calc(100vh - 24px);overflow-y:auto;border:1px solid var(--dsw-alias-border-inverted);border-radius:12px;background:var(--dsw-specific-menu);box-shadow:var(--dsw-shadow-lv3);z-index:10000}.aag-menu-title{padding:8px 10px;font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary)}.aag-menu-item{display:flex;align-items:center;gap:8px;width:100%;min-height:40px;padding:8px 10px;border:none;border-radius:10px;background:transparent;cursor:pointer;text-align:left;font-size:14px;line-height:22px;color:var(--dsw-alias-label-primary);box-sizing:border-box}.aag-menu-item:hover{background:var(--dsw-alias-interactive-bg-hover)}.aag-emoji{flex:0 0 auto;font-size:16px}.aag-menu-empty{padding:8px 10px;color:var(--dsw-alias-label-secondary);font-size:13px}[data-composer-card] :has(> button[aria-haspopup=\"listbox\"]) > :nth-child(2){order:2}\n.aag-section{box-sizing:border-box;display:flex;min-width:0;max-width:760px;width:100%;margin:0 auto;flex-direction:column;gap:16px;padding:0 0 32px;color:var(--dsw-alias-label-primary)}\n.aag-toolbar{display:flex;align-items:flex-start;gap:16px;padding-bottom:12px}\n.aag-title{margin:0;font-size:20px;line-height:28px;font-weight:650;letter-spacing:-.2px}\n.aag-desc{margin:4px 0 0;max-width:42em;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}\n.aag-actions{display:flex;align-items:center;gap:8px;margin-left:auto}\n.aag-action{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;min-height:32px;padding:0 12px;border:1px solid transparent;border-radius:8px;background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);font:inherit;font-size:13px;font-weight:550;cursor:pointer;transition:opacity 180ms ease,background 180ms ease,border-color 180ms ease}\n.aag-action:hover:not(:disabled){opacity:.9}.aag-action:disabled{opacity:.5;cursor:default}\n.aag-action-secondary{background:transparent;border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}\n.aag-action:focus-visible{outline:2px solid var(--dsw-alias-state-success-primary);outline-offset:2px}\n.aag-summary{display:flex;align-items:center;gap:12px;padding:12px 14px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:var(--dsw-alias-bg-layer-2)}\n.aag-summary-count{font-size:18px;font-weight:650}.aag-summary-label{color:var(--dsw-alias-label-secondary);font-size:12px}.aag-summary-separator{width:1px;height:24px;background:var(--dsw-alias-border-l2)}\n.aag-group{display:flex;flex-direction:column;overflow:hidden;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-2)}\n.aag-group-head{display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1px solid var(--dsw-alias-border-l1)}\n.aag-group-title{margin:0;font-size:14px;font-weight:600}.aag-count{color:var(--dsw-alias-label-tertiary);font-size:12px}\n.aag-row{display:flex;align-items:center;gap:12px;padding:13px 16px;border-bottom:1px solid var(--dsw-alias-border-l1)}\n.aag-row:last-child{border-bottom:0}\n.aag-row-main{display:flex;min-width:0;flex:1;flex-direction:column;gap:3px}\n.aag-row-id{display:flex;align-items:center;gap:7px;min-width:0}\n.aag-row-name{overflow:hidden;font-size:13px;font-weight:500;line-height:20px;text-overflow:ellipsis;white-space:nowrap}\n.aag-tag{flex:none;padding:1px 6px;border:1px solid var(--dsw-alias-border-l3);border-radius:4px;color:var(--dsw-alias-label-secondary);font-size:11px;line-height:16px}\n.aag-tag-on{border-color:var(--dsw-alias-state-success-primary);color:var(--dsw-alias-state-success-primary)}\n.aag-tag-off{border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}\n.aag-note{overflow:hidden;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;text-overflow:ellipsis;white-space:nowrap}\n.aag-error{color:var(--dsw-alias-state-error-primary);font-size:13px;line-height:20px}\n.aag-filters{display:flex;align-items:flex-end;gap:10px}\n.aag-field{display:flex;min-width:0;flex:1;flex-direction:column;gap:6px}\n.aag-field-category{flex:0 1 220px}\n.aag-field-search{flex:1 1 240px}\n.aag-label{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:16px}\n.aag-control{box-sizing:border-box;width:100%;min-height:32px;padding:0 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font:inherit;font-size:13px}\n.aag-control:focus-visible{outline:2px solid var(--dsw-alias-state-success-primary);outline-offset:2px}\n.aag-search-wrap{position:relative;display:flex;align-items:center}\n.aag-search{padding-right:32px}.aag-search::-webkit-search-cancel-button,.aag-search::-webkit-search-decoration{-webkit-appearance:none;appearance:none}\n.aag-search-clear{position:absolute;right:4px;display:inline-flex;align-items:center;justify-content:center;width:24px;height:24px;border:0;border-radius:6px;background:transparent;color:var(--dsw-alias-label-tertiary);font:inherit;font-size:16px;line-height:1;cursor:pointer}\n.aag-search-clear:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}\n.aag-search-clear:focus-visible{outline:2px solid var(--dsw-alias-state-success-primary);outline-offset:2px}\n.aag-empty{display:flex;flex-direction:column;align-items:center;gap:12px;padding:28px 16px;border:1px dashed var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px;text-align:center}\n.aag-filter-meta{margin-left:auto;color:var(--dsw-alias-label-tertiary);font-size:12px}\n@media (max-width:560px){.aag-toolbar{flex-wrap:wrap}.aag-actions{margin-left:0}.aag-filters{flex-direction:column;align-items:stretch}.aag-field-category,.aag-field-search{flex:none}.aag-row{align-items:flex-start;flex-wrap:wrap}.aag-row>.aag-action{margin-left:auto}.aag-filter-meta{margin-left:0}}\n@media (prefers-reduced-motion:reduce){.aag-action{transition:none}}\n" + DIVISION_ORDER.map((d) => `[role="listbox"] div[data-source="division.${d}"] ~ button span:last-child`).join(",") + "{flex:1 1 auto;max-width:none;min-width:0}";
 		/** 将写失败映射到 agency 词条；非冲突错误返回 null，由调用方展示原始消息。 */
 		function writeErrorKey(error, options) {
 			if (error instanceof Error && error.message.includes("changed since it was read")) {
@@ -6773,7 +6843,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				});
 				setOpen(false);
 			};
-			const groups = groupByDivision(EXPERTS.filter((e) => enabled.has(e.slug)));
+			const groups = groupByDivision(EXPERTS.filter((e) => enabled.has(e.slug)), props.getActive());
 			const menu = open ? react.default.createElement("div", { className: "aag-menu" }, groups.length === 0 ? react.default.createElement("div", { className: "aag-menu-empty" }, props.t("menu.empty")) : groups.map((g) => menuGroup(g, pick, props.t, props.getActive))) : null;
 			return react.default.createElement("div", { className: "aag-btn-wrap" }, react.default.createElement("button", {
 				type: "button",
@@ -6785,6 +6855,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function AgentsSettings(props) {
 			const [state, setState] = react.default.useState(null);
 			const [error, setError] = react.default.useState(null);
+			const [query, setQuery] = react.default.useState("");
+			const [division, setDivision] = react.default.useState("");
 			const saving = react.default.useRef(false);
 			const [isSaving, setIsSaving] = react.default.useState(false);
 			const load = react.default.useCallback(() => {
@@ -6852,9 +6924,19 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				className: "aag-note"
 			}, props.t("settings.loading")));
 			else {
-				const groups = groupByDivision(EXPERTS);
+				const filtered = filterExperts(EXPERTS, {
+					query,
+					division
+				});
+				const groups = groupByDivision(filtered, props.getActive());
 				const enabledCount = [...state.enabled].filter((slug) => EXPERTS.some((e) => e.slug === slug)).length;
 				const total = EXPERTS.length;
+				const filteredCount = filtered.length;
+				const hasFilter = normalizeExpertQuery(query) !== "" || division !== "";
+				const resetFilters = () => {
+					setQuery("");
+					setDivision("");
+				};
 				nodes.push(react.default.createElement("div", {
 					key: "toolbar",
 					className: "aag-toolbar"
@@ -6867,7 +6949,56 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				nodes.push(react.default.createElement("div", {
 					key: "summary",
 					className: "aag-summary"
-				}, react.default.createElement("span", { className: "aag-summary-count" }, total), react.default.createElement("span", { className: "aag-summary-label" }, props.t(total === 1 ? "summary.total.one" : "summary.total.other", { count: total })), react.default.createElement("span", { className: "aag-summary-separator" }), react.default.createElement("span", { className: "aag-summary-count" }, enabledCount), react.default.createElement("span", { className: "aag-summary-label" }, props.t(enabledCount === 1 ? "summary.enabled.one" : "summary.enabled.other", { count: enabledCount }))));
+				}, react.default.createElement("span", { className: "aag-summary-count" }, total), react.default.createElement("span", { className: "aag-summary-label" }, props.t(total === 1 ? "summary.total.one" : "summary.total.other", { count: total })), react.default.createElement("span", { className: "aag-summary-separator" }), react.default.createElement("span", { className: "aag-summary-count" }, enabledCount), react.default.createElement("span", { className: "aag-summary-label" }, props.t(enabledCount === 1 ? "summary.enabled.one" : "summary.enabled.other", { count: enabledCount })), hasFilter ? react.default.createElement("span", {
+					className: "aag-filter-meta",
+					"aria-live": "polite"
+				}, props.t(filteredCount === 1 ? "settings.filter.showing.one" : "settings.filter.showing.other", { count: filteredCount })) : null));
+				nodes.push(react.default.createElement("div", {
+					key: "filters",
+					className: "aag-filters"
+				}, react.default.createElement("div", { className: "aag-field aag-field-category" }, react.default.createElement("label", {
+					className: "aag-label",
+					htmlFor: "aag-filter-category"
+				}, props.t("settings.filter.category")), react.default.createElement("select", {
+					id: "aag-filter-category",
+					className: "aag-control",
+					value: division,
+					onChange: (ev) => setDivision(ev.currentTarget.value)
+				}, react.default.createElement("option", { value: "" }, props.t("settings.filter.option", {
+					name: props.t("settings.filter.all"),
+					count: total
+				})), DIVISION_ORDER.map((key) => react.default.createElement("option", {
+					key,
+					value: key
+				}, props.t("settings.filter.option", {
+					name: props.t(`division.${key}`),
+					count: DIVISION_COUNTS[key] ?? 0
+				}))))), react.default.createElement("div", { className: "aag-field aag-field-search" }, react.default.createElement("label", {
+					className: "aag-label",
+					htmlFor: "aag-filter-search"
+				}, props.t("settings.search")), react.default.createElement("div", { className: "aag-search-wrap" }, react.default.createElement("input", {
+					id: "aag-filter-search",
+					className: "aag-control aag-search",
+					type: "search",
+					value: query,
+					autoComplete: "off",
+					spellCheck: false,
+					placeholder: props.t("settings.search.placeholder"),
+					onChange: (ev) => setQuery(ev.currentTarget.value)
+				}), query !== "" ? react.default.createElement("button", {
+					type: "button",
+					className: "aag-search-clear",
+					"aria-label": props.t("settings.search.clear"),
+					onClick: () => setQuery("")
+				}, "×") : null))));
+				if (groups.length === 0) nodes.push(react.default.createElement("div", {
+					key: "empty",
+					className: "aag-empty"
+				}, react.default.createElement("div", null, props.t("settings.empty", { all: props.t("settings.filter.all") })), react.default.createElement("button", {
+					type: "button",
+					className: "aag-action aag-action-secondary",
+					onClick: resetFilters
+				}, props.t("settings.empty.reset"))));
 				for (const g of groups) nodes.push(react.default.createElement("div", {
 					key: g.division,
 					className: "aag-group"
@@ -6965,7 +7096,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		exports.apply = apply;
 		exports.applyExpertSummon = applyExpertSummon;
 		exports.buildSummonInstruction = buildSummonInstruction;
+		exports.compareExpertName = compareExpertName;
+		exports.filterExperts = filterExperts;
 		exports.inject = inject;
+		exports.matchExpertQuery = matchExpertQuery;
+		exports.normalizeExpertQuery = normalizeExpertQuery;
 		exports.writeErrorKey = writeErrorKey;
 		exports.writeErrorMessage = writeErrorMessage;
 		return module.exports;