小糯 (Xiaonuo) 281dc7a725 refactor: ~/skills → ~/Code/skills,sync.sh 支持 cursor rules 同步
- 所有引用从 ~/skills 改为 ~/Code/skills(遵循 ~/Code/ 约定)
- sync.sh 新增 cursor/*.mdc → ~/.cursor/rules/ 自动同步
- cfg HERMES_AGENT_CONVENTIONS 同步更新

[小糯]
2026-04-23 20:12:27 +08:00

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