@reconcrap/boss-recommend-mcp 2.1.23 → 2.1.24

package/src/domains/recommend/filters.js

@@ -8,60 +8,60 @@ import {
   getOuterHTML,
   pressKey,
   querySelectorAll,
-  sleep,
-  waitForSelector
-} from "../../core/browser/index.js";
-import { htmlToText, normalizeText } from "../../core/screening/index.js";
-import {
-  RECOMMEND_ACTIVITY_GROUP,
-  RECOMMEND_ACTIVITY_GROUP_HEADING,
-  RECOMMEND_ACTIVITY_LEVELS,
-  RECOMMEND_CARD_SELECTOR,
-  RECOMMEND_FILTER_GROUP_ORDER,
-  RECOMMEND_FILTER_SELECTORS
-} from "./constants.js";
-
+  sleep,
+  waitForSelector
+} from "../../core/browser/index.js";
+import { htmlToText, normalizeText } from "../../core/screening/index.js";
+import {
+  RECOMMEND_ACTIVITY_GROUP,
+  RECOMMEND_ACTIVITY_GROUP_HEADING,
+  RECOMMEND_ACTIVITY_LEVELS,
+  RECOMMEND_CARD_SELECTOR,
+  RECOMMEND_FILTER_GROUP_ORDER,
+  RECOMMEND_FILTER_SELECTORS
+} from "./constants.js";
+
 const SKIP_OPTION_LABELS = new Set(["不限", "全部", "all"]);
 
 export function normalizeFilterOptionLabel(label) {
   return normalizeText(label).replace(/\s+/g, "");
 }
 
