---
template: sheet
title: Doctor 体检：Hermes 与 HFC（2026-10-31 17:25）
subtitle: HFC 全绿；Hermes 有 1 个真问题、2 个配置格式待迁移
cols: 2
source: hermes doctor · hermes_feishu_card.cli doctor --explain · sidecar /health
---

Lead: HFC 卡片链路全部正常，只有两个已知的可选告警。Hermes 侧 6 项里有 1 个真问题：OpenCode Zen 的 key 已失效。

## A Hermes doctor：6 项待处理 {span=2}

| 项目 | 级别 | 影响 | 建议 |
|---|---|---|---|
| OpenCode Zen key 失效 | 真问题 | 主链走 opencode-go 不受影响，zen 通道不可用 | 换新 key 或删掉该键 |
| SiliconFlow 是 legacy 条目 | 格式迁移 | 8 个辅助槽正在用它，运行时能解析 | 迁到 providers: 段防未来断链 |
| Ikuncode GPT 是 legacy 条目 | 格式迁移 | 当前未使用 | 同上一并迁或直接删 |
| web workspace 7 个 npm 漏洞 | 上游 | 需官方 lockfile 修复 | 本地修不持久，等上游 |
| ui-tui workspace 2 个 npm 漏洞 | 上游 | 同上 | 同上 |
| 部分可选 key 缺失 | 可选 | discord / xAI / image_gen 不可用 | 不用就不管 |

## B HFC doctor：核心全绿

```kv cols=2
Hermes 兼容性: partial（缺可选锚点 status_callback）
Exact delivery: ready
Runtime import: ok
Install state: installed（Decomposed ownership）
Card readiness: ready / runtime_ready
sidecar /health: healthy，delivery=live
generation_match: true，restart_required: false
last_seen_age: 10 秒
anchors: 22 个里 21 个 found
Feishu SDK: lark-oapi 1.6.8，支持 extra_ua_tags
Streaming: enabled
```

```callout info 三个告警都不算坏
status_callback 缺失是 0.22.5 拿走了可选锚点；split HOME 是本机固定结构；route_fallback 表示走 bots.default，需要确定性路由时才绑 profile。
```

## C 顺带发现的两件事

- state.db 已经 965 MB，740 个会话、16.6 万条消息，仍在 WAL 模式。磁盘占 64%，暂时不缺空间。
- 备用 provider 链是 liangrekui-claude / liangrekui-gpt / xiaomi，都不依赖 zen，所以 zen key 失效不影响任何现役路由。

## D 如果要修，按这个顺序

```bash
# 1) 清掉失效的 zen key（不影响主链与辅助链）
#    编辑 /root/.hermes/.env 删掉 OPENCODE_ZEN_API_KEY 那一行

# 2) 把两个 legacy provider 迁到 providers: 段
#    改前备份：cp -a /root/.hermes/config.yaml /root/backups/config.yaml.bak.$(date +%Y%m%d_%H%M%S)
#    迁移后必须验：8 个 Xing 辅助槽仍能解析并真实调用
hermes doctor
```

迁移属于会动辅助链路由的改动，建议单独一轮做，改完跑一次配置驱动冒烟再收工。