feat(hermes): add x search controls

scripts/dev-api.js

@@ -4679,6 +4679,17 @@ function normalizeHermesModelConfigString(value, key, required = false) {
   return text
 }
 
+function normalizeHermesXSearchModel(value, strict = false) {
+  const text = String(value ?? '').trim()
+  if (!text) {
+    if (strict) throw new Error('x_search.model 不能为空')
+    return 'grok-4.20-reasoning'
+  }
+  if (/^[a-zA-Z0-9_.:/-]+$/.test(text)) return text
+  if (strict) throw new Error('x_search.model 只能包含字母、数字、下划线、点、斜杠、冒号和短横线')
+  return 'grok-4.20-reasoning'
+}
+
 function normalizeHermesOptionalModelInteger(value, key) {
   const raw = String(value ?? '').trim()
   if (!raw) return ''
@@ -4726,6 +4737,31 @@ export function mergeHermesModelConfig(config = {}, form = {}) {
   return next
 }
 
+export function buildHermesXSearchConfigValues(config = {}) {
+  const root = config && typeof config === 'object' && !Array.isArray(config) ? config : {}
+  const xSearch = root.x_search && typeof root.x_search === 'object' && !Array.isArray(root.x_search)
+    ? root.x_search
+    : {}
+  return {
+    xSearchModel: normalizeHermesXSearchModel(xSearch.model, false),
+    xSearchTimeoutSeconds: parseHermesInteger(xSearch.timeout_seconds, 'x_search.timeout_seconds', 180, 30, 3600, false),
+    xSearchRetries: parseHermesInteger(xSearch.retries, 'x_search.retries', 2, 0, 20, false),
+  }
+}
+
+export function mergeHermesXSearchConfig(config = {}, form = {}) {
+  const next = mergeConfigsPreservingFields({}, config && typeof config === 'object' && !Array.isArray(config) ? config : {})
+  const currentValues = buildHermesXSearchConfigValues(next)
+  const xSearch = next.x_search && typeof next.x_search === 'object' && !Array.isArray(next.x_search)
+    ? mergeConfigsPreservingFields(next.x_search, {})
+    : {}
+  xSearch.model = normalizeHermesXSearchModel(Object.hasOwn(form, 'xSearchModel') ? form.xSearchModel : currentValues.xSearchModel, true)
+  xSearch.timeout_seconds = parseHermesInteger(Object.hasOwn(form, 'xSearchTimeoutSeconds') ? form.xSearchTimeoutSeconds : currentValues.xSearchTimeoutSeconds, 'x_search.timeout_seconds', 180, 30, 3600, true)
+  xSearch.retries = parseHermesInteger(Object.hasOwn(form, 'xSearchRetries') ? form.xSearchRetries : currentValues.xSearchRetries, 'x_search.retries', 2, 0, 20, true)
+  next.x_search = xSearch
+  return next
+}
+
 function isHermesModelAliasName(value) {
   return /^[a-zA-Z0-9_.-]+$/.test(String(value || '').trim())
 }
@@ -12462,6 +12498,27 @@ const handlers = {
     }
   },
 
