当Hermes Agent的web_config.json被误改导致控制台异常时，需按版本判断并恢复：v1.8.0+须用hermes config init --force-web一键重建，或手动从GitHub获取对应版本原始文件替换，或从早于误改时间的备份中还原。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当Hermes Agent的web_config.json被误改导致控制台样式错乱、功能按钮消失或页面加载空白时，必须立即恢复该文件原始结构，否则Dashboard将无法正常渲染交互组件。
确认web_config.json是否属于当前版本配置体系
并非所有Hermes Agent版本都使用web_config.json——v1.8.0起才正式引入该前端配置文件，此前版本仅依赖config.yaml中web相关字段。执行hermes version检查输出版本号，若低于1.8.0则无需处理此文件，直接跳转至config.yaml重置流程。
方法一：通过CLI命令一键覆盖（推荐）
该方式调用内置初始化逻辑，自动适配当前安装版本的默认web_config.json结构，避免手动复制粘贴引发的字段缺失或缩进错误。
执行hermes config init --force-web，命令会强制重建web_config.json并保留其余配置文件不变。
这一步操作起来很简单，直接在终端输入命令回车即可，无需进入任何目录。
【注意】该命令不会触碰config.yaml或.env，但会彻底删除原有web_config.json内容，请确保你未在此文件中添加过自定义CSS变量或第三方UI插件路径。
方法二：手动替换为官方默认内容
适用于CLI命令不可用或需验证配置细节的场景，必须严格匹配当前版本的schema定义。
第一步：从GitHub官方仓库获取对应commit的原始文件
访问https://github.com/hermes-ai/hermes-agent/tree/main/web/src/config → 找到与hermes version输出一致的tag分支 → 点击web_config.json → 右上角Raw按钮 → 全选复制内容
第二步：定位并替换本地文件
执行find ~/.hermes -name "web_config.json" 2>/dev/null确认路径，通常为~/.hermes/web/web_config.json；用nano或vim打开该文件，清空全部内容后粘贴刚复制的原始JSON。
第三步：校验JSON语法与字段完整性
保存后执行jq empty ~/.hermes/web/web_config.json 2>/dev/null || echo "格式错误"，若无输出则表示语法合法；再运行grep -E '"theme"| "layout"| "sidebar"' ~/.hermes/web/web_config.json确认核心字段存在。
方法三：从备份快照还原
如果你此前执行过hermes config export，导出包内必然包含web_config.json副本，这是最安全的恢复路径。
解压最近一次备份包：tar -xzf ~/.hermes-config-snapshot-*.tar.gz -C /tmp/hermes-restore
提取其中的web_config.json：cp /tmp/hermes-restore/web/web_config.json ~/.hermes/web/
【关键前提】必须确保该备份生成时间早于web_config.json被修改的时间点，否则还原无效。
