Hermes Decision Trace

Hermes 主项目 GitHub PR/Issue 讨论趋势评估

Hermes 主项目现在处在 社区爆发 + 架构补课 + 产品化收敛 阶段。讨论热点已经从“CLI agent 能不能跑”转向 长期在线、多平台 Gateway、provider/model 标准化、memory/session 连续性、插件化工具与 Dashboard 配置化

HTML完整论证
Wiki可检索归档
Feishu短入口交付
🎯
核心结论

Hermes 主项目现在处在 社区爆发 + 架构补课 + 产品化收敛 阶段。讨论热点已经从“CLI agent 能不能跑”转向 长期在线、多平台 Gateway、provider/model 标准化、memory/session 连续性、插件化工具与 Dashboard 配置化

🧭
推荐路径

不要无脑追最新版:继续按 Hermes upgrade runbook 做收益评估和定点回归。

🛡️
关键边界

最近创建 PR 速度非常快,样本中 7 天内 PR 已超过 200,而 merged known 样本远低于创建量。Search API 后续触发 rate limit,所以这不是全量精确数,但趋势足够明确。

关键判断

判断项摘要
推荐方案不要无脑追最新版:继续按 Hermes upgrade runbook 做收益评估和定点回归。
关键依据见完整记录中的评分依据、状态摘要和证据链。
落地方式按行动清单推进,保持可回退。
风险边界最近创建 PR 速度非常快,样本中 7 天内 PR 已超过 200,而 merged known 样本远低于创建量。Search API 后续触发 rate limit,所以这不是全量精确数,但趋势足够明确。

证据摘要

  • 由 Hermes 会话生成。证据点 1
  • 如涉及外部事实,应在正文中保留来源或验证路径。证据点 2

行动清单

不要无脑追最新版:继续按 Hermes upgrade runbook 做收益评估和定点回归。
建立 upstream watchlist:优先看 gateway、provider、memory/session、skills/plugins、dashboard。
本地改动保持薄补丁:官方正在快速补同类问题,本地 patch 要尽量可撤销。
重要能力先独立验证再切换:尤其 provider、gateway、compression、WebUI。
把我们已验证的运行经验沉淀成 skill/reference:官方方向一致,后续可选择性回灌 issue/PR,但不要把本地主线绑死到 upstream 节奏。

边界 / 风险

风险点

最近创建 PR 速度非常快,样本中 7 天内 PR 已超过 200,而 merged known 样本远低于创建量。Search API 后续触发 rate limit,所以这不是全量精确数,但趋势足够明确。

风险点

后果:

风险点

重复 PR 增多;

风险点

类似 bug 多人重复修;

风险点

label/priority 压不住噪音;

风险点

review 成瓶颈;

完整记录

Hermes 主项目 GitHub PR / Issue 讨论趋势评估

评估时间:2026-05-28 11:56:01 CST
目标仓库:NousResearch/hermes-agent
数据来源:GitHub 官方 REST API 当前样本 + 最近 issue / PR 标签、标题、状态、评论数结构化统计。

一句话结论

Hermes 主项目现在处在 社区爆发 + 架构补课 + 产品化收敛 阶段。讨论热点已经从“CLI agent 能不能跑”转向 长期在线、多平台 Gateway、provider/model 标准化、memory/session 连续性、插件化工具与 Dashboard 配置化

我的判断:Hermes 正在从本地 CLI agent 演进成个人/团队本地优先的 agent runtime / agent OS。短期高 churn 和升级风险会上升,但长期方向和我们本地 Hermes 体系高度一致,值得持续跟踪,但不适合无脑追最新版。

关键数据快照

指标当前观察
Stars170,440
Forks28,503
Open issues / PRs 计数14,488
最近 push2026-05-28 03:19 UTC
Discussions未开启
Subscribers667
最近更新 issue 样本84 个真实 issue
最近更新 PR 样本300 个 PR
最近创建 PR 样本200 个,几乎全部落在近 7 天

这个量级说明 Hermes 已不是普通开源小工具,而是高速增长中的基础设施项目。问题也很直接:社区提交速度明显高于维护消化速度

PR 趋势:主线在补稳定性,不只是加功能

最近更新 PR 样本中,标签分布最明显:

标签样本出现数含义
type/bug179修运行态问题是当前主旋律
type/feature74新功能仍多,但少于 bugfix
type/security17安全与边界开始被关注
type/refactor9架构整理刚开始
type/docs9文档更新跟进,但不是主投入

