@michengai/dsh-agency-agents 0.1.33 → 0.1.34

package/CHANGELOG.md

@@ -6,6 +6,11 @@ The five most recent published versions are listed below.
 
 ## Unreleased
 
+## 0.1.34 - 2026-09-08
+
+- Fixed the composer Expert picker so its scrollable menu opens within the available viewport space instead of being clipped when many experts are enabled.
+- Kept the initial enabled-first ordering in Expert Settings stable while toggling individual experts, preventing cards from jumping during bulk setup.
+
 ## 0.1.33 - 2026-09-07
 
 - Added independent in-product update checks with automatic updates when a verified DSH update service is available and a profile-specific manual fallback otherwise.

package/CHANGELOG.zh-CN.md

@@ -6,6 +6,11 @@
 
 ## 未发布
 
+## 0.1.34 - 2026-09-08
+
+- 修复输入框「专家」选择器在启用较多专家时超出视口而被截断的问题，菜单现在会在可用空间内展开并滚动。
+- 设置页首次进入后保持已启用优先的卡片顺序，连续启停专家不再让卡片跳动。
+
 ## 0.1.33 - 2026-09-07
 
 - 新增独立的插件内检查更新能力：仅在已验证的 DSH 更新服务可用时自动更新，其余环境提供与 Profile 对应的手工更新命令。

package/lib/client.js

@@ -7690,6 +7690,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			else inactive.push(expert);
 			return [...active, ...inactive];
 		}
