Hermes Agent 手动配置指南

本路线直接维护 Hermes config-v12 的 named provider 配置。它与 hermes model 向导分开验证。

当前状态：配置机制已确认，最终客户端/工具调用/用量与扣费 evidence 待完成。选择器在 evidence 通过前不生成可复制配置。

¶ 凭据文件

编辑 ~/.hermes/.env：

ACEDATA_API_KEY={token}

{token} 只代表用户本机 Token，示例不包含真实密钥。

¶ Provider 配置

编辑 ~/.hermes/config.yaml：

providers:
  acedatacloud:
    name: Ace Data Cloud
    api: https://api.acedata.cloud/v1
    key_env: ACEDATA_API_KEY
    transport: chat_completions
    default_model: MODEL_ID

model:
  provider: custom:acedatacloud
  default: MODEL_ID

把两个 MODEL_ID 替换为 Coding 选择器当前允许的同一个 exact model ID。不要自行添加未验证的 context、vision、thinking 或 tools 声明。

¶ 验证

hermes --version
hermes chat -Q --max-turns 1 -q "Reply exactly HERMES_MANUAL_OK"

Wave 1 evidence 还需要真实工具调用、最终请求路径、trace、ApiUsage、扣费和 Coding Application 余额核对。配置文件与 .env 是同一 profile 的两个必需 artifacts。

¶ 安全

chmod 600 ~/.hermes/.env ~/.hermes/config.yaml

不要提交这两个文件。修改后完全重启 Hermes。

返回 Coding Plan 配置中心。