Hermes 配置

在 IDE 中安装 Hermes 插件，填写 QiyuanHub 的 Base URL 与 API Key，完成解释代码、单测与修 Bug 等能力对接。

适用说明

Hermes 以 IDE 插件形式提供 AI 编程能力（解释代码、生成单测、修复 Bug、侧边栏对话等）。将其 Provider 设为 OpenAI 兼容并指向 QiyuanHub 后，调用会计入你的平台额度。

支持右键菜单快捷操作与侧边栏 Chat
协议：OpenAI Compatible
模型名必须使用平台 slug，不要用插件内置的官方模型名（除非碰巧一致）

开始前请确认

已注册并登录 QiyuanHub（官网注册页完成邮箱验证）
账号状态为 active：控制台可正常创建 API Key；pending 审核中无法调用
已在「控制台 → API 密钥」创建密钥，格式为 `sk-opc-...`（完整 Key 仅创建时显示一次）
钱包有可用余额，或仍有体验额度
已从「模型 & 定价」确认目标模型为「已上线」，推荐先用 `deepseek-v4.1` 做连通验证

对接参数（复制用）

Base URL：`https://api.qiyuanapi.cc/v1`（必须带 `/v1`，不要写成 `https://api.qiyuanapi.cc`）
API Key：`sk-opc-你的密钥`（请求头为 `Authorization: Bearer <key>`）
模型 ID：使用定价页中的 slug：`deepseek-v4.1`

先用 curl 确认网关可用

export OPC_API_KEY="sk-opc-your-api-key"

curl https://api.qiyuanapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $OPC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍自己"}]
  }'

安装插件

1. 打开扩展市场

在 VS Code / Cursor 等兼容 IDE 的扩展面板搜索「Hermes」。

2. 安装并重载

点击 Install；若提示 Reload Window，请重载后再配置。

3. 确认活动栏出现 Hermes 图标

能打开 Hermes 侧边栏，说明插件已加载。

配置 QiyuanHub

若设置里同时有「API Host」和「Base URL」，两者都填同一地址，且都带 `/v1`。

1. 打开 Hermes Settings

点击侧边栏 Hermes → 齿轮 / Settings，进入 Hermes 设置页。

2. 选择 Provider 类型（如有）

选择 OpenAI / OpenAI Compatible / Custom OpenAI。

3. 填写 API Base URL

填：`https://api.qiyuanapi.cc/v1`

4. 填写 API Key

粘贴 `sk-opc-...`，注意不要多空格或换行。

5. 填写默认模型

填 `deepseek-v4.1`；思考深浅用 reasoning_effort 调，见「思考强度设置」。

6. 保存

点击「保存 / Save」。部分版本需再开关一次侧边栏才会生效。

验证能否使用

1. 侧边栏对话

打开 Hermes Chat，发送「你好」。应收到模型回复。

2. 右键菜单（可选）

在编辑器选中一段代码 → 右键 → Hermes →「解释代码」或「生成单元测试」。

3. 核对平台用量

打开 QiyuanHub 控制台 → 使用日志，确认有刚才的请求与模型名。

排错

401 unauthorized — Key 错误、被禁用，或未加 `Bearer ` 前缀
402 / quota_exceeded — 余额不足，请充值或使用兑换码
403 application_pending — 账号尚未审核通过
403 ip_not_allowed — 当前 IP 不在该 Key 白名单内（若你开启了 IP 限制）
model_not_allowed / 模型不存在 — slug 写错，或模型未上线 / 无权限
429 rate_limited — 触发限流，稍后重试或降低并发
点了保存仍走旧配置：完全退出 IDE 再开，或 Disable/Enable 一次插件
右键没有 Hermes：确认已选中代码，且扩展已启用当前工作区
自定义 Prompt 导致异常：先清空 System Prompt，用默认配置复测

export OPC_API_KEY="sk-opc-your-api-key" curl https://api.qiyuanapi.cc/v1/chat/completions \ -H "Authorization: Bearer $OPC_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-v4.1", "messages": [{"role": "user", "content": "你好，请用一句话介绍自己"}] }'