- 所有引用从 ~/skills 改为 ~/Code/skills(遵循 ~/Code/ 约定) - sync.sh 新增 cursor/*.mdc → ~/.cursor/rules/ 自动同步 - cfg HERMES_AGENT_CONVENTIONS 同步更新 [小糯]
2.9 KiB
2.9 KiB
09. Hermes 基础配置
检查
# 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
npm install -g @shazhou/hermes-harness
2. 确认 config.yaml 基本结构
config.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、压缩、搜索等),可以用更便宜/快速的模型:
# 查看当前状态
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. 性格配置(可选)
询问主人是否需要设置可切换的性格类型。如果需要:
# 查看已有性格
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 的人设内容末尾追加家族共识:
## 家族共识
- 代码仓库统一 clone 到 `~/Code/`
- Skills repo 在 `~/Code/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,每次对话自动加载。
验证
hermes-har models status
# 应显示 main model 和所有 auxiliary models
hermes --version
# 应能正常输出版本号