feat(hermes): add model aliases config

2026-05-29 20:30:00 +08:00 · 2026-05-26 04:28:33 +08:00
parent 59d7833203
commit a34d7befb6
8 changed files with 621 additions and 3 deletions
--- a/src/engines/hermes/pages/config.js
+++ b/src/engines/hermes/pages/config.js
@@ -83,6 +83,10 @@ const QUICK_COMMANDS_DEFAULTS = {
  quickCommandsJson: '{}',
 }

+const MODEL_ALIASES_DEFAULTS = {
+  modelAliasesJson: '{}',
+}
+
 const HOOKS_DEFAULTS = {
  hooksAutoAccept: false,
  hooksJson: '{}',
@@ -286,6 +290,7 @@ export function render() {
  let memoryValues = { ...MEMORY_DEFAULTS }
  let skillsValues = { ...SKILLS_DEFAULTS }
  let quickCommandsValues = { ...QUICK_COMMANDS_DEFAULTS }
+  let modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS }
  let hooksValues = { ...HOOKS_DEFAULTS }
  let providerOverridesValues = { ...PROVIDER_OVERRIDES_DEFAULTS }
  let mcpServersValues = { ...MCP_SERVERS_DEFAULTS }
@@ -318,6 +323,7 @@ export function render() {
  let memoryLoading = true
  let skillsLoading = true
  let quickCommandsLoading = true
+  let modelAliasesLoading = true
  let hooksLoading = true
  let providerOverridesLoading = true
  let mcpServersLoading = true
@@ -350,6 +356,7 @@ export function render() {
  let memorySaving = false
  let skillsSaving = false
  let quickCommandsSaving = false
+  let modelAliasesSaving = false
  let hooksSaving = false
  let providerOverridesSaving = false
  let mcpServersSaving = false
@@ -382,6 +389,7 @@ export function render() {
  let memoryError = null
  let skillsError = null
  let quickCommandsError = null
+  let modelAliasesError = null
  let hooksError = null
  let providerOverridesError = null
  let mcpServersError = null
@@ -413,7 +421,7 @@ export function render() {
  }

  function isBusy() {
-    return loading || runtimeLoading || compressionLoading || promptCachingLoading || openrouterCacheLoading || providerRoutingLoading || auxiliaryLoading || toolGuardrailsLoading || memoryLoading || skillsLoading || quickCommandsLoading || hooksLoading || providerOverridesLoading || mcpServersLoading || agentToolsetsLoading || platformToolsetsLoading || agentRuntimeLoading || unauthorizedDmLoading || securityLoading || displayLoading || humanDelayLoading || streamingLoading || executionLimitsLoading || ioSafetyLoading || checkpointsLoading || cronLoading || loggingLoading || approvalsLoading || privacyLoading || browserLoading || sttLoading || terminalLoading || saving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || platformToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || securitySaving || displaySaving || humanDelaySaving || streamingSaving || executionLimitsSaving || ioSafetySaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || privacySaving || browserSaving || sttSaving || terminalSaving
+    return loading || runtimeLoading || compressionLoading || promptCachingLoading || openrouterCacheLoading || providerRoutingLoading || auxiliaryLoading || toolGuardrailsLoading || memoryLoading || skillsLoading || quickCommandsLoading || modelAliasesLoading || hooksLoading || providerOverridesLoading || mcpServersLoading || agentToolsetsLoading || platformToolsetsLoading || agentRuntimeLoading || unauthorizedDmLoading || securityLoading || displayLoading || humanDelayLoading || streamingLoading || executionLimitsLoading || ioSafetyLoading || checkpointsLoading || cronLoading || loggingLoading || approvalsLoading || privacyLoading || browserLoading || sttLoading || terminalLoading || saving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || modelAliasesSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || platformToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || securitySaving || displaySaving || humanDelaySaving || streamingSaving || executionLimitsSaving || ioSafetySaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || privacySaving || browserSaving || sttSaving || terminalSaving
  }

  function option(labelKey, value, selected) {
@@ -875,7 +883,7 @@ export function render() {
  }

  function renderQuickCommandsConfigPanel() {
-    const disabled = loading || saving || quickCommandsLoading || quickCommandsSaving || 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 || 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">
@@ -900,8 +908,34 @@ export function render() {
    `
  }

+  function renderModelAliasesConfigPanel() {
+    const disabled = loading || saving || modelAliasesLoading || modelAliasesSaving || quickCommandsSaving || 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">
+          <div>
+            <div class="hm-panel-title">${t('engine.hermesModelAliasesConfigTitle')}</div>
+            <div class="hm-channel-panel-desc">${t('engine.hermesModelAliasesConfigDesc')}</div>
+          </div>
+          <div class="hm-panel-actions">
+            <span class="hm-muted">${modelAliasesSaving ? t('engine.hermesConfigStatusSaving') : modelAliasesLoading ? t('engine.hermesConfigStatusLoading') : t('engine.hermesModelAliasesConfigStatusReady')}</span>
+            <button class="hm-btn hm-btn--cta hm-btn--sm" id="hm-model-aliases-save" ${disabled ? 'disabled' : ''}>${t('engine.hermesModelAliasesConfigSave')}</button>
+          </div>
+        </div>
+        <div class="hm-panel-body">
+          ${renderError(modelAliasesError)}
+          <label class="hm-field hm-field--wide">
+            <span class="hm-field-label">${t('engine.hermesModelAliasesConfigJson')}</span>
+            <textarea id="hm-model-aliases-json" class="hm-input" spellcheck="false" rows="8" ${disabled ? 'disabled' : ''} style="font-family:var(--hm-font-mono);line-height:1.65;min-height:220px">${esc(modelAliasesValues.modelAliasesJson)}</textarea>
+          </label>
+          <div class="hm-channel-footnote">${t('engine.hermesModelAliasesConfigFootnote')}</div>
+        </div>
+      </div>
+    `
+  }
+
  function renderHooksConfigPanel() {
-    const disabled = loading || saving || hooksLoading || hooksSaving || quickCommandsSaving || providerOverridesSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
+    const disabled = loading || saving || hooksLoading || hooksSaving || quickCommandsSaving || modelAliasesSaving || 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-hooks-panel">
        <div class="hm-panel-header">
@@ -1894,6 +1928,7 @@ export function render() {
      ${renderMemoryPanel()}
      ${renderSkillsConfigPanel()}
      ${renderQuickCommandsConfigPanel()}
+      ${renderModelAliasesConfigPanel()}
      ${renderHooksConfigPanel()}
      ${renderProviderOverridesConfigPanel()}
      ${renderMcpServersConfigPanel()}
@@ -1933,6 +1968,7 @@ export function render() {
    el.querySelector('#hm-memory-save')?.addEventListener('click', saveMemory)
    el.querySelector('#hm-skills-config-save')?.addEventListener('click', saveSkillsConfig)
    el.querySelector('#hm-quick-commands-save')?.addEventListener('click', saveQuickCommandsConfig)
+    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)
    el.querySelector('#hm-mcp-servers-save')?.addEventListener('click', saveMcpServersConfig)
@@ -2011,6 +2047,11 @@ export function render() {
    quickCommandsValues = { ...QUICK_COMMANDS_DEFAULTS, ...(data?.values || {}) }
  }

+  async function loadModelAliasesConfig() {
+    const data = await api.hermesModelAliasesConfigRead()
+    modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS, ...(data?.values || {}) }
+  }
+
  async function loadHooksConfig() {
    const data = await api.hermesHooksConfigRead()
    hooksValues = { ...HOOKS_DEFAULTS, ...(data?.values || {}) }
@@ -2128,6 +2169,7 @@ export function render() {
    memoryLoading = true
    skillsLoading = true
    quickCommandsLoading = true
+    modelAliasesLoading = true
    hooksLoading = true
    providerOverridesLoading = true
    mcpServersLoading = true
@@ -2160,6 +2202,7 @@ export function render() {
    memoryError = null
    skillsError = null
    quickCommandsError = null
+    modelAliasesError = null
    hooksError = null
    providerOverridesError = null
    mcpServersError = null
@@ -2357,6 +2400,14 @@ export function render() {
      quickCommandsLoading = false
      draw()
    }
+    try {
+      await loadModelAliasesConfig()
+    } catch (err) {
+      modelAliasesError = humanizeError(err, t('engine.hermesModelAliasesConfigLoadFailed') || 'Load model aliases config failed')
+    } finally {
+      modelAliasesLoading = false
+      draw()
+    }
    try {
      await loadHooksConfig()
    } catch (err) {
@@ -2488,6 +2539,9 @@ export function render() {
      try {
        await loadQuickCommandsConfig()
      } catch {}
+      try {
+        await loadModelAliasesConfig()
+      } catch {}
      try {
        await loadHooksConfig()
      } catch {}
@@ -2844,6 +2898,31 @@ export function render() {
    }
  }

+  async function saveModelAliasesConfig() {
+    const form = {
+      modelAliasesJson: el.querySelector('#hm-model-aliases-json')?.value || '{}',
+    }
+    modelAliasesSaving = true
+    modelAliasesError = null
+    draw()
+    try {
+      const result = await api.hermesModelAliasesConfigSave(form)
+      modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS, ...(result?.values || form) }
+      await refreshRawAfterStructuredSave()
+      const backup = result?.backup || ''
+      toast({
+        message: t('engine.hermesModelAliasesConfigSaveSuccess'),
+        hint: backup ? t('engine.hermesConfigBackupHint', { path: backup }) : '',
+      }, 'success')
+    } catch (err) {
+      modelAliasesError = humanizeError(err, t('engine.hermesModelAliasesConfigSaveFailed') || 'Save model aliases config failed')
+      toast(modelAliasesError, 'error')
+    } finally {
+      modelAliasesSaving = false
+      draw()
+    }
+  }
+
  async function saveHooksConfig() {
    const form = {
      hooksAutoAccept: !!el.querySelector('#hm-hooks-auto-accept')?.checked,
--- a/src/lib/tauri-api.js
+++ b/src/lib/tauri-api.js
@@ -529,6 +529,8 @@ export const api = {
  hermesSkillsConfigSave: (form) => invoke('hermes_skills_config_save', { form }),
  hermesQuickCommandsConfigRead: () => invoke('hermes_quick_commands_config_read'),
  hermesQuickCommandsConfigSave: (form) => invoke('hermes_quick_commands_config_save', { form }),
+  hermesModelAliasesConfigRead: () => invoke('hermes_model_aliases_config_read'),
+  hermesModelAliasesConfigSave: (form) => invoke('hermes_model_aliases_config_save', { form }),
  hermesHooksConfigRead: () => invoke('hermes_hooks_config_read'),
  hermesHooksConfigSave: (form) => invoke('hermes_hooks_config_save', { form }),
  hermesProviderOverridesConfigRead: () => invoke('hermes_provider_overrides_config_read'),
--- a/src/locales/modules/engine.js
+++ b/src/locales/modules/engine.js
@@ -823,6 +823,15 @@ export default {
  hermesQuickCommandsConfigSaveFailed: _('保存快捷命令失败', 'Save quick commands failed', '儲存快捷命令失敗'),
  hermesQuickCommandsConfigJson: _('quick_commands JSON 映射', 'quick_commands JSON map', 'quick_commands JSON 映射'),
  hermesQuickCommandsConfigFootnote: _('键名会变成斜杠命令，例如 status 对应 /status。每个命令必须是对象，type 只能为 exec 或 alias；exec 需要 command，alias 的 target 必须以 / 开头。', 'Keys become slash commands, for example status maps to /status. Each command must be an object with type exec or alias; exec needs command, and alias target must start with /.', '鍵名會變成斜線命令，例如 status 對應 /status。每個命令必須是物件，type 只能是 exec 或 alias；exec 需要 command，alias 的 target 必須以 / 開頭。'),
+  hermesModelAliasesConfigTitle: _('模型别名', 'Model aliases', '模型別名'),
+  hermesModelAliasesConfigDesc: _('配置 /model 命令可用的短别名，把常用模型、provider 和自定义 base_url 固定下来，减少手输错误。', 'Configure short aliases for the /model command, pinning common models, providers, and custom base_url values to reduce manual input errors.', '設定 /model 命令可用的短別名，把常用模型、provider 和自訂 base_url 固定下來，減少手動輸入錯誤。'),
+  hermesModelAliasesConfigStatusReady: _('结构化 JSON', 'structured JSON', '結構化 JSON'),
+  hermesModelAliasesConfigSave: _('保存模型别名', 'Save model aliases', '儲存模型別名'),
+  hermesModelAliasesConfigSaveSuccess: _('模型别名已保存，建议重启 Hermes Gateway 生效', 'Model aliases saved. Restart Hermes Gateway to take effect.', '模型別名已儲存，建議重啟 Hermes Gateway 生效'),
+  hermesModelAliasesConfigLoadFailed: _('加载模型别名失败', 'Load model aliases failed', '載入模型別名失敗'),
+  hermesModelAliasesConfigSaveFailed: _('保存模型别名失败', 'Save model aliases failed', '儲存模型別名失敗'),
+  hermesModelAliasesConfigJson: _('model_aliases JSON 映射', 'model_aliases JSON map', 'model_aliases JSON 映射'),
+  hermesModelAliasesConfigFootnote: _('键名是 /model 使用的短别名。每项至少需要 model，可选 provider 和 base_url；未知字段会保留在 raw YAML 中。', 'Keys are short aliases used by /model. Each entry needs at least model, with optional provider and base_url. Unknown fields stay in raw YAML.', '鍵名是 /model 使用的短別名。每項至少需要 model，可選 provider 和 base_url；未知欄位會保留在 raw YAML 中。'),
  hermesHooksConfigTitle: _('Shell Hooks', 'Shell hooks', 'Shell Hooks'),
  hermesHooksConfigDesc: _('配置 Hermes 在工具调用、模型调用和会话生命周期中执行的本地脚本。请只添加可信脚本，自动接受会跳过首次确认。', 'Configure local scripts Hermes runs during tool calls, model calls, and session lifecycle events. Only add trusted scripts; auto accept skips first-use confirmation.', '設定 Hermes 在工具呼叫、模型呼叫和工作階段生命週期中執行的本機腳本。請只加入可信腳本，自動接受會略過首次確認。'),
  hermesHooksConfigStatusReady: _('结构化 JSON', 'structured JSON', '結構化 JSON'),