GithubBackup/clawpanel
1
0
Fork 0
mirror of https://github.com/qingchencloud/clawpanel.git synced 2026-06-01 05:40:07 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat(hermes): add update backup controls

Browse Source
This commit is contained in:
晴天
2026-05-27 02:33:57 +08:00
parent 77ab060e9c
commit 66a23f861c
8 changed files with 365 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

97
src/engines/hermes/pages/config.js
View File

@@ -23,6 +23,11 @@ const SESSIONS_MAINTENANCE_DEFAULTS = {
sessionsWriteJsonSnapshots: false,
}
const UPDATES_DEFAULTS = {
updatesPreUpdateBackup: false,
updatesBackupKeep: 5,
}
const COMPRESSION_DEFAULTS = {
enabled: true,
threshold: 0.5,
@@ -356,6 +361,7 @@ export function render() {
let yaml = ''
let runtimeValues = { ...SESSION_RUNTIME_DEFAULTS }
let sessionsMaintenanceValues = { ...SESSIONS_MAINTENANCE_DEFAULTS }
let updatesValues = { ...UPDATES_DEFAULTS }
let compressionValues = { ...COMPRESSION_DEFAULTS }
let promptCachingValues = { ...PROMPT_CACHING_DEFAULTS }
let openrouterCacheValues = { ...OPENROUTER_CACHE_DEFAULTS }
@@ -393,6 +399,7 @@ export function render() {
let loading = true
let runtimeLoading = true
let sessionsMaintenanceLoading = true
let updatesLoading = true
let compressionLoading = true
let promptCachingLoading = true
let openrouterCacheLoading = true
@@ -430,6 +437,7 @@ export function render() {
let saving = false
let runtimeSaving = false
let sessionsMaintenanceSaving = false
let updatesSaving = false
let compressionSaving = false
let promptCachingSaving = false
let openrouterCacheSaving = false
@@ -467,6 +475,7 @@ export function render() {
let error = null
let runtimeError = null
let sessionsMaintenanceError = null
let updatesError = null
let compressionError = null
let promptCachingError = null
let openrouterCacheError = null
@@ -511,7 +520,7 @@ export function render() {
}
function isBusy() {
return loading || runtimeLoading || sessionsMaintenanceLoading || 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 || sttLoading || terminalLoading || saving || runtimeSaving || sessionsMaintenanceSaving || 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 || sttSaving || terminalSaving
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 || sttLoading || 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 || sttSaving || terminalSaving
}
function option(labelKey, value, selected) {
@@ -528,7 +537,7 @@ export function render() {
}
function renderRuntimePanel() {
const disabled = loading || saving || runtimeLoading || runtimeSaving || sessionsMaintenanceSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
const disabled = loading || saving || runtimeLoading || runtimeSaving || sessionsMaintenanceSaving || updatesSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
return `
<div class="hm-panel hm-config-runtime-panel">
<div class="hm-panel-header">
@@ -580,7 +589,7 @@ export function render() {
}
function renderSessionsMaintenancePanel() {
const disabled = loading || saving || sessionsMaintenanceLoading || sessionsMaintenanceSaving || runtimeSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
const disabled = loading || saving || sessionsMaintenanceLoading || sessionsMaintenanceSaving || runtimeSaving || updatesSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
return `
<div class="hm-panel hm-config-runtime-panel">
<div class="hm-panel-header">
@@ -625,8 +634,42 @@ export function render() {
`
}
function renderUpdatesPanel() {
const disabled = loading || saving || updatesLoading || updatesSaving || runtimeSaving || sessionsMaintenanceSaving || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || auxiliarySaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
return `
<div class="hm-panel hm-config-runtime-panel">
<div class="hm-panel-header">
<div>
<div class="hm-panel-title">${t('engine.hermesUpdatesConfigTitle')}</div>
<div class="hm-channel-panel-desc">${t('engine.hermesUpdatesConfigDesc')}</div>
</div>
<div class="hm-panel-actions">
<span class="hm-muted">${updatesSaving ? t('engine.hermesConfigStatusSaving') : updatesLoading ? t('engine.hermesConfigStatusLoading') : t('engine.hermesUpdatesConfigStatusReady')}</span>
<button class="hm-btn hm-btn--cta hm-btn--sm" id="hm-updates-save" ${disabled ? 'disabled' : ''}>${t('engine.hermesUpdatesConfigSave')}</button>
</div>
</div>
<div class="hm-panel-body">
${renderError(updatesError)}
<div class="hm-config-check-grid">
<label class="hm-channel-check">
<input id="hm-updates-pre-update-backup" type="checkbox" ${updatesValues.updatesPreUpdateBackup ? 'checked' : ''} ${disabled ? 'disabled' : ''}>
<span>${t('engine.hermesUpdatesConfigPreUpdateBackup')}</span>
</label>
</div>
<div class="hm-config-runtime-grid">
<label class="hm-field">
<span class="hm-field-label">${t('engine.hermesUpdatesConfigBackupKeep')}</span>
<input id="hm-updates-backup-keep" class="hm-input" type="number" inputmode="numeric" min="1" max="1000" step="1" value="${esc(updatesValues.updatesBackupKeep)}" ${disabled ? 'disabled' : ''}>
</label>
</div>
<div class="hm-channel-footnote">${t('engine.hermesUpdatesConfigFootnote')}</div>
</div>
</div>
`
}
function renderCompressionPanel() {
const disabled = loading || saving || compressionLoading || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || runtimeSaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
const disabled = loading || saving || compressionLoading || compressionSaving || promptCachingSaving || openrouterCacheSaving || providerRoutingSaving || runtimeSaving || updatesSaving || toolGuardrailsSaving || memorySaving || skillsSaving || quickCommandsSaving || providerOverridesSaving || agentToolsetsSaving || agentRuntimeSaving || unauthorizedDmSaving || streamingSaving || executionLimitsSaving || checkpointsSaving || cronSaving || loggingSaving || approvalsSaving || terminalSaving
return `
<div class="hm-panel hm-config-runtime-panel hm-config-compression-panel">
<div class="hm-panel-header">
@@ -2350,6 +2393,7 @@ export function render() {
${renderRuntimePanel()}
${renderSessionsMaintenancePanel()}
${renderUpdatesPanel()}
${renderTerminalPanel()}
${renderStreamingPanel()}
${renderExecutionLimitsPanel()}
@@ -2405,6 +2449,7 @@ export function render() {
el.querySelector('#hm-config-save')?.addEventListener('click', save)
el.querySelector('#hm-runtime-save')?.addEventListener('click', saveRuntime)
el.querySelector('#hm-sessions-maintenance-save')?.addEventListener('click', saveSessionsMaintenance)
el.querySelector('#hm-updates-save')?.addEventListener('click', saveUpdatesConfig)
el.querySelector('#hm-compression-save')?.addEventListener('click', saveCompression)
el.querySelector('#hm-prompt-caching-save')?.addEventListener('click', savePromptCaching)
el.querySelector('#hm-openrouter-cache-save')?.addEventListener('click', saveOpenrouterCache)
@@ -2456,6 +2501,11 @@ export function render() {
sessionsMaintenanceValues = { ...SESSIONS_MAINTENANCE_DEFAULTS, ...(data?.values || {}) }
}
async function loadUpdatesConfig() {
const data = await api.hermesUpdatesConfigRead()
updatesValues = { ...UPDATES_DEFAULTS, ...(data?.values || {}) }
}
async function loadCompression() {
const data = await api.hermesCompressionConfigRead()
compressionValues = { ...COMPRESSION_DEFAULTS, ...(data?.values || {}) }
@@ -2630,6 +2680,7 @@ export function render() {
loading = true
runtimeLoading = true
sessionsMaintenanceLoading = true
updatesLoading = true
compressionLoading = true
promptCachingLoading = true
openrouterCacheLoading = true
@@ -2667,6 +2718,7 @@ export function render() {
error = null
runtimeError = null
sessionsMaintenanceError = null
updatesError = null
compressionError = null
promptCachingError = null
openrouterCacheError = null
@@ -2724,6 +2776,14 @@ export function render() {
sessionsMaintenanceLoading = false
draw()
}
try {
await loadUpdatesConfig()
} catch (err) {
updatesError = humanizeError(err, t('engine.hermesUpdatesConfigLoadFailed') || 'Load updates config failed')
} finally {
updatesLoading = false
draw()
}
try {
await loadCompression()
} catch (err) {
@@ -3023,6 +3083,9 @@ export function render() {
try {
await loadSessionsMaintenance()
} catch {}
try {
await loadUpdatesConfig()
} catch {}
try {
await loadCompression()
} catch {}
@@ -3187,6 +3250,32 @@ export function render() {
}
}
async function saveUpdatesConfig() {
const form = {
updatesPreUpdateBackup: !!el.querySelector('#hm-updates-pre-update-backup')?.checked,
updatesBackupKeep: el.querySelector('#hm-updates-backup-keep')?.value || '5',
}
updatesSaving = true
updatesError = null
draw()
try {
const result = await api.hermesUpdatesConfigSave(form)
updatesValues = { ...UPDATES_DEFAULTS, ...(result?.values || form) }
await refreshRawAfterStructuredSave()
const backup = result?.backup || ''
toast({
message: t('engine.hermesUpdatesConfigSaveSuccess'),
hint: backup ? t('engine.hermesConfigBackupHint', { path: backup }) : '',
}, 'success')
} catch (err) {
updatesError = humanizeError(err, t('engine.hermesUpdatesConfigSaveFailed') || 'Save updates config failed')
toast(updatesError, 'error')
} finally {
updatesSaving = false
draw()
}
}
async function saveCompression() {
const form = {
enabled: !!el.querySelector('#hm-compression-enabled')?.checked,

2
src/lib/tauri-api.js
View File

@@ -569,6 +569,8 @@ export const api = {
hermesCronConfigSave: (form) => invoke('hermes_cron_config_save', { form }),
hermesSessionsMaintenanceConfigRead: () => invoke('hermes_sessions_maintenance_config_read'),
hermesSessionsMaintenanceConfigSave: (form) => invoke('hermes_sessions_maintenance_config_save', { form }),
hermesUpdatesConfigRead: () => invoke('hermes_updates_config_read'),
hermesUpdatesConfigSave: (form) => invoke('hermes_updates_config_save', { form }),
hermesLoggingConfigRead: () => invoke('hermes_logging_config_read'),
hermesLoggingConfigSave: (form) => invoke('hermes_logging_config_save', { form }),
hermesApprovalsConfigRead: () => invoke('hermes_approvals_config_read'),

10
src/locales/modules/engine.js
View File

@@ -512,6 +512,16 @@ export default {
hermesSessionsMaintenanceRetentionDays: _('已结束会话保留天数', 'Ended-session retention days', '已結束會話保留天數'),
hermesSessionsMaintenanceMinIntervalHours: _('自动维护最小间隔小时', 'Minimum maintenance interval hours', '自動維護最小間隔小時'),
hermesSessionsMaintenanceFootnote: _('这里写入 sessions.*。自动清理只触碰已结束会话，活跃会话由 Hermes 保留；VACUUM 会在删除后回收磁盘但可能短暂阻塞写入。旧版 JSON 快照默认关闭，只有外部工具直接读取 ~/.hermes/sessions/session_*.json 时才建议开启。', 'This writes sessions.*. Auto-prune only touches ended sessions; active sessions are preserved by Hermes. VACUUM reclaims disk after deletes but may briefly block writes. Legacy JSON snapshots are off by default; enable them only if an external tool reads ~/.hermes/sessions/session_*.json directly.', '這裡寫入 sessions.*。自動清理只觸碰已結束會話，活躍會話由 Hermes 保留；VACUUM 會在刪除後回收磁碟但可能短暫阻塞寫入。舊版 JSON 快照預設關閉，只有外部工具直接讀取 ~/.hermes/sessions/session_*.json 時才建議啟用。'),
hermesUpdatesConfigTitle: _('升级前备份', 'Pre-update backup', '升級前備份'),
hermesUpdatesConfigDesc: _('控制 hermes update 前是否创建完整备份，并限制升级前备份保留数量，降低自动更新失败后的恢复成本。', 'Control whether hermes update creates a full backup first, and cap how many pre-update backups are retained to reduce recovery cost after failed updates.', '控制 hermes update 前是否建立完整備份，並限制升級前備份保留數量，降低自動更新失敗後的復原成本。'),
hermesUpdatesConfigStatusReady: _('结构化配置', 'structured settings', '結構化設定'),
hermesUpdatesConfigSave: _('保存升级备份配置', 'Save update backups', '儲存升級備份設定'),
hermesUpdatesConfigSaveSuccess: _('升级前备份配置已保存，建议重启 Hermes Gateway 生效', 'Pre-update backup settings saved. Restart Hermes Gateway to take effect.', '升級前備份設定已儲存，建議重啟 Hermes Gateway 生效'),
hermesUpdatesConfigLoadFailed: _('加载升级前备份配置失败', 'Load pre-update backup settings failed', '載入升級前備份設定失敗'),
hermesUpdatesConfigSaveFailed: _('保存升级前备份配置失败', 'Save pre-update backup settings failed', '儲存升級前備份設定失敗'),
hermesUpdatesConfigPreUpdateBackup: _('执行 hermes update 前创建完整备份', 'Create a full backup before hermes update', '執行 hermes update 前建立完整備份'),
hermesUpdatesConfigBackupKeep: _('保留升级前备份数量', 'Pre-update backups to keep', '保留升級前備份數量'),
hermesUpdatesConfigFootnote: _('这里写入 updates.*。备份会落在 <HERMES_HOME>/backups/，大目录可能让每次更新慢几分钟；保留数量最少为 1，如需关闭升级前备份请关闭开关，而不是填 0。其他 updates 高级字段会保留在 raw YAML 中。', 'This writes updates.*. Backups are stored under <HERMES_HOME>/backups/ and large homes may add minutes to each update. Keep count must be at least 1; turn the switch off to disable pre-update backups instead of entering 0. Other advanced updates fields stay in raw YAML.', '這裡寫入 updates.*。備份會落在 <HERMES_HOME>/backups/，大目錄可能讓每次更新慢幾分鐘；保留數量最少為 1，如需關閉升級前備份請關閉開關，而不是填 0。其他 updates 進階欄位會保留在 raw YAML 中。'),
hermesTerminalConfigTitle: _('终端执行', 'Terminal execution', '終端執行'),
hermesTerminalConfigDesc: _('控制 Hermes 工具命令的执行环境、工作目录、超时和容器资源，避免长任务卡死或沙箱范围误配。', 'Control command execution backend, working directory, timeouts, and container resources to avoid stuck runs or sandbox misconfiguration.', '控制 Hermes 工具命令的執行環境、工作目錄、逾時和容器資源，避免長任務卡死或沙箱範圍誤配。'),
hermesTerminalConfigStatusReady: _('结构化配置', 'structured settings', '結構化設定'),