+  hermes_x_search_config_read() {
+    const { configPath, exists, config } = readHermesConfigYamlObject()
+    return {
+      exists,
+      configPath,
+      values: buildHermesXSearchConfigValues(config),
+    }
+  },
+
+  hermes_x_search_config_save({ form } = {}) {
+    const { configPath, config } = readHermesConfigYamlObject()
+    const next = mergeHermesXSearchConfig(config, form || {})
+    const backup = writeHermesConfigYamlObject(configPath, next)
+    return {
+      ok: true,
+      configPath,
+      backup,
+      values: buildHermesXSearchConfigValues(next),
+    }
+  },
+
   hermes_model_aliases_config_read() {
     const { configPath, exists, config } = readHermesConfigYamlObject()
     return {

src-tauri/src/commands/hermes.rs

@@ -8724,6 +8724,100 @@ fn merge_hermes_model_catalog_config(
     Ok(())
 }
 
+fn normalize_hermes_x_search_model(value: Option<String>, strict: bool) -> Result<String, String> {
+    let text = value.unwrap_or_default().trim().to_string();
+    if text.is_empty() {
+        if strict {
+            return Err("x_search.model 不能为空".to_string());
+        }
+        return Ok("grok-4.20-reasoning".to_string());
+    }
+    if text
+        .chars()
+        .all(|ch| ch.is_ascii_alphanumeric() || matches!(ch, '_' | '.' | ':' | '/' | '-'))
+    {
+        return Ok(text);
+    }
+    if strict {
+        return Err(
+            "x_search.model 只能包含字母、数字、下划线、点、斜杠、冒号和短横线".to_string(),
+        );
+    }
+    Ok("grok-4.20-reasoning".to_string())
+}
+
+fn build_hermes_x_search_config_values(config: &serde_yaml::Value) -> Value {
+    let root = config.as_mapping();
+    let x_search = root.and_then(|map| yaml_get_mapping(map, "x_search"));
+    let model = normalize_hermes_x_search_model(
+        x_search.and_then(|map| yaml_string_field(map, "model")),
+        false,
+    )
+    .unwrap_or_else(|_| "grok-4.20-reasoning".to_string());
+    let timeout_seconds = x_search
+        .map(|map| bounded_hermes_i64(yaml_i64_field(map, "timeout_seconds"), 180, 30, 3600))
+        .unwrap_or(180);
+    let retries = x_search
+        .map(|map| bounded_hermes_i64(yaml_i64_field(map, "retries"), 2, 0, 20))
+        .unwrap_or(2);
+
+    serde_json::json!({
+        "xSearchModel": model,
+        "xSearchTimeoutSeconds": timeout_seconds,
+        "xSearchRetries": retries,
+    })
+}
+
+fn merge_hermes_x_search_config(
+    config: &mut serde_yaml::Value,
+    form: &Value,
+) -> Result<(), String> {
+    let current = build_hermes_x_search_config_values(config);
+    let model = normalize_hermes_x_search_model(
+        if form.get("xSearchModel").is_some() {
+            form_string(form, "xSearchModel")
+        } else {
+            current["xSearchModel"].as_str().map(ToString::to_string)
+        },
+        true,
+    )?;
+    let timeout_seconds = validate_hermes_i64(
+        if form.get("xSearchTimeoutSeconds").is_some() {
+            form_i64(form, "xSearchTimeoutSeconds")
+        } else {
+            current["xSearchTimeoutSeconds"].as_i64()
+        },
+        "x_search.timeout_seconds",
+        180,
+        30,
+        3600,
+    )?;
+    let retries = validate_hermes_i64(
+        if form.get("xSearchRetries").is_some() {
+            form_i64(form, "xSearchRetries")
+        } else {
+            current["xSearchRetries"].as_i64()
+        },
+        "x_search.retries",
+        2,
+        0,
+        20,
+    )?;
+
+    let root = ensure_yaml_object(config)?;
+    let x_search = yaml_child_object(root, "x_search")?;
+    x_search.insert(yaml_key("model"), serde_yaml::Value::String(model));
+    x_search.insert(
+        yaml_key("timeout_seconds"),
+        serde_yaml::Value::Number(serde_yaml::Number::from(timeout_seconds)),
+    );
+    x_search.insert(
+        yaml_key("retries"),
+        serde_yaml::Value::Number(serde_yaml::Number::from(retries)),
+    );
+    Ok(())
+}
+
 fn build_hermes_lsp_config_values(config: &serde_yaml::Value) -> Value {
     let root = config.as_mapping();
     let lsp = root.and_then(|map| yaml_get_mapping(map, "lsp"));
@@ -11505,6 +11599,30 @@ pub fn hermes_model_catalog_config_save(form: Value) -> Result<Value, String> {
     }))
 }
 
+#[tauri::command]
+pub fn hermes_x_search_config_read() -> Result<Value, String> {
+    let (config_path, exists, config) = read_hermes_channel_yaml_config()?;
+    ensure_yaml_object(&mut config.clone())?;
+    Ok(serde_json::json!({
+        "exists": exists,
+        "configPath": config_path.to_string_lossy(),
+        "values": build_hermes_x_search_config_values(&config),
+    }))
+}
+
+#[tauri::command]
+pub fn hermes_x_search_config_save(form: Value) -> Result<Value, String> {
+    let (config_path, _exists, mut config) = read_hermes_channel_yaml_config()?;
+    merge_hermes_x_search_config(&mut config, &form)?;
+    let backup = write_hermes_yaml_config(&config_path, &config)?;
+    Ok(serde_json::json!({
+        "ok": true,
+        "configPath": config_path.to_string_lossy(),
+        "backup": backup,
+        "values": build_hermes_x_search_config_values(&config),
+    }))
+}
+
 #[tauri::command]
 pub fn hermes_stt_config_read() -> Result<Value, String> {
     let (config_path, exists, config) = read_hermes_channel_yaml_config()?;
@@ -18276,6 +18394,101 @@ streaming:
     }
 }
 
