Hermes Studio 客户端完整操作手册

1. 文档适用范围与读者对象

本文档适用于需要使用、配置、运维或验收 Hermes Studio 客户端的个人用户、管理员、技术支持人员和内部培训对象。文档以当前电脑上实际运行的 Hermes Studio 客户端为准，官网和说明文档仅用于建立功能范围和差异核对。

2. 资料核对与版本差异

2.1 核对来源

• Hermes Studio 官方网站：https://hermes-studio.ai/，定位为 Hermes 智能体的自托管智能会话控制台。
• Hermes 网页界面说明文档：github.com/EKKOLearnAI/hermes-web-ui/README.md，列出会话、历史、频道、任务、技能、记忆、用量、终端、用户档案、设置等功能。
• Hermes 智能体官方文档：https://hermes-agent.nousresearch.com/docs/，用于核对智能体、网关、技能、记忆、MCP、消息网关和安全能力范围。
• MCP 官方功能页：Hermes 智能体 MCP 文档，用于核对 MCP 服务管理范围。
• 本机 Hermes Studio 0.6.12 设备接口：用于核对设备发现、扫描、配对状态、活跃连接、远程终端、远程命令和文件传输能力。

2.2 版本差异说明

3. 快速上手流程

1. 启动 Hermes Studio.app，等待客户端打开本地网页界面。
2. 在浏览器或客户端窗口访问 http://127.0.0.1:8748；如出现登录页，输入已配置的用户名和密码。
3. 进入左侧 对话 页面，确认顶部显示当前模型和用户档案。
4. 在输入框输入测试提示词，点击发送，观察流式输出、工具调用和最终结果。
5. 通过左侧导航检查 历史、任务、看板、频道、技能、MCP、设备、记忆、模型、日志、用量、性能监控、用户、设置 等页面。
6. 配置密钥、模型服务商、MCP、频道令牌前，先确认用户档案和权限范围，避免把测试配置写入生产用户档案。

4. 界面总览

主界面采用左侧导航、顶部状态区、中央工作区和底部输入/状态区的布局。当前登录用户显示为超级管理员角色，当前模型入口位于聊天页顶部与输入区附近。左侧导航是功能盘点的主要依据。

4.1 导航与状态区域

4.2 全局搜索与命令入口

1. 点击左侧“搜索”入口或使用页面中搜索按钮。
2. 在弹窗输入关键词。
3. 从结果中进入对应会话、任务、记忆或配置项。
4. 关闭弹窗后回到原页面。

5. 会话与流式输出

5.1 新建聊天并发送消息

1. 进入 对话 页面。
2. 确认顶部或底部显示的模型名称，必要时点击模型选择器切换。
3. 在底部输入框输入提示词。
4. 点击发送按钮，等待流式输出。
5. 输出完成后检查回复内容、工具调用展开项、错误提示和会话记录。

5.2 工具调用、停止、重试、复制

1. 在对话输出中查看工具调用块；展开后可检查参数、运行状态和返回结果。
2. 长时间任务可使用停止按钮中止当前输出。
3. 失败后使用重试或重新发送，必要时切换模型或降低任务复杂度。
4. 使用复制按钮复制最终回答；复制前检查是否包含敏感信息。

5.3 会话保存、恢复、切换、删除

1. 发送消息后，当前会话会出现在历史列表。
2. 进入 历史 页面可恢复完整线程。
3. 如页面提供删除入口，点击前确认该会话不再需要。
4. 删除后回到历史页确认记录已移除。

5.4 附件与文件引用

当前对话页可见文件/工作区抽屉入口，支持浏览或引用工作区文件。未观察到在聊天输入区直接上传附件后的完整演示流程；需要文件操作时优先使用 工作区 抽屉。

6. 会话历史

1. 点击左侧 历史。
2. 使用顶部搜索框或过滤器查找目标会话。
3. 点击会话条目打开完整消息线程。
4. 如页面提供排序或来源分组，按最新消息、平台来源或活跃状态定位。
5. 如需要删除或归档，先确认该会话不含需保留的业务记录。

7. 记忆管理

1. 进入 记忆 页面。
2. 使用搜索框按关键词查找记忆。
3. 查看条目内容、时间、来源和标签信息。
4. 如页面提供新增、编辑或删除入口，使用前确认当前用户档案。
5. 完成变更后刷新或重新搜索，验证条目已按预期变化。

8. 技能与插件管理

8.1 技能列表

1. 点击 技能。
2. 使用搜索框按名称或能力查找技能。
3. 点击技能卡片或详情按钮查看说明、来源、权限和版本信息。
4. 如提供安装、启用、停用或卸载按钮，先确认技能来源可信。
5. 安装失败时查看错误提示，并到 日志 页面检索依赖或权限错误。

