Hermes Desktop 多模型接入的实现步骤

hermes config set model.provider custom
hermes config set model.default xopkimik26
hermes config set model.base_url "https://maas-coding-api.cn-huabei-1.xf-yun.com/v2"
hermes config set model.api_key "<your-api-key>"

model:
  default: xopkimik26
  provider: custom
  base_url: https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
  api_key: <your-api-key>

curl -s "https://maas-coding-api.cn-huabei-1.xf-yun.com/v2/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -d '{"model":"xopkimik26","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

# 1. custom_providers — 运行时路由（必须有 models 列表）
custom_providers:
  - name: xunfei
    base_url: https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
    api_key: <your-api-key>
    models:
      - xopglm51
      - xopkimik26
# 2. providers — 供 /model 命令使用（可选，但建议清空避免冲突）
providers: {}

DEEPSEEK
  Deepseek V4 Pro 中
  Deepseek V4 Flash 中
XIAOMI
  Mimo V2.5 Pro 中
  Mimo V2.5 中
XUNFEI                    ← 新增
  Xopglm51 中
  Xopkimik26 中

# ✅ 正确：providers 清空，custom_providers 包含所有模型
providers: {}
custom_providers:
  - name: xunfei
    base_url: https://...
    api_key: ...
    models: [xopglm51, xopkimik26]

# ❌ 错误 — "default" 是未知字段，被静默丢弃
providers:
  xunfei:
    default: xopglm51
# ✅ 正确 — 必须用 "model" 字段
providers:
  xunfei:
    model: xopglm51

# ❌ 只能显示一个模型
custom_providers:
  - name: xunfei
    model: xopglm51
# ✅ 用 models 列表显示多个模型
custom_providers:
  - name: xunfei
    models:
      - xopglm51
      - xopkimik26

# ~/.hermes/hermes-agent/hermes_cli/models.py
_PROVIDER_MODELS = {
    ...
    "xunfei": [
        "xopkimik26",
        "xopglm51",
    ],
}

# ── 默认模型 ──
model:
  default: mimo-v2.5          # 或你的默认模型
  provider: xiaomi             # 内置 provider
# ── 命名自定义 Provider（多个模型） ──
custom_providers:
  - name: xunfei
    base_url: https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
    api_key: <your-api-key>
    models:
      - xopglm51
      - xopkimik26
# ── providers 清空（避免与 custom_providers 冲突） ──
providers: {}

请帮我配置 Hermes Agent 的自定义 API 模型，要求如下：

API 地址：<https://your-api.com/v2>
API Key：<your-api-key>
模型列表：<model-id-1, model-id-2, ...>
Provider 名称：<自定义名称，如 xunfei>

具体操作：

1. 用 hermes config set 命令配置默认模型：
   - model.provider 设为 custom
   - model.default 设为 <model-id-1>
   - model.base_url 设为 <API地址>
   - model.api_key 设为 <API Key>

2. 编辑 ~/.hermes/config.yaml（或 Windows 上的 C:\Users\<用户名>\AppData\Local\hermes\config.yaml），添加 custom_providers section：
   custom_providers:
     - name: <自定义名称>
       base_url: <API地址>
       api_key: <API Key>
       models:
         - <model-id-1>
         - <model-id-2>

3. 将 providers section 清空为 providers: {}，避免与 custom_providers 冲突。

4. 编辑 hermes_cli/models.py，在 _PROVIDER_MODELS 字典中添加：
   "<自定义名称>": ["<model-id-1>", "<model-id-2>"]
   这样 /model 命令才能自动识别这些模型。

5. 用 curl 测试每个模型的连通性，确认返回 HTTP 200。

6. 用 python yaml.safe_load 验证 config.yaml 格式正确。

7. 提示我重启 Hermes Desktop 以生效。

帮我配置 Hermes Agent 接入一个第三方 API：

API: <https://your-api.com/v2>
Key: <your-api-key>
模型: <model-id>

用 hermes config set 设好默认模型，然后在 config.yaml 里加 custom_providers，记得把 providers 清空避免冲突。

我现在 Hermes 已经配了一个自定义模型 <model-id-1>（provider 名叫 <provider-name>）。
请帮我追加同一个 API 下的另一个模型 <model-id-2>，要求：
1. 在 config.yaml 的 custom_providers 里把 models 改成列表，包含两个模型
2. 在 hermes_cli/models.py 的 _PROVIDER_MODELS 里也加上第二个模型
3. 不要动 model.default，保留原来的默认模型