+#[cfg(test)]
+mod hermes_x_search_config_tests {
+    use super::{build_hermes_x_search_config_values, merge_hermes_x_search_config};
+    use serde_json::json;
+
+    #[test]
+    fn x_search_values_have_upstream_defaults() {
+        let config: serde_yaml::Value = serde_yaml::from_str("{}").unwrap();
+        let values = build_hermes_x_search_config_values(&config);
+        assert_eq!(values["xSearchModel"], "grok-4.20-reasoning");
+        assert_eq!(values["xSearchTimeoutSeconds"], 180);
+        assert_eq!(values["xSearchRetries"], 2);
+    }
+
+    #[test]
+    fn x_search_values_read_yaml_fields() {
+        let config: serde_yaml::Value = serde_yaml::from_str(
+            r#"
+x_search:
+  model: grok-4.20-fast
+  timeout_seconds: 90
+  retries: 4
+"#,
+        )
+        .unwrap();
+        let values = build_hermes_x_search_config_values(&config);
+        assert_eq!(values["xSearchModel"], "grok-4.20-fast");
+        assert_eq!(values["xSearchTimeoutSeconds"], 90);
+        assert_eq!(values["xSearchRetries"], 4);
+    }
+
+    #[test]
+    fn merge_x_search_config_preserves_unknown_fields() {
+        let mut config: serde_yaml::Value = serde_yaml::from_str(
+            r#"
+model:
+  provider: xai
+x_search:
+  model: old-grok
+  timeout_seconds: 60
+  retries: 1
+  custom_flag: keep-x-search
+streaming:
+  enabled: true
+"#,
+        )
+        .unwrap();
+
+        merge_hermes_x_search_config(
+            &mut config,
+            &json!({
+                "xSearchModel": "grok-4.20-reasoning",
+                "xSearchTimeoutSeconds": 240,
+                "xSearchRetries": 3,
+            }),
+        )
+        .unwrap();
+
+        assert_eq!(config["model"]["provider"].as_str(), Some("xai"));
+        assert_eq!(config["streaming"]["enabled"].as_bool(), Some(true));
+        assert_eq!(
+            config["x_search"]["model"].as_str(),
+            Some("grok-4.20-reasoning")
+        );
+        assert_eq!(config["x_search"]["timeout_seconds"].as_i64(), Some(240));
+        assert_eq!(config["x_search"]["retries"].as_i64(), Some(3));
+        assert_eq!(
+            config["x_search"]["custom_flag"].as_str(),
+            Some("keep-x-search")
+        );
+    }
+
+    #[test]
+    fn merge_x_search_config_rejects_invalid_values() {
+        let mut config = serde_yaml::Value::Mapping(serde_yaml::Mapping::new());
+        let err =
+            merge_hermes_x_search_config(&mut config, &json!({ "xSearchModel": "" })).unwrap_err();
+        assert!(err.contains("x_search.model"));
+        let err =
+            merge_hermes_x_search_config(&mut config, &json!({ "xSearchModel": "bad model" }))
+                .unwrap_err();
+        assert!(err.contains("x_search.model"));
+        let err =
+            merge_hermes_x_search_config(&mut config, &json!({ "xSearchTimeoutSeconds": 29 }))
+                .unwrap_err();
+        assert!(err.contains("x_search.timeout_seconds"));
+        let err = merge_hermes_x_search_config(&mut config, &json!({ "xSearchRetries": -1 }))
+            .unwrap_err();
+        assert!(err.contains("x_search.retries"));
+        let err = merge_hermes_x_search_config(&mut config, &json!({ "xSearchRetries": 21 }))
+            .unwrap_err();
+        assert!(err.contains("x_search.retries"));
+    }
+}
+
 #[cfg(test)]
 mod hermes_lsp_config_tests {
     use super::{build_hermes_lsp_config_values, merge_hermes_lsp_config};

src-tauri/src/lib.rs

@@ -333,6 +333,8 @@ pub fn run() {
             hermes::hermes_lsp_config_save,
             hermes::hermes_model_catalog_config_read,
             hermes::hermes_model_catalog_config_save,
+            hermes::hermes_x_search_config_read,
+            hermes::hermes_x_search_config_save,
             hermes::hermes_stt_config_read,
             hermes::hermes_stt_config_save,
             hermes::hermes_tts_voice_config_read,

src/engines/hermes/pages/config.js

@@ -126,6 +126,12 @@ const MODEL_CATALOG_DEFAULTS = {
   modelCatalogProvidersJson: '{}',
 }
 
+const X_SEARCH_DEFAULTS = {
+  xSearchModel: 'grok-4.20-reasoning',
+  xSearchTimeoutSeconds: 180,
+  xSearchRetries: 2,
+}
+
 const MODEL_ALIASES_DEFAULTS = {
   modelAliasesJson: '{}',
 }
@@ -429,6 +435,7 @@ export function render() {
   let quickCommandsValues = { ...QUICK_COMMANDS_DEFAULTS }
   let modelValues = { ...MODEL_DEFAULTS }
   let modelCatalogValues = { ...MODEL_CATALOG_DEFAULTS }
+  let xSearchValues = { ...X_SEARCH_DEFAULTS }
   let modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS }
   let hooksValues = { ...HOOKS_DEFAULTS }
   let providerOverridesValues = { ...PROVIDER_OVERRIDES_DEFAULTS }
@@ -471,6 +478,7 @@ export function render() {
   let quickCommandsLoading = true
   let modelLoading = true
   let modelCatalogLoading = true
+  let xSearchLoading = true
   let modelAliasesLoading = true
   let hooksLoading = true
   let providerOverridesLoading = true
@@ -513,6 +521,7 @@ export function render() {
   let quickCommandsSaving = false
   let modelSaving = false
   let modelCatalogSaving = false
+  let xSearchSaving = false
   let modelAliasesSaving = false
   let hooksSaving = false
   let providerOverridesSaving = false
@@ -555,6 +564,7 @@ export function render() {
   let quickCommandsError = null
   let modelError = null
   let modelCatalogError = null
+  let xSearchError = null
   let modelAliasesError = null
   let hooksError = null
   let providerOverridesError = null
@@ -591,7 +601,7 @@ export function render() {
   }
 
   function isBusy() {
-    return loading || runtimeLoading || sessionsMaintenanceLoading || updatesLoading || compressionLoading || promptCachingLoading || openrouterCacheLoading || providerRoutingLoading || auxiliaryLoading || toolGuardrailsLoading || memoryLoading || skillsLoading || curatorLoading || quickCommandsLoading || modelLoading || modelCatalogLoading || modelAliasesLoading || hooksLoading || providerOverridesLoading || mcpServersLoading || agentToolsetsLoading || platformToolsetsLoading || agentRuntimeLoading || unauthorizedDmLoading || securityLoading || displayLoading || humanDelayLoading || kanbanLoading || streamingLoading || executionLimitsLoading || ioSafetyLoading || checkpointsLoading || cronLoading || loggingLoading || approvalsLoading || privacyLoading || browserLoading || webLoading || lspLoading || sttLoading || ttsVoiceLoading || terminalLoading || saving || runtimeSaving || sessionsMaintenanceSaving || updatesSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || curatorSaving || quickCommandsSaving || modelSaving || modelCatalogSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || platformToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || securitySaving || displaySaving || humanDelaySaving || kanbanSaving || streamingSaving || executionLimitsSaving || ioSafetySaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || privacySaving || browserSaving || webSaving || lspSaving || sttSaving || ttsVoiceSaving || terminalSaving
+    return loading || runtimeLoading || sessionsMaintenanceLoading || updatesLoading || compressionLoading || promptCachingLoading || openrouterCacheLoading || providerRoutingLoading || auxiliaryLoading || toolGuardrailsLoading || memoryLoading || skillsLoading || curatorLoading || quickCommandsLoading || modelLoading || modelCatalogLoading || xSearchLoading || modelAliasesLoading || hooksLoading || providerOverridesLoading || mcpServersLoading || agentToolsetsLoading || platformToolsetsLoading || agentRuntimeLoading || unauthorizedDmLoading || securityLoading || displayLoading || humanDelayLoading || kanbanLoading || streamingLoading || executionLimitsLoading || ioSafetyLoading || checkpointsLoading || cronLoading || loggingLoading || approvalsLoading || privacyLoading || browserLoading || webLoading || lspLoading || sttLoading || ttsVoiceLoading || terminalLoading || saving || runtimeSaving || sessionsMaintenanceSaving || updatesSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || curatorSaving || quickCommandsSaving || modelSaving || modelCatalogSaving || xSearchSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || platformToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || securitySaving || displaySaving || humanDelaySaving || kanbanSaving || streamingSaving || executionLimitsSaving || ioSafetySaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || privacySaving || browserSaving || webSaving || lspSaving || sttSaving || ttsVoiceSaving || terminalSaving
   }
 
   function option(labelKey, value, selected) {
@@ -1209,7 +1219,7 @@ export function render() {
   }
 
   function renderQuickCommandsConfigPanel() {
-    const disabled = loading || saving || quickCommandsLoading || quickCommandsSaving || modelSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
+    const disabled = loading || saving || quickCommandsLoading || quickCommandsSaving || modelSaving || xSearchSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
     return `
       <div class="hm-panel hm-config-runtime-panel hm-config-quick-commands-panel">
         <div class="hm-panel-header">
@@ -1235,7 +1245,7 @@ export function render() {
   }
 
   function renderModelConfigPanel() {
-    const disabled = loading || saving || modelLoading || modelSaving || modelCatalogSaving || quickCommandsSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
+    const disabled = loading || saving || modelLoading || modelSaving || modelCatalogSaving || xSearchSaving || quickCommandsSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
     return `
       <div class="hm-panel hm-config-runtime-panel hm-config-model-panel">
         <div class="hm-panel-header">
@@ -1279,7 +1289,7 @@ export function render() {
   }
 
   function renderModelCatalogConfigPanel() {
-    const disabled = loading || saving || modelCatalogLoading || modelCatalogSaving || modelSaving || quickCommandsSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
+    const disabled = loading || saving || modelCatalogLoading || modelCatalogSaving || modelSaving || xSearchSaving || quickCommandsSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
     return `
       <div class="hm-panel hm-config-runtime-panel hm-config-model-catalog-panel">
         <div class="hm-panel-header">
@@ -1320,8 +1330,44 @@ export function render() {
     `
   }
 
+  function renderXSearchConfigPanel() {
+    const disabled = loading || saving || xSearchLoading || xSearchSaving || modelSaving || modelCatalogSaving || quickCommandsSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
+    return `
+      <div class="hm-panel hm-config-runtime-panel hm-config-x-search-panel">
+        <div class="hm-panel-header">
+          <div>
+            <div class="hm-panel-title">${t('engine.hermesXSearchConfigTitle')}</div>
+            <div class="hm-channel-panel-desc">${t('engine.hermesXSearchConfigDesc')}</div>
+          </div>
+          <div class="hm-panel-actions">
+            <span class="hm-muted">${xSearchSaving ? t('engine.hermesConfigStatusSaving') : xSearchLoading ? t('engine.hermesConfigStatusLoading') : t('engine.hermesXSearchConfigStatusReady')}</span>
+            <button class="hm-btn hm-btn--cta hm-btn--sm" id="hm-x-search-save" ${disabled ? 'disabled' : ''}>${t('engine.hermesXSearchConfigSave')}</button>
+          </div>
+        </div>
+        <div class="hm-panel-body">
+          ${renderError(xSearchError)}
+          <div class="hm-config-runtime-grid">
+            <label class="hm-field hm-field--wide">
+              <span class="hm-field-label">${t('engine.hermesXSearchConfigModel')}</span>
+              <input id="hm-x-search-model" class="hm-input" value="${esc(xSearchValues.xSearchModel)}" placeholder="grok-4.20-reasoning" ${disabled ? 'disabled' : ''}>
+            </label>
+            <label class="hm-field">
+              <span class="hm-field-label">${t('engine.hermesXSearchConfigTimeoutSeconds')}</span>
+              <input id="hm-x-search-timeout-seconds" class="hm-input" type="number" inputmode="numeric" min="30" max="3600" step="1" value="${esc(xSearchValues.xSearchTimeoutSeconds)}" ${disabled ? 'disabled' : ''}>
+            </label>
+            <label class="hm-field">
+              <span class="hm-field-label">${t('engine.hermesXSearchConfigRetries')}</span>
+              <input id="hm-x-search-retries" class="hm-input" type="number" inputmode="numeric" min="0" max="20" step="1" value="${esc(xSearchValues.xSearchRetries)}" ${disabled ? 'disabled' : ''}>
+            </label>
+          </div>
+          <div class="hm-channel-footnote">${t('engine.hermesXSearchConfigFootnote')}</div>
+        </div>
+      </div>
+    `
+  }
+
   function renderModelAliasesConfigPanel() {
-    const disabled = loading || saving || modelAliasesLoading || modelAliasesSaving || quickCommandsSaving || modelSaving || modelCatalogSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
+    const disabled = loading || saving || modelAliasesLoading || modelAliasesSaving || quickCommandsSaving || modelSaving || modelCatalogSaving || xSearchSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
     return `
       <div class="hm-panel hm-config-runtime-panel hm-config-model-aliases-panel">
         <div class="hm-panel-header">
@@ -2755,6 +2801,7 @@ export function render() {
       ${renderQuickCommandsConfigPanel()}
       ${renderModelConfigPanel()}
       ${renderModelCatalogConfigPanel()}
+      ${renderXSearchConfigPanel()}
       ${renderModelAliasesConfigPanel()}
       ${renderHooksConfigPanel()}
       ${renderProviderOverridesConfigPanel()}
@@ -2801,6 +2848,7 @@ export function render() {
     el.querySelector('#hm-quick-commands-save')?.addEventListener('click', saveQuickCommandsConfig)
     el.querySelector('#hm-model-config-save')?.addEventListener('click', saveModelConfig)
     el.querySelector('#hm-model-catalog-save')?.addEventListener('click', saveModelCatalogConfig)
+    el.querySelector('#hm-x-search-save')?.addEventListener('click', saveXSearchConfig)
     el.querySelector('#hm-model-aliases-save')?.addEventListener('click', saveModelAliasesConfig)
     el.querySelector('#hm-hooks-save')?.addEventListener('click', saveHooksConfig)
     el.querySelector('#hm-provider-overrides-save')?.addEventListener('click', saveProviderOverridesConfig)
@@ -2909,6 +2957,11 @@ export function render() {
     modelCatalogValues = { ...MODEL_CATALOG_DEFAULTS, ...(data?.values || {}) }
   }
 
+  async function loadXSearchConfig() {
+    const data = await api.hermesXSearchConfigRead()
+    xSearchValues = { ...X_SEARCH_DEFAULTS, ...(data?.values || {}) }
+  }
+
   async function loadModelAliasesConfig() {
     const data = await api.hermesModelAliasesConfigRead()
     modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS, ...(data?.values || {}) }
@@ -3056,6 +3109,7 @@ export function render() {
     quickCommandsLoading = true
     modelLoading = true
     modelCatalogLoading = true
+    xSearchLoading = true
     modelAliasesLoading = true
     hooksLoading = true
     providerOverridesLoading = true
@@ -3098,6 +3152,7 @@ export function render() {
     quickCommandsError = null
     modelError = null
     modelCatalogError = null
+    xSearchError = null
     modelAliasesError = null
     hooksError = null
     providerOverridesError = null
@@ -3363,6 +3418,14 @@ export function render() {
       modelCatalogLoading = false
       draw()
     }
+    try {
+      await loadXSearchConfig()
+    } catch (err) {
+      xSearchError = humanizeError(err, t('engine.hermesXSearchConfigLoadFailed') || 'Load X search config failed')
+    } finally {
+      xSearchLoading = false
+      draw()
+    }
     try {
       await loadModelAliasesConfig()
     } catch (err) {
@@ -4029,6 +4092,33 @@ export function render() {
     }
   }
 
+  async function saveXSearchConfig() {
+    const form = {
+      xSearchModel: el.querySelector('#hm-x-search-model')?.value || X_SEARCH_DEFAULTS.xSearchModel,
+      xSearchTimeoutSeconds: el.querySelector('#hm-x-search-timeout-seconds')?.value || String(X_SEARCH_DEFAULTS.xSearchTimeoutSeconds),
+      xSearchRetries: el.querySelector('#hm-x-search-retries')?.value || String(X_SEARCH_DEFAULTS.xSearchRetries),
+    }
+    xSearchSaving = true
+    xSearchError = null
+    draw()
+    try {
+      const result = await api.hermesXSearchConfigSave(form)
+      xSearchValues = { ...X_SEARCH_DEFAULTS, ...(result?.values || form) }
+      await refreshRawAfterStructuredSave()
+      const backup = result?.backup || ''
+      toast({
+        message: t('engine.hermesXSearchConfigSaveSuccess'),
+        hint: backup ? t('engine.hermesConfigBackupHint', { path: backup }) : '',
+      }, 'success')
+    } catch (err) {
+      xSearchError = humanizeError(err, t('engine.hermesXSearchConfigSaveFailed') || 'Save X search config failed')
+      toast(xSearchError, 'error')
+    } finally {
+      xSearchSaving = false
+      draw()
+    }
+  }
+
   async function saveModelAliasesConfig() {
     const form = {
       modelAliasesJson: el.querySelector('#hm-model-aliases-json')?.value || '{}',

src/lib/tauri-api.js

@@ -585,6 +585,8 @@ export const api = {
   hermesLspConfigSave: (form) => invoke('hermes_lsp_config_save', { form }),
   hermesModelCatalogConfigRead: () => invoke('hermes_model_catalog_config_read'),
   hermesModelCatalogConfigSave: (form) => invoke('hermes_model_catalog_config_save', { form }),
+  hermesXSearchConfigRead: () => invoke('hermes_x_search_config_read'),
+  hermesXSearchConfigSave: (form) => invoke('hermes_x_search_config_save', { form }),
   hermesSttConfigRead: () => invoke('hermes_stt_config_read'),
   hermesSttConfigSave: (form) => invoke('hermes_stt_config_save', { form }),
   hermesTtsVoiceConfigRead: () => invoke('hermes_tts_voice_config_read'),

src/locales/modules/engine.js

@@ -751,6 +751,17 @@ export default {
   hermesModelCatalogConfigTtlHours: _('缓存小时数', 'Cache TTL hours', '快取小時數'),
   hermesModelCatalogConfigProvidersJson: _('Provider 目录覆盖 JSON', 'Provider catalog override JSON', 'Provider 目錄覆蓋 JSON'),
   hermesModelCatalogConfigFootnote: _('这里写入 model_catalog.enabled、model_catalog.url、model_catalog.ttl_hours 和 model_catalog.providers。providers 必须是 JSON object，provider 名称只能包含字母、数字、下划线、点和短横线；每个 provider 的 url 必须是 http 或 https。未知 model_catalog 子字段会保留在 raw YAML 中。', 'This writes model_catalog.enabled, model_catalog.url, model_catalog.ttl_hours, and model_catalog.providers. providers must be a JSON object, provider names may contain letters, numbers, underscores, dots, and hyphens only, and each provider url must use http or https. Unknown model_catalog fields stay in raw YAML.', '這裡寫入 model_catalog.enabled、model_catalog.url、model_catalog.ttl_hours 和 model_catalog.providers。providers 必須是 JSON object，provider 名稱只能包含字母、數字、底線、點和短橫線；每個 provider 的 url 必須是 http 或 https。未知 model_catalog 子欄位會保留在 raw YAML 中。'),
+  hermesXSearchConfigTitle: _('X 搜索', 'X Search', 'X 搜尋'),
+  hermesXSearchConfigDesc: _('控制 Hermes x_search 工具的模型、超时和重试次数，只管理运行参数，不保存 xAI 凭证。', 'Control the Hermes x_search tool model, timeout, and retry count. This manages runtime parameters only and does not store xAI credentials.', '控制 Hermes x_search 工具的模型、逾時和重試次數，只管理執行參數，不儲存 xAI 憑證。'),
+  hermesXSearchConfigStatusReady: _('结构化配置', 'structured settings', '結構化設定'),
+  hermesXSearchConfigSave: _('保存 X 搜索配置', 'Save X Search settings', '儲存 X 搜尋設定'),
+  hermesXSearchConfigSaveSuccess: _('X 搜索配置已保存，建议重启 Hermes Gateway 生效', 'X Search settings saved. Restart Hermes Gateway to take effect.', 'X 搜尋設定已儲存，建議重啟 Hermes Gateway 生效'),
+  hermesXSearchConfigLoadFailed: _('加载 X 搜索配置失败', 'Load X Search settings failed', '載入 X 搜尋設定失敗'),
+  hermesXSearchConfigSaveFailed: _('保存 X 搜索配置失败', 'Save X Search settings failed', '儲存 X 搜尋設定失敗'),
+  hermesXSearchConfigModel: _('搜索模型', 'Search model', '搜尋模型'),
+  hermesXSearchConfigTimeoutSeconds: _('超时秒数', 'Timeout seconds', '逾時秒數'),
+  hermesXSearchConfigRetries: _('重试次数', 'Retry count', '重試次數'),
+  hermesXSearchConfigFootnote: _('这里写入 x_search.model、x_search.timeout_seconds 和 x_search.retries。xAI OAuth 或 XAI_API_KEY 仍由 Hermes 运行时读取；需要启用 x_search toolset 后才会调用该工具。未知 x_search 子字段会保留在 raw YAML 中。', 'This writes x_search.model, x_search.timeout_seconds, and x_search.retries. xAI OAuth or XAI_API_KEY is still read by the Hermes runtime; the x_search toolset must be enabled before the tool is called. Unknown x_search fields stay in raw YAML.', '這裡寫入 x_search.model、x_search.timeout_seconds 和 x_search.retries。xAI OAuth 或 XAI_API_KEY 仍由 Hermes 執行時讀取；需要啟用 x_search toolset 後才會呼叫該工具。未知 x_search 子欄位會保留在 raw YAML 中。'),
   hermesLspConfigTitle: _('LSP 语义诊断', 'LSP semantic diagnostics', 'LSP 語意診斷'),
   hermesLspConfigDesc: _('控制写文件和补丁后的语言服务器诊断等待、工作区扫描和缺失服务器自动安装策略。', 'Control language-server diagnostic waits, workspace scans, and missing-server install strategy after file writes and patches.', '控制寫檔和補丁後的語言伺服器診斷等待、工作區掃描和缺失伺服器自動安裝策略。'),
   hermesLspConfigStatusReady: _('结构化配置', 'structured settings', '結構化設定'),

tests/hermes-config-page-ui.test.js

@@ -139,6 +139,17 @@ test('Hermes 配置页会暴露模型目录结构化配置字段', () => {
   }
 })
 
+test('Hermes 配置页会暴露 X 搜索结构化配置字段', () => {
+  for (const id of [
+    'hm-x-search-save',
+    'hm-x-search-model',
+    'hm-x-search-timeout-seconds',
+    'hm-x-search-retries',
+  ]) {
+    assert.match(source, new RegExp(`id="${id}"`), `缺少 ${id}`)
+  }
+})
+
 test('Hermes 配置页会暴露 provider 超时覆盖结构化配置字段', () => {
   for (const id of [
     'hm-provider-overrides-save',

tests/hermes-x-search-config.test.js

@@ -0,0 +1,78 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+import {
+  buildHermesXSearchConfigValues,
+  mergeHermesXSearchConfig,
+} from '../scripts/dev-api.js'
+
+test('Hermes X 搜索配置读取会提供上游默认值', () => {
+  const values = buildHermesXSearchConfigValues({})
+
+  assert.deepEqual(values, {
+    xSearchModel: 'grok-4.20-reasoning',
+    xSearchTimeoutSeconds: 180,
+    xSearchRetries: 2,
+  })
+})
+
+test('Hermes X 搜索配置读取会回显 YAML 字段', () => {
+  const values = buildHermesXSearchConfigValues({
+    x_search: {
+      model: 'grok-4.20-fast',
+      timeout_seconds: 90,
+      retries: 4,
+    },
+  })
+
+  assert.equal(values.xSearchModel, 'grok-4.20-fast')
+  assert.equal(values.xSearchTimeoutSeconds, 90)
+  assert.equal(values.xSearchRetries, 4)
+})
+
+test('Hermes X 搜索配置保存会保留未知字段并写入上游结构', () => {
+  const next = mergeHermesXSearchConfig({
+    model: { provider: 'xai' },
+    x_search: {
+      model: 'old-grok',
+      timeout_seconds: 60,
+      retries: 1,
+      custom_flag: 'keep-x-search',
+    },
+    streaming: { enabled: true },
+  }, {
+    xSearchModel: 'grok-4.20-reasoning',
+    xSearchTimeoutSeconds: 240,
+    xSearchRetries: 3,
+  })
+
+  assert.deepEqual(next.model, { provider: 'xai' })
+  assert.deepEqual(next.streaming, { enabled: true })
+  assert.equal(next.x_search.model, 'grok-4.20-reasoning')
+  assert.equal(next.x_search.timeout_seconds, 240)
+  assert.equal(next.x_search.retries, 3)
+  assert.equal(next.x_search.custom_flag, 'keep-x-search')
+})
+
+test('Hermes X 搜索配置保存会拒绝非法模型、超时和重试次数', () => {
+  assert.throws(
+    () => mergeHermesXSearchConfig({}, { xSearchModel: '' }),
+    /x_search\.model/,
+  )
+  assert.throws(
+    () => mergeHermesXSearchConfig({}, { xSearchModel: 'bad model' }),
+    /x_search\.model/,
+  )
+  assert.throws(
+    () => mergeHermesXSearchConfig({}, { xSearchTimeoutSeconds: 29 }),
+    /x_search\.timeout_seconds/,
+  )
+  assert.throws(
+    () => mergeHermesXSearchConfig({}, { xSearchRetries: -1 }),
+    /x_search\.retries/,
+  )
+  assert.throws(
+    () => mergeHermesXSearchConfig({}, { xSearchRetries: 21 }),
+    /x_search\.retries/,
+  )
+})