# Hermes 西农 DeepSeek 档位改 xhigh · 变更说明

- 时间：2026-10-30 11:01（北京时间）
- 目标文件：`/vol1/ai/agents/hermes/config.yaml`
- 生效对象：Hermes 默认模型 `DeepSeek-V4.1-Flash`（provider `nwafu`，本地转发 `http://127.0.0.1:18001/v1` → 校内 `deepseek.nwafu.edu.cn`）
- 生效方式：**per-model 覆盖**，全局 `agent.reasoning_effort` 仍是 `medium`（其它模型不受影响）

## 改了什么

```diff
@@ -41,6 +41,8 @@ agent:
   max_turns: 500
   verbose: false
   reasoning_effort: medium
+  reasoning_overrides:
+    nwafu/DeepSeek-V4.1-Flash: xhigh
   personalities: {}
```

只有这两行新增。备份：`/vol1/ai/agents/hermes/config.yaml.bak-xhigh-20261030-110108`（改动前 sha1 `fb673481871109a56b005df16cf7bf1d6b7f6d5c`；改动后 sha256 `62f8f00b275ab17c8cf17f7c9ffce8c7ebc5443cec71c3b0366724ae98d3c2fb`）。

## 为什么是 xhigh、为什么走 per-model

- 该上游只接受 `low / high / xhigh / max` 或 1~100 的整数；**全局的 `medium` 会被 400 拒**：
  `DeepSeek V4.1 reasoning_effort must be low, high, xhigh, max, or an integer within [1, 100] in chat_template_kwargs`（11:01 前 `logs/agent.log` 里两次）。
- 原始探针（同一 key、同一模型）`none/high/xhigh/max` 全部 HTTP 200，reasoning tokens 分别 0 / 228 / 310 / 327 —— xhigh 是真档位，仅低于 max。
- 用 per-model 覆盖而不是改全局，是为了让 `Qwen3-32B`、`Qwen3-235B-A22B` 等仍停在 medium。

## 验证结果

| 检查 | 结果 |
|---|---|
| YAML `safe_load` | 通过 |
| `diff` 备份 | 只有上述两行 |
| Hermes `resolve_reasoning_config` | `DeepSeek-V4.1-Flash` → `{enabled: true, effort: xhigh}`；`nwafu/DeepSeek-V4.1-Flash` → xhigh；`Qwen3-235B-A22B` → medium（未被带动） |
| 网关 `/v1/chat/completions` 实跑 | HTTP 200，返回 `reasoning_content`，13×17=221 正确 |
| 改后新 400 | 0 条（最后一条 400 停在 11:01 之前） |
| Hermes CLI 一次性 `-z` | HTTP 200，正常回答 |

服务未重启：网关每轮 `_load_gateway_config()` 重读配置，新轮次即时生效。

## 回滚

```bash
cd /vol1/ai/agents/hermes && cp -p config.yaml.bak-xhigh-20261030-110108 config.yaml
```

（或手工删掉 `reasoning_overrides` 下的那一行与空键。）

## 附带发现（未处理）

默认 `hermes` 启动器用的是 `tools/python-3.14.7+20260901-linux-x64`，该解释器缺 `ruamel`，所以 `hermes config get/set` 走默认入口会直接 `ModuleNotFoundError` 崩。可用 `/mnt/ssd/apps/trim.hermes/runtime/python/bin/python3.11` + `PYTHONPATH=/mnt/ssd/apps/trim.hermes/hermes-agent` + `HERMES_HOME=/vol1/ai/agents/hermes` 绕过；本次即用该方式读出 `nwafu/DeepSeek-V4.1-Flash: xhigh` 佐证。
