📌 什么是子任务并行

使用 delegate_task，HERMES 能同时执行多个独立任务——每个子任务有自己独立的上下文环境和工具集，互不干扰，最终结果统一汇总给你。这就像同时派三个助手分头工作，然后汇总结果。

🏗️ 并行架构

📖 使用方式

# 方式1：直接对话（推荐）
你：帮我同时做三件事
1. 搜索今天 AI 行业新闻
2. 查看我的日程安排
3. 检查项目 A 的代码是否有错误

# 方式2：指定工具集
你：帮我同时做：
- 用浏览器打开 news.ycombinator.com
- 用终端检查磁盘空间
- 阅读我的日程文件

🎯 后台运行

子任务在后台独立运行，不阻塞当前对话。你可以在子任务执行的同时继续做其他事，子任务的结果会自动返回。

💡 并行技巧

• 任务要独立——子任务之间不能互相依赖（A 不需要 B 的结果）
• 每个任务自包含——提供完整的上下文信息
• 适合组合：搜索 + 分析 + 生成、检查各服务器状态、多文件并行处理
• 不适合：需要依赖前一步结果的任务、需要用户确认的任务
• 最多同时执行 3 个子任务（当前限制）

🔁 delegate_task 底层调用

# HERMES 内部实际调用的方式
delegate_task(tasks=[
  {goal: "搜索今天AI行业新闻", toolsets: ["web"]},
  {goal: "查看日程文件 ~/schedule.md", toolsets: ["file"]},
  {goal: "检查项目A代码是否有语法错误", toolsets: ["terminal", "file"]}
])
# 每个子任务独立运行，结果自动返回

🎯 子任务角色类型

💡 并行适用场景判断

📌 什么是网关

网关（Gateway）是 HERMES 的消息桥梁——让你通过飞书、微信、Telegram 等即时通讯软件与 HERMES 对话，而不只是在终端使用。开启了网关，你可以在手机上给 HERMES 发消息，就像跟一个同事聊天一样方便。

🏗️ 架构

🚀 启动网关

# 启动时带网关（推荐）
hermes start --gateway

# 后台守护模式运行
hermes start --daemon --gateway

# 查看网关状态
hermes gateway status

# 测试网关是否正常运行
curl http://localhost:8080/health

🔧 网关配置

# config.yaml 网关配置
gateway:
  enabled: true
  port: 8080              # 网关监听端口
  platforms:
    - feishu              # 飞书
    - weixin              # 微信（如已配置）

# .env 中的平台配置
FEISHU_APP_ID=cli_xxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxx
FEISHU_VERIFICATION_TOKEN=xxxxx
# WEIXIN_APP_ID=wx_xxxxx
# WEIXIN_APP_SECRET=xxxxx

📋 平台接入步骤

1. 飞书开放平台：创建企业自建应用 → 获取 App ID / App Secret → 配置事件回调 URL（{你的网关}/webhook/feishu）→ 订阅 im.message.receive_v1 事件 → 添加 im:message 权限 → 发布上线
2. 微信：前往微信公众平台 → 创建服务号 → 开发 → 基本配置 → 配置服务器 URL（{你的网关}/webhook/weixin）→ Token 需与 .env 一致 → 获取 AppID / AppSecret
3. Telegram：在 Telegram 中搜索 BotFather → 发送 /newbot → 获取 Token → 配置到 .env 的 TELEGRAM_BOT_TOKEN

🔧 平台配置参考

# .env 中的平台配置
# 飞书
FEISHU_APP_ID=cli_a7xxxxxxxxxxxx
FEISHU_APP_SECRET=*** 微信
WEIXIN_APP_ID=wx_xxxxxxxxxxxx
WEIXIN_APP_SECRET=*** Telegram
TELEGRAM_BOT_TOKEN=123456:ABC-*** 网关健康检查
curl http://localhost:8080/health
# 返回 {"status":"ok","platforms":["feishu","weixin"]}

# 查看具体平台连接状态
curl http://localhost:8080/status

💡 网关使用技巧

• 启动后先测试健康检查端点 curl http://localhost:8080/health
• 飞书回调 URL 必须是公网可访问的，本地开发用 frp 或 ngrok 穿透
• 网关日志通过 hermes logs | grep gateway 查看
• 如果某平台收不到消息，先检查该平台的开发者后台是否正确配置
• Cron 任务的 deliver 参数设为"all"会把结果推送到所有已连接平台

📌 什么是记忆

记忆系统是 HERMES 区别于普通 AI Chat 的关键特性——它能跨会话记住信息。你告诉它的偏好、环境配置、工作流知识，在下次对话或下下次对话中仍然有效，不需要重复说明。