-export function isSafeFilterOptionLabel(label) {
-  const normalized = normalizeFilterOptionLabel(label);
-  return Boolean(normalized) && !SKIP_OPTION_LABELS.has(normalized.toLowerCase());
-}
-
-function isSelectableFilterOptionLabel(label, { allowUnlimited = false } = {}) {
-  const normalized = normalizeFilterOptionLabel(label);
-  if (!normalized) return false;
-  return allowUnlimited || !SKIP_OPTION_LABELS.has(normalized.toLowerCase());
-}
-
-function normalizeActivityGroupText(text) {
-  return normalizeFilterOptionLabel(text)
-    .replace(/【/g, "[")
-    .replace(/】/g, "]");
-}
-
-export function isRecommendActivityGroupText(text) {
-  const normalized = normalizeActivityGroupText(text);
-  const heading = normalizeActivityGroupText(RECOMMEND_ACTIVITY_GROUP_HEADING);
-  const exactOptionCount = RECOMMEND_ACTIVITY_LEVELS.filter((label) => (
-    normalized.includes(normalizeFilterOptionLabel(label))
-  )).length;
-  const hasUnlimited = normalized.includes(normalizeFilterOptionLabel("不限"));
-  return (
-    (normalized.startsWith(heading) && exactOptionCount >= 2 && hasUnlimited)
-    || (exactOptionCount === RECOMMEND_ACTIVITY_LEVELS.length && hasUnlimited)
-  );
-}
-
-export function isActiveOption(attributes = {}, outerHTML = "") {
-  const className = attributes.class || "";
-  return /\bactive\b/.test(className) || /\bactive\b/.test(String(outerHTML || "").split(">")[0] || "");
-}
-
+export function isSafeFilterOptionLabel(label) {
+  const normalized = normalizeFilterOptionLabel(label);
+  return Boolean(normalized) && !SKIP_OPTION_LABELS.has(normalized.toLowerCase());
+}
+
+function isSelectableFilterOptionLabel(label, { allowUnlimited = false } = {}) {
+  const normalized = normalizeFilterOptionLabel(label);
+  if (!normalized) return false;
+  return allowUnlimited || !SKIP_OPTION_LABELS.has(normalized.toLowerCase());
+}
+
+function normalizeActivityGroupText(text) {
+  return normalizeFilterOptionLabel(text)
+    .replace(/【/g, "[")
+    .replace(/】/g, "]");
+}
+
+export function isRecommendActivityGroupText(text) {
+  const normalized = normalizeActivityGroupText(text);
+  const heading = normalizeActivityGroupText(RECOMMEND_ACTIVITY_GROUP_HEADING);
+  const exactOptionCount = RECOMMEND_ACTIVITY_LEVELS.filter((label) => (
+    normalized.includes(normalizeFilterOptionLabel(label))
+  )).length;
+  const hasUnlimited = normalized.includes(normalizeFilterOptionLabel("不限"));
+  return (
+    (normalized.startsWith(heading) && exactOptionCount >= 2 && hasUnlimited)
+    || (exactOptionCount === RECOMMEND_ACTIVITY_LEVELS.length && hasUnlimited)
+  );
+}
+
+export function isActiveOption(attributes = {}, outerHTML = "") {
+  const className = attributes.class || "";
+  return /\bactive\b/.test(className) || /\bactive\b/.test(String(outerHTML || "").split(">")[0] || "");
+}
+
 export function chooseFirstSafeFilterOption(options = [], groupOrder = RECOMMEND_FILTER_GROUP_ORDER) {
   for (const group of groupOrder) {
     const option = options.find((item) => (
@@ -71,45 +71,45 @@ export function chooseFirstSafeFilterOption(options = [], groupOrder = RECOMMEND
     ));
     if (option) return option;
   }
-  return null;
-}
-
-export function chooseFilterOptionByLabels(options = [], {
-  group = "",
-  labels = [],
-  allowUnlimited = false
-} = {}) {
-  const normalizedGroup = normalizeText(group);
-  const normalizedLabels = labels.map(normalizeFilterOptionLabel).filter(Boolean);
-  for (const label of normalizedLabels) {
-    const option = options.find((item) => (
-      (!normalizedGroup || item.group === normalizedGroup)
-      && !item.active
-      && normalizeFilterOptionLabel(item.label) === label
-      && isSelectableFilterOptionLabel(item.label, { allowUnlimited })
-    ));
-    if (option) return option;
-  }
-  return null;
-}
-
-export function chooseFilterOptionsByLabels(options = [], {
-  group = "",
-  labels = [],
-  allowUnlimited = false
-} = {}) {
-  const normalizedGroup = normalizeText(group);
-  const normalizedLabels = labels.map(normalizeFilterOptionLabel).filter(Boolean);
-  return normalizedLabels.map((label) => {
-    const option = options.find((item) => (
-      (!normalizedGroup || item.group === normalizedGroup)
-      && normalizeFilterOptionLabel(item.label) === label
-      && isSelectableFilterOptionLabel(item.label, { allowUnlimited })
-    ));
-    return {
-      label,
-      option: option || null
-    };
+  return null;
+}
+
+export function chooseFilterOptionByLabels(options = [], {
+  group = "",
+  labels = [],
+  allowUnlimited = false
+} = {}) {
+  const normalizedGroup = normalizeText(group);
+  const normalizedLabels = labels.map(normalizeFilterOptionLabel).filter(Boolean);
+  for (const label of normalizedLabels) {
+    const option = options.find((item) => (
+      (!normalizedGroup || item.group === normalizedGroup)
+      && !item.active
+      && normalizeFilterOptionLabel(item.label) === label
+      && isSelectableFilterOptionLabel(item.label, { allowUnlimited })
+    ));
+    if (option) return option;
+  }
+  return null;
+}
+
+export function chooseFilterOptionsByLabels(options = [], {
+  group = "",
+  labels = [],
+  allowUnlimited = false
+} = {}) {
+  const normalizedGroup = normalizeText(group);
+  const normalizedLabels = labels.map(normalizeFilterOptionLabel).filter(Boolean);
+  return normalizedLabels.map((label) => {
+    const option = options.find((item) => (
+      (!normalizedGroup || item.group === normalizedGroup)
+      && normalizeFilterOptionLabel(item.label) === label
+      && isSelectableFilterOptionLabel(item.label, { allowUnlimited })
+    ));
+    return {
+      label,
+      option: option || null
+    };
   });
 }
 
@@ -185,12 +185,12 @@ async function findFilterTriggerCandidates(client, frameNodeId) {
   return candidates;
 }
 
-export async function openFilterPanel(client, frameNodeId) {
-  let triggerCandidates = await findFilterTriggerCandidates(client, frameNodeId);
-  if (!triggerCandidates.length) {
-    const error = new Error("Recommend filter trigger was not found");
-    error.code = "RECOMMEND_FILTER_TRIGGER_UNAVAILABLE";
-    throw error;
+export async function openFilterPanel(client, frameNodeId) {
+  let triggerCandidates = await findFilterTriggerCandidates(client, frameNodeId);
+  if (!triggerCandidates.length) {
+    const error = new Error("Recommend filter trigger was not found");
+    error.code = "RECOMMEND_FILTER_TRIGGER_UNAVAILABLE";
+    throw error;
   }
 
   const preOpenDismissalAttempts = await dismissRecommendControlOverlays(client);
@@ -261,76 +261,76 @@ async function readOptionNode(client, group, nodeId) {
     attributes: {
       class: attributes.class || "",
       value: attributes.value || "",
-      type: attributes.type || ""
-    }
-  };
-}
-
-function uniqueNodeIds(nodeIds = []) {
-  return [...new Set(nodeIds.filter((nodeId) => Number(nodeId) > 0))];
-}
-
-async function nodeMatchesActivityGroup(client, nodeId) {
-  const outerHTML = await getOuterHTML(client, nodeId);
-  return isRecommendActivityGroupText(htmlToText(outerHTML));
-}
-
-export async function resolveRecommendFilterGroupNodeIds(client, frameNodeId, group) {
-  const groupSelector = RECOMMEND_FILTER_SELECTORS.groups[group];
-  if (!groupSelector) return [];
-  if (group !== RECOMMEND_ACTIVITY_GROUP) {
-    return querySelectorAll(client, frameNodeId, groupSelector);
-  }
-
-  const selectorCandidates = uniqueNodeIds(await querySelectorAll(client, frameNodeId, groupSelector));
-  const semanticMatches = [];
-  for (const nodeId of selectorCandidates) {
-    if (await nodeMatchesActivityGroup(client, nodeId)) semanticMatches.push(nodeId);
-  }
-  if (semanticMatches.length) return uniqueNodeIds(semanticMatches);
-
-  const broadCandidates = uniqueNodeIds(await querySelectorAll(
-    client,
-    frameNodeId,
-    RECOMMEND_FILTER_SELECTORS.checkBox
-  ));
-  for (const nodeId of broadCandidates) {
-    if (selectorCandidates.includes(nodeId)) continue;
-    try {
-      if (await nodeMatchesActivityGroup(client, nodeId)) semanticMatches.push(nodeId);
-    } catch {
-      // An unrelated stale filter row does not make the activity control visible.
-    }
-  }
-  if (semanticMatches.length) return uniqueNodeIds(semanticMatches);
-  if (selectorCandidates.length) {
-    throw new Error("Recommend activity filter control was visible but its semantic row could not be verified");
-  }
-  return [];
-}
-
-export async function listFilterOptions(client, frameNodeId, {
-  groupOrder = RECOMMEND_FILTER_GROUP_ORDER
-} = {}) {
-  const options = [];
-  for (const group of groupOrder) {
-    const groupNodeIds = await resolveRecommendFilterGroupNodeIds(client, frameNodeId, group);
-    let optionCount = 0;
-    for (const groupNodeId of groupNodeIds) {
-      const optionNodeIds = await querySelectorAll(client, groupNodeId, RECOMMEND_FILTER_SELECTORS.option);
-      for (const optionNodeId of optionNodeIds) {
-        options.push(await readOptionNode(client, group, optionNodeId));
-        optionCount += 1;
-      }
-    }
-    if (group === RECOMMEND_ACTIVITY_GROUP && groupNodeIds.length && optionCount === 0) {
-      throw new Error("Recommend activity filter control was visible but its options could not be read");
-    }
-  }
-  return options;
-}
-
-async function clickFirstAvailableNode(client, nodeIds) {
+      type: attributes.type || ""
+    }
+  };
+}
+
+function uniqueNodeIds(nodeIds = []) {
+  return [...new Set(nodeIds.filter((nodeId) => Number(nodeId) > 0))];
+}
+
+async function nodeMatchesActivityGroup(client, nodeId) {
+  const outerHTML = await getOuterHTML(client, nodeId);
+  return isRecommendActivityGroupText(htmlToText(outerHTML));
+}
+
+export async function resolveRecommendFilterGroupNodeIds(client, frameNodeId, group) {
+  const groupSelector = RECOMMEND_FILTER_SELECTORS.groups[group];
+  if (!groupSelector) return [];
+  if (group !== RECOMMEND_ACTIVITY_GROUP) {
+    return querySelectorAll(client, frameNodeId, groupSelector);
+  }
+
+  const selectorCandidates = uniqueNodeIds(await querySelectorAll(client, frameNodeId, groupSelector));
+  const semanticMatches = [];
+  for (const nodeId of selectorCandidates) {
+    if (await nodeMatchesActivityGroup(client, nodeId)) semanticMatches.push(nodeId);
+  }
+  if (semanticMatches.length) return uniqueNodeIds(semanticMatches);
+
+  const broadCandidates = uniqueNodeIds(await querySelectorAll(
+    client,
+    frameNodeId,
+    RECOMMEND_FILTER_SELECTORS.checkBox
+  ));
+  for (const nodeId of broadCandidates) {
+    if (selectorCandidates.includes(nodeId)) continue;
+    try {
+      if (await nodeMatchesActivityGroup(client, nodeId)) semanticMatches.push(nodeId);
+    } catch {
+      // An unrelated stale filter row does not make the activity control visible.
+    }
+  }
+  if (semanticMatches.length) return uniqueNodeIds(semanticMatches);
+  if (selectorCandidates.length) {
+    throw new Error("Recommend activity filter control was visible but its semantic row could not be verified");
+  }
+  return [];
+}
+
+export async function listFilterOptions(client, frameNodeId, {
+  groupOrder = RECOMMEND_FILTER_GROUP_ORDER
+} = {}) {
+  const options = [];
+  for (const group of groupOrder) {
+    const groupNodeIds = await resolveRecommendFilterGroupNodeIds(client, frameNodeId, group);
+    let optionCount = 0;
+    for (const groupNodeId of groupNodeIds) {
+      const optionNodeIds = await querySelectorAll(client, groupNodeId, RECOMMEND_FILTER_SELECTORS.option);
+      for (const optionNodeId of optionNodeIds) {
+        options.push(await readOptionNode(client, group, optionNodeId));
+        optionCount += 1;
+      }
+    }
+    if (group === RECOMMEND_ACTIVITY_GROUP && groupNodeIds.length && optionCount === 0) {
+      throw new Error("Recommend activity filter control was visible but its options could not be read");
+    }
+  }
+  return options;
+}
+
+async function clickFirstAvailableNode(client, nodeIds) {
   const errors = [];
   for (const nodeId of nodeIds) {
     try {
@@ -420,86 +420,86 @@ export async function selectFirstSafeFilterOption(client, frameNodeId, {
       node_id: option.node_id
     }))
   };
-}
-
-export async function selectFilterOption(client, frameNodeId, {
-  group = "",
-  labels = [],
-  groupOrder = RECOMMEND_FILTER_GROUP_ORDER,
-  allowUnlimited = false
-} = {}) {
-  const options = await listFilterOptions(client, frameNodeId, { groupOrder });
-  const alreadyActive = labels.length
-    ? options.find((option) => (
-      (!group || option.group === group)
-      && labels.some((label) => (
-        normalizeFilterOptionLabel(option.label) === normalizeFilterOptionLabel(label)
-      ))
-      && option.active
-      && isSelectableFilterOptionLabel(option.label, { allowUnlimited })
-    ))
-    : null;
-  if (alreadyActive) {
-    return {
-      selected_option: {
-        group: alreadyActive.group,
-        label: alreadyActive.label,
-        node_id: alreadyActive.node_id,
-        was_active: true,
-        clicked: false,
-        requested_group: group || null,
-        requested_labels: labels
-      },
-      selected_options: [],
-      option_box: null,
-      unavailable: false,
-      unavailable_groups: [],
-      discovered_options: options.map((option) => ({
-        group: option.group,
-        label: option.label,
-        active: option.active,
-        node_id: option.node_id
-      }))
-    };
-  }
-  const selected = labels.length
-    ? chooseFilterOptionByLabels(options, { group, labels, allowUnlimited })
-    : chooseFirstSafeFilterOption(options, groupOrder);
-
-  if (!selected) {
-    const requestedLabels = labels.map(normalizeFilterOptionLabel).filter(Boolean);
-    const groupOptions = options.filter((option) => !group || option.group === group);
-    const unavailableDefault = (
-      group === RECOMMEND_ACTIVITY_GROUP
-      && allowUnlimited
-      && requestedLabels.length === 1
-      && requestedLabels[0] === normalizeFilterOptionLabel("不限")
-      && groupOptions.length === 0
-    );
-    if (unavailableDefault) {
-      return {
-        selected_option: null,
-        selected_options: [],
-        option_box: null,
-        unavailable: true,
-        unavailable_groups: [{
-          group,
-          requested_labels: labels,
-          reason: "activity_control_unavailable_default"
-        }],
-        discovered_options: options.map((option) => ({
-          group: option.group,
-          label: option.label,
-          active: option.active,
-          node_id: option.node_id
-        }))
-      };
-    }
-    const target = labels.length
-      ? `${group || "any group"} / ${labels.join(", ")}`
-      : "first safe non-active option";
-    throw new Error(`No matching recommend filter option was found for ${target}`);
-  }
+}
+
+export async function selectFilterOption(client, frameNodeId, {
+  group = "",
+  labels = [],
+  groupOrder = RECOMMEND_FILTER_GROUP_ORDER,
+  allowUnlimited = false
+} = {}) {
+  const options = await listFilterOptions(client, frameNodeId, { groupOrder });
+  const alreadyActive = labels.length
+    ? options.find((option) => (
+      (!group || option.group === group)
+      && labels.some((label) => (
+        normalizeFilterOptionLabel(option.label) === normalizeFilterOptionLabel(label)
+      ))
+      && option.active
+      && isSelectableFilterOptionLabel(option.label, { allowUnlimited })
+    ))
+    : null;
+  if (alreadyActive) {
+    return {
+      selected_option: {
+        group: alreadyActive.group,
+        label: alreadyActive.label,
+        node_id: alreadyActive.node_id,
+        was_active: true,
+        clicked: false,
+        requested_group: group || null,
+        requested_labels: labels
+      },
+      selected_options: [],
+      option_box: null,
+      unavailable: false,
+      unavailable_groups: [],
+      discovered_options: options.map((option) => ({
+        group: option.group,
+        label: option.label,
+        active: option.active,
+        node_id: option.node_id
+      }))
+    };
+  }
+  const selected = labels.length
+    ? chooseFilterOptionByLabels(options, { group, labels, allowUnlimited })
+    : chooseFirstSafeFilterOption(options, groupOrder);
+
+  if (!selected) {
+    const requestedLabels = labels.map(normalizeFilterOptionLabel).filter(Boolean);
+    const groupOptions = options.filter((option) => !group || option.group === group);
+    const unavailableDefault = (
+      group === RECOMMEND_ACTIVITY_GROUP
+      && allowUnlimited
+      && requestedLabels.length === 1
+      && requestedLabels[0] === normalizeFilterOptionLabel("不限")
+      && groupOptions.length === 0
+    );
+    if (unavailableDefault) {
+      return {
+        selected_option: null,
+        selected_options: [],
+        option_box: null,
+        unavailable: true,
+        unavailable_groups: [{
+          group,
+          requested_labels: labels,
+          reason: "activity_control_unavailable_default"
+        }],
+        discovered_options: options.map((option) => ({
+          group: option.group,
+          label: option.label,
+          active: option.active,
+          node_id: option.node_id
+        }))
+      };
+    }
+    const target = labels.length
+      ? `${group || "any group"} / ${labels.join(", ")}`
+      : "first safe non-active option";
+    throw new Error(`No matching recommend filter option was found for ${target}`);
+  }
 
   const box = await clickNodeCenter(client, selected.node_id, {
     ...DETERMINISTIC_CLICK_OPTIONS,
@@ -508,45 +508,45 @@ export async function selectFilterOption(client, frameNodeId, {
   await sleep(300);
 
   return {
-    selected_option: {
-      group: selected.group,
-      label: selected.label,
-      node_id: selected.node_id,
-      was_active: selected.active,
-      clicked: true,
-      requested_group: group || null,
-      requested_labels: labels
-    },
-    option_box: box,
-    unavailable: false,
-    unavailable_groups: [],
-    discovered_options: options.map((option) => ({
-      group: option.group,
-      label: option.label,
-      active: option.active,
-      node_id: option.node_id
+    selected_option: {
+      group: selected.group,
+      label: selected.label,
+      node_id: selected.node_id,
+      was_active: selected.active,
+      clicked: true,
+      requested_group: group || null,
+      requested_labels: labels
+    },
+    option_box: box,
+    unavailable: false,
+    unavailable_groups: [],
+    discovered_options: options.map((option) => ({
+      group: option.group,
+      label: option.label,
+      active: option.active,
+      node_id: option.node_id
     }))
   };
-}
-
-export async function selectFilterOptions(client, frameNodeId, {
-  group = "",
-  labels = [],
-  groupOrder = RECOMMEND_FILTER_GROUP_ORDER,
-  allowUnlimited = false
-} = {}) {
-  if (!labels.length) {
-    return selectFilterOption(client, frameNodeId, {
-      group,
-      labels,
-      groupOrder,
-      allowUnlimited
-    });
-  }
-
-  const selectedOptions = [];
-  const missingLabels = [];
-  let discoveredOptions = [];
+}
+
+export async function selectFilterOptions(client, frameNodeId, {
+  group = "",
+  labels = [],
+  groupOrder = RECOMMEND_FILTER_GROUP_ORDER,
+  allowUnlimited = false
+} = {}) {
+  if (!labels.length) {
+    return selectFilterOption(client, frameNodeId, {
+      group,
+      labels,
+      groupOrder,
+      allowUnlimited
+    });
+  }
+
+  const selectedOptions = [];
+  const missingLabels = [];
+  let discoveredOptions = [];
 
   for (const label of labels) {
     if (await getFilterPanelCount(client, frameNodeId) === 0) {
@@ -555,26 +555,26 @@ export async function selectFilterOptions(client, frameNodeId, {
 
     const options = await listFilterOptions(client, frameNodeId, { groupOrder });
     discoveredOptions = options.map((option) => ({
-      group: option.group,
-      label: option.label,
-      active: option.active,
-      node_id: option.node_id
-    }));
-    const selected = chooseFilterOptionByLabels(options, {
-      group,
-      labels: [label],
-      allowUnlimited
-    });
-    const alreadyActive = options.find((option) => (
-      (!group || option.group === group)
-      && normalizeFilterOptionLabel(option.label) === normalizeFilterOptionLabel(label)
-      && option.active
-      && isSelectableFilterOptionLabel(option.label, { allowUnlimited })
-    ));
-
-    if (alreadyActive) {
-      selectedOptions.push({
-        group: alreadyActive.group,
+      group: option.group,
+      label: option.label,
+      active: option.active,
+      node_id: option.node_id
+    }));
+    const selected = chooseFilterOptionByLabels(options, {
+      group,
+      labels: [label],
+      allowUnlimited
+    });
+    const alreadyActive = options.find((option) => (
+      (!group || option.group === group)
+      && normalizeFilterOptionLabel(option.label) === normalizeFilterOptionLabel(label)
+      && option.active
+      && isSelectableFilterOptionLabel(option.label, { allowUnlimited })
+    ));
+
+    if (alreadyActive) {
+      selectedOptions.push({
+        group: alreadyActive.group,
         label: alreadyActive.label,
         node_id: alreadyActive.node_id,
         was_active: true,
@@ -601,113 +601,113 @@ export async function selectFilterOptions(client, frameNodeId, {
       clicked: true,
       requested_group: group || null,
       option_box: box
-    });
-    await sleep(450);
-  }
-
-  if (missingLabels.length) {
-    const groupOptions = discoveredOptions.filter((option) => !group || option.group === group);
-    const unavailableDefault = (
-      group === RECOMMEND_ACTIVITY_GROUP
-      && allowUnlimited
-      && missingLabels.length === 1
-      && normalizeFilterOptionLabel(missingLabels[0]) === normalizeFilterOptionLabel("不限")
-      && groupOptions.length === 0
-    );
-    if (unavailableDefault) {
-      return {
-        selected_option: null,
-        selected_options: [],
-        option_box: null,
-        unavailable: true,
-        unavailable_groups: [{
-          group,
-          requested_labels: labels,
-          reason: "activity_control_unavailable_default"
-        }],
-        discovered_options: discoveredOptions
-      };
-    }
-    throw new Error(`No matching recommend filter options were found for ${group || "any group"} / ${missingLabels.join(", ")}`);
-  }
-
-  return {
-    selected_option: selectedOptions[0] || null,
+    });
+    await sleep(450);
+  }
+
+  if (missingLabels.length) {
+    const groupOptions = discoveredOptions.filter((option) => !group || option.group === group);
+    const unavailableDefault = (
+      group === RECOMMEND_ACTIVITY_GROUP
+      && allowUnlimited
+      && missingLabels.length === 1
+      && normalizeFilterOptionLabel(missingLabels[0]) === normalizeFilterOptionLabel("不限")
+      && groupOptions.length === 0
+    );
+    if (unavailableDefault) {
+      return {
+        selected_option: null,
+        selected_options: [],
+        option_box: null,
+        unavailable: true,
+        unavailable_groups: [{
+          group,
+          requested_labels: labels,
+          reason: "activity_control_unavailable_default"
+        }],
+        discovered_options: discoveredOptions
+      };
+    }
+    throw new Error(`No matching recommend filter options were found for ${group || "any group"} / ${missingLabels.join(", ")}`);
+  }
+
+  return {
+    selected_option: selectedOptions[0] || null,
     selected_options: selectedOptions.map((option) => ({
       group: option.group,
       label: option.label,
       node_id: option.node_id,
       was_active: option.was_active,
-      clicked: option.clicked,
-      requested_group: option.requested_group,
-      requested_labels: labels
-    })),
-    option_box: selectedOptions.find((option) => option.option_box)?.option_box || null,
-    unavailable: false,
-    unavailable_groups: [],
-    discovered_options: discoveredOptions
-  };
-}
-
-export async function selectFilterGroups(client, frameNodeId, {
-  filterGroups = [],
-  groupOrder = RECOMMEND_FILTER_GROUP_ORDER
-} = {}) {
-  const selectedOptions = [];
-  const discoveredOptions = [];
-  const unavailableGroups = [];
-  const groups = filterGroups.filter((item) => item && (item.group || item.labels?.length));
-  if (!groups.length) {
-    return selectFilterOption(client, frameNodeId, { groupOrder });
-  }
-
+      clicked: option.clicked,
+      requested_group: option.requested_group,
+      requested_labels: labels
+    })),
+    option_box: selectedOptions.find((option) => option.option_box)?.option_box || null,
+    unavailable: false,
+    unavailable_groups: [],
+    discovered_options: discoveredOptions
+  };
+}
+
+export async function selectFilterGroups(client, frameNodeId, {
+  filterGroups = [],
+  groupOrder = RECOMMEND_FILTER_GROUP_ORDER
+} = {}) {
+  const selectedOptions = [];
+  const discoveredOptions = [];
+  const unavailableGroups = [];
+  const groups = filterGroups.filter((item) => item && (item.group || item.labels?.length));
+  if (!groups.length) {
+    return selectFilterOption(client, frameNodeId, { groupOrder });
+  }
+
   for (const spec of groups) {
-    const labels = Array.isArray(spec.labels) ? spec.labels : [];
-    const selection = spec.selectAllLabels === false
-      ? await selectFilterOption(client, frameNodeId, {
-        group: spec.group || "",
-        labels,
-        groupOrder,
-        allowUnlimited: spec.allowUnlimited === true
-      })
-      : await selectFilterOptions(client, frameNodeId, {
-        group: spec.group || "",
-        labels,
-        groupOrder,
-        allowUnlimited: spec.allowUnlimited === true
-      });
-    if (selection.selected_option) selectedOptions.push(selection.selected_option);
-    for (const option of selection.selected_options || []) {
-      selectedOptions.push(option);
-    }
-    for (const option of selection.discovered_options || []) {
-      discoveredOptions.push(option);
-    }
-    for (const unavailable of selection.unavailable_groups || []) {
-      unavailableGroups.push(unavailable);
-    }
-  }
-
-  const dedupedSelected = [];
-  const seenSelected = new Set();
-  for (const option of selectedOptions) {
+    const labels = Array.isArray(spec.labels) ? spec.labels : [];
+    const selection = spec.selectAllLabels === false
+      ? await selectFilterOption(client, frameNodeId, {
+        group: spec.group || "",
+        labels,
+        groupOrder,
+        allowUnlimited: spec.allowUnlimited === true
+      })
+      : await selectFilterOptions(client, frameNodeId, {
+        group: spec.group || "",
+        labels,
+        groupOrder,
+        allowUnlimited: spec.allowUnlimited === true
+      });
+    if (selection.selected_option) selectedOptions.push(selection.selected_option);
+    for (const option of selection.selected_options || []) {
+      selectedOptions.push(option);
+    }
+    for (const option of selection.discovered_options || []) {
+      discoveredOptions.push(option);
+    }
+    for (const unavailable of selection.unavailable_groups || []) {
+      unavailableGroups.push(unavailable);
+    }
+  }
+
+  const dedupedSelected = [];
+  const seenSelected = new Set();
+  for (const option of selectedOptions) {
     const key = `${option.group || ""}:${normalizeFilterOptionLabel(option.label || "")}`;
     if (seenSelected.has(key)) continue;
     seenSelected.add(key);
     dedupedSelected.push(option);
   }
-
-  return {
-    selected_option: dedupedSelected[0] || null,
-    selected_options: dedupedSelected,
-    option_box: dedupedSelected.find((option) => option.option_box)?.option_box || null,
-    unavailable: unavailableGroups.length > 0,
-    unavailable_groups: unavailableGroups,
-    discovered_options: discoveredOptions
-  };
-}
-
-export async function confirmFilterPanel(client, frameNodeId, {
+
+  return {
+    selected_option: dedupedSelected[0] || null,
+    selected_options: dedupedSelected,
+    option_box: dedupedSelected.find((option) => option.option_box)?.option_box || null,
+    unavailable: unavailableGroups.length > 0,
+    unavailable_groups: unavailableGroups,
+    discovered_options: discoveredOptions
+  };
+}
+
+export async function confirmFilterPanel(client, frameNodeId, {
   timeoutMs = 8000
 } = {}) {
   const candidates = await readConfirmButtonCandidates(client, frameNodeId);
@@ -759,223 +759,223 @@ export async function confirmFilterPanel(client, frameNodeId, {
     confirm_node_id: attempts.at(-1)?.node_id || null,
     confirm_label: attempts.at(-1)?.label || null,
     confirm_candidates: candidates,
-    confirm_attempts: attempts,
-    panel_count: await getFilterPanelCount(client, frameNodeId)
-  };
-}
-
-function normalizeStickyVerificationSpecs(options = {}) {
-  const source = Array.isArray(options.filterGroups) && options.filterGroups.length
-    ? options.filterGroups
-    : [options];
-  return source.filter((spec) => spec?.verifySticky === true).map((spec) => ({
-    group: String(spec.group || ""),
-    labels: Array.isArray(spec.labels) ? spec.labels : [],
-    selectAllLabels: spec.selectAllLabels !== false,
-    allowUnlimited: spec.allowUnlimited === true
-  })).filter((spec) => spec.group && spec.labels.length);
-}
-
-function findUnavailableGroup(unavailableGroups = [], group = "") {
-  return unavailableGroups.find((item) => item?.group === group) || null;
-}
-
-function normalizeRequestedFilterGroups(options = {}) {
-  const source = Array.isArray(options.filterGroups) && options.filterGroups.length
-    ? options.filterGroups.filter(Boolean)
-    : (options.group || options.labels?.length ? [options] : []);
-  return source.map((spec) => ({
-    group: String(spec?.group || ""),
-    labels: Array.isArray(spec?.labels)
-      ? spec.labels.map(normalizeFilterOptionLabel).filter(Boolean)
-      : [],
-    select_all_labels: spec?.selectAllLabels !== false,
-    allow_unlimited: spec?.allowUnlimited === true,
-    verify_sticky: spec?.verifySticky === true
-  }));
-}
-
-export async function verifyFilterGroupsSticky(client, frameNodeId, {
-  specs = [],
-  unavailableGroups = [],
-  settleMs = 300
-} = {}) {
-  const normalizedSpecs = specs.filter((spec) => spec?.group && Array.isArray(spec.labels) && spec.labels.length);
-  const groups = [];
-  const availableSpecs = [];
-  for (const spec of normalizedSpecs) {
-    const unavailable = findUnavailableGroup(unavailableGroups, spec.group);
-    if (unavailable) {
-      groups.push({
-        group: spec.group,
-        requested_labels: spec.labels,
-        active_labels: [],
-        verified: true,
-        unavailable: true,
-        reason: unavailable.reason || "control_unavailable_default"
-      });
-    } else {
-      availableSpecs.push(spec);
-    }
-  }
-
-  let reopen = null;
-  let closeConfirmation = null;
-  if (availableSpecs.length) {
-    reopen = await openFilterPanel(client, frameNodeId);
-    for (const spec of availableSpecs) {
-      const options = await listFilterOptions(client, frameNodeId, {
-        groupOrder: [spec.group]
-      });
-      const requestedLabels = spec.labels.map(normalizeFilterOptionLabel).filter(Boolean);
-      const activeLabels = options
-        .filter((option) => option.group === spec.group && option.active)
-        .map((option) => normalizeFilterOptionLabel(option.label));
-      const verified = spec.selectAllLabels === false
-        ? requestedLabels.length === 1
-          && activeLabels.length === 1
-          && activeLabels[0] === requestedLabels[0]
-        : requestedLabels.every((label) => activeLabels.includes(label));
-      groups.push({
-        group: spec.group,
-        requested_labels: requestedLabels,
-        active_labels: activeLabels,
-        verified,
-        unavailable: false,
-        single_select: spec.selectAllLabels === false,
-        discovered_options: options.map((option) => ({
-          label: option.label,
-          active: option.active,
-          node_id: option.node_id
-        }))
-      });
-    }
-    closeConfirmation = await confirmFilterPanel(client, frameNodeId);
-    if (!closeConfirmation.confirmed) {
-      throw new Error("Recommend filter sticky verification panel could not be closed");
-    }
-    if (settleMs > 0) await sleep(settleMs);
-  }
-
-  const verified = groups.length === normalizedSpecs.length && groups.every((item) => item.verified);
-  const result = {
-    verified,
-    groups,
-    reopened: Boolean(reopen),
-    reopen_panel_node_id: reopen?.panel_node_id || null,
-    close_confirmation: closeConfirmation
-      ? {
-          confirmed: closeConfirmation.confirmed,
-          label: closeConfirmation.confirm_label,
-          node_id: closeConfirmation.confirm_node_id
-        }
-      : null
-  };
-  if (!verified) {
-    const failedGroups = groups.filter((item) => !item.verified).map((item) => item.group);
-    const error = new Error(`Recommend filter sticky verification failed for: ${failedGroups.join(", ")}`);
-    error.sticky_verification = result;
-    throw error;
-  }
-  return result;
-}
-
-export async function selectAndConfirmFirstSafeFilter(client, frameNodeId, options = {}) {
-  const beforeCounts = await getRecommendFilterCounts(client, frameNodeId);
-  const requestedGroups = normalizeRequestedFilterGroups(options);
-  let openResult;
-  try {
-    openResult = await openFilterPanel(client, frameNodeId);
-  } catch (error) {
-    const onlyGroup = requestedGroups.length === 1 ? requestedGroups[0] : null;
-    const requestedLabels = onlyGroup?.labels || [];
-    const unavailableActivityDefault = (
-      error?.code === "RECOMMEND_FILTER_TRIGGER_UNAVAILABLE"
-      && normalizeText(onlyGroup?.group) === RECOMMEND_ACTIVITY_GROUP
-      && onlyGroup?.allow_unlimited === true
-      && requestedLabels.length === 1
-      && requestedLabels[0] === normalizeFilterOptionLabel("不限")
-    );
-    if (!unavailableActivityDefault) throw error;
-
-    const unavailableGroups = [{
-      group: RECOMMEND_ACTIVITY_GROUP,
-      requested_labels: requestedLabels,
-      reason: "activity_control_unavailable_default",
-      scope: "filter_panel"
-    }];
-    const stickySpecs = normalizeStickyVerificationSpecs(options);
-    const stickyVerification = stickySpecs.length
-      ? await verifyFilterGroupsSticky(client, frameNodeId, {
-        specs: stickySpecs,
-        unavailableGroups,
-        settleMs: 0
-      })
-      : null;
-    const afterCounts = await getRecommendFilterCounts(client, frameNodeId);
-    return {
-      opened_panel: false,
-      trigger: null,
-      initial_close_attempts: [],
-      open_attempts: [],
-      before_counts: beforeCounts,
-      after_open_counts: afterCounts,
-      requested_groups: requestedGroups,
-      selected_option: null,
-      selected_options: [],
-      option_box: null,
-      unavailable: true,
-      unavailable_default: true,
-      unavailable_groups: unavailableGroups,
-      discovered_options: [],
-      confirmed: true,
-      confirm_node_id: null,
-      confirm_label: "unavailable-default",
-      confirm_candidates: [],
-      confirm_attempts: [],
-      panel_count: Number(afterCounts.filter_panel || 0),
-      sticky_verification: stickyVerification,
-      after_confirm_counts: afterCounts
-    };
-  }
-  const afterOpenCounts = await getRecommendFilterCounts(client, frameNodeId);
-  const filterGroups = Array.isArray(options.filterGroups) ? options.filterGroups : [];
+    confirm_attempts: attempts,
+    panel_count: await getFilterPanelCount(client, frameNodeId)
+  };
+}
+
+function normalizeStickyVerificationSpecs(options = {}) {
+  const source = Array.isArray(options.filterGroups) && options.filterGroups.length
+    ? options.filterGroups
+    : [options];
+  return source.filter((spec) => spec?.verifySticky === true).map((spec) => ({
+    group: String(spec.group || ""),
+    labels: Array.isArray(spec.labels) ? spec.labels : [],
+    selectAllLabels: spec.selectAllLabels !== false,
+    allowUnlimited: spec.allowUnlimited === true
+  })).filter((spec) => spec.group && spec.labels.length);
+}
+
+function findUnavailableGroup(unavailableGroups = [], group = "") {
+  return unavailableGroups.find((item) => item?.group === group) || null;
+}
+
+function normalizeRequestedFilterGroups(options = {}) {
+  const source = Array.isArray(options.filterGroups) && options.filterGroups.length
+    ? options.filterGroups.filter(Boolean)
+    : (options.group || options.labels?.length ? [options] : []);
+  return source.map((spec) => ({
+    group: String(spec?.group || ""),
+    labels: Array.isArray(spec?.labels)
+      ? spec.labels.map(normalizeFilterOptionLabel).filter(Boolean)
+      : [],
+    select_all_labels: spec?.selectAllLabels !== false,
+    allow_unlimited: spec?.allowUnlimited === true,
+    verify_sticky: spec?.verifySticky === true
+  }));
+}
+
+export async function verifyFilterGroupsSticky(client, frameNodeId, {
+  specs = [],
+  unavailableGroups = [],
+  settleMs = 300
+} = {}) {
+  const normalizedSpecs = specs.filter((spec) => spec?.group && Array.isArray(spec.labels) && spec.labels.length);
+  const groups = [];
+  const availableSpecs = [];
+  for (const spec of normalizedSpecs) {
+    const unavailable = findUnavailableGroup(unavailableGroups, spec.group);
+    if (unavailable) {
+      groups.push({
+        group: spec.group,
+        requested_labels: spec.labels,
+        active_labels: [],
+        verified: true,
+        unavailable: true,
+        reason: unavailable.reason || "control_unavailable_default"
+      });
+    } else {
+      availableSpecs.push(spec);
+    }
+  }
+
+  let reopen = null;
+  let closeConfirmation = null;
+  if (availableSpecs.length) {
+    reopen = await openFilterPanel(client, frameNodeId);
+    for (const spec of availableSpecs) {
+      const options = await listFilterOptions(client, frameNodeId, {
+        groupOrder: [spec.group]
+      });
+      const requestedLabels = spec.labels.map(normalizeFilterOptionLabel).filter(Boolean);
+      const activeLabels = options
+        .filter((option) => option.group === spec.group && option.active)
+        .map((option) => normalizeFilterOptionLabel(option.label));
+      const verified = spec.selectAllLabels === false
+        ? requestedLabels.length === 1
+          && activeLabels.length === 1
+          && activeLabels[0] === requestedLabels[0]
+        : requestedLabels.every((label) => activeLabels.includes(label));
+      groups.push({
+        group: spec.group,
+        requested_labels: requestedLabels,
+        active_labels: activeLabels,
+        verified,
+        unavailable: false,
+        single_select: spec.selectAllLabels === false,
+        discovered_options: options.map((option) => ({
+          label: option.label,
+          active: option.active,
+          node_id: option.node_id
+        }))
+      });
+    }
+    closeConfirmation = await confirmFilterPanel(client, frameNodeId);
+    if (!closeConfirmation.confirmed) {
+      throw new Error("Recommend filter sticky verification panel could not be closed");
+    }
+    if (settleMs > 0) await sleep(settleMs);
+  }
+
+  const verified = groups.length === normalizedSpecs.length && groups.every((item) => item.verified);
+  const result = {
+    verified,
+    groups,
+    reopened: Boolean(reopen),
+    reopen_panel_node_id: reopen?.panel_node_id || null,
+    close_confirmation: closeConfirmation
+      ? {
+          confirmed: closeConfirmation.confirmed,
+          label: closeConfirmation.confirm_label,
+          node_id: closeConfirmation.confirm_node_id
+        }
+      : null
+  };
+  if (!verified) {
+    const failedGroups = groups.filter((item) => !item.verified).map((item) => item.group);
+    const error = new Error(`Recommend filter sticky verification failed for: ${failedGroups.join(", ")}`);
+    error.sticky_verification = result;
+    throw error;
+  }
+  return result;
+}
+
+export async function selectAndConfirmFirstSafeFilter(client, frameNodeId, options = {}) {
+  const beforeCounts = await getRecommendFilterCounts(client, frameNodeId);
+  const requestedGroups = normalizeRequestedFilterGroups(options);
+  let openResult;
+  try {
+    openResult = await openFilterPanel(client, frameNodeId);
+  } catch (error) {
+    const onlyGroup = requestedGroups.length === 1 ? requestedGroups[0] : null;
+    const requestedLabels = onlyGroup?.labels || [];
+    const unavailableActivityDefault = (
+      error?.code === "RECOMMEND_FILTER_TRIGGER_UNAVAILABLE"
+      && normalizeText(onlyGroup?.group) === RECOMMEND_ACTIVITY_GROUP
+      && onlyGroup?.allow_unlimited === true
+      && requestedLabels.length === 1
+      && requestedLabels[0] === normalizeFilterOptionLabel("不限")
+    );
+    if (!unavailableActivityDefault) throw error;
+
+    const unavailableGroups = [{
+      group: RECOMMEND_ACTIVITY_GROUP,
+      requested_labels: requestedLabels,
+      reason: "activity_control_unavailable_default",
+      scope: "filter_panel"
+    }];
+    const stickySpecs = normalizeStickyVerificationSpecs(options);
+    const stickyVerification = stickySpecs.length
+      ? await verifyFilterGroupsSticky(client, frameNodeId, {
+        specs: stickySpecs,
+        unavailableGroups,
+        settleMs: 0
+      })
+      : null;
+    const afterCounts = await getRecommendFilterCounts(client, frameNodeId);
+    return {
+      opened_panel: false,
+      trigger: null,
+      initial_close_attempts: [],
+      open_attempts: [],
+      before_counts: beforeCounts,
+      after_open_counts: afterCounts,
+      requested_groups: requestedGroups,
+      selected_option: null,
+      selected_options: [],
+      option_box: null,
+      unavailable: true,
+      unavailable_default: true,
+      unavailable_groups: unavailableGroups,
+      discovered_options: [],
+      confirmed: true,
+      confirm_node_id: null,
+      confirm_label: "unavailable-default",
+      confirm_candidates: [],
+      confirm_attempts: [],
+      panel_count: Number(afterCounts.filter_panel || 0),
+      sticky_verification: stickyVerification,
+      after_confirm_counts: afterCounts
+    };
+  }
+  const afterOpenCounts = await getRecommendFilterCounts(client, frameNodeId);
+  const filterGroups = Array.isArray(options.filterGroups) ? options.filterGroups : [];
   const selection = filterGroups.length
-    ? await selectFilterGroups(client, frameNodeId, { filterGroups, groupOrder: options.groupOrder })
-    : options.selectAllLabels
-    ? await selectFilterOptions(client, frameNodeId, options)
-    : await selectFilterOption(client, frameNodeId, options);
-  const confirm = await confirmFilterPanel(client, frameNodeId);
-  const stickySpecs = normalizeStickyVerificationSpecs(options);
-  const stickyVerification = confirm.confirmed && stickySpecs.length
-    ? await verifyFilterGroupsSticky(client, frameNodeId, {
-      specs: stickySpecs,
-      unavailableGroups: selection.unavailable_groups || [],
-      settleMs: Number.isFinite(options.stickySettleMs) ? Math.max(0, options.stickySettleMs) : 300
-    })
-    : null;
-  const afterConfirmSettleMs = Number.isFinite(options.afterConfirmSettleMs)
-    ? Math.max(0, options.afterConfirmSettleMs)
-    : 1200;
-  if (afterConfirmSettleMs > 0) await sleep(afterConfirmSettleMs);
-  const afterConfirmCounts = await getRecommendFilterCounts(client, frameNodeId);
-
-  return {
-    opened_panel: true,
-    requested_groups: requestedGroups,
-    trigger: {
+    ? await selectFilterGroups(client, frameNodeId, { filterGroups, groupOrder: options.groupOrder })
+    : options.selectAllLabels
+    ? await selectFilterOptions(client, frameNodeId, options)
+    : await selectFilterOption(client, frameNodeId, options);
+  const confirm = await confirmFilterPanel(client, frameNodeId);
+  const stickySpecs = normalizeStickyVerificationSpecs(options);
+  const stickyVerification = confirm.confirmed && stickySpecs.length
+    ? await verifyFilterGroupsSticky(client, frameNodeId, {
+      specs: stickySpecs,
+      unavailableGroups: selection.unavailable_groups || [],
+      settleMs: Number.isFinite(options.stickySettleMs) ? Math.max(0, options.stickySettleMs) : 300
+    })
+    : null;
+  const afterConfirmSettleMs = Number.isFinite(options.afterConfirmSettleMs)
+    ? Math.max(0, options.afterConfirmSettleMs)
+    : 1200;
+  if (afterConfirmSettleMs > 0) await sleep(afterConfirmSettleMs);
+  const afterConfirmCounts = await getRecommendFilterCounts(client, frameNodeId);
+
+  return {
+    opened_panel: true,
+    requested_groups: requestedGroups,
+    trigger: {
       node_id: openResult.trigger.nodeId,
       selector: openResult.trigger.selector,
       center: openResult.trigger_box.center,
       rect: openResult.trigger_box.rect
-    },
-    initial_close_attempts: openResult.initial_close_attempts,
-    open_attempts: openResult.open_attempts || [],
-    before_counts: beforeCounts,
-    after_open_counts: afterOpenCounts,
-    ...selection,
-    ...confirm,
-    sticky_verification: stickyVerification,
-    after_confirm_counts: afterConfirmCounts
-  };
-}
+    },
+    initial_close_attempts: openResult.initial_close_attempts,
+    open_attempts: openResult.open_attempts || [],
+    before_counts: beforeCounts,
+    after_open_counts: afterOpenCounts,
+    ...selection,
+    ...confirm,
+    sticky_verification: stickyVerification,
+    after_confirm_counts: afterConfirmCounts
+  };
+}