8.2 插件清单

1. 进入 插件 页面。
2. 查看插件名称、来源、状态和描述。
3. 使用搜索或筛选定位目标插件。
4. 如需要删除或禁用插件，先确认其是否被当前任务、MCP 或技能依赖。

9. 终端、文件与工作区

9.1 文件工作区

1. 进入 对话 页面。
2. 点击工作区或文件图标打开抽屉。
3. 在文件树中选择目录或文件。
4. 根据页面按钮执行打开、下载、上传、创建目录等操作。
5. 完成后检查文件列表刷新，确认文件存在且路径正确。

9.2 网页终端

1. 点击终端图标打开网页终端。
2. 确认当前工作目录和用户档案。
3. 输入只读命令进行诊断，例如查看版本或列出当前目录。
4. 观察输出区域和错误提示。
5. 结束后关闭终端抽屉，避免误输入命令。

10. 执行审批

当前遍历过程中未触发独立的审批弹窗，也未发现名为执行审批的独立页面。Hermes 智能体文档中存在命令审批和授权相关能力，因此本节记录应对流程和验收口径。

11. 定时任务管理

11.1 查看任务列表

1. 点击左侧 任务。
2. 查看任务名称、状态、计划、最近运行时间和输出摘要。
3. 使用刷新或自动刷新状态确认任务是否正在运行。
4. 点击任务条目查看详情或运行日志。

11.2 新建定时任务

1. 点击 新建任务 或同义按钮。
2. 填写任务名称，例如演示任务。
3. 填写自然语言提示词，说明任务目标、输出格式和投递要求。
4. 选择预设计划，或输入自定义定时表达式。
5. 选择投递渠道，例如 Telegram、Discord、Slack 或当前页面可见渠道。
6. 选择技能、重复次数、是否启用等选项。
7. 保存后返回任务列表，检查状态和下次运行时间。

11.3 手动立即触发与运行日志

1. 在任务列表选择目标任务。
2. 点击 立即触发 或当前界面同义按钮。
3. 查看实时运行日志、最近输出和状态变化。
4. 如任务失败，复制错误摘要，在日志页面按任务名称或时间检索。

12. 多智能体群聊（测试版）

12.1 查看群聊房间

1. 点击 群聊（测试版）。
2. 查看房间列表、成员数量、最近活动和状态。
3. 点击房间进入聊天流。
4. 使用 @成员名将任务派发给指定成员，或发送普通消息给全部成员。

12.2 创建群聊房间

1. 点击 新建房间。
2. 填写名称，例如演示群组。
3. 填写目标或描述，说明团队任务边界。
4. 选择内置人格智能体或添加自定义成员。
5. 保存后进入房间，检查成员列表和实时消息流。

13. 智能体库

当前客户端未发现名为 智能体库 的独立一级导航。可替代的可见能力包括：群聊（测试版） 中选择成员或人格智能体，用户档案页面中创建/克隆用户档案，会话页面中选择模型或用户档案。

14. 可视化工作流与调度器

当前遍历未发现 可视化工作流构建器、调度器、任务编排 的独立页面或左侧导航。未观察到节点画布、依赖连线、圆桌/战情室布局、研究/构建/评审/部署模板、并行数配置、任务成本历史等独立界面。

15. 运行监控面板

1. 点击 性能监控。
2. 查看 CPU、内存、磁盘、运行时间和网关状态。
3. 如出现异常，切换到日志页面按时间检索错误。
4. 如怀疑成本或模型调用异常，进入用量页面查看令牌与成本趋势。

16. 任务与看板

16.1 查看与移动任务

1. 进入 看板 页面。
2. 查看不同状态列中的任务卡片。
3. 按优先级、标签、负责人或来源链接识别任务。
4. 拖拽任务卡片到目标列，改变状态。
5. 打开任务详情，检查评论、描述、阻塞状态或完成状态。

16.2 新建任务卡片

1. 点击 新建任务。
2. 填写标题，例如“演示任务”。
3. 填写描述、优先级、标签、来源链接和负责人。
4. 选择初始状态列。
5. 保存后返回看板，确认卡片出现在指定列。

17. 成本与用量分析

1. 进入 用量 页面。
2. 查看总令牌、输入/输出拆分、成本估算和图表。
3. 切换时间范围，观察近期趋势。
4. 按模型、会话或用户档案维度定位异常成本。
5. 进入 技能用量 查看技能调用频率和工具使用分布。

18. 日志查看

1. 点击 日志。
2. 选择“全部”或“错误”筛选。
3. 在搜索框输入关键词，例如模型服务商、网关、MCP、定时任务。
4. 开启或关闭自动滚动，便于观察实时错误。
5. 将错误时间与会话、任务、用量页面中的异常事件对应起来。

