feat(hermes): add shell hooks config

This commit is contained in:
晴天
2026-05-26 04:04:22 +08:00
parent be7aca03fa
commit 59d7833203
8 changed files with 699 additions and 5 deletions

View File

@@ -83,6 +83,11 @@ const QUICK_COMMANDS_DEFAULTS = {
quickCommandsJson: '{}',
}
const HOOKS_DEFAULTS = {
hooksAutoAccept: false,
hooksJson: '{}',
}
const PROVIDER_OVERRIDES_DEFAULTS = {
providerOverridesJson: '{}',
}
@@ -281,6 +286,7 @@ export function render() {
let memoryValues = { ...MEMORY_DEFAULTS }
let skillsValues = { ...SKILLS_DEFAULTS }
let quickCommandsValues = { ...QUICK_COMMANDS_DEFAULTS }
let hooksValues = { ...HOOKS_DEFAULTS }
let providerOverridesValues = { ...PROVIDER_OVERRIDES_DEFAULTS }
let mcpServersValues = { ...MCP_SERVERS_DEFAULTS }
let agentToolsetsValues = { ...AGENT_TOOLSETS_DEFAULTS }
@@ -312,6 +318,7 @@ export function render() {
let memoryLoading = true
let skillsLoading = true
let quickCommandsLoading = true
let hooksLoading = true
let providerOverridesLoading = true
let mcpServersLoading = true
let agentToolsetsLoading = true
@@ -343,6 +350,7 @@ export function render() {
let memorySaving = false
let skillsSaving = false
let quickCommandsSaving = false
let hooksSaving = false
let providerOverridesSaving = false
let mcpServersSaving = false
let agentToolsetsSaving = false
@@ -374,6 +382,7 @@ export function render() {
let memoryError = null
let skillsError = null
let quickCommandsError = null
let hooksError = null
let providerOverridesError = null
let mcpServersError = null
let agentToolsetsError = null
@@ -404,7 +413,7 @@ export function render() {
}
function isBusy() {
return loading || runtimeLoading || compressionLoading || promptCachingLoading || openrouterCacheLoading || providerRoutingLoading || auxiliaryLoading || toolGuardrailsLoading || memoryLoading || skillsLoading || quickCommandsLoading || 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 || 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 || 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
}
function option(labelKey, value, selected) {
@@ -866,7 +875,7 @@ export function render() {
}
function renderQuickCommandsConfigPanel() {
const disabled = loading || saving || quickCommandsLoading || 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 || quickCommandsLoading || 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-quick-commands-panel">
<div class="hm-panel-header">
@@ -891,8 +900,38 @@ export function render() {
`
}
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
return `
<div class="hm-panel hm-config-runtime-panel hm-config-hooks-panel">
<div class="hm-panel-header">
<div>
<div class="hm-panel-title">${t('engine.hermesHooksConfigTitle')}</div>
<div class="hm-channel-panel-desc">${t('engine.hermesHooksConfigDesc')}</div>
</div>
<div class="hm-panel-actions">
<span class="hm-muted">${hooksSaving ? t('engine.hermesConfigStatusSaving') : hooksLoading ? t('engine.hermesConfigStatusLoading') : t('engine.hermesHooksConfigStatusReady')}</span>
<button class="hm-btn hm-btn--cta hm-btn--sm" id="hm-hooks-save" ${disabled ? 'disabled' : ''}>${t('engine.hermesHooksConfigSave')}</button>
</div>
</div>
<div class="hm-panel-body">
${renderError(hooksError)}
<label class="hm-channel-check">
<input id="hm-hooks-auto-accept" type="checkbox" ${hooksValues.hooksAutoAccept ? 'checked' : ''} ${disabled ? 'disabled' : ''}>
<span>${t('engine.hermesHooksConfigAutoAccept')}</span>
</label>
<label class="hm-field hm-field--wide">
<span class="hm-field-label">${t('engine.hermesHooksConfigJson')}</span>
<textarea id="hm-hooks-json" class="hm-input" spellcheck="false" rows="9" ${disabled ? 'disabled' : ''} style="font-family:var(--hm-font-mono);line-height:1.65;min-height:260px">${esc(hooksValues.hooksJson)}</textarea>
</label>
<div class="hm-channel-footnote">${t('engine.hermesHooksConfigFootnote')}</div>
</div>
</div>
`
}
function renderProviderOverridesConfigPanel() {
const disabled = loading || saving || providerOverridesLoading || providerOverridesSaving || quickCommandsSaving || mcpServersSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
const disabled = loading || saving || providerOverridesLoading || providerOverridesSaving || quickCommandsSaving || hooksSaving || 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-provider-overrides-panel">
<div class="hm-panel-header">
@@ -918,7 +957,7 @@ export function render() {
}
function renderMcpServersConfigPanel() {
const disabled = loading || saving || mcpServersLoading || mcpServersSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
const disabled = loading || saving || mcpServersLoading || mcpServersSaving || quickCommandsSaving || hooksSaving || providerOverridesSaving || 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-mcp-servers-panel">
<div class="hm-panel-header">
@@ -944,7 +983,7 @@ export function render() {
}
function renderAgentToolsetsConfigPanel() {
const disabled = loading || saving || agentToolsetsLoading || agentToolsetsSaving || platformToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || mcpServersSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
const disabled = loading || saving || agentToolsetsLoading || agentToolsetsSaving || platformToolsetsSaving || agentRuntimeSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || hooksSaving || providerOverridesSaving || mcpServersSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
return `
<div class="hm-panel hm-config-runtime-panel hm-config-agent-toolsets-panel">
<div class="hm-panel-header">
@@ -1855,6 +1894,7 @@ export function render() {
${renderMemoryPanel()}
${renderSkillsConfigPanel()}
${renderQuickCommandsConfigPanel()}
${renderHooksConfigPanel()}
${renderProviderOverridesConfigPanel()}
${renderMcpServersConfigPanel()}
${renderAgentToolsetsConfigPanel()}
@@ -1893,6 +1933,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-hooks-save')?.addEventListener('click', saveHooksConfig)
el.querySelector('#hm-provider-overrides-save')?.addEventListener('click', saveProviderOverridesConfig)
el.querySelector('#hm-mcp-servers-save')?.addEventListener('click', saveMcpServersConfig)
el.querySelector('#hm-agent-toolsets-save')?.addEventListener('click', saveAgentToolsetsConfig)
@@ -1970,6 +2011,11 @@ export function render() {
quickCommandsValues = { ...QUICK_COMMANDS_DEFAULTS, ...(data?.values || {}) }
}
async function loadHooksConfig() {
const data = await api.hermesHooksConfigRead()
hooksValues = { ...HOOKS_DEFAULTS, ...(data?.values || {}) }
}
async function loadProviderOverridesConfig() {
const data = await api.hermesProviderOverridesConfigRead()
providerOverridesValues = { ...PROVIDER_OVERRIDES_DEFAULTS, ...(data?.values || {}) }
@@ -2082,6 +2128,7 @@ export function render() {
memoryLoading = true
skillsLoading = true
quickCommandsLoading = true
hooksLoading = true
providerOverridesLoading = true
mcpServersLoading = true
agentToolsetsLoading = true
@@ -2113,6 +2160,7 @@ export function render() {
memoryError = null
skillsError = null
quickCommandsError = null
hooksError = null
providerOverridesError = null
mcpServersError = null
agentToolsetsError = null
@@ -2309,6 +2357,14 @@ export function render() {
quickCommandsLoading = false
draw()
}
try {
await loadHooksConfig()
} catch (err) {
hooksError = humanizeError(err, t('engine.hermesHooksConfigLoadFailed') || 'Load hooks config failed')
} finally {
hooksLoading = false
draw()
}
try {
await loadProviderOverridesConfig()
} catch (err) {
@@ -2432,6 +2488,9 @@ export function render() {
try {
await loadQuickCommandsConfig()
} catch {}
try {
await loadHooksConfig()
} catch {}
try {
await loadProviderOverridesConfig()
} catch {}
@@ -2785,6 +2844,32 @@ export function render() {
}
}
async function saveHooksConfig() {
const form = {
hooksAutoAccept: !!el.querySelector('#hm-hooks-auto-accept')?.checked,
hooksJson: el.querySelector('#hm-hooks-json')?.value || '{}',
}
hooksSaving = true
hooksError = null
draw()
try {
const result = await api.hermesHooksConfigSave(form)
hooksValues = { ...HOOKS_DEFAULTS, ...(result?.values || form) }
await refreshRawAfterStructuredSave()
const backup = result?.backup || ''
toast({
message: t('engine.hermesHooksConfigSaveSuccess'),
hint: backup ? t('engine.hermesConfigBackupHint', { path: backup }) : '',
}, 'success')
} catch (err) {
hooksError = humanizeError(err, t('engine.hermesHooksConfigSaveFailed') || 'Save hooks config failed')
toast(hooksError, 'error')
} finally {
hooksSaving = false
draw()
}
}
async function saveProviderOverridesConfig() {
const form = {
providerOverridesJson: el.querySelector('#hm-provider-overrides-json')?.value || '{}',

View File

@@ -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 }),
hermesHooksConfigRead: () => invoke('hermes_hooks_config_read'),
hermesHooksConfigSave: (form) => invoke('hermes_hooks_config_save', { form }),
hermesProviderOverridesConfigRead: () => invoke('hermes_provider_overrides_config_read'),
hermesProviderOverridesConfigSave: (form) => invoke('hermes_provider_overrides_config_save', { form }),
hermesMcpServersConfigRead: () => invoke('hermes_mcp_servers_config_read'),

View File

@@ -823,6 +823,16 @@ export default {
hermesQuickCommandsConfigSaveFailed: _('保存快捷命令失败', 'Save quick commands failed', '儲存快捷命令失敗'),
hermesQuickCommandsConfigJson: _('quick_commands JSON 映射', 'quick_commands JSON map', 'quick_commands JSON 映射'),
hermesQuickCommandsConfigFootnote: _('键名会变成斜杠命令,例如 status 对应 /status。每个命令必须是对象type 只能为 exec 或 aliasexec 需要 commandalias 的 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 或 aliasexec 需要 commandalias 的 target 必須以 / 開頭。'),
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'),
hermesHooksConfigSave: _('保存 Hooks', 'Save hooks', '儲存 Hooks'),
hermesHooksConfigSaveSuccess: _('Hooks 配置已保存,建议重启 Hermes Gateway 生效', 'Hook settings saved. Restart Hermes Gateway to take effect.', 'Hooks 設定已儲存,建議重啟 Hermes Gateway 生效'),
hermesHooksConfigLoadFailed: _('加载 Hooks 配置失败', 'Load hook settings failed', '載入 Hooks 設定失敗'),
hermesHooksConfigSaveFailed: _('保存 Hooks 配置失败', 'Save hook settings failed', '儲存 Hooks 設定失敗'),
hermesHooksConfigAutoAccept: _('自动接受已配置 Hooks仅限可信脚本', 'Auto accept configured hooks, trusted scripts only', '自動接受已設定 Hooks僅限可信腳本'),
hermesHooksConfigJson: _('hooks JSON 映射', 'hooks JSON map', 'hooks JSON 映射'),
hermesHooksConfigFootnote: _('键名必须是合法事件,例如 pre_tool_call、post_tool_call、pre_llm_call 或 subagent_stop。每项必须包含 command可选 matcher 和 timeout未知字段会保留在 raw YAML 中。', 'Keys must be valid events such as pre_tool_call, post_tool_call, pre_llm_call, or subagent_stop. Each item needs command, with optional matcher and timeout. Unknown fields stay in raw YAML.', '鍵名必須是合法事件,例如 pre_tool_call、post_tool_call、pre_llm_call 或 subagent_stop。每項必須包含 command可選 matcher 和 timeout未知欄位會保留在 raw YAML 中。'),
hermesProviderOverridesConfigTitle: _('Provider 超时覆盖', 'Provider timeout overrides', 'Provider 逾時覆蓋'),
hermesProviderOverridesConfigDesc: _('为指定 provider 或模型单独设置请求超时和非流式卡死检测,适合本地模型冷启动、慢速大上下文和云端快速失败策略。', 'Set request timeouts and non-streaming stale detection per provider or model. Useful for local cold starts, slow large contexts, and fast-fail cloud routes.', '為指定 provider 或模型單獨設定請求逾時和非串流卡死偵測,適合本地模型冷啟動、慢速大上下文和雲端快速失敗策略。'),
hermesProviderOverridesConfigStatusReady: _('结构化 JSON', 'structured JSON', '結構化 JSON'),