小糯 (Xiaonuo) 8610cf6329 feat(onboard): SOUL.md 家族共识写入 09-hermes-config
- ~/Code/ 统一代码目录、nvm/cfg 加载、Git 署名等共识
- 写入 SOUL.md 焊进 system prompt,每次对话自动生效

[小糯]
2026-04-23 18:07:43 +08:00

119 lines
2.9 KiB
Markdown

# 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
# 应能正常输出版本号
```