19. MCP 服务管理

19.1 查看 MCP 服务器列表

1. 点击 MCP。
2. 查看服务器名称、类型、命令、URL、启用状态和连接状态。
3. 按需重载或刷新服务器状态。
4. 进入日志页面确认启动失败、环境变量缺失或连接超时等错误。

19.2 新增 MCP 服务

1. 点击新增 MCP 服务。
2. 填写服务器名称。
3. 选择标准输入输出或 HTTP 类型。
4. 标准输入输出类型填写命令、参数、环境变量；HTTP 类型填写 URL 和认证信息。
5. 保存后触发重载。
6. 返回列表检查连接状态，并在会话中验证 MCP 工具是否可被调用。

20. 平台集成

1. 进入 频道 页面。
2. 选择目标平台卡片。
3. 填写令牌、机器人编号、网络回调、密钥或页面要求的凭据。
4. 启用平台，并使用测试连接按钮验证。
5. 查看网关状态和日志页面，确认平台已连接。
6. 为定时任务或会话选择投递渠道时，确认渠道处于已配置状态。

21. 设备管理

1. 进入 设备 页面。
2. 查看设备列表中的电脑名称、端点类型、访问地址、系统、Hermes Agent 版本、网页界面版本、延迟和最后发现时间。
3. 点击刷新或扫描，更新局域网设备发现缓存。
4. 检查入站和出站配对状态；未配对设备需要先发起配对请求，已配对设备才能连接。
5. 连接前确认目标设备名称和地址，避免把远程终端、文件传输或命令执行发到错误设备。
6. 不再使用时断开活跃连接，并回到设备列表确认状态变化。

22. 设置

22.1 账户管理

1. 进入 设置。
2. 选择账户相关页签。
3. 查看当前用户名、角色、会话状态和账户列表。
4. 需要修改用户名或密码时，打开账户编辑弹窗。
5. 保存前确认新凭据已记录在安全位置。

22.2 模型服务商设置

1. 进入 模型 页面。
2. 查看当前模型服务商列表、默认模型和可用模型。
3. 点击添加模型服务商。
4. 选择预设模型服务商或填写自定义兼容 OpenAI 的端点。
5. 输入凭据并保存；保存后测试模型列表是否能拉取。
6. 回到会话页面，在模型选择器中验证新模型可见。

22.3 显示、代理、记忆、会话、隐私、语音

23. 备份、恢复与导入

1. 点击左侧 用户。
2. 查看用户档案列表、当前激活用户档案和权限状态。
3. 点击创建用户档案，填写名称和描述。
4. 如需备份，使用导出入口生成用户档案归档。
5. 如需恢复，使用导入入口选择归档文件。
6. 恢复后切换到目标用户档案，检查模型、任务、记忆、技能和会话是否可用。

24. 安装为应用与桌面体验

当前电脑已安装 macOS 桌面客户端，未在当前客户端设置页中观察到独立的安装为应用入口。浏览器版可以使用 Chrome 或 Edge 的“安装此站点为应用”能力，但此能力来自浏览器，不是当前 Hermes Studio 页面内独立功能。

1. 使用 Chrome 或 Edge 打开 http://127.0.0.1:8748。
2. 点击浏览器地址栏右侧安装图标，或进入浏览器菜单选择安装应用。
3. 安装后从系统应用列表启动。
4. 重启后验证本机 Hermes Studio 服务是否已启动；若服务未运行，安装后的应用窗口会显示无法连接。

25. 安全与权限章节

26. 常见问题与故障排除

27. 卸载与数据清理

27.1 停止服务

1. 先退出 Hermes Studio 客户端。
2. 确认没有正在运行的会话、任务、网关投递和外部渠道任务。
3. 如必须停止网关，先记录当前用户档案和运行状态。
4. 停止后通过浏览器访问 8748 验证页面已不可达。

27.2 清理 Studio 数据

1. 先导出用户档案或备份整个网页界面状态目录。
2. 清理浏览器本地存储前确认不会丢失登录状态或前端偏好。
3. 清理 ~/.hermes-web-ui 前确认不再需要网页界面登录、数据库、日志、上传文件和用户档案状态。
4. ~/.hermes/ 属于 Hermes 智能体数据目录，包含智能体配置、技能、记忆和运行数据；除非同时卸载智能体，否则不要误删。

27.3 Docker / systemd / 本地依赖

当前安装方式为 macOS 桌面客户端，未观察到本机 Docker 或 systemd 安装入口。若使用 Docker 部署，应按编排文件停止容器并备份数据卷；若使用 Linux systemd，应先禁用服务，再停止并清理服务文件。

28. 版本预览与编程智能体

29. 附录

29.1 快捷键

29.2 术语表