Hermes Agent 中文教程课程蓝图
课程定位
这套教程面向没有 Agent 使用经验的读者。读者完成核心课程后，应能在自己的电脑上通过 Desktop 或 CLI 运行 Hermes，完成并验证一个真实任务，保留稳定偏好，并在失败时停止、检查和恢复。场景课程继续覆盖消息平台、定时任务和多媒体输入；高级选修覆盖多代理与扩展开发。
官方文档承担参数与功能事实。本教程承担学习路径、场景选择、动手练习和失败恢复。
四层内容结构
课程不要求读者按编号读完 18 篇。
| 层级 | 范围 | 用法 |
|---|---|---|
| 核心主线 | 01—10 | 从产品认知走到安全、可恢复的日常使用，建议按顺序学习 |
| 场景课程 | 11—13 | 按消息平台、自动化和多媒体目标选择 |
| 高级选修 | 14—16 | 按多代理、身份隔离和扩展目标选择 |
| 综合实战 | 17—18 | 用一个受控任务和一个常驻工作流检验所学能力 |
| 参考中心 | CLI、配置、消息平台、provider、术语和 FAQ | 遇到问题时查询，不计入课程进度 |
五个阶段，18 篇
第一阶段：第一次成功与安全边界
| 篇 | 主题 | 学习成果 |
|---|---|---|
| 01 | Hermes Agent 是什么 | 能区分聊天机器人、代码助手、脚本和 Agent，知道 Hermes 的适用边界 |
| 02 | 安装、界面、模型与第一次启动 | 按自己的系统选择 Desktop 或 CLI，完成安装和 provider 设置，通过 hermes doctor 检查环境并完成第一次对话；知道凭据不能发进聊天或提交到仓库 |
| 03 | 第一个真实任务 | 在独立练习目录中让 Hermes 读取文件、生成结果并检查内容 |
| 04 | Hermes 怎样工作 | 看懂模型、工具、Agent 循环和权限确认之间的关系 |
| 05 | 权限、安全与凭据 | 判断文件、命令、网络、删除、发布和凭据操作是否可以批准，并知道怎样撤销凭据和停止任务 |
阶段成果：Hermes 能完成一个文件任务，读者能展示并验证结果，也能说明哪些动作需要停止确认。
第二阶段：形成可恢复的日常使用方法
| 篇 | 主题 | 学习成果 |
|---|---|---|
| 06 | 怎样描述一个可执行任务 | 用背景、目标、输入、限制、交付物和验收标准组成任务说明 |
| 07 | 会话、上下文与继续工作 | 创建、命名、继续、查找和压缩会话，知道何时开始新会话 |
| 08 | 工具与 toolsets | 理解文件、终端、网页、浏览器和图像工具的边界，并按任务启用最小工具范围 |
| 09 | Memory 与 Skills | 判断什么应被记住，什么应写成可复用流程，什么只应留在当前会话 |
| 10 | 排错、更新、停止与恢复 | 使用 status、doctor、配置检查和日志定位故障；停止失控任务，更新 Hermes，并恢复一个失败工作流 |
核心主线成果：读者不依赖消息平台，也能在本机稳定使用 Hermes，并在失败时知道先查什么、怎样停止和怎样恢复。
第三阶段：接入消息平台与自动化
| 篇 | 主题 | 学习成果 |
|---|---|---|
| 11 | 接入消息平台 | 运行 hermes gateway setup，以飞书为主案例完成第一个移动端任务；钉钉、企业微信和微信的差异与配置入口进入参考中心 |
| 12 | 定时任务 Cron | 创建、检查、暂停和删除一个有输出的计划任务，明确运行成本、交付位置和停止方式 |
| 13 | 语音、图片与文件 | 从消息平台发送语音、截图和文档，理解输入、工具处理与结果交付的路径 |
阶段成果：Hermes 可以脱离终端接收任务；完成自动化课程后，还能在指定时间交付结果并被随时暂停。
第四阶段：扩展与协作
| 篇 | 主题 | 学习成果 |
|---|---|---|
| 14 | Delegation 多代理 | 把独立研究任务交给子代理，控制上下文、并发和验收 |
| 15 | Profiles 多身份 | 为工作、个人或不同机器人建立隔离配置，理解会话、记忆和凭据的边界 |
| 16 | MCP、Plugins 与功能选择 | 为一个需求选择内置工具、skill、MCP、plugin 或自定义工具；开发实作进入开发者参考区 |
阶段成果：读者能扩展能力，也能说明每种扩展的权限、数据和维护边界。
第五阶段：综合实战
| 篇 | 主题 | 学习成果 |
|---|---|---|
| 17 | 综合练习：可验证的资料整理 | 在独立目录中完成资料读取、带来源整理、文件交付、结果验收和失败重试，不依赖常驻服务 |
| 18 | 综合实战：每日研究助手 | 从信息源、任务提示、状态、定时运行到消息平台交付完成闭环，并设置成本边界、暂停方式和凭据撤销路径 |
阶段成果：读者拥有一个能运行、能停止、能排错、能控制成本的常驻工作流。
三条学习路线
消息平台范围
首版只覆盖消息平台：
- 飞书作为完整主案例；
- 钉钉、企业微信和微信提供平台差异、官方配置入口和必要的排错说明；
- 正文不加入国外消息平台，避免分散目标读者的注意力；
- 平台清单和配置步骤以 Hermes 官方文档当前支持情况为准，发布前必须重新验证。
参考中心
下列内容不进入 18 篇编号课程：
- Desktop、CLI 与操作系统安装矩阵；
- CLI 与斜杠命令；
- provider、模型与凭据方式选择；
config.yaml配置字段；- toolsets 与消息平台配置清单；
- 环境变量；
- 更新、备份、成本控制、FAQ、术语表和版本验证记录。
正文只保留当课需要的参数，并链接 Hermes 官方文档。这样能控制学习负担，也能降低版本变化带来的维护成本。
为什么不做 50 篇
新手教程的任务是建立一条成功路径，不是覆盖每个命令。18 篇容纳 Hermes 的产品差异，核心主线又控制在 10 篇。读者在第三篇完成任务，在第五篇建立安全判断，并在第十篇学会恢复，不需要学完扩展功能才能稳定使用。
每个阶段的验收标准
- 第一阶段：读者能展示一个由 Hermes 写出的文件，说明验证方法，并判断权限请求。
- 第二阶段：读者能解释 memory 与 skill 的差异，继续一个旧会话，并恢复一次人为设置的失败。
- 第三阶段：读者能从一个消息平台发任务并收到回复；完成自动化课程后还能收到 Cron 交付结果。
- 第四阶段：读者能为一个需求选择 delegation、profile、MCP、plugin 或自定义工具，并说明边界。
- 第五阶段：读者能停止任务、找到日志、控制成本、移除凭据并恢复一个失败工作流。
内容生产顺序
- 完成 01—05，分别邀请 Desktop 与 CLI 新人试读。
- 根据卡点修改术语、安装、首个任务和权限说明。
- 完成 06—10，验证本机核心路径和失败恢复路径。
- 完成 11—13，以飞书验证完整主案例，再核对钉钉、企业微信和微信的参考入口。
- 完成 14—18，加入扩展、受控练习和常驻综合实战。
- 建立参考中心和版本验证记录。
- Hermes 发布新版本时执行命令检查，不按页面数量追求更新。