# 09. Hermes 基础配置

## 检查

```bash
# config.yaml 存在
ls ~/.hermes/config.yaml

# hermes-har 可用
hermes-har models status
```

✅ 达标：config.yaml 存在，`hermes-har models status` 能显示当前模型配置

## 前置

- 已完成 01 (Node.js & nvm) — hermes-har 是 npm 全局包
- 已完成 03 (cfg CLI) — 需要 provider 相关配置

## 安装

### 1. 安装 hermes-har

```bash
npm install -g @shazhou/hermes-harness
```

### 2. 确认 config.yaml 基本结构

config.yaml 应包含：

```yaml
provider: custom
model: claude-opus-4.6

custom:
  api_key: "..."
  base_url: "http://..."

telegram:
  bot_token: "..."
  home_channel: "..."
```

如果 config.yaml 不存在或缺少字段，联系主人获取配置信息。

### 3. 配置 Auxiliary Models

Auxiliary models 用于非主对话任务（vision、压缩、搜索等），可以用更便宜/快速的模型：

```bash
# 查看当前状态
hermes-har models status

# 查看可用 providers
hermes-har models providers

# 设置 auxiliary model（每个任务单独设置）
hermes-har models switch <provider> [model] --aux vision
hermes-har models switch <provider> [model] --aux compression
hermes-har models switch <provider> [model] --aux session_search
hermes-har models switch <provider> [model] --aux web_extract
hermes-har models switch <provider> [model] --aux skills_hub
hermes-har models switch <provider> [model] --aux approval
hermes-har models switch <provider> [model] --aux mcp
hermes-har models switch <provider> [model] --aux flush_memories
```

推荐配置：
- **vision**: 用支持视觉的模型（如 gemini-3.1-pro-preview）
- **其他 auxiliary**: 用快速便宜的模型（如 gpt-5.4-mini）

### 4. 性格配置（可选）

询问主人是否需要设置可切换的性格类型。如果需要：

```bash
# 查看已有性格
hermes-har personality list

# 添加性格
hermes-har personality add <name> "<system prompt>"

# 切换性格
hermes-har personality switch <name>

# 通过 Telegram 切换
hermes-har personality switch <name> --tg
```

⚠️ 性格配置因人而异，必须跟主人确认后再设置。

### 5. SOUL.md 家族共识

在 `~/.hermes/SOUL.md` 的人设内容末尾追加家族共识：

```markdown
## 家族共识

- 代码仓库统一 clone 到 `~/Code/`
- Skills repo 在 `~/skills/`
- Node.js 用 nvm 管理，非交互 shell 需先 `export NVM_DIR="$HOME/.nvm" && . "$NVM_DIR/nvm.sh"`
- 配置管理用 cfg CLI，`eval "$(cfg env)"` 加载环境变量
- 代码托管在 git.shazhou.work（Gitea），Git 提交末尾署名 `[你的名字]`
- Gitea 操作（comment/issue/PR/文档）须署名标识自己
```

⚠️ 署名改成你自己的名字。这段会焊进 system prompt，每次对话自动加载。

## 验证

```bash
hermes-har models status
# 应显示 main model 和所有 auxiliary models

hermes --version
# 应能正常输出版本号
```