+		/** 按首次进入设置页时保存的顺序排列；不在单项启停后重新排序。 */
+		function sortExpertsByOrder(list, order) {
+			const positions = new Map(order.map((slug, index) => [slug, index]));
+			return list.slice().sort((left, right) => {
+				return (positions.get(left.slug) ?? Number.MAX_SAFE_INTEGER) - (positions.get(right.slug) ?? Number.MAX_SAFE_INTEGER);
+			});
+		}
 		const DIVISION_COUNTS = Object.fromEntries(DIVISION_ORDER.map((division) => [division, EXPERTS.filter((expert) => expert.division === division).length]));
 		/** 根据 slug 稳定分配复用头像；空头像池安全回退为第 0 项。 */
 		function expertAvatarIndex(slug, avatarCount) {
@@ -7828,7 +7835,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const MENU_NAME_OVERRIDE = DIVISION_ORDER.map((division) => inputTriggerSourceId(division)).map((name) => `[role="listbox"] div[data-source=${JSON.stringify(name)}] ~ button`).map((selector) => `${selector} span:last-child`).join(",");
 		/** Windows 优先使用彩色 emoji 字体，名称中的普通文字由后续字体安全回退。 */
 		const EXPERT_MENU_NAME_STYLE = "flex:1 1 auto;max-width:none;min-width:0;font-family:\"Segoe UI Emoji\",\"Apple Color Emoji\",\"Noto Color Emoji\",sans-serif!important;font-variant-emoji:emoji!important";
-		const COMPOSER_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}";
+		const COMPOSER_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(100dvh - 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[data-placement=\"below\"]{top:calc(100% + 4px);bottom:auto}.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}";
 		const SETTINGS_CSS = `
 .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)}
 .aag-toolbar{display:flex;align-items:flex-start;gap:16px;padding-bottom:12px}
@@ -8047,6 +8054,23 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function resolveExpertToolbarClick(enabledCount) {
 			return enabledCount === 0 ? "settings" : "menu";
 		}
+		/**
+		* 让浮层始终留在可视区域内。输入框通常贴近底部，因此默认向上展开；
+		* 当上方空间更小时，改为向下展开并将列表限制在实际可滚动的高度内。
+		*/
+		function resolveExpertMenuPosition(trigger, viewportHeight) {
+			const gap = 4;
+			const viewportInset = 12;
+			const above = Math.max(0, Math.floor(trigger.top - gap - viewportInset));
+			const below = Math.max(0, Math.floor(viewportHeight - trigger.bottom - gap - viewportInset));
+			return above >= below ? {
+				placement: "above",
+				maxHeight: above
+			} : {
+				placement: "below",
+				maxHeight: below
+			};
+		}
 		const SETTINGS_TRIGGER_LABELS = /* @__PURE__ */ new Set(["设置", "Settings"]);
 		const COMPOSER_TRIGGER_SCOPE = "[data-composer-card], .aag-btn-wrap";
 		function isSettingsTriggerLabel(label) {
@@ -8146,6 +8170,33 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const [open, setOpen] = react.default.useState(false);
 			const [enabled, setEnabled] = react.default.useState(/* @__PURE__ */ new Set());
 			const [insertError, setInsertError] = react.default.useState(null);
+			const [menuPosition, setMenuPosition] = react.default.useState();
+			const rootRef = react.default.useRef(null);
+			react.default.useLayoutEffect(() => {
+				if (!open) return;
+				const updatePosition = () => {
+					const root = rootRef.current;
+					if (root === null) return;
+					const viewportHeight = window.visualViewport?.height ?? window.innerHeight;
+					const next = resolveExpertMenuPosition(root.getBoundingClientRect(), viewportHeight);
+					setMenuPosition((current) => current?.placement === next.placement && current.maxHeight === next.maxHeight ? current : next);
+				};
+				updatePosition();
+				window.addEventListener("resize", updatePosition);
+				window.addEventListener("scroll", updatePosition, true);
+				const visualViewport = window.visualViewport;
+				visualViewport?.addEventListener("resize", updatePosition);
+				visualViewport?.addEventListener("scroll", updatePosition);
+				const observer = typeof ResizeObserver === "undefined" ? void 0 : new ResizeObserver(updatePosition);
+				if (rootRef.current !== null) observer?.observe(rootRef.current);
+				return () => {
+					window.removeEventListener("resize", updatePosition);
+					window.removeEventListener("scroll", updatePosition, true);
+					visualViewport?.removeEventListener("resize", updatePosition);
+					visualViewport?.removeEventListener("scroll", updatePosition);
+					observer?.disconnect();
+				};
+			}, [open]);
 			react.default.useEffect(() => {
 				if (!open) return;
 				const onPointerDown = (ev) => {
@@ -8181,14 +8232,22 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				setOpen(false);
 			};
 			const groups = groupByDivision(EXPERTS.filter((e) => enabled.has(e.slug)), props.getActive());
-			const menu = open ? react.default.createElement("div", { className: "aag-menu" }, insertError === null ? null : react.default.createElement("div", {
+			const menu = open ? react.default.createElement("div", {
+				className: "aag-menu",
+				"data-placement": menuPosition?.placement,
+				style: menuPosition === void 0 ? void 0 : { maxHeight: `${menuPosition.maxHeight}px` }
+			}, insertError === null ? null : react.default.createElement("div", {
 				className: "aag-error",
 				role: "alert"
 			}, insertError), 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", {
+			return react.default.createElement("div", {
+				className: "aag-btn-wrap",
+				ref: rootRef
+			}, react.default.createElement("button", {
 				type: "button",
 				className: "aag-btn",
 				title: props.t("button.title"),
+				"aria-expanded": open,
 				onMouseDown: keepComposerFocus,
 				onClick
 			}, expertIcon(), react.default.createElement("span", null, props.t("settings.nav"))), menu);
@@ -8349,6 +8408,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		}
 		function ExpertCardsSettings(props) {
 			const [state, setState] = react.default.useState(null);
+			const [initialOrder, setInitialOrder] = react.default.useState(null);
 			const [error, setError] = react.default.useState(null);
 			const [query, setQuery] = react.default.useState("");
 			const [division, setDivision] = react.default.useState("");
@@ -8361,6 +8421,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const load = react.default.useCallback(() => {
 				readEnabled(props.remote).then((current) => {
 					setState(current);
+					setInitialOrder((order) => order ?? sortExpertsByEnabled(EXPERTS, current.enabled).map((expert) => expert.slug));
 					setError(null);
 					props.onEnabledChange?.(current.enabled);
 				}).catch((err) => {
@@ -8372,6 +8433,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				readEnabled(props.remote).then((current) => {
 					if (!alive) return;
 					setState(current);
+					setInitialOrder((order) => order ?? sortExpertsByEnabled(EXPERTS, current.enabled).map((expert) => expert.slug));
 					props.onEnabledChange?.(current.enabled);
 				}).catch((err) => {
 					if (alive) setError(err instanceof Error ? err.message : String(err));
@@ -8459,10 +8521,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				className: "aag-note"
 			}, props.t("settings.loading")));
 			else {
-				const filtered = sortExpertsByEnabled(filterExperts(EXPERTS, {
+				const filtered = filterExperts(initialOrder === null ? sortExpertsByEnabled(EXPERTS, state.enabled) : sortExpertsByOrder(EXPERTS, initialOrder), {
 					query,
 					division
-				}), state.enabled);
+				});
 				const enabledCount = [...state.enabled].filter((slug) => EXPERTS.some((expert) => expert.slug === slug)).length;
 				const total = EXPERTS.length;
 				const hasFilter = normalizeExpertQuery(query) !== "" || division !== "";
@@ -8784,9 +8846,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		exports.normalizeExpertQuery = normalizeExpertQuery;
 		exports.openAgentSettings = openAgentSettings;
 		exports.pickHostSettingsTrigger = pickHostSettingsTrigger;
+		exports.resolveExpertMenuPosition = resolveExpertMenuPosition;
 		exports.resolveExpertToolbarClick = resolveExpertToolbarClick;
 		exports.resolveReferenceInsertionTarget = resolveReferenceInsertionTarget;
 		exports.sortExpertsByEnabled = sortExpertsByEnabled;
+		exports.sortExpertsByOrder = sortExpertsByOrder;
 		exports.writeErrorKey = writeErrorKey;
 		exports.writeErrorMessage = writeErrorMessage;
 		return module.exports;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@michengai/dsh-agency-agents",
   "description": "Agency Experts — a summonable domain-expert roster for DSH (expert mode)",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "type": "module",
   "packageManager": "pnpm@11.22.0",
   "engines": {