feat(hermes): add model catalog controls

This commit is contained in:
晴天
2026-05-27 05:06:32 +08:00
parent 18c0164bdb
commit c9e4a380a9
8 changed files with 723 additions and 3 deletions

View File

@@ -119,6 +119,13 @@ const MODEL_DEFAULTS = {
modelMaxTokens: '',
}
const MODEL_CATALOG_DEFAULTS = {
modelCatalogEnabled: true,
modelCatalogUrl: 'https://hermes-agent.nousresearch.com/docs/api/model-catalog.json',
modelCatalogTtlHours: 24,
modelCatalogProvidersJson: '{}',
}
const MODEL_ALIASES_DEFAULTS = {
modelAliasesJson: '{}',
}
@@ -421,6 +428,7 @@ export function render() {
let curatorValues = { ...CURATOR_DEFAULTS }
let quickCommandsValues = { ...QUICK_COMMANDS_DEFAULTS }
let modelValues = { ...MODEL_DEFAULTS }
let modelCatalogValues = { ...MODEL_CATALOG_DEFAULTS }
let modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS }
let hooksValues = { ...HOOKS_DEFAULTS }
let providerOverridesValues = { ...PROVIDER_OVERRIDES_DEFAULTS }
@@ -462,6 +470,7 @@ export function render() {
let curatorLoading = true
let quickCommandsLoading = true
let modelLoading = true
let modelCatalogLoading = true
let modelAliasesLoading = true
let hooksLoading = true
let providerOverridesLoading = true
@@ -503,6 +512,7 @@ export function render() {
let curatorSaving = false
let quickCommandsSaving = false
let modelSaving = false
let modelCatalogSaving = false
let modelAliasesSaving = false
let hooksSaving = false
let providerOverridesSaving = false
@@ -544,6 +554,7 @@ export function render() {
let curatorError = null
let quickCommandsError = null
let modelError = null
let modelCatalogError = null
let modelAliasesError = null
let hooksError = null
let providerOverridesError = null
@@ -580,7 +591,7 @@ export function render() {
}
function isBusy() {
return loading || runtimeLoading || sessionsMaintenanceLoading || updatesLoading || compressionLoading || promptCachingLoading || openrouterCacheLoading || providerRoutingLoading || auxiliaryLoading || toolGuardrailsLoading || memoryLoading || skillsLoading || curatorLoading || quickCommandsLoading || modelLoading || 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 || 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 || 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
}
function option(labelKey, value, selected) {
@@ -1224,7 +1235,7 @@ export function render() {
}
function renderModelConfigPanel() {
const disabled = loading || saving || modelLoading || 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 || 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
return `
<div class="hm-panel hm-config-runtime-panel hm-config-model-panel">
<div class="hm-panel-header">
@@ -1267,8 +1278,50 @@ 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
return `
<div class="hm-panel hm-config-runtime-panel hm-config-model-catalog-panel">
<div class="hm-panel-header">
<div>
<div class="hm-panel-title">${t('engine.hermesModelCatalogConfigTitle')}</div>
<div class="hm-channel-panel-desc">${t('engine.hermesModelCatalogConfigDesc')}</div>
</div>
<div class="hm-panel-actions">
<span class="hm-muted">${modelCatalogSaving ? t('engine.hermesConfigStatusSaving') : modelCatalogLoading ? t('engine.hermesConfigStatusLoading') : t('engine.hermesModelCatalogConfigStatusReady')}</span>
<button class="hm-btn hm-btn--cta hm-btn--sm" id="hm-model-catalog-save" ${disabled ? 'disabled' : ''}>${t('engine.hermesModelCatalogConfigSave')}</button>
</div>
</div>
<div class="hm-panel-body">
${renderError(modelCatalogError)}
<div class="hm-config-check-grid">
<label class="hm-channel-check">
<input id="hm-model-catalog-enabled" type="checkbox" ${modelCatalogValues.modelCatalogEnabled ? 'checked' : ''} ${disabled ? 'disabled' : ''}>
<span>${t('engine.hermesModelCatalogConfigEnabled')}</span>
</label>
</div>
<div class="hm-config-runtime-grid">
<label class="hm-field hm-field--wide">
<span class="hm-field-label">${t('engine.hermesModelCatalogConfigUrl')}</span>
<input id="hm-model-catalog-url" class="hm-input" type="url" value="${esc(modelCatalogValues.modelCatalogUrl)}" placeholder="https://hermes-agent.nousresearch.com/docs/api/model-catalog.json" ${disabled ? 'disabled' : ''}>
</label>
<label class="hm-field">
<span class="hm-field-label">${t('engine.hermesModelCatalogConfigTtlHours')}</span>
<input id="hm-model-catalog-ttl-hours" class="hm-input" type="number" inputmode="numeric" min="1" max="8760" step="1" value="${esc(modelCatalogValues.modelCatalogTtlHours)}" ${disabled ? 'disabled' : ''}>
</label>
<label class="hm-field hm-field--wide">
<span class="hm-field-label">${t('engine.hermesModelCatalogConfigProvidersJson')}</span>
<textarea id="hm-model-catalog-providers-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(modelCatalogValues.modelCatalogProvidersJson)}</textarea>
</label>
</div>
<div class="hm-channel-footnote">${t('engine.hermesModelCatalogConfigFootnote')}</div>
</div>
</div>
`
}
function renderModelAliasesConfigPanel() {
const disabled = loading || saving || modelAliasesLoading || modelAliasesSaving || quickCommandsSaving || modelSaving || 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 || 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">
@@ -2701,6 +2754,7 @@ export function render() {
${renderCuratorConfigPanel()}
${renderQuickCommandsConfigPanel()}
${renderModelConfigPanel()}
${renderModelCatalogConfigPanel()}
${renderModelAliasesConfigPanel()}
${renderHooksConfigPanel()}
${renderProviderOverridesConfigPanel()}
@@ -2746,6 +2800,7 @@ export function render() {
el.querySelector('#hm-curator-config-save')?.addEventListener('click', saveCuratorConfig)
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-model-aliases-save')?.addEventListener('click', saveModelAliasesConfig)
el.querySelector('#hm-hooks-save')?.addEventListener('click', saveHooksConfig)
el.querySelector('#hm-provider-overrides-save')?.addEventListener('click', saveProviderOverridesConfig)
@@ -2849,6 +2904,11 @@ export function render() {
modelValues = { ...MODEL_DEFAULTS, ...(data?.values || {}) }
}
async function loadModelCatalogConfig() {
const data = await api.hermesModelCatalogConfigRead()
modelCatalogValues = { ...MODEL_CATALOG_DEFAULTS, ...(data?.values || {}) }
}
async function loadModelAliasesConfig() {
const data = await api.hermesModelAliasesConfigRead()
modelAliasesValues = { ...MODEL_ALIASES_DEFAULTS, ...(data?.values || {}) }
@@ -2995,6 +3055,7 @@ export function render() {
curatorLoading = true
quickCommandsLoading = true
modelLoading = true
modelCatalogLoading = true
modelAliasesLoading = true
hooksLoading = true
providerOverridesLoading = true
@@ -3036,6 +3097,7 @@ export function render() {
curatorError = null
quickCommandsError = null
modelError = null
modelCatalogError = null
modelAliasesError = null
hooksError = null
providerOverridesError = null
@@ -3293,6 +3355,14 @@ export function render() {
modelLoading = false
draw()
}
try {
await loadModelCatalogConfig()
} catch (err) {
modelCatalogError = humanizeError(err, t('engine.hermesModelCatalogConfigLoadFailed') || 'Load model catalog config failed')
} finally {
modelCatalogLoading = false
draw()
}
try {
await loadModelAliasesConfig()
} catch (err) {
@@ -3931,6 +4001,34 @@ export function render() {
}
}
async function saveModelCatalogConfig() {
const form = {
modelCatalogEnabled: !!el.querySelector('#hm-model-catalog-enabled')?.checked,
modelCatalogUrl: el.querySelector('#hm-model-catalog-url')?.value || MODEL_CATALOG_DEFAULTS.modelCatalogUrl,
modelCatalogTtlHours: el.querySelector('#hm-model-catalog-ttl-hours')?.value || '24',
modelCatalogProvidersJson: el.querySelector('#hm-model-catalog-providers-json')?.value || '{}',
}
modelCatalogSaving = true
modelCatalogError = null
draw()
try {
const result = await api.hermesModelCatalogConfigSave(form)
modelCatalogValues = { ...MODEL_CATALOG_DEFAULTS, ...(result?.values || form) }
await refreshRawAfterStructuredSave()
const backup = result?.backup || ''
toast({
message: t('engine.hermesModelCatalogConfigSaveSuccess'),
hint: backup ? t('engine.hermesConfigBackupHint', { path: backup }) : '',
}, 'success')
} catch (err) {
modelCatalogError = humanizeError(err, t('engine.hermesModelCatalogConfigSaveFailed') || 'Save model catalog config failed')
toast(modelCatalogError, 'error')
} finally {
modelCatalogSaving = false
draw()
}
}
async function saveModelAliasesConfig() {
const form = {
modelAliasesJson: el.querySelector('#hm-model-aliases-json')?.value || '{}',

View File

@@ -583,6 +583,8 @@ export const api = {
hermesWebConfigSave: (form) => invoke('hermes_web_config_save', { form }),
hermesLspConfigRead: () => invoke('hermes_lsp_config_read'),
hermesLspConfigSave: (form) => invoke('hermes_lsp_config_save', { form }),
hermesModelCatalogConfigRead: () => invoke('hermes_model_catalog_config_read'),
hermesModelCatalogConfigSave: (form) => invoke('hermes_model_catalog_config_save', { form }),
hermesSttConfigRead: () => invoke('hermes_stt_config_read'),
hermesSttConfigSave: (form) => invoke('hermes_stt_config_save', { form }),
hermesTtsVoiceConfigRead: () => invoke('hermes_tts_voice_config_read'),

View File

@@ -739,6 +739,18 @@ export default {
hermesWebConfigBackend_xai: _('xAI Search', 'xAI Search', 'xAI Search'),
hermesWebConfigBackend_native: _('原生提取', 'Native extraction', '原生提取'),
hermesWebConfigFootnote: _('这里写入 web.backend、web.search_backend 和 web.extract_backend。留空会删除覆盖让 Hermes 按密钥、可用 provider 和上游默认策略自动选择;未知 web 字段会保留在 raw YAML 中。', 'This writes web.backend, web.search_backend, and web.extract_backend. Leaving a value empty removes the override so Hermes can auto-select based on keys, available providers, and upstream defaults. Unknown web fields stay in raw YAML.', '這裡寫入 web.backend、web.search_backend 和 web.extract_backend。留空會刪除覆蓋讓 Hermes 按密鑰、可用 provider 和上游預設策略自動選擇;未知 web 欄位會保留在 raw YAML 中。'),
hermesModelCatalogConfigTitle: _('模型目录', 'Model catalog', '模型目錄'),
hermesModelCatalogConfigDesc: _('控制 Hermes 模型目录拉取、缓存时间和 provider 专属目录覆盖,用于让模型选择列表在网络波动或私有镜像下保持可用。', 'Control Hermes model catalog fetching, cache TTL, and provider-specific catalog overrides so model selection stays usable with network issues or private mirrors.', '控制 Hermes 模型目錄拉取、快取時間和 provider 專屬目錄覆蓋,用於讓模型選擇列表在網路波動或私有鏡像下保持可用。'),
hermesModelCatalogConfigStatusReady: _('结构化配置', 'structured settings', '結構化設定'),
hermesModelCatalogConfigSave: _('保存模型目录配置', 'Save model catalog settings', '儲存模型目錄設定'),
hermesModelCatalogConfigSaveSuccess: _('模型目录配置已保存,建议重启 Hermes Gateway 生效', 'Model catalog settings saved. Restart Hermes Gateway to take effect.', '模型目錄設定已儲存,建議重啟 Hermes Gateway 生效'),
hermesModelCatalogConfigLoadFailed: _('加载模型目录配置失败', 'Load model catalog settings failed', '載入模型目錄設定失敗'),
hermesModelCatalogConfigSaveFailed: _('保存模型目录配置失败', 'Save model catalog settings failed', '儲存模型目錄設定失敗'),
hermesModelCatalogConfigEnabled: _('启用模型目录', 'Enable model catalog', '啟用模型目錄'),
hermesModelCatalogConfigUrl: _('默认目录 URL', 'Default catalog URL', '預設目錄 URL'),
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 objectprovider 名称只能包含字母、数字、下划线、点和短横线;每个 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 objectprovider 名稱只能包含字母、數字、底線、點和短橫線;每個 provider 的 url 必須是 http 或 https。未知 model_catalog 子欄位會保留在 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', '結構化設定'),