📖 记忆的工作原理

💾 记忆操作

# 主动保存（推荐显式告知）
你：记住我的工作目录是 D:/Projects
你：记住我喜欢用 Markdown 格式回复
你：记住我的 API Key 在 .env 文件里
你：记住这个数据源：qt.gtimg.cn 可以查股票行情

# 查看已记住的信息
你：你记得哪些关于我的信息？
你：记忆里有什么重要内容？

# 修改记忆
你：把我的工作目录改到 E:/Work

# 删除记忆
你：忘掉刚才那个 API 地址

💡 记忆管理技巧

📁 存储位置

~/.hermes/
├── memory.db          # 记忆数据库（SQLite，自动维护）
├── memory/            # 用户信息目录（手工编辑可用）

🤖 HERMES 自动记忆的内容

🎯 记忆管理策略

🔍 检查记忆状态

# 查看所有记忆
你：你记得哪些关于我的信息？
你：我的记忆里有什么内容？
你：查一下你记住的数据源

# 更新记忆
你：忘掉之前的工作目录
你：把工作目录改成 E:/Projects

# 批量清理
你：帮我清理所有过时的记忆
你：重新帮我整理一下记忆内容

📌 什么是 Profile

Profile 是 HERMES 的多配置方案——你可以为不同使用场景准备独立的配置文件、技能包、记忆库和环境变量。工作用一套配置，个人用另一套，互不干扰，切换只需要一个参数。

🎯 典型使用场景

📖 使用 Profile

# 启动时指定 Profile
hermes --profile work start
hermes --profile personal start

# 查看当前使用哪个 Profile
hermes config get profile

# 创建新 Profile
mkdir -p ~/.hermes/profiles/myprofile
# 在目录中创建独立的 config.yaml 和 .env

📁 Profile 目录结构

~/.hermes/profiles/
├── default/               # 默认配置（不指定 profile 时使用）
│   ├── config.yaml
│   ├── .env
│   ├── skills/
│   └── memory.db
├── work/                  # 工作 Profile
│   ├── config.yaml        # 独立的模型/工具配置
│   ├── .env               # 公司的 API Key
│   ├── skills/            # 工作相关的 Skills
│   │   ├── code-review/
│   │   └── daily-report/
│   └── memory.db          # 独立的记忆库
├── personal/              # 个人 Profile
│   ├── config.yaml
│   ├── .env               # 个人的 API Key
│   ├── skills/
│   │   ├── stock-check/
│   │   └── study-helper/
│   └── memory.db
└── dev/                   # 开发 Profile
    ├── config.yaml
    ├── .env
    └── skills/

🛠️ 创建新 Profile

# 方式1：手动创建目录
mkdir -p ~/.hermes/profiles/work
# 复制默认配置作为起点
cp ~/.hermes/config.yaml ~/.hermes/profiles/work/
# 创建独立的 .env
touch ~/.hermes/profiles/work/.env

# 方式2：让 HERMES 帮你创建
你：帮我创建一个新的 Profile 叫 work
你：创建开发用的 Profile 叫 dev

# 启动时指定 Profile
hermes --profile work start --gateway
hermes --profile dev start

📋 Profile vs 多实例对比

💡 Profile 使用技巧

• 切换 Profile 需要重启 HERMES——不同的 Profile 不会同时运行
• 默认 Profile（default）在不指定 --profile 时使用
• 每个 Profile 有独立的记忆库——工作记忆不会混入个人记忆
• 共享 Skills 可以放在公共目录，各 Profile 通过符号链接引用
• 不同 Profile 可以使用不同的 API Key 和模型配置，方便费用管理

📌 什么是守护模式

守护模式（Daemon）让 HERMES 在后台持续运行——即使关闭了终端窗口或 SSH 连接断开，HERMES 仍在工作。配合网关（Gateway），你可以随时通过飞书/微信给后台的 HERMES 发消息。

🚀 启动守护模式

# 最简单的启动方式
hermes start --daemon --gateway

# 指定 Profile 启动
hermes --profile work start --daemon --gateway

# 指定端口（避免冲突）
hermes start --daemon --gateway --port 8081

🪟 Windows 自启动（bat 脚本）

# 创建 start_hermes.bat，放到「启动」文件夹
@echo off
cd /d D:\hermes-agent
call .venv\Scripts\activate
hermes start --daemon --gateway

# 或创建 VBS 脚本（无窗口后台运行）
' start_hermes.vbs
CreateObject("WScript.Shell").Run "cmd /c D:\hermes-agent\start_hermes.bat", 0, False

