18 个
核心术语
覆盖安装、模型、Skills、Gateway、工作流和上线验收。
5 类
使用场景
按新手真实路径组织，不把概念堆成字典。
可验证
每个词都有验收点
看完不只知道含义，还知道下一步怎么检查。
Reading order
新手先按这条线理解
不需要一次记住所有词。先把模型入口、记忆、技能、消息入口和验收边界连起来，再回到具体教程。
读术语时先看边界
很多报错不是因为概念不懂，而是边界没分清。Provider 解决模型入口，Memory 保存稳定事实，Skills 保存方法，Gateway 连接消息平台，验收清单决定能不能长期运行。
All terms
全部名词解释
每个词都配了常见误区、验证点和下一步教程入口。遇到报错时，先回到对应术语确认你排查的是哪一层。
核心概念
核心概念术语
Agent Harness
把模型、记忆、工具、技能、消息入口和工作流组织在一起的运行框架。
AI Agent HarnessAgent 运行框架
理解 Agent Harness 的价值，是把 Hermes Agent 从一次性聊天工具看成一个可长期维护的工作系统。它关心的不只是模型回答，还包括输入来源、执行边界、日志、失败恢复和交接。
什么时候用：当你准备把日报、Issue 分类、内容选题、客户 FAQ 或研究监控变成固定流程时，先用 Harness 视角拆清 Provider、Memory、Skills、Gateway 和 Workflow。
常见误区和验收点⌄
误区：只把 Harness 理解成模型外壳，忽略权限、日志、人工确认和长期维护。
能说清楚当前工作流的输入、输出、模型、权限、失败处理和负责人。
Memory
保存稳定事实、偏好和项目约定的机制，不适合塞进所有临时资料。
记忆长期上下文
Memory 应该记录长期稳定的信息，例如项目偏好、输出风格、测试群、人工确认规则。流程步骤、输出模板和复用方法更适合放进 Skill 或工作流模板。
什么时候用：当同一项目反复需要同一偏好或规则时使用，例如“客户消息必须先生成草稿，不自动发送”。
常见误区和验收点⌄
误区：把敏感信息、一次性输入、长文资料或完整流程都写进 Memory。
新会话能遵守关键偏好，但不会暴露不该长期保存的信息。
Skills
把稳定流程、输入要求、输出格式和边界沉淀成可复用能力。
技能可复用能力
Skills 适合承载重复执行的方法，而不是保存事实。一个好 Skill 应该写清什么时候使用、需要什么输入、输出什么字段、哪些动作不能自动执行。
什么时候用：当一个工作流已经连续跑过数次、格式稳定、失败原因可记录时，再沉淀成 Skill。
常见误区和验收点⌄
误区：流程只跑过一次就固化成 Skill，或者触发条件写得太泛导致误触发。
用低风险输入连续测试 3 次，输出字段、边界和触发条件都稳定。
安装部署
安装部署术语
hermes setup
安装后的交互式设置向导，按模型与 Provider、终端后端、消息平台、工具等分段配置。
setup 验收初始化配置
首次运行先选 Quick Setup（Nous Portal 浏览器登录）、Full setup 或 Blank Slate；国内用户用国内 Provider 的 Key 时选 Full setup。结尾会打印 Tool Availability Summary 和配置文件位置，模型没配好时会提示 No inference provider is configured。每一段都能单独重跑，例如 hermes setup model。
什么时候用：第一次安装、换机器、换 Provider、或怀疑配置被改乱时使用。
常见误区和验收点⌄
误区：向导跑完就继续接复杂任务，没有用 hermes doctor、hermes status 和一次短问答验收。
setup 后能跑短问答，Skills 可浏览，Gateway 未启用时也知道下一步该配置什么。
hermes doctor
用于检查 Hermes Agent 运行环境、依赖和配置状态的诊断命令。
环境检查doctor 命令
doctor 适合在安装失败、命令异常、模型无法调用或 Gateway 不回复前先跑一次，帮助你把问题缩小到环境、配置或运行层。
什么时候用：出现 command not found、依赖缺失、Provider 配置失败或工作流突然不可用时使用。
常见误区和验收点⌄
误区：不看 doctor 输出，直接重装或同时修改多个配置。
能根据 doctor 输出判断下一步是查 PATH、依赖、API Key、权限还是 Gateway。
WSL2
Windows 里运行的 Linux 环境，是 Windows 上安装 Hermes Agent 的两条路线之一。
Windows Subsystem for LinuxWindows Linux 环境
v0.21 起原生 Windows 已正式支持，WSL2 不再是必须。需要完整的 Linux 工具链，或者本来就在 WSL2 里工作时再选它；原生安装的数据在 %LOCALAPPDATA%\hermes，WSL2 里的在 ~/.hermes，是两套独立环境。
什么时候用：需要 POSIX 环境、习惯 Linux 工具链，或仪表盘内置终端这类仍需 WSL2 的功能时使用。
常见误区和验收点⌄
误区：在 PowerShell 安装，在 WSL2 运行，或两个环境混用配置目录。
安装、setup、运行模板都在同一个 WSL2 终端里完成。
模型接入
模型接入术语
Provider
Hermes Agent 调用大模型时连接的服务入口，例如 OpenRouter、兼容端点或本地模型服务。
模型供应商模型入口
Provider 决定请求发给谁、用哪个模型、如何鉴权，以及失败时应该排查 API Key、模型名、额度还是路由。
什么时候用：安装完成后，先让一个 Provider 完成短问答，再进入工作流模板和 Gateway。
常见误区和验收点⌄
误区：模型报错时同时修改 API Key、模型名、Prompt 和 Gateway，导致无法定位是哪一步恢复。
短问答稳定返回，并且能记录模型名、Key 存放位置和最近一次成功时间。
OpenRouter
常见的模型聚合入口，可以用统一 API 接入多个模型和供应商。
OpenRouter ProviderOpenRouter 模型平台
OpenRouter 适合新手快速接模型，但要认真管理模型名、API Key、额度、限流和 Provider Routing。遇到 401、429 或 model not found 时，应先恢复短问答。
什么时候用：需要快速比较不同模型、降低切换成本、或希望通过一个入口管理多个模型时使用。
常见误区和验收点⌄
误区：只看价格，不记录失败重试、长上下文和人工修改带来的真实成本。
能用一个明确模型完成短问答，并能解释 401、429、model not found 分别先查什么。
API Key
模型平台用于识别账户和授权请求的凭证。
密钥模型 Key
API Key 应该只放在服务端环境变量或受控配置里，不应该写进页面、模板、截图或公开仓库。Hermes 以 ~/.hermes/.env 为准，它会覆盖 shell 里 export 的同名变量；排查 401 先看这个文件里的 Key，改完要重启会话和网关。
什么时候用：配置 OpenRouter、兼容模型端点或其他 Provider 时需要。
常见误区和验收点⌄
误区：复制不完整、放错环境、改完不重启，或者把 Key 暴露到前端和仓库。
Key 不出现在页面源码和 Git 历史里，短问答能稳定通过鉴权。
Provider Routing
按成本、速度、质量或供应商偏好选择模型实际调用路径的策略。
模型路由供应商路由
Provider Routing 适合在基础链路稳定后再优化。新手阶段先保证一个模型可靠返回，再逐步做任务分层、白名单、备用模型和成本记录。
什么时候用：当工作流稳定运行，并且你需要控制成本、速度或供应商选择时使用。
常见误区和验收点⌄
误区：链路还没稳定就配置复杂路由，导致报错时不知道是模型、Key、路由还是额度问题。
能记录每条工作流的模型、成本、失败率和人工修改时间。
429 / Rate limit
模型平台因为额度、频率或请求过大而拒绝继续处理。
限流额度限制
429 通常不是 Prompt 写坏了，而是调用频率、重试、额度或上下文长度触发限制。先降频、缩短输入、停止失败重试，再看平台额度。
什么时候用：工作流突然大量失败、短时间频繁触发、或长报告任务堆积时重点排查。
常见误区和验收点⌄
误区：看到失败后不停重试，让限流更严重。
降低频率和输入长度后，短问答恢复稳定，并记录失败重试次数。
消息入口
消息入口术语
Gateway
让 Hermes Agent 从 Telegram、飞书、企业微信、Slack 等消息平台接收和发送任务的入口。
消息入口Messaging Gateway
Gateway 让 Agent 更接近真实工作场景，但也带来权限、群聊、误触发和日志问题。正式群上线前，应先在测试群完成最短命令和低风险工作流。
什么时候用：当 CLI 已稳定，且团队需要在聊天工具里触发日报、提醒、查询或草稿生成时使用。
常见误区和验收点⌄
误区：第一天就接正式群，或者让所有成员都能触发高风险命令。
测试群能稳定收到状态回复，允许名单生效，失败日志能被维护者看到。
Webhook
外部系统把事件推送到一个地址、触发 Hermes Agent 执行的方式，是可选的入口。
回调地址消息回调
常用聊天平台并不靠 Webhook 收消息：Telegram 默认用长轮询，Slack、飞书、企业微信用 WebSocket 长连接，都不需要公网地址。Webhook 适合 GitHub、表单、监控告警这类外部系统主动触发任务，用 hermes webhook subscribe 创建订阅；它需要地址可访问、签名正确。
什么时候用：让 GitHub、表单、告警或自定义系统的事件触发 Hermes Agent 时使用；接聊天平台一般用不到。
常见误区和验收点⌄
误区：以为接 Telegram、飞书也要先配公网回调地址；或者开了 Webhook 却不校验签名和来源。
测试消息能进入日志，来源身份可识别，错误能返回到维护者。
工作流运营
工作流运营术语
Workflow
围绕固定输入、固定步骤和固定输出组织的一条可复现任务。
工作流任务流程
工作流不是一句 Prompt，而是一组可验证的操作：输入来自哪里、输出给谁、失败怎么发现、人工怎么确认、何时可以升级为定时任务或 Skill。
什么时候用：日报、周报、竞品监控、客户邮件分类、PR 摘要、Issue 分拣等重复任务都适合做成工作流。
常见误区和验收点⌄
误区：只关注一次输出是否漂亮，不定义输入来源、验收字段和失败恢复。
同一输入重复运行时，输出结构一致，人工能快速判断是否可用。
Starter 包
给新手第一次试跑准备的模板、Skills 示例、检查清单和排错清单。
免费资源包Free Starter
Starter 包的价值不是一次解决所有场景，而是让用户用低风险模板跑出第一条可复现工作流，理解目录结构和验收方法。
什么时候用：第一次安装后、还没有清晰场景时，先用 Starter 包选择日报、Issue 分类或内容选题模板。
常见误区和验收点⌄
误区：下载后立刻大改所有模板，导致安装、模型和 Prompt 问题混在一起。
30 分钟内跑通一个模板，并保存输入、输出、错误和人工修改记录。
人工确认
在外发、写入、删除、部署等高风险动作前保留人工审核。
Human in the loop二次确认
Hermes Agent 可以帮你整理、生成草稿和提示风险，但生产写入、客户消息、价格承诺、权限变更和部署动作都应保留人工确认。
什么时候用：任何可能影响客户、生产系统、账单、权限或外部承诺的工作流都需要。
常见误区和验收点⌄
误区：把“自动化”理解成完全无人值守，忽略可撤回性和责任边界。
高风险动作默认只生成草稿或建议，真正执行前需要明确确认。
验收清单
把能跑一次的工作流，变成可复现、可维护、可交接的检查标准。
上线检查Acceptance checklist
验收清单应覆盖 Provider、Memory、Skills、Gateway、输出质量、日志、权限、失败恢复和交接。没有验收，自动化只是一段临时演示。
什么时候用：从个人试跑进入长期使用、团队频道、客户项目或 VPS 运行前使用。
常见误区和验收点⌄
误区：只看一次成功输出，不记录失败条件和回滚方式。
别人接手后能按清单复现运行、定位错误并安全停止。
会话交接
记录上次成功、当前配置、已知问题、下一步和回滚方式，方便长期维护。
交接记录Session handoff
Hermes Agent 的长期价值来自可延续的上下文，而不是每次从头解释。会话交接让团队知道当前状态、谁负责、哪里失败过、下一次怎么继续。
什么时候用：定时任务、多人维护、客户项目或阶段性暂停后都应该写交接记录。
常见误区和验收点⌄
误区：只把结果发出去，不记录运行环境、错误、手动修改和下一步。
接手的人能在 10 分钟内知道项目状态、最近成功时间和下一步动作。