组件热点:

组件样本出现数判断
comp/gateway96Gateway 已经是核心战场
comp/cli84CLI/config/provider 仍在高频变化
comp/agent69agent runtime 本体仍在补稳定性
comp/plugins43插件化边界逐步成形
comp/tools19tool dispatch / schema / registry 是后续重点
comp/cron15scheduler 进入真实运行场景
comp/tui14TUI 仍有稳定性和体验问题

关键判断:Hermes 当前不是平稳迭代,而是在被真实使用场景反向推动架构升级。大量 PR 涉及 Docker、Gateway、session、provider、compression、skills、MCP、Dashboard,说明用户已经把它当长期运行系统在用。

Issue 趋势:用户真正想要的是“连续运行的 agent 系统”

真实 issue 样本标签热点:

标签样本出现数
P353
type/bug42
type/feature37
comp/agent29
comp/gateway26
P224
comp/cli15
tool/skills8
tool/memory8
provider/openai7
platform/telegram7

高价值讨论集中在:

  • Lazy Tool Schema Loading:减少 token overhead。
  • Single-Daemon Multi-Agent:单 daemon、多 topic、多 workspace、多 memory isolation。
  • Persistent Session Memory:跨会话搜索与自动压缩。
  • Topic-to-Profile routing:Telegram topic/thread 路由到不同 profile。
  • Codex / OpenAI provider 不稳定:Hermes 内和原生 CLI 行为不一致。
  • context compression 后 /goal 丢失。
  • Gateway session JSONL/state.db/idle TTL 导致上下文丢失。
  • send_message 跨通道上下文断裂。

这些不是零散需求,而是同一个方向:用户希望 Hermes 具备长期在线、跨平台、有记忆、有路由、有状态连续性的 runtime 能力。

五条主要讨论主线

1. Gateway 从边缘功能变成核心 runtime

Gateway 相关 PR/issue 密度最高之一,涉及:

  • Telegram / Feishu / Discord / platform routing;
  • topic / profile / user routing;
  • session JSONL、state.db、idle TTL;
  • media path、delivery root;
  • busy agent queueing、interrupt、feedback;
  • Docker supervised gateway restart。

判断:Hermes 正在从“本地命令行 agent”转向“长期在线、多通道、多 profile、多 session 的 agent runtime”。

2. Provider / model 生态继续扩张,但必须标准化

近期方向包括:

  • ModelArk / BytePlus Coding Plan;
  • Alibaba Coding Plan 类 provider;
  • OpenAI Codex Responses API;
  • xAI OAuth loopback fallback;
  • keyless provider model discovery;
  • custom provider api_mode
  • fallback provider auth/context。

核心矛盾:provider 加得越快,auth、model discovery、stream/non-stream、fallback、tool_use、health check 越容易碎片化。

判断:后面会需要更正式的 provider contract。否则每加一个 provider 就会带来一批 config/auth/model/fallback 问题。

3. Dashboard / WebUI 会从展示页变成配置中心

近期 PR 已经开始把 plugin setup、web provider setup、sidebar、trust-proxy、skills page 等放入 Dashboard。

判断:Dashboard 后续大概率会承载:

  • provider key 配置;
  • plugin setup;
  • gateway 状态;
  • skills 管理;
  • cron / sessions / memory 可视化;
  • 多 profile 管理;
  • diagnostics / doctor 可视化。

这会让 Hermes WebUI 从聊天界面转成轻量控制台。

4. Memory / context compression / session continuity 是下一阶段关键能力

现在已有多个 issue 指向同一个底层问题:session 连续性不够稳。

典型问题:

  • compression 旋转 session_id 后 goal 丢失;
  • session transcript fallback;
  • persistent memory;
  • cross-session search;
  • cross-channel amnesia;
  • ACP session provenance metadata。

判断:Hermes 后面会把 session provenance、memory index、workspace binding、topic/profile routing、compression metadata 抽成更正式的架构层。

5. Tools / MCP / Skills 会走能力注册表和按需注入

当前讨论包括:

  • V4A skill_manage patches;
  • external skill dirs;
  • MCP breaker-open;
  • tool dispatch session_id;
  • native Responses web_search;
  • lazy tool schema loading。

判断:Hermes 会从“内置工具列表”转向“能力注册表 + 按需注入 + 插件化工具运行时”。Lazy Tool Schema Loading 很可能成为降 token 和提升稳定性的关键设计。