🔧 管理守护进程

🪟 Windows 注册为服务（后台常驻）

# 使用 NSSM（Non-Sucking Service Manager）注册为 Windows 服务
# 1. 下载 nssm.exe https://nssm.cc/download
# 2. 注册服务
nssm install HermesAgent

# 在弹出的界面中配置：
# Application Path: C:\path	o\.venv\Scripts\hermes.exe
# Arguments: start --daemon --gateway
# Startup directory: C:\path	o\hermes-agent

# 3. 启动服务
nssm start HermesAgent

# 4. 查看状态
nssm status HermesAgent

# 5. 设置开机自启（默认已开启）
nssm set HermesAgent Start SERVICE_AUTO_START

🔄 守护进程生命周期管理

💡 建议

• 配合 系统自启动 使用，开机自动运行
• Windows：启动文件夹 bat / VBS 脚本，或注册为 NSSM 服务
• Linux：用 systemd 服务（见第 32 章详细配置）
• 定期检查日志（每周一次），确保守护进程正常运行
• 升级前先 hermes stop，升级完成再启动
• 建立启动日志，遇到问题时方便回溯

📌 诊断命令大全

🔧 常见问题与解决

🌐 网络诊断工具

🔄 恢复步骤（按严重程度排序）

1. 查看日志 — 先看 hermes logs --tail 30，日志里有最详细的错误原因
2. 发日志给 HERMES — 帮我看看这个日志哪里错了，它自己能分析自己的错误
3. 重启 — hermes stop && hermes start，解决很多临时问题
4. 检查网络 — 用上面的网络诊断工具测试 API 连通性
5. 备份并重置 — 备份 ~/.hermes，然后 hermes config reset
6. 重装依赖 — 删除 .venv 重新 uv pip install -e .

💡 调试技巧

• 查看日志永远是第一步——日志里有最详细的错误信息
• 把日志内容直接发给 HERMES：帮我看看这个日志哪里错了
• 升级前先备份 ~/.hermes 整个目录
• 遇到奇怪问题先试试重启——能解决大部分临时故障
• 升级后如果出问题，检查是否需要更新 config.yaml 格式

📌 API 安全——最高优先级

🛡️ 安全清单

📋 .gitignore 推荐配置

# 必加项（防止密钥和数据库泄露）
.env
*.db
*.log
__pycache__/
.venv/

# 建议添加
config.yaml          # 如果包含敏感信息
*.key
.secrets
credentials*
token*
secret*

# HERMES 特定
~/.hermes/
hermes.log
.cache/
*.pid

🛡️ 攻击面分析与防范

✅ 最佳实践汇总

📌 提示词工程基础

好的提示词（Prompt）能让 HERMES 的输出质量提升数倍。以下是经过验证的核心原则——理解这些，你的 HERMES 使用体验会有质的飞跃。

🎯 提示词五大原则

📝 提示词模板示例

# 结构化的提示词
你：[角色]作为数据分析师，
[任务]分析下面这份销售数据，
[格式]用表格展示：月份、销售额、增长率，
[约束]只输出表格，不要其他文字，
[数据]2024年Q1：1月100万、2月120万、3月150万

# 效果：HERMES 会严格按照你的四段式指令执行

💡 System Prompt 优化

在 config.yaml 中设置 system_prompt，让 HERMES 始终保持特定风格和行为模式：

# config.yaml
system_prompt: |
  你是一个专业的 Python 开发助手。
  回复要简洁，代码要有注释。
  先解释思路，再给代码。
  不要使用 "首先/然后/最后" 等过渡词。
  如果问题不明确，先问清楚再回答。

🔁 多轮对话技巧

# 第1轮：提出任务
你：帮我分析这份服务器日志

# 第2轮：补充要求
你：只看 ERROR 和 WARN 级别
你：按时间排序显示
你：把重复的错误去重

# 第3轮：调整输出
你：改成表格，加一列"出现次数"
你：导出为 CSV 文件保存到桌面

📖 Few-Shot 示例引导

给 HERMES 提供输入输出示例，能显著提升特定任务的准确性：

你：我需要把产品名称转成标准格式，示例如下：
输入："苹果 iPhone 15 Pro Max 256GB 深黑色"
输出：iPhone 15 Pro Max / 256GB / 深黑

输入："华为 Mate60 Pro 512GB 雅丹黑"
输出：Mate60 Pro / 512GB / 雅丹黑

现在帮我转换：
输入："三星 Galaxy S24 Ultra 1TB 钛灰"

🧠 Chain of Thought（思维链）

