跳转到内容
Amaranth Wiki

Quickstart

常见故障模式（Common Failure Modes）

Section titled “常见故障模式（Common Failure Modes）”

以下是浪费最多时间的问题：

症状（Symptom）可能原因（Likely cause）修复方法（Fix）
Hermes 打开但返回空或错误的回复提供者认证（Provider auth）或模型选择错误重新运行 hermes model 并确认提供者（provider）、模型和认证（auth）
自定义端点“正常工作”但返回垃圾信息基础 URL、模型名称错误，或实际上不兼容 OpenAI先在单独客户端中验证端点
网关启动但无人可向其发送消息机器人令牌（Bot token）、允许列表（allowlist）或平台设置不完整重新运行 hermes gateway setup 并检查 hermes gateway status
hermes --continue 找不到旧会话切换了配置文件（profiles）或会话从未保存检查 hermes sessions list 并确认你处于正确的配置文件中
模型不可用或出现奇怪的默认回退行为提供者路由（Provider routing）或回退设置过于激进在基础提供者稳定之前保持路由关闭
hermes doctor 标记配置问题配置值缺失或过期修复配置，在添加功能前重新测试普通聊天

恢复工具包（Recovery Toolkit）

Section titled “恢复工具包（Recovery Toolkit）”

当感觉有问题时，按此顺序操作：

  1. hermes doctor
  2. hermes model
  3. hermes setup
  4. hermes sessions list
  5. hermes --continue
  6. hermes gateway status

该序列能让你从“异常状态”快速回到已知状态。

--- body --- --- body ---

快速参考（Quick Reference）

Section titled “快速参考（Quick Reference）”
命令（Command）描述（Description）
hermes开始聊天
hermes model选择你的 LLM 提供者（provider）和模型
hermes tools配置每个平台启用的工具（tools）
hermes setup完整设置向导（一次性配置所有内容）
hermes doctor诊断问题
hermes update更新到最新版本
hermes gateway启动消息网关（messaging gateway）
hermes --continue恢复上次会话

下一步（Next Steps）

Section titled “下一步（Next Steps）”