feat(hermes): add context engine controls

2026-06-22 08:03:52 +08:00 · 2026-05-27 05:39:22 +08:00
parent a592b0194d
commit 88ac3f6cca
8 changed files with 354 additions and 1 deletions
--- a/src/engines/hermes/pages/config.js
+++ b/src/engines/hermes/pages/config.js
@@ -132,6 +132,10 @@ const X_SEARCH_DEFAULTS = {
  xSearchRetries: 2,
 }

+const CONTEXT_DEFAULTS = {
+  contextEngine: 'compressor',
+}
+
 const MODEL_ALIASES_DEFAULTS = {
  modelAliasesJson: '{}',
 }
@@ -436,6 +440,7 @@ export function render() {
  let modelValues = { ...MODEL_DEFAULTS }
  let modelCatalogValues = { ...MODEL_CATALOG_DEFAULTS }
  let xSearchValues = { ...X_SEARCH_DEFAULTS }
+  let contextValues = { ...CONTEXT_DEFAULTS }
  let modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS }
  let hooksValues = { ...HOOKS_DEFAULTS }
  let providerOverridesValues = { ...PROVIDER_OVERRIDES_DEFAULTS }
@@ -479,6 +484,7 @@ export function render() {
  let modelLoading = true
  let modelCatalogLoading = true
  let xSearchLoading = true
+  let contextLoading = true
  let modelAliasesLoading = true
  let hooksLoading = true
  let providerOverridesLoading = true
@@ -522,6 +528,7 @@ export function render() {
  let modelSaving = false
  let modelCatalogSaving = false
  let xSearchSaving = false
+  let contextSaving = false
  let modelAliasesSaving = false
  let hooksSaving = false
  let providerOverridesSaving = false
@@ -565,6 +572,7 @@ export function render() {
  let modelError = null
  let modelCatalogError = null
  let xSearchError = null
+  let contextError = null
  let modelAliasesError = null
  let hooksError = null
  let providerOverridesError = null
@@ -601,7 +609,7 @@ export function render() {
  }

  function isBusy() {
-    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
+    return loading || runtimeLoading || sessionsMaintenanceLoading || updatesLoading || compressionLoading || promptCachingLoading || openrouterCacheLoading || providerRoutingLoading || auxiliaryLoading || toolGuardrailsLoading || memoryLoading || skillsLoading || curatorLoading || quickCommandsLoading || modelLoading || modelCatalogLoading || xSearchLoading || contextLoading || 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 || contextSaving || 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) {
@@ -1366,6 +1374,34 @@ export function render() {
    `
  }

+  function renderContextConfigPanel() {
+    const disabled = loading || saving || contextLoading || contextSaving || 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-context-panel">
+        <div class="hm-panel-header">
+          <div>
+            <div class="hm-panel-title">${t('engine.hermesContextConfigTitle')}</div>
+            <div class="hm-channel-panel-desc">${t('engine.hermesContextConfigDesc')}</div>
+          </div>
+          <div class="hm-panel-actions">
+            <span class="hm-muted">${contextSaving ? t('engine.hermesConfigStatusSaving') : contextLoading ? t('engine.hermesConfigStatusLoading') : t('engine.hermesContextConfigStatusReady')}</span>
+            <button class="hm-btn hm-btn--cta hm-btn--sm" id="hm-context-config-save" ${disabled ? 'disabled' : ''}>${t('engine.hermesContextConfigSave')}</button>
+          </div>
+        </div>
+        <div class="hm-panel-body">
+          ${renderError(contextError)}
+          <div class="hm-config-runtime-grid">
+            <label class="hm-field hm-field--wide">
+              <span class="hm-field-label">${t('engine.hermesContextConfigEngine')}</span>
+              <input id="hm-context-engine" class="hm-input" value="${esc(contextValues.contextEngine)}" placeholder="compressor" ${disabled ? 'disabled' : ''}>
+            </label>
+          </div>
+          <div class="hm-channel-footnote">${t('engine.hermesContextConfigFootnote')}</div>
+        </div>
+      </div>
+    `
+  }
+
  function renderModelAliasesConfigPanel() {
    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 `
@@ -2802,6 +2838,7 @@ export function render() {
      ${renderModelConfigPanel()}
      ${renderModelCatalogConfigPanel()}
      ${renderXSearchConfigPanel()}
+      ${renderContextConfigPanel()}
      ${renderModelAliasesConfigPanel()}
      ${renderHooksConfigPanel()}
      ${renderProviderOverridesConfigPanel()}
@@ -2849,6 +2886,7 @@ export function render() {
    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-context-config-save')?.addEventListener('click', saveContextConfig)
    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)
@@ -2962,6 +3000,11 @@ export function render() {
    xSearchValues = { ...X_SEARCH_DEFAULTS, ...(data?.values || {}) }
  }

+  async function loadContextConfig() {
+    const data = await api.hermesContextConfigRead()
+    contextValues = { ...CONTEXT_DEFAULTS, ...(data?.values || {}) }
+  }
+
  async function loadModelAliasesConfig() {
    const data = await api.hermesModelAliasesConfigRead()
    modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS, ...(data?.values || {}) }
@@ -3110,6 +3153,7 @@ export function render() {
    modelLoading = true
    modelCatalogLoading = true
    xSearchLoading = true
+    contextLoading = true
    modelAliasesLoading = true
    hooksLoading = true
    providerOverridesLoading = true
@@ -3153,6 +3197,7 @@ export function render() {
    modelError = null
    modelCatalogError = null
    xSearchError = null
+    contextError = null
    modelAliasesError = null
    hooksError = null
    providerOverridesError = null
@@ -3426,6 +3471,14 @@ export function render() {
      xSearchLoading = false
      draw()
    }
+    try {
+      await loadContextConfig()
+    } catch (err) {
+      contextError = humanizeError(err, t('engine.hermesContextConfigLoadFailed') || 'Load context config failed')
+    } finally {
+      contextLoading = false
+      draw()
+    }
    try {
      await loadModelAliasesConfig()
    } catch (err) {
@@ -4119,6 +4172,31 @@ export function render() {
    }
  }

+  async function saveContextConfig() {
+    const form = {
+      contextEngine: el.querySelector('#hm-context-engine')?.value || CONTEXT_DEFAULTS.contextEngine,
+    }
+    contextSaving = true
+    contextError = null
+    draw()
+    try {
+      const result = await api.hermesContextConfigSave(form)
+      contextValues = { ...CONTEXT_DEFAULTS, ...(result?.values || form) }
+      await refreshRawAfterStructuredSave()
+      const backup = result?.backup || ''
+      toast({
+        message: t('engine.hermesContextConfigSaveSuccess'),
+        hint: backup ? t('engine.hermesConfigBackupHint', { path: backup }) : '',
+      }, 'success')
+    } catch (err) {
+      contextError = humanizeError(err, t('engine.hermesContextConfigSaveFailed') || 'Save context config failed')
+      toast(contextError, 'error')
+    } finally {
+      contextSaving = false
+      draw()
+    }
+  }
+
  async function saveModelAliasesConfig() {
    const form = {
      modelAliasesJson: el.querySelector('#hm-model-aliases-json')?.value || '{}',
--- a/src/lib/tauri-api.js
+++ b/src/lib/tauri-api.js
@@ -587,6 +587,8 @@ export const api = {
  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 }),
+  hermesContextConfigRead: () => invoke('hermes_context_config_read'),
+  hermesContextConfigSave: (form) => invoke('hermes_context_config_save', { form }),
  hermesSttConfigRead: () => invoke('hermes_stt_config_read'),
  hermesSttConfigSave: (form) => invoke('hermes_stt_config_save', { form }),
  hermesTtsVoiceConfigRead: () => invoke('hermes_tts_voice_config_read'),
--- a/src/locales/modules/engine.js
+++ b/src/locales/modules/engine.js
@@ -762,6 +762,15 @@ export default {
  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 中。'),
+  hermesContextConfigTitle: _('上下文引擎', 'Context engine', '上下文引擎'),
+  hermesContextConfigDesc: _('控制 Hermes 在接近上下文窗口上限时使用内置压缩器还是插件上下文引擎，适合长会话稳定性调优。', 'Control whether Hermes uses the built-in compressor or a plugin context engine when approaching the context window limit. Useful for long-session stability tuning.', '控制 Hermes 在接近上下文視窗上限時使用內建壓縮器還是外掛上下文引擎，適合長會話穩定性調校。'),
+  hermesContextConfigStatusReady: _('结构化配置', 'structured settings', '結構化設定'),
+  hermesContextConfigSave: _('保存上下文引擎配置', 'Save context engine settings', '儲存上下文引擎設定'),
+  hermesContextConfigSaveSuccess: _('上下文引擎配置已保存，建议重启 Hermes Gateway 生效', 'Context engine settings saved. Restart Hermes Gateway to take effect.', '上下文引擎設定已儲存，建議重啟 Hermes Gateway 生效'),
+  hermesContextConfigLoadFailed: _('加载上下文引擎配置失败', 'Load context engine settings failed', '載入上下文引擎設定失敗'),
+  hermesContextConfigSaveFailed: _('保存上下文引擎配置失败', 'Save context engine settings failed', '儲存上下文引擎設定失敗'),
+  hermesContextConfigEngine: _('引擎名称', 'Engine name', '引擎名稱'),
+  hermesContextConfigFootnote: _('这里写入 context.engine。compressor 表示使用内置压缩器；填写插件名会让 Hermes 尝试加载 plugins/context_engine/<name>/ 或用户插件目录中的上下文引擎。未知 context 子字段会保留在 raw YAML 中。', 'This writes context.engine. compressor uses the built-in compressor; entering a plugin name makes Hermes try plugins/context_engine/<name>/ or user plugin directories. Unknown context fields stay in raw YAML.', '這裡寫入 context.engine。compressor 表示使用內建壓縮器；填寫外掛名稱會讓 Hermes 嘗試載入 plugins/context_engine/<name>/ 或使用者外掛目錄中的上下文引擎。未知 context 子欄位會保留在 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', '結構化設定'),