让 HERMES 展示推理过程可以提高复杂任务的准确率：

你：一步一步思考，然后回答：
公司A 的营收是 1000万，成本是 600万
公司B 的营收是 800万，成本是 500万
问：哪家公司的利润率更高？
请先列出计算过程，再给出答案

🎭 角色设定模板

# 不同的角色设定适合不同的任务类型
你：你是一个资深 Python 架构师，帮我 review 这段代码
你：你是一个金融分析师，分析这个股票的技术面
你：你是一个资深编辑，帮我润色这篇文章
你：你是一个系统管理员，帮我诊断服务器问题
你：你是一个法律顾问，帮我审查这份合同的条款

📌 什么是工作流

工作流是一系列有序步骤的组合——将多个工具调用和判断逻辑串联起来完成一个复杂任务。HERMES 会自动规划执行路径并逐步完成，你只需要描述想要的结果。

🏗️ 工作流通用结构

📖 三种搭建方式

📋 实战示例：每日数据报告

# 第1步：在工作流运行之前先准备好
你：帮我设计一个每日数据报告工作流

# 第2步：描述工作流步骤
1. 每天早上8点从数据库拉取昨日销售数据
2. 计算关键指标（日活用户、收入、转化率）
3. 与上周同期对比，标注涨跌
4. 生成简洁的 HTML 报告
5. 发送到飞书团队群

# 第3步：保存为 Skill
你：把这个工作流存为 Skill 叫 daily-report
# 之后只需说：用 daily-report 技能跑今天的报告

🔀 带条件分支的工作流

你：帮我设计一个带条件判断的工作流
每天早上8点：
1. 获取服务器状态（CPU、内存、磁盘）
2. 判断状态：
   - 如果所有指标正常 → 记录日志，不通知
   - 如果 CPU > 80% → 发送告警到飞书
   - 如果磁盘 > 90% → 发告警并建议清理
   - 如果有任何指标异常 → 生成状态报告
3. 保存状态快照到文件

📋 工作流设计模式

💡 工作流设计原则

📌 什么是知识库（RAG）

知识库是 HERMES 的外部知识来源——把你公司的产品文档、技术手册、操作规范放进去，HERMES 在回答时会先检索相关知识再生成回答（RAG：检索增强生成）。这意味着 HERMES 可以回答它训练数据中不存在的特定领域问题。

🏗️ RAG 工作流程

📁 知识库目录结构

~/.hermes/knowledge/
├── 产品手册/
│   ├── 功能介绍.md
│   ├── 版本更新.md
│   └── FAQ.md
├── 技术文档/
│   ├── API参考.md
│   ├── 部署指南.md
│   └── 数据库设计.md
├── 培训资料/
│   ├── 新手教程.md
│   └── 最佳实践.md
└── 公司规范/
    ├── 代码规范.md
    └── 安全制度.md

📖 使用方式

# 添加文档到知识库
你：把这份产品文档加到知识库
你：把这个 FAQ 文件导入知识库

# 基于知识库提问
你：根据产品手册，介绍一下核心功能
你：查一下我们的 API 限流规则是什么
你：根据部署指南，新服务器需要装哪些依赖

# 更新知识库
你：把新的 API 文档替换旧的版本

🏗️ RAG 技术实现原理

1. 文档索引：知识库中的文档被解析成文本块并建立索引
2. 查询检索：用户提问时，系统根据问题在知识库中检索最相关的文档块
3. 上下文注入：检索到的相关文档块被注入到 LLM 的上下文中
4. 增强生成：LLM 基于检索到的知识 + 自身能力生成更准确的回答

📁 支持的文件格式

📚 企业知识库搭建案例

# 推荐结构
~/.hermes/knowledge/
├── 产品手册/
│   ├── 01-产品概述.md
│   ├── 02-功能说明.md
│   ├── 03-版本更新日志.md
│   └── FAQ.md
├── 技术文档/
│   ├── API参考.md
│   ├── 部署指南.md
│   ├── 数据库设计.md
│   └── 架构说明.md
├── 培训资料/
│   ├── 新手教程.md
│   └── 最佳实践.md
└── 公司规范/
    ├── 代码规范.md
    ├── 安全制度.md
    └── 流程规范.md

💡 知识库最佳实践

• 文档格式：推荐 Markdown 格式，结构清晰，层级分明，易于检索
• 分门别类：按主题/部门/项目分类存放，文件名加编号便于维护
• 定期更新：文档更新后同步更新知识库，避免回答过时信息
• 质量控制：知识库内容的质量直接决定回答的准确性，定期审核
• 原子化：每个文档聚焦一个主题，不要把所有内容堆在一个文件里
• 版本管理：重要文档加版本号，方便追踪变更历史

