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

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

分支1Tags0
当前项目代码仓暂无内容

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

定制我的领域