当前主要风险

风险一:PR/issue 吞吐不匹配

最近创建 PR 速度非常快,样本中 7 天内 PR 已超过 200,而 merged known 样本远低于创建量。Search API 后续触发 rate limit,所以这不是全量精确数,但趋势足够明确。

后果:

  • 重复 PR 增多;
  • 类似 bug 多人重复修;
  • label/priority 压不住噪音;
  • review 成瓶颈;
  • 社区贡献者容易挫败。

风险二:架构边界还在漂

现在很多 PR 横跨多层:

  • provider 改到 agent/config/auth/docs/test;
  • gateway 改到 session/memory/tools;
  • dashboard 改到 plugin/provider/env;
  • compression 改到 goal/session_id/tool dispatch。

说明项目处在架构再组织期。短期活跃,但升级风险偏高。

风险三:真实运行态 bug 多

Docker restart、gateway logs、media delivery、session persistence、Telegram/Feishu topic routing 都是真实运行问题,不是 demo 问题。

对我们本机 Hermes 来说,后续升级不能只看 release note,要按链路回归:provider、gateway、memory、cron、skills、WebUI 都要验。

发展趋势判断

短期:1–2 个月

会继续围绕这些方向高频更新:

  • Codex/OpenAI/xAI/provider 兼容;
  • Gateway 稳定性;
  • Docker/s6 镜像;
  • Dashboard 配置入口;
  • skills/plugin bugfix;
  • context compression/session continuity;
  • Telegram/Feishu/Discord 多平台细节。

判断:高频更新继续,main 和 release 之间可能经常出现“main 已修、release 未出”的窗口。

中期:3–6 个月

大概率形成几条正式能力:

  1. Provider contract:model discovery、static model list、auth、fallback、health check、Responses API、tool_use。
  2. Gateway runtime:单 daemon、多平台、多 topic、多 profile、多 workspace isolation。
  3. Dashboard 配置中心:provider/plugin/skills/gateway/session/cron。
  4. Memory / Session / Compression 统一模型。
  5. Tools / Skills / MCP registry。

长期:6–12 个月

如果治理跟上,Hermes 会从 agent CLI 演进成:

个人/团队本地优先的 agent OS/runtime:CLI + WebUI + Gateway + Plugins + Memory + Scheduler + Multi-provider。

如果治理跟不上,则可能变成:

社区热度极高,但 issue/PR 积压、provider 兼容碎片化、主分支频繁破运行态的高速迭代项目。

我偏向前者,但前提是官方能收住 triage、release cadence、plugin boundary 和 provider contract。

对我们本机 Hermes 生态的建议

P0:必须盯

  • Gateway session persistence / topic routing / delivery;
  • Provider config / custom provider / model discovery;
  • Context compression / session_id / goal persistence;
  • Skills external dirs / skill_manage patch;
  • WebUI / Dashboard plugin setup。

这些会直接影响涛哥本机主链路。

P1:选择性吸收

  • 新 provider,如 ModelArk / Alibaba / xAI / Codex;
  • Native web_search / Responses web_search;
  • Docker supervised gateway;
  • Lazy Tool Schema Loading。

P2:暂缓跟随

  • 纯 UI 小改;
  • 非主平台 adapter;
  • 低优先级 P3 feature;
  • 未合并社区 PR。

操作建议

  1. 不要无脑追最新版:继续按 Hermes upgrade runbook 做收益评估和定点回归。
  2. 建立 upstream watchlist:优先看 gateway、provider、memory/session、skills/plugins、dashboard。
  3. 本地改动保持薄补丁:官方正在快速补同类问题,本地 patch 要尽量可撤销。
  4. 重要能力先独立验证再切换:尤其 provider、gateway、compression、WebUI。
  5. 把我们已验证的运行经验沉淀成 skill/reference:官方方向一致,后续可选择性回灌 issue/PR,但不要把本地主线绑死到 upstream 节奏。

最终判断

Hermes 主项目的讨论趋势已经很清楚:从“能干活的 CLI agent”升级为“长期在线、多平台、有记忆、有工具生态的 agent runtime”。

这条路线和我们现在本地 Hermes 使用方式高度一致。短期会乱、会快、会有升级坑;但中长期值得持续跟。我们的策略应该是:跟方向,不盲追;吸收架构,不被 churn 带节奏;关键链路永远本地验证后再切。