📈 模型响应速度优化方法一览

⚡ 模型响应速度对比

💾 显存管理技巧

💰 API 费用节省策略

🎯 模型选择决策指南

⚡ 日常使用优化清单

1. 默认模型设 Flash：日常 90% 的任务完全够用，费用仅为旗舰模型的 1/30
2. 开启流式输出：stream: true，首字显示快 3 倍，体验更好
3. 控制 max_tokens：简单问答设 1024，复杂任务设 4096，避免浪费
4. 定期清会话：每 20-30 轮 hermes new 一次，减少上下文消耗
5. 常用任务存 Skill：减少重复的提示词和上下文，节省 30-60% token
6. 配置 temperature：精确任务设 0.1，创意任务设 0.8

📊 性能基准测试方法

# 测试 API 响应速度
curl -s -o /dev/null -w "总耗时: %{time_total}s
连接: %{time_connect}s
首字: %{time_starttransfer}s
" \
  https://api.deepseek.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer *** \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}],"stream":false,"max_tokens":10}'

# 测试令牌生成速度（多次取平均）
for i in 1 2 3; do
  curl -s ... -o /dev/null -w "%{time_total}s\n"
done

⚡ 不同场景的模型推荐

🏗️ 多 Agent 架构图解

多 Agent 协作的核心思想是分工合作——一个主 Agent 负责任务拆解和结果汇总，多个子 Agent 并行执行独立任务，大幅提升效率。

🔄 用 delegate_task 实现多 Agent

在同一个 HERMES 实例里，你可以同时派出多个子任务并行工作——每个子任务有自己独立的上下文和工具集：

# 同时做三件事，互不干扰
你：帮我同时做以下三件事：
1. 搜索今天AI行业新闻
2. 查看我的日程安排
3. 检查项目A的代码是否有错误

# HERMES 内部会这样调度（你不需要手动写这个）
delegate_task(tasks=[
  {goal: "搜索今天AI行业新闻", toolsets: ["web"]},
  {goal: "查看日程文件 ~/schedule.md", toolsets: ["file"]},
  {goal: "检查项目A代码是否有语法错误", toolsets: ["terminal"]}
])
# 每个子任务独立运行，结果自动返回

🎯 delegate_task 参数详解

🖥️ 多 HERMES 实例协作（高级）

你可以同时运行多个 HERMES 实例，每个干不同的活，通过不同端口访问：

# 终端1：启动实例A（用默认配置，做日常问答）
hermes start --port 8081

# 终端2：启动实例B（用工作配置，做代码审查）
hermes --profile work start --port 8082

# 终端3：启动实例C（用网关，接飞书消息）
hermes start --gateway --port 8083

📂 团队共享知识库

把 HERMES 的知识库放在共享目录，团队成员可以共用同一套配置和知识：

# 推荐目录结构
共享盘:/HERMES_知识库/
├── config.yaml              ← 团队统一配置
├── .env                     ← 共享 API Key（需权限管理）
├── skills/                  ← 团队共享技能
│   ├── 客服流程/
│   └── 代码规范/
├── knowledge/               ← 团队知识文档
│   ├── 产品手册/
│   ├── 技术文档/
│   └── 培训资料/
└── cron/                    ← 共享定时任务

👥 团队协作工作流示例

# 示例：团队周报汇总 Cron 工作流
cronjob(
  action="create",
  name="团队周报汇总",
  schedule="0 17 * * 5",        # 每周五下午5点
  prompt="
    1. 查看团队共享目录中的周报文件
    2. 提取每个人的核心工作内容
    3. 按项目分类汇总进度
    4. 标注风险和阻碍项
    5. 生成格式化的团队周报
    6. 发送到飞书团队群",
  deliver="feishu:oc_team_group"
)

💡 多 Agent 使用建议

• 任务要独立——子 Agent 之间不能互相依赖结果
• 给足上下文——每个子 Agent 需要独立、完整的任务描述
• 适合场景：多源数据收集、并行分析、批量文件处理
• 不适合：需要前一步结果的任务、需要用户确认的任务
• 限制：同时最多 3 个并发子 Agent（可配置）

🔁 Agent 通信模式

📋 扇出模式实战：市场调研

你：帮我做一个市场调研，同时查以下信息：
1. 搜索"2026年 AI 行业市场规模预测"
2. 搜索"主要 AI 公司最新财报"
3. 搜索"AI 行业政策变化"
汇总成一份市场调研报告，包含数据来源