@michengai/dsh-agency-agents 0.1.29 → 0.1.30

package/CHANGELOG.md

@@ -6,6 +6,10 @@ The five most recent published versions are listed below.
 
 ## Unreleased
 
+## 0.1.30 — 2026-09-03
+
+- When no experts are enabled, the composer Experts button opens Settings → Experts. It only clicks a uniquely labeled Settings trigger and ignores composer dialogs such as the + button.
+
 ## 0.1.29 — 2026-09-03
 
 - Updated the DSH development baseline to `0.1.2-rc.1` while retaining the existing `>=0.1.0-rc.5 <0.2.0` peer compatibility range.

package/CHANGELOG.zh-CN.md

@@ -6,6 +6,10 @@
 
 ## 未发布
 
+## 0.1.30 — 2026-09-03
+
+- 未启用任何专家时，点击输入框「专家」会打开「设置 → 专家」。只点击唯一可识别的设置入口，并忽略输入区「+」等其他弹窗。
+
 ## 0.1.29 — 2026-09-03
 
 - 将 DSH 开发基线升级至 `0.1.2-rc.1`，同时保留现有 `>=0.1.0-rc.5 <0.2.0` 的 peer 兼容范围。

package/lib/client.js

@@ -2574,7 +2574,7 @@ window.__ModuleLoader__.load({
 			"summary.enabled.other": "位已启用",
 			"summary.group": "{count} 个",
 			"button.title": "召唤专家",
-			"menu.empty": "暂无可召唤的专家",
+			"menu.empty": "暂无可召唤的专家。请先在设置里启用。",
 			"division.academic": ZH_DIVISION.academic,
 			"division.design": ZH_DIVISION.design,
 			"division.engineering": ZH_DIVISION.engineering,
@@ -2626,7 +2626,7 @@ window.__ModuleLoader__.load({
 			"summary.enabled.other": "enabled",
 			"summary.group": "{count} items",
 			"button.title": "Summon expert",
-			"menu.empty": "No experts available yet",
+			"menu.empty": "No experts available yet. Enable some in Settings first.",
 			"division.academic": EN_DIVISION.academic,
 			"division.design": EN_DIVISION.design,
 			"division.engineering": EN_DIVISION.engineering,
@@ -6918,21 +6918,68 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function menuGroup(g, pick, t, getActive) {
 			return react.default.createElement("div", { key: g.division }, react.default.createElement("div", { className: "aag-menu-title" }, t(`division.${g.division}`)), g.experts.map((e) => menuItem(e, pick, getActive)));
 		}
-		function openAgentSettings(t) {
-			if (document.querySelector("[role=\"dialog\"]") === null) {
-				const trigger = document.querySelector("button[aria-haspopup=\"dialog\"]");
-				if (trigger instanceof HTMLElement) trigger.click();
+		/** 没有可召唤专家时打开设置页，否则打开本地菜单。 */
+		function resolveExpertToolbarClick(enabledCount) {
+			return enabledCount === 0 ? "settings" : "menu";
+		}
+		const SETTINGS_TRIGGER_LABELS = /* @__PURE__ */ new Set(["设置", "Settings"]);
+		const COMPOSER_TRIGGER_SCOPE = "[data-composer-card], .aag-btn-wrap";
+		function isSettingsTriggerLabel(label) {
+			return SETTINGS_TRIGGER_LABELS.has(label.trim());
+		}
+		/** 只认明确的设置按钮；输入区里的「+」和其他弹窗一律排除。 */
+		function pickHostSettingsTrigger(candidates) {
+			const labeled = candidates.filter((item) => !item.inComposer && isSettingsTriggerLabel(item.label));
+			if (labeled.length === 1) return labeled[0];
+			if (labeled.length > 1) return void 0;
+			const dialogs = candidates.filter((item) => !item.inComposer && item.hasDialogPopup);
+			return dialogs.length === 1 ? dialogs[0] : void 0;
+		}
+		function buttonAccessibleLabel(button) {
+			return (button.getAttribute("aria-label") ?? button.textContent ?? "").trim();
+		}
+		function collectSettingsTriggerCandidates(root) {
+			const result = [];
+			for (const node of root.querySelectorAll("button")) {
+				if (!(node instanceof HTMLElement)) continue;
+				result.push({
+					button: node,
+					label: buttonAccessibleLabel(node),
+					inComposer: node.closest(COMPOSER_TRIGGER_SCOPE) !== null,
+					hasDialogPopup: node.getAttribute("aria-haspopup") === "dialog"
+				});
 			}
-			const select = () => {
-				const buttons = document.querySelectorAll("[role=\"dialog\"] nav button");
-				for (const button of buttons) if (button.textContent !== null && button.textContent.trim() === t("settings.nav")) {
-					button.click();
-					return;
-				}
-			};
-			window.requestAnimationFrame(() => {
-				window.requestAnimationFrame(select);
+			return result;
+		}
+		function findHostSettingsTrigger(root) {
+			return pickHostSettingsTrigger(collectSettingsTriggerCandidates(root))?.button;
+		}
+		function findExpertSettingsNavButton(root, navLabel) {
+			for (const dialog of root.querySelectorAll("[role=\"dialog\"]")) for (const button of dialog.querySelectorAll("nav button")) if (button instanceof HTMLElement && (button.textContent ?? "").trim() === navLabel) return button;
+		}
+		function queueSettingsNav(work) {
+			if (typeof requestAnimationFrame === "function") {
+				requestAnimationFrame(() => {
+					requestAnimationFrame(work);
+				});
+				return;
+			}
+			work();
+		}
+		/** 打开宿主设置并选中专家分区；找不到唯一设置入口时返回 false，由调用方回退到本地菜单。 */
+		function openAgentSettings(navLabel, root = document, schedule = queueSettingsNav) {
+			const existing = findExpertSettingsNavButton(root, navLabel);
+			if (existing !== void 0) {
+				existing.click();
+				return true;
+			}
+			const trigger = findHostSettingsTrigger(root);
+			if (trigger === void 0) return false;
+			trigger.click();
+			schedule(() => {
+				findExpertSettingsNavButton(root, navLabel)?.click();
 			});
+			return true;
 		}
 		function resolveReferenceInsertionTarget(sessions, sessionId, getConversation) {
 			const targetSessionId = sessionId ?? sessions.list?.getSnapshot().current;
@@ -6988,9 +7035,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				readEnabled(props.remote).then((current) => {
 					setEnabled(current.enabled);
 					props.onEnabledChange?.(current.enabled);
-					if (current.enabled.size === 0) {
-						openAgentSettings(props.t);
-						return;
+					if (resolveExpertToolbarClick(current.enabled.size) === "settings") {
+						if (openAgentSettings(props.t("settings.nav"))) {
+							setOpen(false);
+							return;
+						}
 					}
 					setInsertError(null);
 					setOpen((prev) => !prev);
@@ -7471,6 +7520,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		exports.compareExpertName = compareExpertName;
 		exports.expertMentionFromReference = expertMentionFromReference;
 		exports.filterExperts = filterExperts;
+		exports.findExpertSettingsNavButton = findExpertSettingsNavButton;
+		exports.findHostSettingsTrigger = findHostSettingsTrigger;
 		exports.formatExpertMention = formatExpertMention;
 		exports.formatExpertMentionInsertion = formatExpertMentionInsertion;
 		exports.inject = inject;
@@ -7480,9 +7531,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		exports.inputTriggerSourceName = inputTriggerSourceName;
 		exports.insertExpertReference = insertExpertReference;
 		exports.insertSelectedExpert = insertSelectedExpert;
+		exports.isSettingsTriggerLabel = isSettingsTriggerLabel;
 		exports.keepComposerFocus = keepComposerFocus;
 		exports.matchExpertQuery = matchExpertQuery;
 		exports.normalizeExpertQuery = normalizeExpertQuery;
+		exports.openAgentSettings = openAgentSettings;
+		exports.pickHostSettingsTrigger = pickHostSettingsTrigger;
+		exports.resolveExpertToolbarClick = resolveExpertToolbarClick;
 		exports.resolveReferenceInsertionTarget = resolveReferenceInsertionTarget;
 		exports.writeErrorKey = writeErrorKey;
 		exports.writeErrorMessage = writeErrorMessage;

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.29",
+  "version": "0.1.30",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",