Hermes Agent 中文入门教程课程蓝图
课程定位
这套教程面向没有 Hermes、AI Agent 或软件开发经验的学习者。学习者只需要会安装普通应用、管理文件和复制命令，不需要先学 Python、Git、API 或模型原理。
完成共同基础后，学习者应能在 Desktop 或 CLI 中运行 Hermes，完成并验证一个受控任务，管理会话与长期信息，并在失败时停止、检查和恢复。之后可以按需要继续学习消息平台、Cron、多媒体、Delegation、Profiles 和能力选择。
官方文档承担参数与功能事实；本教程承担学习顺序、真实场景、动手练习、权限判断和失败恢复。
能力边界
本课程的终点是“独立、安全、可验证地使用 Hermes”，不是源码或协议开发。课程不增加：
- Hermes 核心源码分析；
- 自定义 Tool、Plugin 开发；
- MCP Server、ACP Adapter 或 A2A 开发；
- API Server、TUI JSON-RPC 或 Gateway 内部实现；
- 生产级部署、并发与可观测性工程。
第 16 课只帮助学习者选择现有扩展方式，不安装第三方代码，也不要求编程。
三条学习路线
| 路线 | 必修范围 | 最终成果 | 完成后的边界 |
|---|---|---|---|
| 基础使用 | 01—10 | 一个受控文件任务和一份故障恢复记录 | 能在本机稳定使用，不依赖消息平台 |
| 个人自动化 | 01—12、17—18 | 一个可暂停的每日研究助手 | 能配置个人自动化，高风险外部动作仍需人工确认 |
| 多入口与协作 | 01—11、14—17 | 一个从消息端接收并协作整理资料的工作流 | 能组合现有能力，不涉及底层扩展开发 |
课程不要求机械读完 18 课。第一次学习建议按顺序完成 01—10，再按目标继续。
五个阶段，18 课
第一阶段：第一次成功与安全边界
| 课 | 现有主题 | 学习成果 | 留下的证据 |
|---|---|---|---|
| 01 | Hermes 是什么 | 区分回答、固定脚本和 Agent 行动 | 三个任务的适配判断 |
| 02 | 安装与第一次对话 | 选择 Desktop 或 CLI，完成模型回复和环境检查 | 版本、入口和 doctor 摘要 |
| 03 | 第一个真实任务 | 在隔离目录生成并验收 summary.md | 文件、结构、事实与边界检查 |
| 04 | Hermes 怎样完成任务 | 用第 03 课轨迹区分模型、工具、循环和人工验收 | 一张执行步骤标注 |
| 05 | 权限、凭据与审批 | 判断读取、写入、删除、发布与凭据风险 | 个人安全清单 |
阶段验收：现场完成一次受控文件任务，并指出输入、输出、工具动作、权限边界和验收方法。
第二阶段：形成可恢复的日常方法
| 课 | 现有主题 | 学习成果 | 留下的证据 |
|---|---|---|---|
| 06 | 可执行任务说明 | 将第 03 课的任务整理成完整任务说明 | task-brief.md |
| 07 | 会话与上下文 | 继续、压缩或交接同一练习任务 | 会话交接记录 |
| 08 | Tools 与 Toolsets | 根据任务选择最小工具范围 | tool-plan.md |
| 09 | Memory 与 Skills | 分类长期事实、复用流程和临时背景 | 信息分类表 |
| 10 | 排错、更新与恢复 | 按统一顺序恢复一次受控失败 | 故障恢复记录 |
阶段验收：能继续旧任务、写清新任务、选择最小工具，并恢复一次人为设置的失败。
第三阶段：消息接入与自动化
| 课 | 现有主题 | 学习成果 | 留下的证据 |
|---|---|---|---|
| 11 | 接入飞书 | 从已授权用户发起一个受控任务 | 成功消息与拒绝越权的记录 |
| 12 | Cron | 创建、检查、暂停、恢复和删除定时任务 | Job 状态与本地输出 |
| 13 | 语音、图片与文件 | 分别验证三类输入，再组合整理 | 带来源和不确定项的摘要 |
阶段验收：能从消息平台发起任务，并完整管理一个可停止的 Cron。
第四阶段：协作与能力选择
| 课 | 现有主题 | 学习成果 | 留下的证据 |
|---|---|---|---|
| 14 | Delegation | 拆分不重叠子任务，由父 Agent 验收 | 分派说明与来源核对 |
| 15 | Profiles | 区分个人与工作身份的状态边界 | Profile 边界表 |
| 16 | Tool、Skill、MCP、Plugin 选择 | 为一个需求选择现有能力及退出路径 | extension-decision.md |
阶段验收：能为需求选择现有能力，并说明数据、权限、维护和退出边界。
第五阶段：综合实践
| 课 | 现有主题 | 学习成果 | 留下的证据 |
|---|---|---|---|
| 17 | 可验证资料整理 | 生成带来源、冲突和信息缺口的资料报告 | 自动检查与人工事实核对 |
| 18 | 每日研究助手 | 组合已学内容形成可暂停工作流 | 运行、暂停、恢复和清理记录 |
结课验收：展示一次正常运行、一次暂停、一次故障排查、一次恢复，以及凭据和自动化清理方法。
贯穿练习：个人资料整理与研究助手
现有课程不增加新开发项目，而是让已有练习形成连续关系：
| 课程 | 对同一练习的推进 |
|---|---|
| 03 | 建立 hermes-first-task 并生成第一份摘要 |
| 04 | 标注其中的模型判断、工具动作和人工验收 |
| 05 | 写下读取、写入和外部动作边界 |
| 06 | 把原任务整理为 task-brief.md |
| 07 | 退出、恢复和交接该任务 |
| 08 | 为它选择最小工具范围 |
| 09 | 分类其中的 Session、Context、Memory 和 Skill 信息 |
| 10 | 恢复一次受控错误 |
| 11—16 | 按所选路线增加消息入口、定时运行、输入方式或协作方式 |
| 17—18 | 使用现有综合 fixtures 完成资料整理与每日研究助手 |
消息平台范围
- 飞书作为完整主案例；
- 钉钉、企业微信和微信只提供差异、官方入口和必要排错；
- 主页面不按地域给平台分类，也不扩张平台清单；
- 所有支持情况发布前按 Hermes 官方文档重新核验。
单课学习合同
每课统一包含：
- 课程位置和可见产物；
- 预计时间、前置课程、版本、平台与影响范围；
- 本课需要的 2—4 个概念；
- 原生 SVG 流程及文字解释；
- 分步实验：操作、位置、预期、原因和失败检查；
- 本课新增的权限边界；
- 常见错误与最短诊断顺序；
- 本课作品；
- 3 个概念/情境题、1 个操作题、1 个排错题；
- 可核验的完成清单；
- “以后只记住这三点”；
- 版本信息与一手来源。
版本与维护
每页显示教程版本、Hermes 适用版本、实测平台、核验日期和验证方式。命令变化时更新具体页面，不按篇数追求更新。
发布前至少完成：站点构建、链接检查、fixtures 验证、秘密扫描、SVG XML 检查，以及早中晚各一课的浏览器检查。真正的零基础试读应记录完成时间、第一次失败、求助点、权限误判和恢复结果。