hermes-optimization-guide:基于 Hermes-Agent 的优化指南与实用工具项目

Hermes Agent setup, migration, LightRAG, Telegram, and skill creation guide

分支1Tags0
文件最后提交记录最后更新时间
19 天前
1 个月前
19 天前
2 个月前
19 天前
5 个月前
19 天前
19 天前
19 天前
19 天前
19 天前
2 个月前
19 天前
19 天前
5 个月前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前
19 天前

Hermes 优化指南(中文简版)

Hermes Optimization Guide

English 完整版 · 本页是入口摘要,章节正文仍为英文。 · 最后同步:2026-08-22

⚠️ 状态说明:本文件有意保持为入口级摘要——完整指南(29 章 + 评分脚本、"绝不这样做" 清单、故障复盘)目前仅有英文。翻译是排队的后续工作;在翻译完成前,请以英文版为准。

实用指南 + 可安装制品(Skills、配置模板、基础设施脚本),针对 NousResearch/hermes-agent(当前覆盖到 v0.20.4 “Herald”(v2026.8.18),含流式语音、A2A 代理协议、外部密钥管理、egress/iron-proxy、桌面 Bots 与 computer use)。

一键起步

# 新建 Debian 12 / Ubuntu 24.04 VPS 上运行
curl -sSL https://raw.githubusercontent.com/OnlyTerp/hermes-optimization-guide/main/scripts/vps-bootstrap.sh | sudo bash

或阅读 docs/quickstart.md(5 分钟 Telegram 机器人)。

v0.19 / v0.20 新特性速览(摘要)

v0.20 “Herald”part24part15 等):

  • 流式语音 — 支持 barge-in 打断与唤醒词的实时语音输入输出
  • A2A v1.0 — Linux Foundation 的 Agent-to-Agent 开放协议(双向调用)
  • 出站 Webhook — 带负载过滤的 HTTP 推送
  • 桌面版增强 — Bots 标签页(Bot Mode)、多连接、memory graph
  • computer usehermes computer-use 在后台驱动桌面
  • egress / iron-proxy — 沙箱只持代理令牌,真实密钥由宿主机解析
  • 外部密钥 — 从 Bitwarden / 1Password / CLI 保险库供应 API 密钥

v0.18.0 “Judgment” 及之前的旧特性part26):

  • Mixture-of-Agents 成为一等模型 — 每个 MoA 预设都是 moa provider 下可直接选择的虚拟模型,各参考模型的推理分块展示,聚合答案实时流式输出;/moa 变成一次性快捷方式
  • 代理自证工作完成 — 编码任务附带验证证据(真正跑项目检查,而非口头宣称成功)、/goal 完成契约、/goal wait <pid>pre_verify 钩子
  • /learn + /journey 自我提升 — 从目录 / URL / 工作流中提炼可复用技能,并在时间线上浏览、编辑、删除代理学到的一切;桌面端新增可交互记忆图谱
  • 后台子代理并发扇出delegate_task 并行派发后台子代理,全部完成后合并为一轮回复,聊天永不阻塞
  • 桌面应用变身编码驾驶舱 — 按 profile 的 Projects(侧边栏、编码轨道、评审面板、worktree 管理)、多终端面板、聊天内 PR 风格 diff
  • 团队部署 — 网关 scale-to-zero(带排空协调)、/etc/hermes 管理员固定作用域、单网关多 profile 复用、cron 续跑
  • Google Vertex AI provider(自动铸造/刷新 OAuth2 令牌);Gemini-CLI OAuth provider 已移除,迁移说明见 part9

v0.17.0 “Reach”part15 等):

  • iMessage via Photon Spectrum,无需 Machermes photon login 即可进蓝色气泡;另有官方 WhatsApp Business Cloud API 适配器与 Raft 代理网络通道
  • 后台子代理delegate_task(background=true) 立即返回句柄,结果完成后自动回到会话
  • 桌面应用大升级 — 可重绑快捷键、原生系统通知、子代理实时观察窗、VS Code Marketplace 主题、可调终端面板
  • 仪表板成熟 — 浏览器内完整 profile 构建器(模型 + Skills + MCP)、重构的 Skills Hub(预览 + 安全扫描)、加固的仪表板认证
  • image_generate 支持图生图;Automation Blueprints 以引导表单取代裸 cron 语法;memory 工具支持原子批量操作
  • Telegram 富消息(Bot API 10.1,默认开启)、MCP elicitation(工具调用中途可向任意界面发起询问)

内容一览

  • 29 章正文part1part28 + 本 README) — v0.18 MoA / 验证 / /learn、v0.17 iMessage(Photon)、v0.16 桌面应用、NVIDIA / DGX Spark 本地运行、多智能体 Swarm、/undo、模糊模型选择器、Grok OAuth、hermes proxy、Kanban、/goal、Checkpoints v2、Curator、TUI、插件、LightRAG、Telegram、MCP、安全、可观测性、远程沙箱
  • 13 个可安装 Skillskills/) — 审计、备份、依赖扫描、成本报告、Telegram 分类、PR 审查、收件箱分类、Hermes 周报、垃圾过滤、会议准备 等
  • 5 套生产配置模板templates/config/) — minimum / telegram-bot / production / cost-optimized / security-hardened
  • 基础设施templates/compose/, templates/caddy/, templates/systemd/, scripts/) — Langfuse 自托管、Caddy 反代、systemd 硬化、VPS 引导脚本
  • Mermaid 架构图diagrams/
  • 可复现基准测试benchmarks/) — 13 个模型 × 5 个任务,含方法论
  • 生态目录ECOSYSTEM.md) — MCP 服务器、编码代理、仪表板插件
  • 交互式配置向导docs/wizard/) — 浏览器内生成 config.yaml

推荐阅读顺序

  1. 想最快跑通 Telegram 机器人 → docs/quickstart.md
  2. 想了解架构 → diagrams/architecture.md
  3. 想省钱 → part20-observability.md 的 "Cost-routing playbook"
  4. 想上生产 → docs/reference-architectures/ 选一个最接近的
  5. 用户面公开部署 → part19-security-playbook.md 必看
  6. 想要图形界面而非终端 → part24-desktop-app.md(Hermes 桌面应用)
  7. 想用自己的 GPU 本地运行 → part25-nvidia-local.md(RTX / DGX Spark)
  8. 想要多模型合议 + 可验证的任务完成 → part26-moa-verification.md(MoA、/goal 完成契约、/learn

许可与贡献

MIT。欢迎 Issue / PR,详见 CONTRIBUTING.md

项目介绍

Hermes Agent setup, migration, LightRAG, Telegram, and skill creation guide

定制我的领域