# Hermes Agent 全面体检清单

> 来源：2026-07-24 全量体检实操 + 2026-07-26 state.db 损坏恢复 + CloudBase 部署排查
> 核心命令：`hermes doctor` → `hermes status --all` → 本文件补充诊断
> **原则：一次性系统排查所有组件，不要逐个修复（用户会不耐烦）**

## 十步体检清单

### 第1优先级（立即并行执行）

1. **版本检查**
   ```bash
   hermes --version
   ```

2. **核心诊断**
   ```bash
   hermes doctor
   ```

3. **组件状态**
   ```bash
   hermes status --all
   ```

4. **state.db 健康**
   ```bash
   ls -lh ~/.hermes/state.db
   sqlite3 ~/.hermes/state.db "PRAGMA integrity_check;" 2>&1 | head -5
   ```

5. **模型配置一致性（Pitfall 29f）**
   ```bash
   python3 -c "
   import yaml
   with open('$HOME/.hermes/config.yaml') as f: c = yaml.safe_load(f)
   print('default:', c.get('model',{}).get('default','EMPTY!'))
   print('provider:', c.get('model',{}).get('provider','EMPTY!'))
   "
   ```

### 第2优先级

6. **MEMORY.md 容量** — 目标 <70%，参照 Pitfall 59 批量精简
7. **Gateway + Cron** — `hermes gateway status` + `hermes cron status`
8. **基础设施** — HTTP:8765 / Tailscale / tmux

### 第3优先级

9. **配置优化** — `curator.enabled true` + `approvals.mode smart`
10. **CloudBase 部署验证** — tcb hosting download 验 Origin

## 修复速查表

| 问题 | 修复 |
|------|------|
| MODEL.default/provider 为空 | `hermes config set model.default deepseek-v4-pro` |
| MEMORY.md >80% | memory operations 批量精简 |
| state.db 损坏 | Pitfall 62 路径 D |
| HTTP 8765 未运行 | tmux 隔离启动 |
| Tunnel 过期 | Pitfall 64 流程 |
| CloudBase 数据加载失败 | 部署数据文件到 CloudBase（Pitfall 63） |
| web_search 不可用 | Tavily 注册（Pitfall 61） |

## 关键预防措施

1. hermes update 后验证 Gateway + cron 心跳
2. state.db 更新前先 integrity_check
3. HTTP 8765 和 cloudflared 用 tmux 隔离
4. 页面内置离线登录回退（Pitfall 64）