Hermes Studio 帮助
Hermes Studio 每个功能的综合指南。使用下面的目录跳转到任意章节。
1. 入门指南
连接 Hermes Gateway
Hermes Studio 通过 Hermes Gateway 服务器与你的 AI - 自定义 Agent 角色 通信。使用任何功能之前,你需要:
- 点击侧边栏中的齿轮图标或按 打开设置界面。.
- 在连接部分,输入你的 Gateway URL(例如
或你的远程服务器地址)。如果 Gateway 需要 API Key,请在 API Key 字段中输入。 - 如果 Gateway 需要 API Key,请在 API Key 字段中输入。
- 点击 测试连接 验证连通性。顶部栏中的绿色指示灯确认连接成功。
- 提示:
或你的远程服务器地址)。首次设置首次启动 Hermes Studio 时,可能会出现设置向导指导你完成初始配置。如果没有,请手动:
配置你的 Gateway 连接(见上文)。
- 进入设置,在外观下选择你偏好的主题和强调色。
- 可选:在身份部分设置你的身份文件(SOUL.md 和 persona.md),以个性化你的 AI 交互。
- 浏览技能注册表,安装你的工作流所需的技能。
- 浏览技能注册表,安装你的工作流所需的技能。
左侧边栏是你的主要导航。每个图标代表一个主要功能区域:
- 与你的 AI Agent 直接对话
- 对话 - 多 Agent 团队管理
- - 多 Agent 团队管理 - 任务编排与监控
- - 任务编排与监控 - 看板式任务面板
- - 看板式任务面板 - 定时/Cron 任务管理
- - 定时/Cron 任务管理 - 知识图谱和记忆文件
- - 知识图谱和记忆文件 - 技能注册表和管理
- 技能 - 自定义 Agent 角色
- - 自定义 Agent 角色 - 文件浏览器和编辑器
- - 文件浏览器和编辑器 - 集成终端
- - 集成终端 - 用量分析和审计日志
- - 用量分析和审计日志 - 应用配置
- - 应用配置 侧边栏可以通过点击顶部的汉堡菜单图标折叠。在较小的屏幕上,它会自动折叠。
侧边栏可以通过点击顶部的汉堡菜单图标折叠。在较小的屏幕上,它会自动折叠。
2. 对话
开始对话
对话界面是你与 AI Agent 交互的主要界面。要开始新对话:
- 点击侧边栏中的 对话 图标打开对话界面。
- 在屏幕底部的输入框中输入你的消息。
- 按 Enter 发送消息,或按 Shift+Enter 换行而不发送。
- 每次对话都存在于一个会话中。你可以使用会话面板管理会话:
点击会话侧边栏中的
按钮创建新会话。
- 点击会话侧边栏中的 + 按钮创建新会话。点击列表中的任何现有会话以切换。
- 点击列表中的任何现有会话以切换到它。
- 会话在应用重启后仍然保留,因此你可以稍后继续对话。
- 审批(批准 / 拒绝 / 始终允许)
当 AI 想执行需要权限的操作(如运行命令、写入文件或访问网络)时,会显示审批卡片,并提供三种选择:
批准
- - 仅允许这一次具体操作。 拒绝
- - 拒绝此操作。AI 会收到通知,并可能建议替代方案。 始终允许
- - 在当前会话中永久批准此类操作。权限会被记住,你之后不会被反复询问。 - - 仅允许这一次具体操作。 this type of action permanently for the current session. The permission is remembered so you won't be asked again for the same tool or pattern.
你可以为消息附加文件供 AI 分析或处理:
点击消息输入框旁边的回形针图标。
- 点击消息输入框旁边的回形针图标。
- 附加的文件会以标签形式显示在输入框上方。点击标签上的 X 移除它。
- 附加的文件会以标签形式显示在输入框上方。点击标签上的 X 移除它。
- 流式响应
响应逐 Token 流式传输,带来实时体验。响应流式输出时:
你可以随时点击
- 停止 按钮暂停生成。 工具调用及其结果显示为可折叠的内联块。
- 代码块带有语法高亮和复制按钮。
- Markdown 格式(标题、列表、表格、链接)自动渲染。
- Markdown 格式(标题、列表、表格、链接)自动渲染。
3. - 多 Agent 团队管理(多 Agent 团队)
创建 Crew
- Crews 让你可以把多个 AI Agents 组织成能够协作处理复杂任务的团队。要创建新 Crew:
- 从侧边栏导航到 - 多 Agent 团队管理 界面。
- 点击右上角的 + 新 Crew 按钮。
- 为你的 Crew 输入名称和可选描述。
- 选择是从零开始还是使用模板。
- 点击 创建 完成。添加成员
创建 Crew 后,你需要添加参与其中的 Agent 成员:
在 Crew 列表中点击你的 Crew 打开。
- 在成员面板中点击
- 在成员面板中点击 添加成员。从可用 Agents 中选择一个 Agent,或内联创建一个新 Agent。
- 为成员分配角色(例如:研究员、开发者、审查员)。
- 可选:设置覆盖该 Agent 在此 Crew 上下文中的默认提示词的特定指令。
- 使用模板
模板为常见工作流提供预配置的 Crew 设置:
研究团队
- - 为深度研究配置的 Crew,包含专门的研究员和摘要 Agent。 开发团队
- - 包含架构师、开发者和代码审查 Agent。 内容团队
- - 内容创作的文字、编辑和事实核查 Agent。 在创建 Crew 时选择模板,即可用合适的成员和设置预填充 Crew。
调度任务
Dispatching - 看板式任务面板
打开 Crew 详情视图。
- 如果 Gateway 需要 API Key,请在 API Key 字段中输入。
- 点击 调度任务 或使用底部的输入框。描述你希望 Crew 完成什么。
- 任务将根据成员角色和工作流配置分发给 Crew 成员。
- 克隆 Crews
Cloning - 多 Agent 团队管理
右键点击列表中的 Crew,或点击 Crew 卡片上的三点菜单。
- 选择
- 克隆 Crew 将创建具有相同成员、角色和设置的新 Crew。你可以重命名并按需修改。.
- 工作流构建器(DAG 编辑器)
工作流构建器让你可以使用可视化有向无环图(DAG)定义任务如何在 Crew 成员之间流转:
打开 Crew 并切换到
- 标签页。 每个 Crew 成员在画布上显示为一个节点。 拖动节点之间的连线以定义任务流(谁把工作传给谁)。
- 点击连线配置条件或转换。
- 使用工具栏添加决策节点、并行分支或合并点。
- 点击连线配置条件或转换。
- 按钮或
- 保存你的工作流。 你可以使用滚动和拖拽缩放/平移画布。双击节点编辑其属性。 监控 Crew 运行 Crew 工作时,你可以监控进度:.
点击进入 Crew 查看每个成员当前的活动。
时间线视图显示成员之间的操作序列和交接。
- 每个成员的输出显示在各自的面板中。
- 点击进入 Crew 查看每个成员当前的活动。
- 时间线视图显示成员之间的操作序列和交接。
- 每个成员的输出显示在各自的面板中。
4. - 任务编排与监控(任务编排)
启动任务
Conductor 是编排复杂多步骤任务的指挥中心。要启动新任务:
- 从侧边栏导航到 - 任务编排与监控 界面。
- 在主输入框中输入你的任务目标。尽可能具体地描述你想要完成的内容。
- 点击 启动任务 或按 Ctrl+Enter。
- Conductor 将分析你的目标、制定计划,并开始调度 workers。
快捷操作(调研 / 构建 / 审查 / 部署)
对于常见的任务类型,使用输入框下方的快捷操作按钮:
- 调研 - 启动以调研为重点的任务,Agent 配置用于信息收集和综合。
- 构建 - 创建带代码编写 workers 和自动化测试的开发任务。
- 审查 - 启动代码审查任务,检查你的仓库中的问题、改进点和最佳实践。
- 部署 - 启动带部署前检查和发布步骤的部署流水线任务。
每个快捷操作都会为该任务类型预配置合适的模型、worker 数量和监督设置。
- 应用配置 (模型s, 并行 Workers, 监督模式)
启动任务前,点击输入框旁边的齿轮图标配置其参数:
- 模型 - 选择驱动任务运行的 AI 模型(例如 Claude Opus、Claude Sonnet)。更强的模型能更好地处理复杂推理。
- 并行 Workers - 设置同时工作的 Agent 数量(1-8)。更多 workers 加快执行但增加成本。
- 监督模式 - 启用后,Conductor 会在每个主要操作前暂停并征求你的批准。禁用则完全自主运行。
Office View(3 种布局)
Office View 是活跃任务的可视化动画。它将 workers 显示为坐在桌前的动画角色,实时工作。
- 网格布局 - Workers 以网格模式排列。最适合同时查看多个 workers。每个 worker 占据一个单元格,显示其头像、当前任务和状态。
- 行布局 - Workers 以水平行显示,每个 worker 显示更多细节。展示展开的任务描述和最近的输出片段。
- 聚焦布局 - 在大型中央视图中一次高亮一个 worker,完整输出实时流式显示。其他 workers 显示为侧边的小缩略图。点击缩略图聚焦到不同的 worker。
使用 Office View 右上角的布局切换按钮切换布局。workers 是动画的:它们显示打字指示器和进度环。
监控 Workers
Office View 中的每个 worker 显示:
- 彩色状态环:蓝色(工作中)、绿色(已完成子任务)、黄色(等待批准)、红色(出错)。
- 正在处理的当前子任务,以标题形式显示在 worker 上方。
- 进度指示器,显示子任务的完成进度。
- 点击任意 worker 展开其详情面板,查看完整流式输出。
暂停 / 恢复 / 中止
使用顶部栏的传输控件控制运行中的任务:
- 暂停 - 临时暂停所有 workers。它们完成当前的 Token 生成,但不会开始新的子任务。点击 恢复 继续。
- 恢复 - 从暂停处恢复任务。
- 中止 - 永久停止任务。所有 workers 被终止。此操作无法撤销,但你可以用相同目标启动新任务。
任务历史与费用跟踪
所有已完成和中止的任务都保存在你的任务历史中:
- 切换到 历史 标签页查看过去的任务。
- 每个条目显示目标、状态、时长和总费用。
- 费用按每个 worker 的模型用量(输入 Token、输出 Token)细分。
- 点击历史任务查看其完整输出和时间线。
5. - 看板式任务面板(看板)
Creating - 看板式任务面板
Tasks 界面展示看板,用于组织工作项。要创建新任务:
- 从侧边栏导航到 - 看板式任务面板 界面。
- 点击任意列顶部的 + 按钮(待办池、进行中、待审、完成)。
- 为任务输入标题。
- 可选:添加描述、设置优先级、添加标签,并分配给 Agent 或 Crew。
- 点击 添加 将该任务添加到该列。
列间拖放
通过点击和拖动在列之间移动任务:
- 点击并按住任务卡片。
- 将其拖到目标列。
- 松开即可放下。任务状态会自动更新。
- 你也可以通过在列内上下拖动来重新排序任务。
优先级、标签和负责人
每个任务都可以用元数据丰富:
- 优先级 - 点击旗帜图标循环切换优先级:无、低、中、高、关键。高和关键任务会视觉高亮。
- 标签 - 添加彩色标签以分类任务(例如 "bug"、"feature"、"docs")。点击标签图标添加或创建标签。
- 负责人 - 将任务分配给特定 Agents 或 Crews。点击头像图标并从可用 Agents 中选择。
Cross-linking with - 多 Agent 团队管理 / - 任务编排与监控
任务可以链接到 Crew 操作或 Conductor 任务:
- 当 Conductor 任务创建子任务时,它们会自动出现在看板上,并带有返回任务的链接。
- 你可以通过点击 链接到 Crew 手动将任务链接到 Crew。
- 链接的任务显示来自关联 Crew 或任务的状态更新。
6. - 定时/Cron 任务管理(定时任务)
Creating Scheduled - 定时/Cron 任务管理
Jobs 让你可以按 cron 调度安排重复的 AI 任务。要创建新任务:
- 从侧边栏导航到 - 定时/Cron 任务管理 界面。
- 点击 + 新建任务 在右上角点击。
- 为任务输入名称和描述。
- 定义 AI 每次运行时应执行的提示词或任务。
- 设置调度(见下文)。
- 配置输出投递渠道。
- 点击 完成创建。 Job 保存。
调度预设与自定义 Cron
从常用预设中选择,或编写自定义 cron 表达式:
- 每小时 - 在每个整点运行。
- 每天 9 点 - 每天早晨执行。
- 每周一 - 每周一午夜。
- 自定义 - 输入任意有效的 cron 表达式(例如
*/15 * * * *表示每 15 分钟)。
输入框下方的调度预览显示接下来的 5 个计划执行时间,以便你验证调度是否正确。
投递渠道
配置每次运行后任务输出的发送位置:
- 应用内 - 结果出现在 Jobs 界面的运行历史中(始终启用)。
- Telegram - 将结果发送到 Telegram 会话或群组。
- Discord - 通过 webhook 将结果发布到 Discord 频道。
- Slack - 发送到 Slack 频道。
- 邮件 - 将结果发送到指定邮箱地址。
Triggering - 定时/Cron 任务管理 Manually
你不必等待调度来测试任务:
- 在任务列表中找到该任务。
- 点击 the 点击任务卡片上的 按钮(播放图标)。
- 任务立即执行,结果出现在运行历史中。
监控运行历史
每个任务跟踪其执行历史:
- 点击任务查看其详情视图和完整运行历史。
- 每次运行显示:时间戳、时长、状态(成功/失败)和输出。
- 失败的运行显示错误详情,便于诊断问题。
- 如果列表变长,使用 清除历史 按钮移除旧运行。
7. 记忆与知识图谱
Browsing - 知识图谱和记忆文件 - 文件浏览器和编辑器
The - 知识图谱和记忆文件 screen gives you access to the AI's persistent memory stored as structured files:
- 从侧边栏导航到 - 知识图谱和记忆文件 界面。
- 左侧的文件树按类别显示所有记忆文件。
- 点击任意文件在主面板中查看其内容。
- - 知识图谱和记忆文件 files are typically Markdown documents containing facts, preferences, and learned context.
知识图谱可视化
切换到 图谱 标签页,查看记忆条目如何连接的交互式可视化:
- 节点代表单个记忆条目或概念。
- 边显示条目之间的关系(引用、依赖、类别)。
- 悬停在节点上查看其内容预览。
- 点击节点在详情面板中打开完整条目。
- 使用滚轮缩放,拖动平移图谱。
- 图谱使用力导向算法自动布局,但你可以拖动节点重新定位。
搜索条目
如果列表变长,使用 search bar at the top of the - 知识图谱和记忆文件 screen to find specific entries:
- 输入关键词过滤文件列表并高亮匹配条目。
- 搜索覆盖文件名、内容和标签。
- 结果随输入实时更新。
编辑ing - 知识图谱和记忆文件
你可以手动编辑记忆条目,以纠正或扩充 AI 的知识:
- 在树中点击打开记忆文件。
- 点击 the 编辑 点击(铅笔图标)进入编辑模式。
- 按需修改 Markdown 内容。
- 点击 你可以使用滚动和拖拽缩放/平移画布。双击节点编辑其属性。 或按 Crew 工作时,你可以监控进度: 保存你的更改。
8. 技能
浏览技能注册表
技能是可扩展 AI 能力的模块化功能。要浏览可用技能:
- 从侧边栏导航到 技能 界面。
- 注册表以卡片形式显示所有可用技能,包括名称、描述和状态。
- 使用搜索栏按名称或类别过滤技能。
- 点击技能卡片查看完整详情,包括文档和配置选项。
安装ing 技能
要为你的设置添加新技能:
- 在注册表中找到你想要的技能。
- 点击 the 安装 点击技能卡片上的安装按钮。
- 如果技能需要配置(API Key、参数),会出现配置表单。填写必填字段。
- 点击 确认 确认完成安装。
- 该技能现在可用于对话、Crews 和任务。
Enabling / Disabling 技能
你可以临时禁用技能而无需卸载:
- 切换任意已安装技能卡片上的开关以启用或禁用。
- 禁用的技能保留配置,但 AI 不可用。
- 这有助于故障排查或临时限制 AI 的能力。
9. - 自定义 Agent 角色(自定义角色)
Creating 自定义 - 自定义 Agent 角色
Agents 是具有特定行为和专长的自定义 AI 角色。要创建一个:
- 从侧边栏导航到 - 自定义 Agent 角色 界面。
- 点击 + 新建 Agent 在右上角点击 + 新建 Agent。
- 为 Agent 输入名称(例如 "Code Reviewer"、"Technical Writer")。
- 编写定义 Agent 个性、专长和行为规则的系统提示词。
- 自定义外观(表情头像和强调色)。
- 点击 完成创建。 保存 Agent。
表情与颜色自定义
让你的 Agents 在视觉上与众不同:
- 点击表情选择器,选择代表 Agent 角色的头像表情。
- 从调色板中选择强调色。此颜色用于 Agent 的对话气泡、Crew 成员指示和 Conductor worker 环。
- 表情和颜色会出现在整个应用中所有引用该 Agent 的地方。
系统提示词
系统提示词是 Agent 身份的核心。编写它来定义:
- 角色 - Agent 是什么(例如 "你是一名专攻分布式系统的高级后端工程师")。
- 行为 - Agent 应该如何回应(例如 "始终为代码更改建议测试")。
- 约束 - Agent 应该避免什么(例如 "绝不修改生产配置文件")。
- 语气 - 沟通风格(例如 "简洁直接。使用要点列表。")。
Using - 自定义 Agent 角色 in - 多 Agent 团队管理
创建后,Agents 可以分配给 Crews:
- 向 Crew 添加成员时,你的自定义 Agents 会出现在 Agent 选择下拉框中。
- 每个 Agent 都会将其系统提示词和个性带入 Crew 上下文。
- 你可以按 Crew 覆盖特定指令,而无需更改 Agent 的基础配置。
10. 文件与终端
文件浏览器导航
The - 文件浏览器和编辑器 screen provides a full file browser for navigating your project:
- 左侧面板显示文件树。点击文件夹展开/折叠。
- 点击文件在右侧编辑器面板中打开。
- 右键点击文件或文件夹弹出上下文菜单,选项包括:重命名、删除、复制路径、新建文件、新建文件夹。
- 使用顶部的面包屑路径向上导航目录树。
编辑ing - 文件浏览器和编辑器 (Monaco 编辑or)
- 文件浏览器和编辑器 open in an integrated Monaco editor (the same editor that powers VS Code):
- 所有主要语言都支持完整的语法高亮。
- 语言服务器可用时提供 IntelliSense 风格自动补全。
- 查找和替换使用 Ctrl+F and Ctrl+H.
- 保存文件s with Crew 工作时,你可以监控进度:. Unsaved changes are indicated by a dot on the file 拖动节点之间的连线以定义任务流(谁把工作传给谁)。
- 多个文件可以同时在标签页中打开。
- 集成终端 Usage
集成终端让你可以直接在 Hermes Studio 中使用 Shell:
- 从侧边栏导航到 - 集成终端 从侧边栏进入终端界面,或按 Ctrl+` 将其作为底部面板切换。
- 终端在你的项目工作目录中打开。
- 像在普通终端中一样运行任何 Shell 命令。
- 支持多个终端标签页 - 点击 + to create a new 拖动节点之间的连线以定义任务流(谁把工作传给谁)。
11. 分析与审计
Event - 用量分析和审计日志 Dashboard
The - 用量分析和审计日志 screen provides insights into your AI usage patterns:
- 查看随时间变化的图表,显示消息发送量、Token 用量和费用。
- 使用顶部栏的日期选择器按日期范围过滤。
- 按 Agent、模型或会话细分用量。
- 将数据导出为 CSV 以进一步分析。
Session 历史
查看所有过去的对话会话:
- 每个会话显示其开始时间、消息数和 Token 用量。
- 点击会话查看完整对话记录。
- 使用搜索按内容或日期查找会话。
审计日志
审计日志记录 AI 采取的每一个重要操作:
- 文件修改、命令执行和 API 调用都会被记录。
- 每个条目包含时间戳、操作类型、详情以及执行它的 Agent。
- 按操作类型或严重级别过滤。
- 这在受监督环境中对问责至关重要。
日志查看器
访问原始系统日志以进行调试和监控:
- 点击 the 日志 tab within - 用量分析和审计日志.
- 日志实时流式传输,严重级别颜色编码(info、warning、error)。
- 使用过滤栏搜索特定日志条目。
- 点击 暂停 冻结日志流以便阅读。
12. 设置与配置
Connection - 应用配置
配置 Hermes Studio 如何连接到你的 Gateway:
- Gateway URL - 你的 Hermes Gateway 服务器的 HTTP 地址。
- API Key - 安全 Gateway 的认证密钥。
- 重连间隔 - 连接断开时的重试频率(默认:5 秒)。
- WebSocket - 启用/禁用 WebSocket 以进行实时流式传输(推荐:启用)。
外观(主题、强调色)
自定义 Hermes Studio 的视觉外观:
- 主题 - 从可用的深色主题中选择。应用仅设计为深色模式,以便长时间使用时获得最佳可读性。
- 强调色 - 选择主强调色,用于高亮整个界面中的交互元素、按钮和激活状态。
- 字号 - 调整基础字号以提高可读性。
- 更改立即生效,无需重启。
集成(Telegram、Discord、Slack 等)
连接外部服务以进行通知和投递:
- 进入设置并打开 集成 拖动节点之间的连线以定义任务流(谁把工作传给谁)。
- 点击 添加集成 选择服务。
- 按照服务专属的设置步骤(例如为 Telegram 粘贴机器人 Token,为 Discord 提供 webhook URL)。
- 使用 发送测试 按钮。
- 配置完成后,这些集成可作为 Jobs 和通知中的投递渠道使用。
MCP Servers
Manage 模型 Context Protocol (MCP) server connections:
- MCP 服务器为 AI 提供额外的工具和能力。
- 点击 添加 MCP Server 按 URL 注册新服务器。
- 每个服务器显示其可用工具和连接状态。
- 切换服务器开/关以控制哪些工具可用。
权限与安全
控制 AI 被允许做什么:
- 自动批准的路径 - AI 无需询问权限即可读写的文件路径。
- 阻止的命令 - AI 绝不允许运行的 Shell 命令。
- 始终允许规则 - 查看并撤销之前从对话授予的始终允许权限。
- 监督模式默认值 - 设置新任务是否默认以监督模式启动。
Identity - 文件浏览器和编辑器 (SOUL.md, persona.md)
身份文件塑造 AI 在所有交互中的核心个性:
- SOUL.md - 定义 AI 的基本价值观、沟通风格和行为准则。这是个性最深的一层。
- persona.md - 更表层的个性文件,定义语气、偏好和交互模式。
- 编辑 these files in the Identity section of - 应用配置 or directly via the - 文件浏览器和编辑器 screen.
- 更改在新对话中生效;现有会话保留其原始上下文。
系统d 自动启动
配置 Hermes Gateway 随系统自动启动:
- 在设置中找到 系统 部分。
- 点击 安装 Systemd 服务。
- 应用生成 systemd unit 文件并为你安装。
- 如果列表变长,使用 启用 开关控制是否开机启动。
- The 状态 指示灯显示服务当前是否活跃。
13. 键盘快捷键
Hermes Studio 支持键盘快捷键以快速导航和执行常用操作。以下是完整参考:
全局导航
| 快捷键 | 动作 |
|---|---|
| Ctrl + 1 | 前往对话 |
| Ctrl + 2 | 前往 Crews |
| Ctrl + 3 | 前往 Conductor |
| Ctrl + 4 | 前往任务看板 |
| Ctrl + 5 | 前往任务 |
| Ctrl + 6 | 前往记忆 |
| Ctrl + 7 | 前往文件 |
| Ctrl + , | 打开设置 |
| Ctrl + K | 打开命令面板 |
| Ctrl + B | 切换侧边栏 |
对话
| 快捷键 | 动作 |
|---|---|
| Enter | 发送消息 |
| Shift + Enter | 消息中换行 |
| Ctrl + N | 新会话 |
| Esc | 停止流式响应 |
| Ctrl + L | 清空对话显示 |
编辑or
| 快捷键 | 动作 |
|---|---|
| Ctrl + S | 保存文件 |
| Ctrl + F | 文件中查找 |
| Ctrl + H | 查找和替换 |
| Ctrl + Z | 撤销 |
| Ctrl + Shift + Z | 重做 |
| Ctrl + W | 关闭当前标签页 |
- 任务编排与监控
| 快捷键 | 动作 |
|---|---|
| Ctrl + Enter | 启动任务 |
| 空格 | 暂停 / 恢复任务 |
| Ctrl + . | 中止任务 |
| 1 / 2 / 3 | 切换 Office View 布局(网格 / 行 / 聚焦) |
- 集成终端
| 快捷键 | 动作 |
|---|---|
| Ctrl + ` | 切换终端面板 |
| Ctrl + Shift + T | 新建终端标签页 |
| Ctrl + C | 中断正在运行的命令 |
14. 故障排查
Connection Issues
如果连接指示灯显示红色或你看到 "未连接" 消息:
- 确认设置中的 Gateway URL 正确(检查拼写错误、端口号是否正确)。
- 确保 Hermes Gateway 服务器正在运行。如果你将其安装为 systemd 服务,请检查:
systemctl --user status hermes-gateway. - 检查没有防火墙阻止连接端口。
- 如果使用远程服务器,确保你的网络可以访问它(尝试 ping 主机)。
- 点击设置中的 测试连接 点击设置中的测试连接按钮 - 它会提供具体的错误消息。
Gateway 无响应
如果 Gateway 可达但对请求无响应:
- 检查 Gateway 自己的日志以查找错误(通常在其运行的终端中,或通过
journalctl --user -u hermes-gateway). - 确认你的 API Key 正确且未过期。
- 重启 Gateway 服务并重试。
- 确保 Gateway 中配置的 AI 服务商(Anthropic 等)API Key 有效。
功能显示为不可用
如果某些功能显示灰色或显示 "不可用":
- 某些功能需要特定的 Gateway 能力。请将 Hermes Gateway 更新到最新版本。
- 确认所需技能已在技能界面安装并启用。
- 确认你的 Gateway 配置包含必要模块(例如用于任务的 conductor 模块)。
- 确保你的连接具有适当的权限。某些 Gateway 会按 API Key 范围限制功能。
Rate Limits
如果你遇到限流错误:
- 限流来自底层 AI 服务商(例如 Anthropic 的 API 限制)。
- 减少 Conductor 任务中的并行 workers 数量。
- 避免连续快速发送对话消息。
- 考虑为不太关键的任务使用较低档模型,为重要工作保留配额。
- 查看你的 AI 服务商控制台,了解当前用量和限制。
- 如果经常达到限制,请联系你的 AI 服务商升级套餐。