AI 程式設計教程中文版
官方教程中文版入門

規劃 Hermes Agent 學習路徑

按經驗等級和使用場景選擇 Hermes Agent 文件閱讀順序,先跑通基礎閉環,再進入工具、記憶、訊息閘道器和自動化。

Hermes Agent 的官方文件樹很大:CLI、TUI、provider(推理服務商)、sessions(會話)、tools、memory、skills、context files(上下文檔案)、MCP(模型上下文協議)、Gateway、cron、delegation(子代理委派)、hooks(生命週期鉤子)、batch(批處理)、RL training(強化學習訓練)、plugins、developer guide(開發者指南)全都在裡面。學它不適合從第一篇一路掃到最後一篇——先完成基礎閉環,再按你接下來要做的事深入

官方資料:Learning Pathllms.txtGitHub README

先給結論:所有人先完成「安裝 → provider 配置 → 第一次對話 → session 恢復」;之後再按「本地 CLI / 訊息機器人 / 長期助手 / 自動化 / 開發擴充套件 / 研究訓練」六類目標選擇路徑。基礎不穩就開擴充套件,等於在裂縫上加壓。

共同起點

無論你後面想做什麼,都先完成這條鏈路:

Installation -> Quickstart -> first chat -> session resume
(安装 → 快速上手 → 第一次对话 → 会话恢复)

對應入口:

如果這條鏈路還不穩定,不要先看 Gateway、cron、MCP、skills 或開發者擴充套件。

按經驗等級走

官方學習路徑頁給了三檔時間估算(Beginner ~1 小時 / Intermediate ~2–3 小時 / Advanced ~4–6 小時)。本文的中文路徑比官方多一點:"為什麼這一步" 的說明。

新手:跑起來、能對話、能恢復、能看懂報錯(約 1 小時)

  1. 安裝 Hermes Agent —— 命令可用、PATH 生效。
  2. 快速上手 Hermes Agent —— provider 配置 + 第一次對話。
  3. 配置 Hermes Agent —— 看清 ~/.hermes/ 下各檔案的分工。
  4. 第一個穩定閉環 —— 把上面三步壓成可重複的最小流程。
  5. 工具系統與終端後端 —— 在開 toolset 之前先理解執行邊界。

進階:把 Hermes 從本地 CLI 擴充套件成長期助手或訊息入口(約 2–3 小時)

  1. Sessions 與恢復 —— session 複用是後續所有功能的載體。
  2. 訊息閘道器 —— 接平臺前先理解 allowlist 和 DM pairing。
  3. 工具系統 —— 遠端接入前控制工具許可權。
  4. 技能系統 —— 把可複用流程沉澱為 skill。
  5. 記憶系統 —— 長期事實記憶的寫入門檻。
  6. 自動化邊界 —— 後臺任務上線前的安全基線。

高階:擴充套件工具、開發外掛、接 MCP、做批處理或研究訓練(約 4–6 小時)

  1. 官方 Plugins / MCP / Hooks 文件
  2. 官方 Architecture / Agent Loop / Prompt Assembly 文件
  3. 官方 Adding Tools / Creating Skills 文件
  4. 官方 Batch Processing 文件
  5. 上游原始碼和測試:github.com/NousResearch/hermes-agent

高階路徑不適合跳過基礎閉環直接看原始碼。不瞭解 session、toolsets、memory 和 provider runtime(推理服務商執行時),原始碼閱讀會很散,看到的是一堆類名而不是動作鏈路。

按使用場景走

與官方 By Use Case 段對照——挑一條貼近你目標的路徑開幹。

本地 CLI 編碼助理

Installation -> Quickstart -> CLI Usage -> Code Execution -> Context Files -> Tips & Tricks
(安装 → 快速上手 → 配置 → 工具 → 上下文文件 → 安全)

Telegram / Discord / Slack 機器人

Installation -> Configuration -> Messaging Gateway -> Telegram/Discord 子页 -> Voice Mode -> Security
(安装 → 配置 → 消息网关 → 选定平台 → 语音模式 → 安全)

個人長期助手

Quickstart -> Memory -> Skills -> Sessions -> Gateway -> Cron
(快速上手 → 记忆 → 技能 → 会话 → 消息网关 → 定时)

團隊共享入口

Quickstart -> Messaging -> allowlist / DM pairing -> toolsets per platform -> logs
(快速上手 → 消息平台 → 允许名单与私聊配对 → 按平台设工具集 → 日志审计)

自動化任務

Quickstart -> Cron -> Delegation -> Hooks -> Delivery -> rollback plan
(快速上手 → 定时 → 子代理委派 → 钩子 → 投递 → 回滚预案)

自定義能力開發

Plugins -> Tools -> Skills -> MCP -> Architecture -> Tests
(插件 → 工具 → 技能 → MCP 集成 → 架构源码 → 测试)

功能地圖

這組中文教程不復刻官方完整目錄,而是把最關鍵的使用面重寫成中文學習路徑。遇到實現細節(命令引數、配置可選值、限額),以官方 docs、llms.txt 和 GitHub 原始碼為準——本站只是中文導航與判斷指引,不是命令字典。

每讀一頁都問三件事

讀 Hermes 文件容易"看完就忘",因為頁面間聯動密集、術語很多。每讀完一頁,強制自己回答下面三個問題:

  • 這頁解決的真實問題是什麼?(不是"它在講 cron",而是"它解決了我哪種實際場景下的什麼痛點")
  • 它依賴前面哪一層能力?(cron 依賴 session + 工具集 + 日誌,session 不穩就開 cron 等於在流沙上蓋樓)
  • 今天啟用它,最小驗收動作是什麼?(不是"配完就行",而是"配完後我跑哪條命令能確認它真的在工作")

能回答這三個問題,再進入下一頁。不能回答,說明你是在堆功能,不是在搭穩定工作流——回頭補這頁或回退一層再讀。

下一步

官方資料

本頁目錄