在 Hermes 中使用 ZhiFlo

Hermes 提供 Custom endpoint 向导，可以在终端中保存 ZhiFlo 地址、Token、协议和模型。完成后，hermes chat 会使用新 provider 返回回复。

开始前

• 已按照 Hermes 官方文档安装客户端；hermes --version 能显示版本信息。
• 已创建一枚当前设备专用的 Token。
• 已复制账户当前可用的完整 模型 ID。

Windows 可在开始菜单搜索 PowerShell，macOS 可打开 Terminal，Linux 从应用列表打开终端。安装完成后若命令仍找不到，关闭旧终端并重新打开，再运行版本命令。

运行模型设置向导

1. 如果正在 Hermes chat 中，先退出聊天。

2. 在普通终端运行：

   hermes model

3. 选择 Custom endpoint。

4. 在 API Base URL 中输入：

   https://api.zhiflo.com/v1

5. 在 API Key 提示中粘贴当前设备专用的 ZhiFlo Token。

   只在向导的凭据提示中粘贴 Token，不要把它写进命令、截图或聊天消息。

6. 在兼容模式中选择：

   chat_completions

7. 从发现列表选择账户可用模型；如果未自动列出，手工输入完整模型 ID。

8. 核对摘要中的地址、兼容模式和模型 ID。

9. 保存 provider。

hermes model 才是添加 provider 的完整向导。聊天中的 /model 只能在已经保存的 provider 之间切换，不能代替上述设置。

开始聊天

运行：

hermes chat

确认当前 provider 或模型指向刚保存的 ZhiFlo 设置，然后发送：

不要调用工具，只回答 OK。

看到 OK，说明 provider 已保存、模型已选中并且请求返回了内容。

向导或聊天出现问题

• 无法自动发现模型：使用账户列表中的完整模型 ID 手工继续；发现失败不代表输入的模型一定不可用。
• /model 中没有 ZhiFlo：退出聊天，重新运行 hermes model，完成到最终保存步骤。
• 返回 401：重新进入向导更新 Token，检查是否复制完整以及是否已经过期或撤销。
• 返回 404：确认 Base URL 是 https://api.zhiflo.com/v1，兼容模式是 chat_completions。

下一步：查看 用量和额度。